Debian Codegraph @

texmf-dist/doc/latex/tkz-elements/TKZdoc-elements-classes-rectangle.tex

raw
1 \newpage
2 \section{Class \tkzClass{rectangle}}
3
4 The variable \code{R} holds a table used to store triangles. It is optional, and you are free to choose the variable name. However, using \code{R} is a recommended convention for clarity and consistency. If you use a custom variable (e.g., rectangles), you must initialize it manually. The \code{init\_elements()} function reinitializes the \code{R} table if used.
5
6
7 \subsection{Rectangle attributes}
8 \label{sub:rectangle_attributes}
9
10
11 Points are created in the direct direction. A test is performed to check whether the points form a rectangle, otherwise compilation is blocked.
12
13 \begin{mybox}
14 Creation | R.ABCD = rectangle:new(z.A, z.B, z.C, z.D)|
15 \end{mybox}
16
17 \bgroup
18 \catcode`_=12
19 \small
20 \captionof{table}{rectangle attributes.}\label{rectangle:attributes}
21 \begin{tabular}{lll}
22 \toprule
23 \textbf{Attributes} & \textbf{Application} & \\
24 \midrule
25 \tkzAttr{rectangle}{pa} & |z.A = R.ABCD.pa| & \\
26 \tkzAttr{rectangle}{pb} & |z.B = R.ABCD.pb| & \\
27 \tkzAttr{rectangle}{pc} & |z.C = R.ABCD.pc| & \\
28 \tkzAttr{rectangle}{pd} & |z.D = R.ABCD.pd| & \\
29 \tkzAttr{rectangle}{type} & |R.ABCD.type= 'rectangle'| &\\
30 \tkzAttr{rectangle}{center} & |z.I = R.ABCD.center| & center of the rectangle\\
31 \tkzAttr{rectangle}{length} & |R.ABCD.length| & the length \\
32 \tkzAttr{rectangle}{width} & |R.ABCD.width| & the width \\
33 \tkzAttr{rectangle}{diagonal} & |R.ABCD.diagonal| & diagonal length\\
34 \tkzAttr{rectangle}{ab} & |R.ABCD.ab| & line passing through two vertices \\
35 \tkzAttr{rectangle}{ac} & |R.ABCD.ca| & idem. \\
36 \tkzAttr{rectangle}{ad} & |R.ABCD.ad| & idem. \\
37 \tkzAttr{rectangle}{bc} & |R.ABCD.bc| & idem. \\
38 \tkzAttr{rectangle}{bd} & |R.ABCD.bd| & idem. \\
39 \tkzAttr{rectangle}{cd} & |R.ABCD.cd| & idem. \\
40 \bottomrule
41 \end{tabular}
42 \egroup
43
44
45
46 \subsubsection{Example}
47
48 \begin{minipage}{.5\textwidth}
49 \begin{verbatim}
50 \directlua{
51 init_elements()
52 z.A = point(0, 0)
53 z.B = point(4, 0)
54 z.C = point(4, 4)
55 z.D = point(0, 4)
56 R.new = rectangle(z.A, z.B, z.C, z.D)
57 z.I = R.new.center}
58
59 \begin{tikzpicture}
60 \tkzGetNodes
61 \tkzDrawPolygon(A,B,C,D)
62 \tkzDrawPoints(A,B,C,D)
63 \tkzLabelPoints(A,B)
64 \tkzLabelPoints[above](C,D)
65 \tkzDrawPoints[red](I)
66 \end{tikzpicture}
67 \end{verbatim}
68 \end{minipage}
69 \hspace{\fill}\begin{minipage}{.5\textwidth}
70 \directlua{
71 init_elements()
72 z.A = point(0, 0)
73 z.B = point(4, 0)
74 z.C = point(4, 4)
75 z.D = point(0, 4)
76 R.new = rectangle(z.A, z.B, z.C, z.D)
77 z.I = R.new.center}
78
79 \begin{tikzpicture}[scale =1.5]
80 \tkzGetNodes
81 \tkzDrawPolygon(A,B,C,D)
82 \tkzDrawSegment[dashed](A,C)
83 \tkzDrawPoints(A,B,C,D)
84 \tkzLabelPoints(A,B)
85 \tkzLabelPoints[above](C,D)
86 \tkzDrawPoints[red](I)
87 \tkzLabelPoint[right = 10pt](I){$I$\\ |R.new.center|}
88 \tkzLabelSegment[sloped,above](C,D){|R.new.length| =
89 \pmpn{\tkzUseLua{R.new.length}}}
90 \tkzLabelSegment[sloped,above](A,C){|R.new.diagonal| =
91 \pmpn{\tkzUseLua{R.new.diagonal}}}
92 % \tkzUseLua{R.new.length} and \tkzUseLua{R.new.diagonal} to get the values.
93 \end{tikzpicture}
94 \end{minipage}
95 \newpage
96
97 \subsection{Rectangle methods}
98
99 \bgroup
100 \catcode`_=12
101 \small
102 \captionof{table}{Rectangle methods.}\label{rectangle:methods}
103 \begin{tabular}{lll}
104 \textbf{Methods} & \texttt{Reference} & \\
105 \toprule
106 \tkzMeth{rectangle}{new(za ,zb, zc, zd)} &[\ref{meth_rectangle_new}]\\
107 \tkzMeth{rectangle}{angle (zi, za, angle)} & [\ref{ssub:angle_method}]\\
108 \tkzMeth{rectangle}{gold (za, zb)} & [\ref{ssub:gold_method}]\\
109 \tkzMeth{rectangle}{diagonal (za, zc)} &[\ref{ssub:diagonal_method}]\\
110 \tkzMeth{rectangle}{side (za, zb, d)} & [\ref{ssub:side_method}]\\
111 \tkzMeth{rectangle}{get\_lengths ()} & [\ref{ssub:function_rectangle_get__lengths}]\\
112 \bottomrule %
113 \end{tabular}
114 \egroup
115
116
117 \subsubsection{Method \tkzMeth{rectangle}{new(pt,pt,pt,pt)}}
118 \label{meth_rectangle_new}
119 This function creates a square using four points. No test is performed, and verification is left to the user.
120
121 \begin{tkzexample}[latex=.5\textwidth]
122 \directlua{
123 z.A = point(0, 0)
124 z.B = point(4, 0)
125 z.C = point(4, 3)
126 z.D = point(-2, -3)
127 L.AB = line(z.A,z.B)
128 L.CD = line(z.C,z.D)
129 z.I = intersection(L.AB, L.CD)
130 C.I = circle(through(z.I, 3.5))
131 z.G,z.E = intersection(L.AB, C.I)
132 z.F,z.H = intersection(L.CD, C.I)
133 R.I = rectangle(z.E, z.F, z.G, z.H)
134 z.X = R.I.ab:projection(z.I)}
135 \begin{tikzpicture}
136 \tkzGetNodes
137 \tkzDrawPolygon(E,F,G,H)
138 \tkzDrawPoints(A,B,C,D,I,E,F,G,H,X)
139 \tkzLabelPoints(A,B,C,D,I,E,F,G,H,X)
140 \tkzDrawPoints(I)
141 \end{tikzpicture}
142 \end{tkzexample}
143
144 \subsubsection{Method \tkzMeth{rectangle}{angle(pt,pt,an)}}
145 \label{ssub:angle_method}
146
147 |R.ang = rectangle:angle(z.I,z.A)| ; |z.A | vertex ; ang angle between 2 vertices
148
149
150 \begin{minipage}{.5\textwidth}
151 \begin{verbatim}
152 \directlua{
153 init_elements()
154 z.A = point(0, 0)
155 z.B = point(4, 0)
156 z.I = point(4, 3)
157 P.ABCD = rectangle:angle(z.I, z.A,
158 math.pi / 6)
159 z.B = P.ABCD.pb
160 z.C = P.ABCD.pc
161 z.D = P.ABCD.pd}
162 \begin{tikzpicture}[scale = .5]
163 \tkzGetNodes
164 \tkzDrawPolygon(A,B,C,D)
165 \tkzDrawPoints(A,B,C)
166 \tkzLabelPoints(A,B,C,D)
167 \tkzDrawPoints[new](I)
168 \end{tikzpicture}
169 \end{verbatim}
170 \end{minipage}
171 \begin{minipage}{.5\textwidth}
172 \directlua{
173 init_elements()
174 z.A = point(0, 0)
175 z.B = point(4, 0)
176 z.I = point(4, 3)
177 P.ABCD = rectangle:angle(z.I, z.A, math.pi / 6)
178 z.B = P.ABCD.pb
179 z.C = P.ABCD.pc
180 z.D = P.ABCD.pd}
181 \begin{tikzpicture}[scale = .5]
182 \tkzGetNodes
183 \tkzDrawPolygon(A,B,C,D)
184 \tkzDrawPoints(A,B,C)
185 \tkzLabelPoints(A,B)
186 \tkzLabelPoints[above](C,D)
187 \tkzDrawPoints[new](I)
188 \tkzLabelSegment[sloped,above](A,B){%
189 |rectangle: angle (z.C,z.A,math.pi/6)|}
190 \end{tikzpicture}
191 \end{minipage}
192
193 \subsubsection{Method \tkzMeth{rectangle}{side(pt,pt,d)}}
194 \label{ssub:side_method}
195 \begin{minipage}{.5\textwidth}
196 \begin{verbatim}
197 \directlua{
198 init_elements()
199 z.A = point(0, 0)
200 z.B = point(4, 3)
201 R.side = rectangle:side(z.A, z.B, 3)
202 z.C = R.side.pc
203 z.D = R.side.pd
204 z.I = R.side.center}
205 \begin{tikzpicture}
206 \tkzGetNodes
207 \tkzDrawPolygon(A,B,C,D)
208 \tkzDrawPoints(A,B,C,D)
209 \tkzLabelPoints(A,B)
210 \tkzLabelPoints[above](C,D)
211 \tkzDrawPoints[red](I)
212 \end{tikzpicture}
213 \end{verbatim}
214 \end{minipage}
215 \begin{minipage}{.5\textwidth}
216 \directlua{
217 init_elements()
218 z.A = point(0, 0)
219 z.B = point(4, 3)
220 R.side = rectangle:side(z.A, z.B, 3)
221 z.C = R.side.pc
222 z.D = R.side.pd
223 z.I = R.side.center}
224 \begin{tikzpicture}
225 \tkzGetNodes
226 \tkzDrawPolygon(A,B,C,D)
227 \tkzDrawPoints(A,B,C,D)
228 \tkzLabelPoints(A,B)
229 \tkzLabelPoints[above](C,D)
230 \tkzDrawPoints[red](I)
231 \tkzLabelSegment[sloped,above](A,B){%
232 |rectangle:side(z.A,z.B,3)|}
233 \end{tikzpicture}
234 \end{minipage}
235
236 \subsubsection{Method \tkzMeth{rectangle}{diagonal(pt,pt)}}
237 \label{ssub:diagonal_method}
238 \begin{minipage}{.5\textwidth}
239 \begin{verbatim}
240 \directlua{
241 init_elements()
242 z.A = point(0, 0)
243 z.C = point(4, 3)
244 R.diag = rectangle:diagonal(z.A, z.C)
245 z.B = R.diag.pb
246 z.D = R.diag.pd
247 z.I = R.diag.center}
248 \begin{tikzpicture}
249 \tkzGetNodes
250 \tkzDrawPolygon(A,B,C,D)
251 \tkzDrawPoints(A,B,C,D)
252 \tkzLabelPoints(A,B)
253 \tkzLabelPoints[above](C,D)
254 \tkzDrawPoints[red](I)
255 \tkzLabelSegment[sloped,above](A,B){%
256 |rectangle:diagonal(z.A,z.C)|}
257 \end{tikzpicture}
258 \end{verbatim}
259 \end{minipage}
260 \begin{minipage}{.5\textwidth}
261 \directlua{
262 z.A = point(0, 0)
263 z.C = point(4, 3)
264 R.diag = rectangle:diagonal(z.A, z.C)
265 z.B = R.diag.pb
266 z.D = R.diag.pd
267 z.I = R.diag.center}
268
269 \begin{tikzpicture}
270 \tkzGetNodes
271 \tkzDrawPolygon(A,B,C,D)
272 \tkzDrawPoints(A,B,C,D)
273 \tkzLabelPoints(A,B)
274 \tkzLabelPoints[above](C,D)
275 \tkzDrawPoints[red](I)
276 \tkzLabelSegment[sloped,above](A,B){%
277 |rectangle:diagonal(z.A, z.C)|}
278 \end{tikzpicture}
279 \end{minipage}
280
281 \subsubsection{Method \tkzMeth{rectangle}{gold(pt,pt)}}
282 \label{ssub:gold_method}
283 \begin{minipage}{.5\textwidth}
284 \begin{verbatim}
285 \directlua{
286 init_elements()
287 z.X = point(0, 0)
288 z.Y = point(4, 2)
289 R.gold = rectangle:gold(z.X, z.Y)
290 z.Z = R.gold.pc
291 z.W = R.gold.pd
292 z.I = R.gold.center}
293 \begin{tikzpicture}
294 \tkzGetNodes
295 \tkzDrawPolygon(X,Y,Z,W)
296 \tkzDrawPoints(X,Y,Z,W)
297 \tkzLabelPoints(X,Y)
298 \tkzLabelPoints[above](Z,W)
299 \tkzDrawPoints[red](I)
300 \tkzLabelSegment[sloped,above](X,Y){%
301 |rectangle:gold(z.X,z.Y)|}
302 \end{tikzpicture}
303 \end{verbatim}
304 \end{minipage}
305 \begin{minipage}{.5\textwidth}
306 \directlua{
307 init_elements()
308 z.X = point(0, 0)
309 z.Y = point(4, 2)
310 R.gold = rectangle:gold(z.X, z.Y)
311 z.Z = R.gold.pc
312 z.W = R.gold.pd
313 z.I = R.gold.center}
314
315 \begin{tikzpicture}
316 \tkzGetNodes
317 \tkzDrawPolygon(X,Y,Z,W)
318 \tkzDrawPoints(X,Y,Z,W)
319 \tkzLabelPoints(X,Y)
320 \tkzLabelPoints[above](Z,W)
321 \tkzDrawPoints[red](I)
322 \tkzLabelSegment[sloped,above](X,Y){%
323 |rectangle:gold(z.X,z.Y)|}
324 \end{tikzpicture}
325 \end{minipage}
326
327 \subsubsection{Method \tkzMeth{rectangle}{get\_lengths}()}
328 \label{ssub:function_rectangle_get__lengths}
329
330 \begin{tkzexample}[latex=.45\textwidth]
331 \directlua{
332 init_elements()
333 z.I = point(2, 1)
334 z.A = point(0, 0)
335 R.ABCD = rectangle:angle(z.I, z.A, math.pi / 3)
336 z.B = R.ABCD.pb
337 z.C = R.ABCD.pc
338 z.D = R.ABCD.pd
339 tkzx,tkzy = R.ABCD:get_lengths()}
340 \begin{tikzpicture}
341 \tkzGetNodes
342 \tkzDrawPolygon(A,B,C,D)
343 \tkzDrawCircle(I,A)
344 \tkzDrawPoints(A,B,C,D)
345 \tkzLabelPoints(A,B)
346 \tkzLabelPoints[above](C,D)
347 \tkzDrawPoints[](I)
348 \tkzLabelSegment(A,B){%
349 $\pmpn{\tkzUseLua{tkzx}}$}
350 \tkzLabelSegment[right](B,C){%
351 $\pmpn{\tkzUseLua{tkzy}}$}
352 \end{tikzpicture}
353 \end{tkzexample}
354 \endinput