Graphicx

G³ówn± funkcj± pakietu jest do³±czenie plików graficznych w ró¿nych formatach (w przypadku plików nie zawieraj±cych deklaracji rozmiaru, nale¿y go wyspecyfikowaæ).

Pakiet korzysta z pakietów graphics (jest jego rozszerzeniem) i keyval, tak wiêc opisujê polecenia obu pakietów (je¿eli ³adujemy pakiet graphicx, wszystkie one s± dostêpne).

Opcje okre¶laj±ce mo¿liwo¶ci driverów

Opcja Opis mo¿liwo¶ci
dvips.dvi przetwarzany przez dvips T.Rokickiegowszystko
xdviwszystko
dvipdfS.Lasenkowszystko
dvipdfmwszystko
pdftexpdftexwszystko
dvipsoneY & Ywszystko
dviwindojwwszystko
emtexsterowniki emtexatylko do³±czanie plików (bez skalowania)
dviwinH.Sendoukastylko do³±czanie plików
oztexA.Trevorrowdo³±czanie plików, obroty, kolory
texturesBlue Sky???
pctexpsPCTEXdo³±czanie plików, obroty, kolory
pctexwinPCTEXdo³±czanie plików, obroty, kolory
pctexhpPCTEXdo³±czanie plików
pctex32PCTEXwszystko
truetexKinchdo³±czanie plików (ograniczone kolory)
tcidviKinch???
vtex???????

Pozosta³e opcje

Opcja Opis
debugshow ???
draftnie jest wstawiana grafika, (wstawiana jest nazwa pliku) rezerwowane jest jedynie miejsce
finalwy³±cza opcjê draft
hiderotateje¿eli driver nie obs³uguje funkcji obrotu tekstu, a w tek¶cie bêd± u¿yte takie funkcje nie bêdzie sygnalizowany b³±d, ale tekst, który ma byæ obrócony nie bêdzie widoczny
hiresbbrezerwuje na rysunek miejsce o wymiarach okre¶lonych przez %%HiResBoundingBox, a nie okre¶lonych przez %%BoundingBox
hidescaleje¿eli driver nie obs³uguje funkcji skalowania tekstu, a w tek¶cie bêd± u¿yte takie funkcje nie bêdzie sygnalizowany b³±d, ale tekst, który ma byæ skalowany nie bêdzie widoczny
unknownkeysallowedopcja dla pakietu keyval
unknownkeyserroropcja dla pakietu keyval

Polecenia

