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.