Mail Archives: geda-user/2013/05/28/19:06:11
Dave McGuire <mcguire AT neurotica DOT com> schrieb am 27. May 2013:
> I see no such program in my build of gEDA. Is it not a part of the
> standard distribution?
IIRC, it was added in the latest release. That is, gEDA/gaf v1.9.0 which
was released in December 2012.
By the way, is there usage information beyond the man page? The
command "gaf config" is not transparent to me, yet. According to the man
page it is used like this:
gaf config [OPTION] [GROUP KEY [VALUE]]
But what options, group keys and values can this be used with? What job
is this config meant to do? What tricks can be achieved? Anybody got
some examples or use cases?
---<)kaimartin(>---
PS: Here is a copy of the man page:
/------------------------------------------------------
NAME
gaf - gEDA/gaf Command-Line Utility
SYNOPSIS
gaf [OPTION ...] COMMAND [ARGS ...]
DESCRIPTION
gaf is part of the gEDA (GPL Electronic Design Automation)
toolset. It provides a number of small command-line utilities
for working with schematic and symbol files, and is designed to
be used for batch processing of designs created using the
schematic editor gschem(1). It currently has three built-in COM‐
MANDs:
gaf export is used to create SVG, PDF, PNG, PS and EPS files from
schematic and symbol files, for printing or embedding in other
documents.
gaf config allows reading and writing settings in gEDA project,
user and system configuration stores.
gaf shell provides a Scheme REPL for command-line batch process‐
ing of schematic data.
GENERAL OPTIONS
--no-rcfiles
Prevent `gafrc' Scheme initialisation files from being
loaded.
-h, --help
Print a help message.
-V, --version
Print gaf version information.
EXPORTING IMAGE FILES
gaf export [OPTION ...] -o OUTPUT [--] FILE ...
gaf export can export schematic and symbol files in a variety of
image formats for printing or further processing. It currently
supports single-page PNG, SVG and EPS output, and multi-page PS
and PDF output. It accepts a variety of options for controlling
how the output is formatted.
-o, --output=FILE
Output generated image data to FILE.
-f, --format=(png | pdf | svg | ps | eps)
Specify an output format. Usually, this option is not
required, because gaf export will infer the correct for‐
mat from the file extension of the output file.
-p, --paper=NAME
Size the output for a particular paper size. The NAME
should be a PWG 5101.1-2002 paper name. For example,
valid values include `iso_a4', `na_letter', or `na_d'.
-l, --layout=(auto | landscape | portrait)
When using a paper size, set the orientation of the out‐
put. If `auto' layout is used, the orientation that best
fits the drawing will be used.
-s, --size=(auto | WIDTH:HEIGHT)
Size the output with specific dimensions. If the size is
-k, --scale=(FACTOR)
Set the output scale FACTOR. This is a distance identical
with 100 points (1 default grid spacing) in gschem(1)
coordinate space. It is used to size the output when nei‐
ther --paper nor --size are given, and defaults to 100
mil.
-m, --margins=(auto | TOP[:LEFT[:BOTTOM[:RIGHT]]])
Set the widths of the margins to be used. If `auto' mar‐
gins are specified, a sensible default value will be cho‐
sen. Up to four margin widths can be provided. If one
is provided, it will be used on all four sides. If two
are provided, the first will be used for the top/bottom
and the second for the left/right. If three are pro‐
vided, the first will be used for the top, the second for
left/right, and the third for the bottom.
-a, --align=(auto | HALIGN:VALIGN)
Set how the drawing is aligned within the page. HALIGN
controls the horizontal alignment, and VALIGN the verti‐
cal. Each alignment value should be in the range 0.0 to
1.0. The `auto' alignment is equivalent to a value of
`0.5:0.5', i.e. centered.
-d, --dpi=DPI
Set the number of pixels per inch used when generating
PNG output.
-c, --color
Enable colour output.
--no-color
Disable color output.
-F, --font=FONT-FAMILY
Set the font to be used for drawing text.
-- Treat all remaining arguments as schematic or symbol
filenames. Use this if you have a schematic or symbol
filename which begins with `-'.
The --size, --margins, or --scale options described above accept
values using units of `mm', `cm', `in', `pc', `px', or `pt'. If
you do not provide a unit, points are assumed. N.b. that `px'
are evaluated relative to the current --dpi setting.
When using the --size, --margins, or --align options with multi‐
ple values, you may use `;', or ` ' as a separator between them
instead of `:'. In such a case, remember to properly quote your
arguments to avoid them to be interpreted by your shell.
ACCESSING CONFIGURATION
gaf config [OPTION] [GROUP KEY [VALUE]]
gaf config is a basic utility for inspecting and modifying
gEDA/gaf configuration stores.
If a GROUP and KEY are specified, retrieves the value of that
configuration parameter. If a VALUE is specified, sets the value
of that parameter. The -p, -u and -s options can be used to
select the configuration store affected (by default, the project
configuration store for the current working directory). If no
GROUP and KEY are provided, outputs the filename of the selected
configuration store.
-p, --project[=PATH]
Select the project configuration store of the project
located in PATH. If no PATH is provided, selects the
project in the current working directory.
-u, --user
Select the user configuration store.
-s, --system
Select the system configuration store. Depending on user
permissions, the system configuration store may be read-
only.
SCHEME PROCESSING
gaf shell [OPTION ...]
gaf shell provides a Scheme Read-Eval-Print Loop (REPL) for
automating processing of schematic and symbol files. It is
designed to be used with the gEDA Scheme API.
-s FILE Evaluate Scheme source code from FILE, and exit.
-c EXPR Evaluate the Scheme expression EXPR, and exit.
-- Stop scanning arguments; run interactively.
-L DIRECTORY
Prepend DIRECTORY to the list of directories to be
searched for Scheme files.
-l FILE Evaluate Scheme source code from FILE.
The -s, -c and -- switches stop argument processing and pass all
the remaining arguments as the value of `(command-line)'.
ENVIRONMENT
GEDADATA
specifies the search directory for Scheme and rc files.
The default is `${prefix}/share/gEDA'.
GEDADATARC
specifies the search directory for rc files. The default
is `$GEDADATA'.
AUTHORS
See the `AUTHORS' file included with this program.
COPYRIGHT
Copyright © 2012 gEDA Contributors. License GPLv2+: GNU GPL
version 2 or later. Please see the `COPYING' file included with
this program for full details.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
gschem(1).
For more information on the Scheme API, see the geda-scheme Tex‐
info manual. If the info program is properly installed at your
site, the command
info geda-scheme
should give you access to the complete manual.
--
Kai-Martin Knaak
- Raw text -