polecenie opis
\includegraphics[parametry]{nazwa pliku} parametry dodatkowe okre¶laj± dodatkowe operacje na do³±czanej grafice (np. obrót, skalowanie) lub okre¶laj± brakuj±ce dane (np. rozmiar); warto¶ci parametrów okre¶lamy w nastêpuj±cy sposób:
nazwa=warto¶æ
kolejne definicje parametrów oddzielamy przecinkiem;
height=d³ugo¶æ
wysoko¶æ obszaru zajmowanego przez grafikê -- rysunek zostanie przeskalowany do zadanego rozmiaru
width=d³ugo¶æ
szeroko¶æ obszaru zajmowanego przez grafikê -- rysunek zostanie przeskalowany do zadanego rozmiaru (je¿eli podamy tylko jeden wymiar pozosta³y zostanie przeskalowany tak, aby zachowaæ proporcje)
keepaspectratio=d³ugo¶æ
je¿eli s± okre¶lone oba rozmiary (wysoko¶æ i szeroko¶æ), rysunek zostanie przeskalowany tak, aby nie przekroczyæ ¿adnego z nich
totalheight=d³ugo¶æ
ca³kowita wysoko¶æ (g³êboko¶æ + wysoko¶æ obszaru zajmowanego przez grafikê -- rysunek zostanie przeskalowany do zadanego rozmiaru -- istotne przy obrotach
angle=warto¶æ
k±t (w stopniach; warto¶æ dodatnia oznacza obrót w kierunku przeciwnym do ruchu wskazówek zegara) obrotu rysunku; (stopieñ przeskalowania zale¿y od kolejno¶ci definicji paramatrów rozmiaru i obrotu)
scale=warto¶æ
wspó³czynnik przeskalowania grafiki
origin=warto¶æ
patrz opis \rotatebox
clip
powoduje obciêcie wszystkiego co ,,wystaje'' poza zadane wymiary obiektu (Boundingbox)
bb=warto¶æ warto¶æ warto¶æ warto¶æ
okre¶la wymiary rysunku -- wspó³rzêdne lewego dolnego i prawego górnego rogu obszaru. Definicja jest niezbêdna je¶li w samym rysunku nie ma takiej informacji.
viewport=warto¶æ warto¶æ warto¶æ warto¶æ
parametr pozwala na wyciêcie z do³±czanej grafiki zadanego prostok±ta, okre¶lonego przez lewy dolny i prawy górny róg
trim=warto¶æ warto¶æ warto¶æ warto¶æ
funkcja podobna jak wy¿ej opisana, ale warto¶ci okre¶laj± wielko¶æ odciêcia z lewej strony,, z do³u, z góry i prawej strony rysunku
draft
zamiast wstawienia rysunku pojawi siê nazwa pliku (zostanie zarezerwowane prawid³owe miejsce na rysunek
hiresbb
patrz opis analogicznej opcji pakietu
type=typ
okre¶la rodzaj grafiki, normalnie rodzaj ten jest okre¶lony przez rozszerzenie nazwy pliku
ext=typ
okre¶la rozszerzenie nazwy; u¿ywane razem z parametrem type
read=plik
okre¶la nazwê pliku zawieraj±cego definicjê rozmiaru; u¿ywane razem z parametrem type
command=polecenie systemowe
okre¶la nazwê polecenia, które dokona konwersji pliku do postaci akceptowalnej; u¿ywane razem z parametrem type
\rotatebox[parametry]{k±t}{tekst} podstawowy argument makroinstrukcji (tekst) jest obracany o zadany k±t (warto¶æ dodatnia oznacza obrót w kierunku przeciwnym do obrotu wskazówek zegara); parametry mog± definiowaæ dodatkowe w³asno¶ci w postaci:
origin=specyfikacja
specyfikacja okre¶la punkt obrotu
l -- lewy brzeg,
r -- prawy brzeg,
c -- ¶rodek (w poziomie),
t -- górny brzeg,
b -- dolny brzeg,
B -- podstawa linii;
i stanowi go para okre¶laj±ca po³o¿enie punktu w pionie i poziomie; np: origin=bc
x=warto¶æ,y=warto¶æ
warto¶æ okre¶la wspó³rzêdne punktu obrotu (odpowiednio w poziomie i pionie w zadanych jednostkach miary)
units=warto¶æ
stosunek warto¶æ do 360 stopni okre¶la mno¿nik k±ta obrotu (np.: units=-360 spowoduje ¿e dodatnia warto¶æ k±ta bêdzie oznacza³a obrót zgodnie z kierunkiem obrotu wskazówek zegara)
\scalebox{przeskalowanie w poziomie}[przeskalowanie w pionie]{tekst} przeskalowuje pude³ko zawieraj±ce tekst o zadane wspó³czynniki; je¿eli parametr przeskalowanie w pionie nie jest okre¶lony zostanie u¿yty ten sam wspó³czynnik co w poziomie (zostan± zachowane proporcje).
\resizebox*{szeroko¶æ}{wysoko¶æ}{tekst} przeskalowuje pude³ko zawieraj±ce tekst do zadanych wymiarów (wersja ,,gwiazdkowa'' za podstawê skalowania bierze ca³kowit± wysoko¶æ pude³ka (totalheigh -- razem z g³êboko¶ci±), a nie tylko wysoko¶æ (height)). Okre¶lenie dowolnej z warto¶ci jako ! powoduje, ¿e pozosta³a warto¶æ zostanie obliczona, tak aby zachowaæ proporcje.
\resizebox{szeroko¶æ}{wysoko¶æ}{tekst}
\DeclareGraphicsExtensions{lista rozszerzeñ} lista rozszerzen stanowi listê dopuszczalnych rozszerzeñ nazw plików zawieraj±cych grafikê (elementy listy musz± byæ rozdzielone przecinkiem); np. \DeclareGraphicsExtensions{.bmp,.eps} je¿eli w katalogu bie¿±cym s± dwa pliki o tej samej nazwie lecz ró¿nym rozszerzeniu nazwy o pobraniu w³a¶ciwego pliku decyduje kolejno¶æ na li¶cie; deklaracja ma znaczenie jedynie wtedy, kiedy specyfikujemy nazwy plików bez rozszerzenia i nie wp³ywa na akceptowalno¶æ danego formatu przez program interpretuj±cy plik .dvi
\graphicspath{lista katalogów} lista katalogów okre¶la listê katalogów (oddzielon± przecinkami), w których poszukiwane s± pliki zawieraj±ce grafikê
\DeclareGraphicsRule{ext}{typ}{zbiór}{polecenie} polecenie umo¿liwia ³adowania grafiki w innej postaci ni¿ przewiduje to driver -- okre¶la ono akcjê (np. konwersjê, rozkompresowanie) któr± nale¿y podj±æ, aby by³a ona zrozumia³a dla drivera (zadeklarowany program konwersji musi produkowaæ wyniki na stdout).
ext okre¶la rozszerzenie nazwy pliku zawieraj±cego grafikê, typ okre¶la typ grafiki, zbiór -- zbiór zawieraj±cy definicjê rozmiaru grafiki (w³a¶ciwy zbiór zawieraj±cy zakodowan± grafikê jest interpretowany przez driver, a nie przez TeX-a, który potrzebuje zarezerwowaæ na ni± miejsce)
np:
%%BoundingBox: 0 0 596 842
polecenie okre¶la jaki program nale¿y wywo³aæ, aby doprowadziæ zbiór do grafiki postaci akceptowalnej przez driver
np. \DeclareGraphicsRule{.ps.arj}{eps}{.ps.bb}{arj -x #1}

W³odzimierz Macewicz
Ostatnie zmiany: 05.05.2014.