File: options.texi

package info (click to toggle)
pcb 20140316-3
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 22,212 kB
  • ctags: 16,012
  • sloc: ansic: 123,955; sh: 7,306; yacc: 5,087; pascal: 4,118; makefile: 1,559; perl: 552; lex: 438; awk: 157; lisp: 86; tcl: 63; xml: 20
file content (983 lines) | stat: -rw-r--r-- 26,919 bytes parent folder | download | duplicates (2)
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
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
@c key options
@menu
* General Options::
* General GUI Options::
* GTK+ GUI Options::
* lesstif GUI Options::
* Colors::
* Layer Names::
* Paths::
* Sizes::
* Commands::
* DRC Options::
* BOM Creation::
* Gerber Export::
* Postscript Export::
* Encapsulated Postscript Export::
* PNG Options::
* lpr Printing Options::
* nelma Options::
@end menu
@c options General Options
@node General Options
@section General Options
@c ./../src/main.c 440
@ftable @code
@item --help
Show help on command line options.
@end ftable
@c ./../src/main.c 445
@ftable @code
@item --version
Show version.
@end ftable
@c ./../src/main.c 449
@ftable @code
@item --verbose
Be verbose on stdout.
@end ftable
@c ./../src/main.c 454
@ftable @code
@item --copyright
Show copyright.
@end ftable
@c ./../src/main.c 459
@ftable @code
@item --show-defaults
Show option defaults.
@end ftable
@c ./../src/main.c 464
@ftable @code
@item --show-actions
Show available actions and exit.
@end ftable
@c ./../src/main.c 469
@ftable @code
@item --dump-actions
Dump actions (for documentation).
@end ftable
@c ./../src/main.c 474
@ftable @code
@item --grid-units-mm <string>
Set default grid units. Can be mm or mil. Defaults to mil.
@end ftable
@c ./../src/main.c 479
@ftable @code
@item --clear-increment-mm <string>
Set default clear increment (amount to change when user presses k or K)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 484
@ftable @code
@item --grid-increment-mm <string>
Set default grid increment (amount to change when user presses g or G)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 489
@ftable @code
@item --line-increment-mm <string>
Set default line increment (amount to change when user presses l or L)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 494
@ftable @code
@item --size-increment-mm <string>
Set default size increment (amount to change when user presses s or S)
when user is using a metric grid unit.
@end ftable
@c ./../src/main.c 499
@ftable @code
@item --clear-increment-mil <string>
Set default clear increment (amount to change when user presses k or K)
when user is using an imperial grid unit.
@end ftable
@c ./../src/main.c 504
@ftable @code
@item --grid-increment-mil <string>
Set default grid increment (amount to change when user presses g or G)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 509
@ftable @code
@item --line-increment-mil <string>
Set default line increment (amount to change when user presses l or L)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 514
@ftable @code
@item --size-increment-mil <string>
Set default size increment (amount to change when user presses s or S)
when user is using a imperial grid unit.
@end ftable
@c ./../src/main.c 737
@ftable @code
@item --backup-interval
Time between automatic backups in seconds. Set to @code{0} to disable.
The default value is @code{60}.
@end ftable
@c ./../src/main.c 774
@ftable @code
@item --groups <string>
Layer group string. Defaults to @code{"1,c:2:3:4:5:6,s:7:8"}.
@end ftable
@c ./../src/main.c 839
@ftable @code
@item --route-styles <string>
A string that defines the route styles. Defaults to @*
@code{"Signal,1000,3600,2000,1000:Power,2500,6000,3500,1000
	:Fat,4000,6000,3500,1000:Skinny,600,2402,1181,600"}
@end ftable
@c ./../src/main.c 858
@ftable @code
@item --element-path <string>
A colon separated list of directories or commands (starts with '|').
The path is passed to the program specified in @option{--element-command}.
@end ftable
@c ./../src/main.c 868
@ftable @code
@item --action-script <string>
If set, this file is executed at startup.
@end ftable
@c ./../src/main.c 873
@ftable @code
@item --action-string <string>
If set, this string of actions is executed at startup.
@end ftable
@c ./../src/main.c 878
@ftable @code
@item --fab-author <string>
Name of author to be put in the Gerber files.
@end ftable
@c ./../src/main.c 883
@ftable @code
@item --layer-stack <string>
Initial layer stackup, for setting up an export. A comma separated list of layer
names, layer numbers and layer groups.
@end ftable
@c ./../src/main.c 934
@ftable @code
@item --save-last-command
If set, the last user command is saved.
@end ftable
@c ./../src/main.c 938
@ftable @code
@item --save-in-tmp
If set, all data which would otherwise be lost are saved in a temporary file
@file{/tmp/PCB.%i.save} . Sequence @samp{%i} is replaced by the process ID.
@end ftable
@c ./../src/main.c 952
@ftable @code
@item --reset-after-element
If set, all found connections are reset before a new component is scanned.
@end ftable
@c ./../src/main.c 957
@ftable @code
@item --ring-bell-finished
Execute the bell command when all rats are routed.
@end ftable
@c options General GUI Options
@node General GUI Options
@section General GUI Options
@c ./../src/main.c 893
@ftable @code
@item --pinout-offset-x <num>
Horizontal offset of the pin number display. Defaults to @code{100mil}.
@end ftable
@c ./../src/main.c 898
@ftable @code
@item --pinout-offset-y <num>
Vertical offset of the pin number display. Defaults to @code{100mil}.
@end ftable
@c ./../src/main.c 903
@ftable @code
@item --pinout-text-offset-x <num>
Horizontal offset of the pin name display. Defaults to @code{800mil}.
@end ftable
@c ./../src/main.c 908
@ftable @code
@item --pinout-text-offset-y <num>
Vertical offset of the pin name display. Defaults to @code{-100mil}.
@end ftable
@c ./../src/main.c 913
@ftable @code
@item --draw-grid
If set, draw the grid at start-up.
@end ftable
@c ./../src/main.c 917
@ftable @code
@item --clear-line
If set, new lines clear polygons.
@end ftable
@c ./../src/main.c 921
@ftable @code
@item --full-poly
If set, new polygons are full ones.
@end ftable
@c ./../src/main.c 925
@ftable @code
@item --unique-names
If set, you will not be permitted to change the name of an component to match that
of another component.
@end ftable
@c ./../src/main.c 929
@ftable @code
@item --snap-pin
If set, pin centers and pad end points are treated as additional grid points
that the cursor can snap to.
@end ftable
@c ./../src/main.c 943
@ftable @code
@item --all-direction-lines
Allow all directions, when drawing new lines.
@end ftable
@c ./../src/main.c 948
@ftable @code
@item --show-number
Pinout shows number.
@end ftable
@c options GTK+ GUI Options
@node GTK+ GUI Options
@section GTK+ GUI Options
@c ./../src/hid/gtk/gui-top-window.c 1672
@ftable @code
@item --listen
Listen for actions on stdin.
@end ftable
@c ./../src/hid/gtk/gui-top-window.c 1678
@ftable @code
@item --bg-image <string>
File name of an image to put into the background of the GUI canvas. The image must
be a color PPM image, in binary (not ASCII) format. It can be any size, and will be
automatically scaled to fit the canvas.
@end ftable
@c ./../src/hid/gtk/gui-top-window.c 1684
@ftable @code
@item --pcb-menu <string>
Location of the @file{gpcb-menu.res} file which defines the menu for the GTK+ GUI.
@end ftable
@c options lesstif GUI Options
@node lesstif GUI Options
@section lesstif GUI Options
@c ./../src/hid/lesstif/main.c 198
@ftable @code
@item --listen
Listen for actions on stdin.
@end ftable
@c ./../src/hid/lesstif/main.c 204
@ftable @code
@item --bg-image <string>
File name of an image to put into the background of the GUI canvas. The image must
be a color PPM image, in binary (not ASCII) format. It can be any size, and will be
automatically scaled to fit the canvas.
@end ftable
@c ./../src/hid/lesstif/main.c 210
@ftable @code
@item --pcb-menu <string>
Location of the @file{pcb-menu.res} file which defines the menu for the lesstif GUI.
@end ftable
@c options Colors
@node Colors
@section Colors
@c ./../src/main.c 519
@ftable @code
@item --black-color <string>
Color value for black. Default: @samp{#000000}
@end ftable
@c ./../src/main.c 523
@ftable @code
@item --black-color <string>
Color value for white. Default: @samp{#ffffff}
@end ftable
@c ./../src/main.c 527
@ftable @code
@item --background-color <string>
Background color of the canvas. Default: @samp{#e5e5e5}
@end ftable
@c ./../src/main.c 532
@ftable @code
@item --crosshair-color <string>
Color of the crosshair. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 537
@ftable @code
@item --cross-color <string>
Color of the cross. Default: @samp{#cdcd00}
@end ftable
@c ./../src/main.c 541
@ftable @code
@item --via-color <string>
Color of vias. Default: @samp{#7f7f7f}
@end ftable
@c ./../src/main.c 545
@ftable @code
@item --via-selected-color <string>
Color of selected vias. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 550
@ftable @code
@item --pin-color <string>
Color of pins. Default: @samp{#4d4d4d}
@end ftable
@c ./../src/main.c 554
@ftable @code
@item --pin-selected-color <string>
Color of selected pins. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 559
@ftable @code
@item --pin-name-color <string>
Color of pin names and pin numbers. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 564
@ftable @code
@item --element-color <string>
Color of components. Default: @samp{#000000}
@end ftable
@c ./../src/main.c 568
@ftable @code
@item --rat-color <string>
Color of ratlines. Default: @samp{#b8860b}
@end ftable
@c ./../src/main.c 572
@ftable @code
@item --invisible-objects-color <string>
Color of invisible objects. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 577
@ftable @code
@item --invisible-mark-color <string>
Color of invisible marks. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 582
@ftable @code
@item --element-selected-color <string>
Color of selected components. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 587
@ftable @code
@item --rat-selected-color <string>
Color of selected rats. Default: @samp{#00ffff}
@end ftable
@c ./../src/main.c 592
@ftable @code
@item --connected-color <string>
Color to indicate physical connections. Default: @samp{#00ff00}
@end ftable
@c ./../src/main.c 597
@ftable @code
@item --found-color <string>
Color to indicate logical connections. Default: @samp{#ff00ff}
@end ftable
@c ./../src/main.c 602
@ftable @code
@item --off-limit-color <string>
Color of off-canvas area. Default: @samp{#cccccc}
@end ftable
@c ./../src/main.c 607
@ftable @code
@item --grid-color <string>
Color of the grid. Default: @samp{#ff0000}
@end ftable
@c ./../src/main.c 611
@ftable @code
@item --layer-color-<n> <string>
Color of layer @code{<n>}, where @code{<n>} is an integer from 1 to 16.
@end ftable
@c ./../src/main.c 629
@ftable @code
@item --layer-selected-color-<n> <string>
Color of layer @code{<n>}, when selected. @code{<n>} is an integer from 1 to 16.
@end ftable
@c ./../src/main.c 648
@ftable @code
@item --warn-color <string>
Color of offending objects during DRC. Default value is @code{"#ff8000"}
@end ftable
@c ./../src/main.c 652
@ftable @code
@item --mask-color <string>
Color of the mask layer. Default value is @code{"#ff0000"}
@end ftable
@c options Layer Names
@node Layer Names
@section Layer Names
@c ./../src/main.c 742
@ftable @code
@item --layer-name-1 <string>
Name of the 1st Layer. Default is @code{"top"}.
@end ftable
@c ./../src/main.c 746
@ftable @code
@item --layer-name-2 <string>
Name of the 2nd Layer. Default is @code{"ground"}.
@end ftable
@c ./../src/main.c 750
@ftable @code
@item --layer-name-3 <string>
Name of the 3nd Layer. Default is @code{"signal2"}.
@end ftable
@c ./../src/main.c 754
@ftable @code
@item --layer-name-4 <string>
Name of the 4rd Layer. Default is @code{"signal3"}.
@end ftable
@c ./../src/main.c 758
@ftable @code
@item --layer-name-5 <string>
Name of the 5rd Layer. Default is @code{"power"}.
@end ftable
@c ./../src/main.c 762
@ftable @code
@item --layer-name-6 <string>
Name of the 6rd Layer. Default is @code{"bottom"}.
@end ftable
@c ./../src/main.c 766
@ftable @code
@item --layer-name-7 <string>
Name of the 7rd Layer. Default is @code{"outline"}.
@end ftable
@c ./../src/main.c 770
@ftable @code
@item --layer-name-8 <string>
Name of the 8rd Layer. Default is @code{"spare"}.
@end ftable
@c options Paths
@node Paths
@section Paths
@c ./../src/main.c 820
@ftable @code
@item --lib-newlib <string>
Top level directory for the newlib style library.
@end ftable
@c ./../src/main.c 829
@ftable @code
@item --lib-name <string>
The default filename for the library.
@end ftable
@c ./../src/main.c 834
@ftable @code
@item --default-font <string>
The name of the default font.
@end ftable
@c ./../src/main.c 845
@ftable @code
@item --file-path <string>
A colon separated list of directories or commands (starts with '|'). The path
is passed to the program specified in @option{--file-command} together with the selected
filename.
@end ftable
@c ./../src/main.c 853
@ftable @code
@item --font-path <string>
A colon separated list of directories to search the default font. Defaults to
the default library path.
@end ftable
@c ./../src/main.c 863
@ftable @code
@item --lib-path <string>
A colon separated list of directories that will be passed to the commands specified
by @option{--element-command} and @option{--element-contents-command}.
@end ftable
@c options Sizes
@node Sizes
@section Sizes
@c ./../src/main.c 657
All parameters should be given with an unit. If no unit is given, 1/100 mil
(cmil) will be used. Write units without space to the
number like @code{3mm}, not @code{3 mm}.
Valid Units are:
 @table @samp
   @item km
    Kilometer
   @item m
    Meter
   @item cm
    Centimeter
   @item mm
    Millimeter
   @item um
    Micrometer
   @item nm
    Nanometer
   @item in
    Inch (1in = 0.0254m)
   @item mil
    Mil (1000mil = 1in)
   @item cmil
    Centimil (1/100 mil)
@end table

@ftable @code
@item --via-thickness <num>
Default diameter of vias. Default value is @code{60mil}.
@end ftable
@c ./../src/main.c 662
@ftable @code
@item --via-drilling-hole <num>
Default diameter of holes. Default value is @code{28mil}.
@end ftable
@c ./../src/main.c 667
@ftable @code
@item --line-thickness <num>
Default thickness of new lines. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 672
@ftable @code
@item --rat-thickness <num><unit>
Thickness of rats. If no unit is given, PCB units are assumed (i.e. 100 
means "1 nm"). This option allows for a special unit @code{px} which 
sets the rat thickness to a fixed value in terms of screen pixels.
Maximum fixed thickness is 100px. Minimum saling rat thickness is 101nm.  
Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 676
@ftable @code
@item --keepaway <num>
Default minimum distance between a track and adjacent copper.
Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 680
@ftable @code
@item --default-PCB-width <num>
Default width of the canvas. Default value is @code{6000mil}.
@end ftable
@c ./../src/main.c 685
@ftable @code
@item --default-PCB-height <num>
Default height of the canvas. Default value is @code{5000mil}.
@end ftable
@c ./../src/main.c 690
@ftable @code
@item --text-scale <num>
Default text scale. This value is in percent. Default value is @code{100}.
@end ftable
@c ./../src/main.c 694
@ftable @code
@item --alignment-distance <num>
Specifies the distance between the board outline and alignment targets.
Default value is @code{2mil}.
@end ftable
@c ./../src/main.c 728
@ftable @code
@item --grid <num>
Initial grid size. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 732
@ftable @code
@item --minimum polygon area <num>
Minimum polygon area.
@end ftable
@c options Commands
@node Commands
@section Commands
@c ./../src/main.c 779
pcb uses external commands for input output operations. These commands can be
configured at start-up to meet local requirements. The command string may include
special sequences @code{%f}, @code{%p} or @code{%a}. These are replaced when the
command is called. The sequence @code{%f} is replaced by the file name,
@code{%p} gets the path and @code{%a} indicates a package name.
@c ./../src/main.c 782
@ftable @code
@item --font-command <string>
Command to load a font.
@end ftable
@c ./../src/main.c 786
@ftable @code
@item --file-command <string>
Command to read a file.
@end ftable
@c ./../src/main.c 790
@ftable @code
@item --element-command <string>
Command to read a footprint. @*
Defaults to @code{"M4PATH='%p';export M4PATH;echo 'include(%f)' | m4"}
@end ftable
@c ./../src/main.c 796
@ftable @code
@item --print-file <string>
Command to print to a file.
@end ftable
@c ./../src/main.c 800
@ftable @code
@item --lib-command-dir <string>
Path to the command that queries the library.
@end ftable
@c ./../src/main.c 805
@ftable @code
@item --lib-command <string>
Command to query the library. @*
Defaults to @code{"QueryLibrary.sh '%p' '%f' %a"}
@end ftable
@c ./../src/main.c 810
@ftable @code
@item --lib-contents-command <string>
Command to query the contents of the library. @*
Defaults to @code{"ListLibraryContents.sh %p %f"} or,
on Windows builds, an empty string (to disable this feature).
@end ftable
@c ./../src/main.c 825
@ftable @code
@item --save-command <string>
Command to save to a file.
@end ftable
@c ./../src/main.c 849
@ftable @code
@item --rat-command <string>
Command for reading a netlist. Sequence @code{%f} is replaced by the netlist filename.
@end ftable
@c options DRC Options
@node DRC Options
@section DRC Options
@c ./../src/main.c 699
All parameters should be given with an unit. If no unit is given, 1/100 mil
(cmil) will be used for backward compability. Valid units are given in section
@ref{Sizes}.
@c ./../src/main.c 703
@ftable @code
@item --bloat <num>
Minimum spacing. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 707
@ftable @code
@item --shrink <num>
Minimum touching overlap. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 711
@ftable @code
@item --min-width <num>
Minimum width of copper. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 715
@ftable @code
@item --min-silk <num>
Minimum width of lines in silk. Default value is @code{10mil}.
@end ftable
@c ./../src/main.c 719
@ftable @code
@item --min-drill <num>
Minimum diameter of holes. Default value is @code{15mil}.
@end ftable
@c ./../src/main.c 723
@ftable @code
@item --min-ring <num>
Minimum width of annular ring. Default value is @code{10mil}.
@end ftable
@c options BOM Creation
@node BOM Creation
@section BOM Creation
@c ./../src/hid/bom/bom.c 26
@ftable @code
@item --bomfile <string>
Name of the BOM output file.
@end ftable
@c ./../src/hid/bom/bom.c 31
@ftable @code
@item --xyfile <string>
Name of the XY output file.
@end ftable
@c ./../src/hid/bom/bom.c 37
@ftable @code
@item --xy-unit <unit>
Unit of XY dimensions. Defaults to mil.
@end ftable
@c options Gerber Export
@node Gerber Export
@section Gerber Export
@c ./../src/hid/gerber/gerber.c 348
@ftable @code
@item --gerberfile <string>
Gerber output file prefix. Can include a path.
@end ftable
@c ./../src/hid/gerber/gerber.c 354
@ftable @code
@item --all-layers
Output contains all layers, even empty ones.
@end ftable
@c ./../src/hid/gerber/gerber.c 360
@ftable @code
@item --verbose
Print file names and aperture counts on stdout.
@end ftable
@c ./../src/hid/gerber/gerber.c 365
@ftable @code
@item --metric
generate metric Gerber and drill files
@end ftable
@c options Postscript Export
@node Postscript Export
@section Postscript Export
@c ./../src/hid/ps/ps.c 146
@ftable @code
@item --psfile <string>
Name of the postscript output file. Can contain a path.
@end ftable
@c ./../src/hid/ps/ps.c 152
@ftable @code
@cindex drill-helper
@item --drill-helper
Print a centering target in large drill holes.
@end ftable
@c ./../src/hid/ps/ps.c 158
@ftable @code
@cindex align-marks
@item --align-marks
Print alignment marks on each sheet. This is meant to ease alignment during exposure.
@end ftable
@c ./../src/hid/ps/ps.c 164
@ftable @code
@item --outline
Print the contents of the outline layer on each sheet.
@end ftable
@c ./../src/hid/ps/ps.c 169
@ftable @code
@item --mirror
Print mirror image.
@end ftable
@c ./../src/hid/ps/ps.c 175
@ftable @code
@item --fill-page
Scale output to make the board fit the page.
@end ftable
@c ./../src/hid/ps/ps.c 181
@ftable @code
@item --auto-mirror
Print mirror image of appropriate layers.
@end ftable
@c ./../src/hid/ps/ps.c 187
@ftable @code
@item --ps-color
Postscript output in color.
@end ftable
@c ./../src/hid/ps/ps.c 193
@ftable @code
@cindex ps-bloat
@item --ps-bloat <num>
Amount to add to trace/pad/pin edges.
@end ftable
@c ./../src/hid/ps/ps.c 199
@ftable @code
@cindex ps-invert
@item --ps-invert
Draw objects as white-on-black.
@end ftable
@c ./../src/hid/ps/ps.c 205
@ftable @code
@item --media <media-name>
Size of the media, the postscript is fitted to. The parameter
@code{<media-name>} can be any of the standard names for paper size: @samp{A0}
to @samp{A10}, @samp{B0} to @samp{B10}, @samp{Letter}, @samp{11x17},
@samp{Ledger}, @samp{Legal}, @samp{Executive}, @samp{A-Size}, @samp{B-size},
@samp{C-Size}, @samp{D-size}, @samp{E-size}, @samp{US-Business_Card},
@samp{Intl-Business_Card}.
@end ftable
@c ./../src/hid/ps/ps.c 211
@ftable @code
@cindex psfade
@item --psfade <num>
Fade amount for assembly drawings (0.0=missing, 1.0=solid).
@end ftable
@c ./../src/hid/ps/ps.c 218
@ftable @code
@item --scale <num>
Scale value to compensate for printer sizing errors (1.0 = full scale).
@end ftable
@c ./../src/hid/ps/ps.c 225
@ftable @code
@cindex multi-file
@item --multi-file
Produce multiple files, one per page, instead of a single multi page file.
@end ftable
@c ./../src/hid/ps/ps.c 232
@ftable @code
@item --xcalib <num>
Paper width. Used for x-Axis calibration.
@end ftable
@c ./../src/hid/ps/ps.c 238
@ftable @code
@item --ycalib <num>
Paper height. Used for y-Axis calibration.
@end ftable
@c ./../src/hid/ps/ps.c 244
@ftable @code
@item --drill-copper
Draw drill holes in pins / vias, instead of leaving solid copper.
@end ftable
@c ./../src/hid/ps/ps.c 251
@ftable @code
@cindex show-legend
@item --show-legend
Print file name and scale on printout.
@end ftable
@c options Encapsulated Postscript Export
@node Encapsulated Postscript Export
@section Encapsulated Postscript Export
@c ./../src/hid/ps/eps.c 76
@ftable @code
@item --eps-file <string>
Name of the encapsulated postscript output file. Can contain a path.
@end ftable
@c ./../src/hid/ps/eps.c 82
@ftable @code
@item --eps-scale <num>
Scale EPS output by the parameter @samp{num}.
@end ftable
@c ./../src/hid/ps/eps.c 88
@ftable @code
@cindex as-shown (EPS)
@item --as-shown
Export layers as shown on screen.
@end ftable
@c ./../src/hid/ps/eps.c 94
@ftable @code
@item --monochrome
Convert output to monochrome.
@end ftable
@c ./../src/hid/ps/eps.c 100
@ftable @code
@cindex only-visible
@item --only-visible
Limit the bounds of the EPS file to the visible items.
@end ftable
@c options PNG Options
@node PNG Options
@section PNG Options
@c ./../src/hid/png/png.c 236
@ftable @code
@item --outfile <string>
Name of the file to be exported to. Can contain a path.
@end ftable
@c ./../src/hid/png/png.c 242
@ftable @code
@item --dpi
Scale factor in pixels/inch. Set to 0 to scale to size specified in the layout.
@end ftable
@c ./../src/hid/png/png.c 248
@ftable @code
@item --x-max
Width of the png image in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 254
@ftable @code
@item --y-max
Height of the png output in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 260
@ftable @code
@item --xy-max
Maximum width and height of the PNG output in pixels. No constraint, when set to 0.
@end ftable
@c ./../src/hid/png/png.c 266
@ftable @code
@item --as-shown
Export layers as shown on screen.
@end ftable
@c ./../src/hid/png/png.c 272
@ftable @code
@item --monochrome
Convert output to monochrome.
@end ftable
@c ./../src/hid/png/png.c 278
@ftable @code
@item --only-visible
Limit the bounds of the exported PNG image to the visible items.
@end ftable
@c ./../src/hid/png/png.c 284
@ftable @code
@item --use-alpha
Make the background and any holes transparent.
@end ftable
@c ./../src/hid/png/png.c 290
@ftable @code
@item --fill-holes
Drill holes in pins/pads are filled, not hollow.
@end ftable
@c ./../src/hid/png/png.c 296
@ftable @code
@item --format <string>
File format to be exported. Parameter @code{<string>} can be @samp{PNG},
@samp{GIF}, or @samp{JPEG}.
@end ftable
@c ./../src/hid/png/png.c 302
@ftable @code
@item --png-bloat <num><dim>
Amount of extra thickness to add to traces, pads, or pin edges. The parameter
@samp{<num><dim>} is a number, appended by a dimension @samp{mm}, @samp{mil}, or
@samp{pix}. If no dimension is given, the default dimension is 1/100 mil.
@end ftable
@c ./../src/hid/png/png.c 308
@ftable @code
@cindex photo-mode
@item --photo-mode
Export a photo realistic image of the layout.
@end ftable
@c ./../src/hid/png/png.c 314
@ftable @code
@item --photo-flip-x
In photo-realistic mode, export the reverse side of the layout. Left-right flip.
@end ftable
@c ./../src/hid/png/png.c 320
@ftable @code
@item --photo-flip-y
In photo-realistic mode, export the reverse side of the layout. Up-down flip.
@end ftable
@c ./../src/hid/png/png.c 326
@ftable @code
@cindex photo-mask-colour
@item --photo-mask-colour <colour>
In photo-realistic mode, export the solder mask as this colour. Parameter
@code{<colour>} can be @samp{green}, @samp{red}, @samp{blue}, or @samp{purple}.
@end ftable
@c ./../src/hid/png/png.c 332
@ftable @code
@cindex photo-plating
@item --photo-plating
In photo-realistic mode, export the exposed copper as though it has this type
of plating. Parameter @code{<colour>} can be @samp{tinned}, @samp{gold},
@samp{silver}, or @samp{copper}.
@end ftable
@c ./../src/hid/png/png.c 338
@ftable @code
@cindex photo-silk-colour
@item --photo-silk-colour
In photo-realistic mode, export the silk screen as this colour. Parameter
@code{<colour>} can be @samp{white}, @samp{black}, or @samp{yellow}.
@end ftable
@c options lpr Printing Options
@node lpr Printing Options
@section lpr Printing Options
@c ./../src/hid/lpr/lpr.c 31
@ftable @code
@item --lprcommand <string>
Command to use for printing. Defaults to @code{lpr}. This can be used to produce
PDF output with a virtual PDF printer. Example: @*
@code{--lprcommand "lp -d CUPS-PDF-Printer"}.
@end ftable
@noindent In addition, all @ref{Postscript Export} options are valid.
@c options nelma Options
@node nelma Options
@section nelma Options
@c ./../src/hid/nelma/nelma.c 155
@ftable @code
@item -- basename <string>
File name prefix.
@end ftable
@c ./../src/hid/nelma/nelma.c 161
@ftable @code
@item --dpi <num>
Horizontal scale factor (grid points/inch).
@end ftable
@c ./../src/hid/nelma/nelma.c 167
@ftable @code
@item --copper-height <num>
Copper layer height (um).
@end ftable
@c ./../src/hid/nelma/nelma.c 173
@ftable @code
@item --substrate-height <num>
Substrate layer height (um).
@end ftable
@c ./../src/hid/nelma/nelma.c 179
@ftable @code
@item --substrate-epsilon <num>
Substrate relative epsilon.
@end ftable