summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/lapdf/README
blob: c24ae48be6be31dd3b161490cb7dd34cbb1cd179 (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
Lapdf
-----
This is a short introduction for the Lapdf style. It has many instructive example
files to show the usage of this macro package. I hope, this style helps you to
produce nice graphics with the pdfTeX engine.

This package is distributed under the GNU general pupblic licence (GPL) and it's
free to use by everyone.


What is it?
-----------
Lapdf  needs pdfTeX and the calc style, which is included in the LaTeX tools
folder as standard package. Lapdf is a drawing environment like the standard
LaTeX picture environment. So you can design you graphic from within the LaTeX
document. Lapdf uses pdfTeX to calculate everything and native PDF commands for
drawing everything. It lets you also put typesetted text into the graphic, which
is sometimes rather complicated in other packages.

Additionally to all the PDF drawing commands, Lapdf has a unique set of it's own
drawing primitives and other macros. Here is a list:

Math functions: These macros are used internally, but they can be also used in
                your own drawings.
                Sin, Cos, Tan, Asin, Acos, Atan, Sinh, Cosh, Tanh, Asinh,
                Acosh, Atanh, Exp, Pow, Ln, Log, Pot, Root, Sqrt, Abs, Sig,
                Mod, Len, Hypot, Direc, Rotpoint

Loop macros:    There are two looping macros for repeating tasks:
                - Whilenum{condition}{commands}
                - Whiledim{condition}{commands}

PDF commands:  These are the available PDF drawing primitives. I used my own
               names, which differ only a bit from the original names:
                - Gsave
                - Grestore
                - Setclip
                - Stroke
                - Closepath
                - Setwidth
                - Setcap
                - Setjoin
                - Setflat
                - Setmiter
                - Setdash
                - Bezier
                - Concat
                - Translate
                - Scale
                - Rotate
                - Rect

Typesetting:    You can typeset text at position with direction with:
                - Text

Drawing macros: Lapdf fully supports color without the need of any style file. Color
                usage is specified as an option [black | color] in the preamble:
                - Setcol
                - Setgray
                For repreated color changes (especially in loops) there are 96
                rainbow colors defined, wich can be used with these macros:
                - Stepcol
                - Nextcol
                - Resetcol
                Here are the standard drawing primitives:
                - Moveto
                - Lineto
                - Line
                - Polygon
                - Vecto
                - Vect
                - Vpolygon
                - Rectangle
                - Triangle
                - Epolygon
                - Circle
                - Point
                - Ellipse
                - Arc
                - Sector
                - Arcto
                - Fill
                - Gfill
                - Sfill
                These are special Bezier curve additions, which are unique. Lapdf
                lets you draw  integral and also rational Bezier curves up to a
                degree of seven.
                - Curveto
                - Curve
                - Rmoveto
                - Rcurveto
                - Rcurve
                - Quadratic
                - Cubic
                There are 5 kinds of grids availabe:
                - Lingrid
                - Logxgrid
                - Logygrid
                - Logxygrid
                - Polgrid
                You can plot functions in three different ways: normal functions,
                parameter functions, polar functions with these commands:
                - Fplot
                - Tplot
                - Pplot
                Additionally you can plot polynoms (degree <= 3) directly and also
                Tangents:
                - Polynom
                - Tangent
                For special tasks you can also compute polynom values, derivatives,
                partial and total derivatives:
                - Fpoly
                - Dpoly
                - Df
                - Dtx
                - Dty
                - Dtt
                - Dpx
                - Dpy
                - Dpt
                Some macros are useful shortcuts, like these:
                - Thick
                - Thin
                - Dash
				- Black
				- Dred
				- Dgreen
				- Dblue
				- Dcyan
				- Dmagenta
				- Dyellow
				- Dgray
				- Gray
				- Red
				- Green
				- Blue
				- Cyan
				- Magenta
				- Yellow
				- White
                
Documentation:
--------------
There are several additional info files, which help you to use this package. I'm
still working on the documentation, but the intro chapter completed. This Lapdf
docs will be completed as soon as possible. The package itself will also be
updated regularly. If you find errors or have any suggestions for improvements,
please let me know.

I wish you happy Texing with Lapdf!
              
Detlef Reimers

---------------------------------------------------------------------------------
(Email: detlefreimers@gmx.de; Web: http://detlefreimers.de)