gdsrip Command Line Syntax

Artwork provides a simple executable (with source code) that exercises the gdsriplib.a 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 line

gdsrip 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.