gdsrip Command Line SyntaxArtwork provides a simple executable (with source code) that exercises the gdsriplib library. Programmers can examine this code to help decide how to write their own calling routines. A programmer can also use the gdsrip application to test the library's performance prior to writing any code at all. The program writes each individual band of data to disk (unless otherwise instructed). The program also writes a log file to disk that includes the width of the image. Every pixel row is padded so that a row length is a multiple of 8 bits. The gdsrip command linegdsrip input_file struct input_layers [options] |
where
gdsrip - name of this application
input_file - the gdsii stream file to be rasterized.
struct - top structure (i.e. structure to be processed)
If you don't know the top structure use an equal
sign =. The program will determine the top structure.
if there is more than one, it will use the "first"
it encounters ...
input_layers - layer or layers to process; each layer number
must be preceded by the + sign. To process layer
6 this argument would be +6. To process layer
5 and 10 this argument would be +5+10
Library Specific Options
------------------------
these arguments are passed directly to the library.
-extents:<xlow>,<ylow>,<xhigh>,<yhigh> - specify the window to be
ratsterized. If not used, defaults
to the calculated data extents.
-dpi:<DPI> - raster resolution in dots per inch.
-dpm:<DPM> - raster resolution in dots per mm.
-pixelsize:<P> - raster resolution in pixel size in um;
only one of the 3 resolution options may be used.
-ram:<BSIZE> - RAM allocated ( in MBytes) for raster buffer
-dbs:<nnn> - number of polygon/path vertices reserved for data
buffer. This is a reference point used to
determine how to subdivide a band.
4000000 is a reasonable setting. This can be varied
to find optimum setting for a given type of
input file and raster buffer.
-only:<i>,<j>...<N-1>,<N-m> process only bands i,j,N-1,N-m
where 0<i,j<=N 0<m<N
-input_is_conditioned tells the rasterizer that input data
is conditioned: i.e. all polygons are
convex in X. This allows the rasterizer
to run faster - but if non conditioned
data is fed to the rasterizer incorrect
results will be output.
-out:<output_file_base_name> base name for the output .log
and raw bitmap files
-memstats Enable logging of memory usage at
different stages of program execution
-logcalls Log the calls made to the library along
with the parameter values passed.
Useful for debugging.
-mirror:M[,m] where M and m can take on the values
of x and/or y; this is the direction
of mirroring and not the axis.
mirroring is applied before any
other transformation.
-scale:S[,s] where S and s are scale factors in
x and y respectively. (default S = s)
scaling is applied after mirroring,
but before rotation
-rotate:R where R is an integer multiplier taken
modulo 4 applied to 90.0 degrees,
e.g. R = 2 implies 180 degrees, while R = -1
implies -90 degree rotatation
rotation is applied after mirroring
and scaling if any. Positive rotatation is
counter clock wise.
-degrees:D where D is the rotation in degrees
applied after mirroring and scaling if any
D must be a multiple of 90.0
-complement invert raster buffer pixels before output,
i.e. take complement of raster buffer
-invert invert TIFF image by setting inverse
flag in TIFF header (TIFF only)
Applications Specific Options
-----------------------------
these options control how the application runs.
-format discard the bitmap immediately after
it is produced. Do not write to disk.
The "raw" bitmaps can be enormous and
there is generally no reason to write
them uncompressed to disk.
-h display command line syntax
-timeout:S specify maximum time to wait for a band
in seconds.
|