summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/polish/tex-virtual-academy-pl/latex2e/macro/graphicx.html
blob: 67a839a9c72125d06a526063b8174b284c3a426d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
<title> Zastaw ciekawych makroinstrukcji </title>
<LINK REL="stylesheet" TYPE="text/css" HREF="mycss.css">
<meta http-equiv="Content-language" content="pl">
<meta name="Author" content="W³odzimierz Macewicz">
<meta name="Keywords" content="tex, latex, makroinstrukcje, pakiety makroinstrukcji, Wirtualna Akademia">
</head>
<body bgcolor=#a0f0a0>
<h2>Graphicx</h2>
<p>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æ).
<p>
Pakiet korzysta z pakietów <tt>graphics</tt> (jest jego rozszerzeniem) i <tt>keyval</tt>, tak wiêc opisujê polecenia obu pakietów
(je¿eli ³adujemy pakiet <tt>graphicx</tt>, wszystkie one s± dostêpne).


<h3>Opcje okre¶laj±ce mo¿liwo¶ci driverów</h3>
<table border=1>
<tr><th>Opcja
	</th><th>Opis
		</th><th>mo¿liwo¶ci</th></tr>
<tr><td><tt>dvips</tt></td><td>.dvi przetwarzany przez
					    <tt>dvips</tt> T.Rokickiego</td><td>wszystko</td></tr>
<tr><td><tt>xdvi</tt></td><td></td><td>wszystko</td></tr>
<tr><td><tt>dvipdf</tt></td><td>S.Lasenko</td><td>wszystko</td></tr>
<tr><td><tt>dvipdfm</tt></td><td></td><td>wszystko</td></tr>
<tr><td><tt>pdftex</tt></td><td>pdftex</td><td>wszystko</td></tr>
<tr><td><tt>dvipsone</tt></td><td>Y &amp; Y</td><td>wszystko</td></tr>
<tr><td><tt>dviwindo</tt></td><td>jw</td><td>wszystko</td></tr>
<tr><td><tt>emtex</tt></td><td>sterowniki emtexa</td><td>tylko do³±czanie
plików (bez skalowania)</td></tr>
<tr><td><tt>dviwin</tt></td><td>H.Sendoukas</td><td>tylko do³±czanie plików</td></tr>
<tr><td><tt>oztex</tt></td><td>A.Trevorrow</td><td>do³±czanie plików, obroty,
kolory</td></tr>
<tr><td><tt>textures</tt></td><td>Blue Sky</td><td>???</td></tr>
<tr><td><tt>pctexps</tt></td><td>PCTEX</td><td>do³±czanie plików, obroty,
kolory</td></tr>
<tr><td><tt>pctexwin</tt></td><td>PCTEX</td><td>do³±czanie plików, obroty,
kolory</td></tr>
<tr><td><tt>pctexhp</tt></td><td>PCTEX</td><td>do³±czanie plików</td></tr>
<tr><td><tt>pctex32</tt></td><td>PCTEX</td><td>wszystko</td></tr>
<tr><td><tt>truetex</tt></td><td>Kinch</td><td>do³±czanie plików (ograniczone
kolory)</td></tr>
<tr><td><tt>tcidvi</tt></td><td>Kinch</td><td>???</td></tr>
<tr><td><tt>vtex</tt></td><td>????</td><td>???</td></tr>
</table>

<h3>Pozosta³e opcje</h3>
<table border=1>
<tr><th>Opcja
	</th><th>Opis</td></tr>
<tr valign="top"><td>
<tt>debugshow</tt>
	</td><td>???
		</td></tr>
<tr valign="top"><td><tt>draft</tt></td><td>nie jest wstawiana grafika, 
(wstawiana jest nazwa pliku) rezerwowane jest
jedynie miejsce </td></tr>
<tr valign="top"><td><tt>final</tt></td><td>wy³±cza opcjê <tt>draft</tt></td></tr>
<tr valign="top"><td><tt>hiderotate</tt></td><td>je¿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</td></tr>
<tr valign="top"><td><tt>hiresbb</tt></td><td>rezerwuje na rysunek miejsce o wymiarach
okre¶lonych przez <tt>%%HiResBoundingBox</tt>, a nie 
okre¶lonych przez <tt>%%BoundingBox</tt>
</td></tr>
<tr valign="top"><td><tt>hidescale</tt></td><td>je¿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</td></tr>
<tr valign="top"><td><tt>unknownkeysallowed</tt></td><td>opcja dla pakietu <tt>keyval</tt></td></tr>
<tr><td><tt>unknownkeyserror</tt></td><td>opcja dla pakietu <tt>keyval</tt></td></tr>
</table>

<h3>Polecenia</h3>
<table border=1>
<tr><th>polecenie
	</th><th>opis
		</th></tr>
