summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fullpict/fullpict.doc
blob: f1db28cd30aacbf8a18cfea22e553ba084c8c436 (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
%%%%%%%%%%%%%%%%%%%%%%%%  fullpict.doc %%%%%%%%%%%%%%%%%%%%%%%%%
%%  Bruce Shawyer  --  March 2001   --  bshawyer@math.mun.ca  %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

This is an updated version of the previous Feb 99 and March 96 documents,
containing information on the new an improved fullpict.sty

Additional macros, making use of the size of the scaled picture box, are:

\xaxis          --- draws a vector just longer than the axis length
\yaxis          --- draws a vector just longer than the axis length
\axes           --- draws vectors  just longer than the axes lengths
\xticks{#1}[#2] --- \#1 -- gap between ticks,
                --- \#2 -- length of tick -- default value is  1
\yticks{#1}[#2] --- \#1 -- gap between ticks,
                --- \#2 -- length of tick -- default value is  1
\ticks{#1}[#2]  --- \#1 -- gap between ticks,
                --- \#2 -- length of tick -- default value is  1
\xnums{#1}[#2]  --- \#1 -- gap between numbers,
                --- \#2 -- dist below axis -- default value is  .25
\ynums{#1}[#2]  --- \#1 -- gap between numbers,
                --- \#2 -- dist to left of axis -- default value is  .25
\nums{#1}[#2]   --- \#1 -- gap between numbers,
                --- \#2 -- dist from axis -- default value is  .25
\origin{#1}     --- \#1 -- size of circle centred on the origin

======================= February 99 file =====================

This is an updated version of the previous March 96 document,
containing information on the new an improved fullpict.sty

There is a new environment ---  scaledpicture

This enhances the previous enviroment   scalepicture   in that it
works properly inside tabular and minipage environments, and also
choose at appropriate font size for the scale of the picture.

New commands for the placement of labels are included. This removes
the enormous amount of guesswork previously required to place a
label appropriately on a diagram. Geographic north, south, east
and west are used.

They are:	
  \nput(x,y){label} - places the label north of (above) the point (x,y)
  \sput(x,y){label} - places the label south of (below) the point (x,y)
  \eput(x,y){label} - places the label east (to the right) of the point (x,y)
  \wput(x,y){label} - places the label west (to the left) of the point (x,y)
  \neput(x,y){label}
  \seput(x,y){label}
  \nwput(x,y){label}
  \swput(x,y){label}
A general form is available:
  \angleput{angle}[radius] (x,y){label}
	angle	in degrees, between -360 and +360
	radius	[optional - default 1] to adjust the distance from the point (x,y)
	(x,y)	the coordinates of the point
	label	the label

I and my co-workers have found that these macros save much time.

For the information of those interested in how the angle works,
a polygon of 24 sides is used instead of a circle. This avoids
trigonometry, for linear functions give the sides. The difference
between a true circle and this polygon become noticeable only for
large values of  radius , which are unlikely to be used.

========================= March 96 file =============================
I make a lot of use of the \LaTeX picture environment, in various
documents with different text widths.  Also, I teach \LaTeX as
part of a course that involves writing a report on a mathematical
experiment.  The greatest difficulty is choosing an appropriate
\unitlength so that the picture fits nicely on the page. Hence the
genesis of ``fullpict.sty''.

In order that a picture not fill up too much of the width of the
printed line, I chose 90% of that width because that seemed to be
most pleasing to the eye.  The macro provides three new picture
environment that behave exactly like the \LaTeX picture
environment.

The advantage is the there is no need to preselect \unitlength. The
appropriate value for \unitlength is calculated from the x--length
given to the picture.

The three environments

1.   \begin{fullpict}(a,b)[(c,d)]
     ...
     \end{fullpict}

     As in the picture environment, the (c,d) is optional and
     defaults to (0,0) if not given.

     This gives a picture 90% of the text width.

2.   \begin{halfpict}(a,b)[(c,d)]
     ...
     \end{halfpict}

     As in the picture environment, the (c,d) is optional and
     defaults to (0,0) if not given.

     This gives a picture 45% of the text width.

3.   \begin{scalepict}{percent}(a,b)[(c,d)]
     ...
     \end{scalepict}

     As in the picture environment, the (c,d) is optional and
     defaults to (0,0) if not given.

     A number must replace ``percent''. This is in the range:

     0 < percent < 112

     otherwise the picture will exceed the text width.  A percent
     of 100 gives the same as ``fullpict'', and a percent of 50
     gives the same as ``halfpict''.


Also available for other use is a macro ``\goodunit''.  This
calculates the appropriate unit length in the above environments.