1rcrpanel(1) General Commands Manual rcrpanel(1)
2
6 rcrpanel - Create a PostScript file of a panel from a script
7
9 rcrpanel filename
10
12 rcrpanel reads a script file describing a panel and produces a Post‐
13 Script image of that panel on the standard output.
14
16 none
17
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 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 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 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 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 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 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 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 Panel -
63 This command defines the size of the panel. The 2 dimensions
64 are the width and height of the panel.
65 Background -
68 This command takes a single color following the equal sign. The
69 entire panel will be filled with this color.
70 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 This command is then followed by another line containing the
82 text to be displayed.
83 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 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 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 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 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 SizeTicks -
122 This command describes the length of the small tick marks. This
123 command refers to the current Dial command.
124 SizeBig -
128 This command describes the length of the large tick marks. This
129 command refers to the current Dial command.
130 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 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 SizeFont -
148 This command describes how large to make the annotation on the
149 ticks. This command refers to the current Dial command.
150 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 ColorTickMarks -
161 This command permits setting the color to draw the small tick
162 marks. This command refers to the current Dial command.
163 ColorBigTickMarks -
167 This command permits setting the color to draw the large tick
168 marks. This command refers to the current Dial command.
169 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 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
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
194 John J. McDonough, WB8RCR
195
197 None known
198 rcrpanel is still lacking the ability to draw random straight lines on
200 the panel.
201 13 Mar 2009 rcrpanel(1)