<tr valign="top"><td>
<tt>\includegraphics[<i>parametry</i>]{<i>nazwa pliku</i>}</tt></td>
		<td>
		<i>parametry dodatkowe</i> 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:<br>
		<tt><i>nazwa</i>=<i>warto¶æ</i></tt><br> kolejne 
		definicje parametrów oddzielamy przecinkiem;<br>
		<dl>
		<dt><tt>height=<i>d³ugo¶æ</i></tt>
		<dd>wysoko¶æ obszaru zajmowanego przez grafikê --
		    rysunek zostanie przeskalowany do zadanego rozmiaru
		<dt><tt>width=<i>d³ugo¶æ</i></tt>
		<dd>szeroko¶æ obszaru zajmowanego przez grafikê --
		    rysunek zostanie przeskalowany do zadanego rozmiaru
		    (<b>je¿eli podamy tylko jeden wymiar
		    pozosta³y zostanie przeskalowany tak, aby zachowaæ proporcje</b>) 
		<dt><tt>keepaspectratio=<i>d³ugo¶æ</i></tt>
		<dd>je¿eli s± okre¶lone oba rozmiary (wysoko¶æ i szeroko¶æ),
		rysunek zostanie przeskalowany tak, aby nie przekroczyæ ¿adnego
		z nich
		<dt><tt>totalheight=<i>d³ugo¶æ</i></tt>
		<dd>ca³kowita wysoko¶æ (g³êboko¶æ + wysoko¶æ 
		obszaru zajmowanego przez grafikê --
		    rysunek zostanie przeskalowany do zadanego rozmiaru -- 
		    istotne przy obrotach
		<dt><tt>angle=<i>warto¶æ</i></tt>
		<dd>k±t (w stopniach; warto¶æ dodatnia oznacza obrót w kierunku 
		przeciwnym do ruchu wskazówek zegara) obrotu rysunku; 
		(<b>stopieñ przeskalowania zale¿y od kolejno¶ci definicji
		paramatrów rozmiaru i obrotu</b>)
		<dt><tt>scale=<i>warto¶æ</i></tt>
		<dd>wspó³czynnik przeskalowania  grafiki
		<dt><tt>origin=<i>warto¶æ</i></tt>
		<dd>patrz opis <tt>\rotatebox</tt>
		<dt><tt>clip</tt>
		<dd>powoduje obciêcie wszystkiego co ,,wystaje'' poza
		zadane wymiary obiektu (<tt>Boundingbox</tt>)
		<dt><tt>bb=<i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i></tt>
		<dd>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.
		<dt><tt>viewport=<i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i></tt>
		<dd>parametr pozwala na wyciêcie z do³±czanej grafiki zadanego
		prostok±ta, okre¶lonego przez lewy dolny i prawy górny róg
		<dt><tt>trim=<i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i> <i>warto¶æ</i></tt>
		<dd>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
		<dt><tt>draft</tt>
		<dd>zamiast wstawienia rysunku pojawi siê nazwa pliku (zostanie
		zarezerwowane <b>prawid³owe</b> miejsce na rysunek
		<dt><tt>hiresbb</tt>
		<dd>patrz opis analogicznej opcji pakietu
		<dt><tt>type=<i>typ</i></tt>
		<dd>okre¶la rodzaj grafiki, normalnie rodzaj ten jest okre¶lony
		przez rozszerzenie nazwy pliku
		<dt><tt>ext=<i>typ</i></tt>
		<dd>okre¶la rozszerzenie nazwy; u¿ywane razem z parametrem
		<tt>type</tt>
		<dt><tt>read=<i>plik</i></tt>
		<dd>okre¶la nazwê pliku zawieraj±cego definicjê rozmiaru; 
		u¿ywane razem z parametrem
		<tt>type</tt>
		<dt><tt>command=<i>polecenie systemowe</i></tt>
		<dd>okre¶la nazwê polecenia, które dokona konwersji pliku
		do postaci akceptowalnej;
		u¿ywane razem z parametrem
		<tt>type</tt>
		</dl>
		     </td></tr>
<tr valign="top"><td>
<tt>\rotatebox[<i>parametry</i>]{<i>k±t</i>}{<i>tekst</i>}</tt></td>
		<td>podstawowy argument makroinstrukcji (<tt>tekst</tt>) jest
		obracany o zadany <i>k±t</i> (warto¶æ dodatnia oznacza
		obrót w kierunku przeciwnym do obrotu wskazówek zegara);
		<i>parametry</i> mog± definiowaæ dodatkowe w³asno¶ci w postaci:
		<dl>
		<dt><tt>origin=<i>specyfikacja</i></tt>
		<dd><i>specyfikacja</i> okre¶la punkt obrotu
		    <dl>
		    <dd><tt>l</tt> -- lewy brzeg,
		    <dd><tt>r</tt> -- prawy brzeg,
		    <dd><tt>c</tt> -- ¶rodek (w poziomie),
		    <dd><tt>t</tt> -- górny brzeg,
		    <dd><tt>b</tt> -- dolny brzeg,
		    <dd><tt>B</tt> -- podstawa linii;
		    </dl>
		i stanowi go para okre¶laj±ca po³o¿enie punktu w pionie i poziomie; np:
		<tt>origin=bc</tt>
		<dt><tt>x=<i>warto¶æ</i>,y=<i>warto¶æ</i></tt>
		<dd><i>warto¶æ</i> okre¶la wspó³rzêdne punktu obrotu
		(odpowiednio w poziomie i pionie w zadanych jednostkach miary)
		<dt><tt>units=<i>warto¶æ</i></tt>
		<dd>stosunek <i>warto¶æ</i> do 360 stopni okre¶la mno¿nik k±ta obrotu (np.:
		<tt>units=-360</tt> spowoduje ¿e dodatnia warto¶æ k±ta
		bêdzie oznacza³a obrót zgodnie z kierunkiem obrotu wskazówek
		zegara)
		</dl>
		     </td></tr>
<tr valign="top"><td>
<tt>\scalebox{<i>przeskalowanie w poziomie</i>}[<i>przeskalowanie w pionie</i>]{<i>tekst</i>}</tt></td>
		<td>przeskalowuje pude³ko zawieraj±ce <i>tekst</i> o zadane
		wspó³czynniki; je¿eli parametr <i>przeskalowanie w pionie</i>
		nie jest okre¶lony zostanie u¿yty ten sam wspó³czynnik
		co w poziomie (zostan± zachowane proporcje).
		     </td></tr>
<tr valign="top"><td>
<tt>\resizebox*{<i>szeroko¶æ</i>}{<i>wysoko¶æ</i>}{<i>tekst</i>}</tt></td>
		<td rowspan=2> przeskalowuje pude³ko zawieraj±ce <i>tekst</i>
		do zadanych wymiarów (wersja ,,gwiazdkowa'' za podstawê
		skalowania bierze
		ca³kowit± wysoko¶æ pude³ka (<tt>totalheigh</tt> -- razem z
		g³êboko¶ci±), a nie tylko wysoko¶æ (<tt>height</tt>)).
		Okre¶lenie dowolnej z warto¶ci jako <tt>!</tt> powoduje, ¿e
		pozosta³a warto¶æ zostanie obliczona, tak aby zachowaæ
		proporcje.
		     </td></tr>
<tr valign="top"><td>
<tt>\resizebox{<i>szeroko¶æ</i>}{<i>wysoko¶æ</i>}{<i>tekst</i>}</tt></td>
		     </tr>
<tr valign="top"><td>
<tt>\DeclareGraphicsExtensions{<i>lista rozszerzeñ</i>}</tt></td>
<td><i>lista rozszerzen</i> stanowi listê dopuszczalnych rozszerzeñ nazw
plików zawieraj±cych grafikê (elementy listy musz± byæ
rozdzielone przecinkiem); np. <tt>\DeclareGraphicsExtensions{.bmp,.eps}</tt>
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 <tt>.dvi</tt>
		     </tr>
<tr valign="top"><td>
<tt>\graphicspath{<i>lista katalogów</i>}</tt></td>
<td><i>lista katalogów</i> okre¶la listê katalogów (oddzielon± przecinkami), 
w których poszukiwane
s± pliki zawieraj±ce grafikê
		     </tr>
<tr valign="top"><td>
<tt>\DeclareGraphicsRule{<i>ext</i>}{<i>typ</i>}{<i>zbiór</i>}{<i>polecenie</i>}</tt></td>
<td>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 <tt>stdout</tt>). <br>
<i>ext</i> okre¶la rozszerzenie nazwy pliku zawieraj±cego grafikê,
<i>typ</i> okre¶la typ grafiki, <i>zbiór</i> -- 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)<br>
np:<br>
<tt>%%BoundingBox: 0 0 596 842</tt><br>
<i>polecenie</i> okre¶la jaki program nale¿y wywo³aæ, aby doprowadziæ 
zbiór do grafiki postaci akceptowalnej przez driver<br>
np.
<tt>
\DeclareGraphicsRule{.ps.arj}{eps}{.ps.bb}{arj -x #1}</tt></dt>

		     </tr>
</table>


<hr>




<a href=../../texologia.html><img src="../../gify/lew-7vs.gif" hspace=10 border=0 align=left></a>
<a href=mailto:W.Macewicz@ia.pw.edu.pl><img src="../../gify/mail.gif" hspace=10 align=left></a>
<a href=http://www.ia.pw.edu.pl/~wujek/index.html>W³odzimierz Macewicz</a><br clear=all>
<hr>
<!--#config timefmt="%y-%m-%d" -->
Ostatnie zmiany: <!--#echo var="LAST_MODIFIED" -->.

</body>
</html>