1rcrpanel(1)                 General Commands Manual                rcrpanel(1)
2
3
4

NAME

6       rcrpanel - Create a PostScript file of a panel from a script
7

SYNOPSIS

9       rcrpanel filename
10

DESCRIPTION

12       rcrpanel  reads  a  script file describing a panel and produces a Post‐
13       Script image of that panel on the standard output.
14

OPTIONS

16       none
17

INPUT FILE

19       The input file contains lines describing the  various  controls.   Most
20       lines  are  of the form Command = something where the spaces around the
21       equal sign are significant, and the command itself is case-sensitive.
22
23       Measurements are in units of millimeters.  Angles are in degrees.  Col‐
24       ors  are given as 24 bit C style integers where each byte repesents the
25       amount of red, green, or blue.
26
27   Commands
28       Reverse -
29              This command takes no arguments.  If this command  appears  any‐
30              where  in  the  input  file,  the  resulting  PostScript will be
31              flipped left to right (for  printing  on  the  reverse  side  of
32              transparency material).
33
34
35       ControlLarge -
36              This  is used for large diameter controls such as large pots and
37              the like.  It takes 2 values after the equal  sign  representing
38              the position of the control on the panel.
39
40
41       ControlPhone -
42              This  is  used for 1/4" phone jacks and similar controls.  The 2
43              values after the equal sign represent the position on the panel.
44
45
46       ControlLED -
47              This command generates an outline for a  5  mm  LED.   Like  the
48              other control commands, it takes 2 values, the X and Y positions
49              on the panel of the center of the LED.
50
51
52       ControlSmall -
53              This command generates an outline for a 3.5 mm phone jack.   The
54              two values are the X and Y positions of the jack on the panel.
55
56
57       ControlTiny -
58              This  command generates an outline for a 2.5 mm phone jack.  The
59              two values are the X and Y positions of the jack on the panel.
60
61
62       Panel -
63              This command defines the size of the panel.   The  2  dimensions
64              are the width and height of the panel.
65
66
67       Background -
68              This command takes a single color following the equal sign.  The
69              entire panel will be filled with this color.
70
71
72       Text - This command is somewhat different from the others.   After  the
73              equal  sign,  it  takes 3 floating point numbers, a color, and a
74              text string.  The fist 2 floating point numbers  are  the  X,  Y
75              position  of  the  text  on  the panel.  The third number is the
76              height of the text.  The color represents the color of the text,
77              and the text string represents the font to be used.  No checking
78              is done before preparing the PostScript;   you  are  responsible
79              for ensuring that the font is available on your printer.
80
81              This  command  is  then  followed by another line containing the
82              text to be displayed.
83
84
85       Dial - This command introduces a new dial.  The Dial command  describes
86              the X,Y center of the dial.  The following commands then further
87              refine the details of this particular dial.   This  relationship
88              between  the  Dial command and it's successors is the only place
89              where the order of the commands within the file matters.
90
91
92       Radius -
93              This command takes a single value which is  the  radius  of  the
94              circle  which  forms the inside of the tick marks.  This command
95              refers to the current Dial command.
96
97
98       Span - This command describes the angle  over  which  the  control  may
99              operate.   Typically,  this would be 270 for a potentiometer and
100              180 for a variable capacitor.  This command refers to  the  cur‐
101              rent Dial command.
102
103
104
105       NumTicks -
106              This command describes the total number of tick marks, large and
107              small, to be drawn.  This is usually an  odd  number  since  the
108              starting  and ending values are counted.  Typically this will be
109              11, 101, or a similar number.  This command refers to  the  cur‐
110              rent Dial command.
111
112
113
114       BigPer -
115              This  command  tells the program how many small tick marks there
116              are per large tick mark.  This command  refers  to  the  current
117              Dial command.
118
119
120
121       SizeTicks -
122              This command describes the length of the small tick marks.  This
123              command refers to the current Dial command.
124
125
126
127       SizeBig -
128              This command describes the length of the large tick marks.  This
129              command refers to the current Dial command.
130
131
132
133       StartingIndicator -
134              This  command  describes  the value to be placed on the furthest
135              counterclockwise large tick mark.  This command  refers  to  the
136              current Dial command.
137
138
139
140       IncrementPerBigTick -
141              This  command  tells rcrpanel how much to increment the value in
142              StartingIndicator for each succeding large tick mark.  This com‐
143              mand refers to the current Dial command.
144
145
146
147       SizeFont -
148              This  command  describes how large to make the annotation on the
149              ticks.  This command refers to the current Dial command.
150
151
152
153       ColorCircle -
154              This command takes a single color as an argument, which is  used
155              to  draw  the  inner circle.  This command refers to the current
156              Dial command.
157
158
159
160       ColorTickMarks -
161              This command permits setting the color to draw  the  small  tick
162              marks.  This command refers to the current Dial command.
163
164
165
166       ColorBigTickMarks -
167              This  command  permits  setting the color to draw the large tick
168              marks.  This command refers to the current Dial command.
169
170
171
172       ColorText -
173              This command accepts a single color which will be used  for  the
174              annotation.  This command refers to the current Dial command.
175
176
177
178       StartAngle -
179              By default, rcrpanel arranges dials so the dead spot on the con‐
180              trol is straight down.  This is the desired behavior  in  almost
181              all  cases.  However, sometimes you may want to rotate a control
182              to some other orientation.  The single argument to StartAngle is
183              the  number  of  degrees  clockwise to rotate the control.  This
184              command refers to the current Dial command.
185
186

LIMITATIONS

188       Current compiled in limits are  20  dials,  50  controls  and  50  text
189       strings.   Strings  are limited to 127 characters and font names may be
190       no more than 31 characters long.
191
192

AUTHOR

194       John J. McDonough, WB8RCR
195

BUGS

197       None known
198
199       rcrpanel is still lacking the ability to draw random straight lines  on
200       the panel.
201
202
203
204                                  13 Mar 2009                      rcrpanel(1)
Impressum