commandname
Menu /path/to/menu
Short short description
Syntax syntax of the command

askfile "TITLE DIALOG-TYPE FILE-MASKS

DEF-DIR DEF-EXT FILE-ALIAS"

Title Title of dialog box

  • TeX and LaTeX
  • Troff
  • Lout
File-alias alias to put filename in blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah

Description long description blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah blah blahblah blahblah blahblah blahblah blahblah blahblah blah
Example

loadfile %{datadir}myfile.cal

loadfile %{setupfile}

loadfile %{GDSROOT}/%HOME/myfile.cal gds-ii

%{COMMANDALIAS} arguments
Notes
  • note1 DO NOT
  • note2 dO THIS
Related commandname2 commandname1 command3
Catagory functional context miscellaneous

help
Menu /help/help
Short help on commands
Syntax help [command]
Description This command shows help on the available commands. Help without a command shows a list of all valid commands. Help with a command shows help on that command.
Example

help help (see this:)

help (see all commands)

Catagory miscellaneous

showkeybnf
Short Show the Bachus Nauer Form of Key format
Syntax showkeybnf
Description This command shows the Bachus Nauer Form of the Key format.
Example

showkeybnf

Catagory miscellaneous

setalias
Menu non
Short Set alias
Syntax setalias aliasname string
Description Creates an internal alias "aliasname" with value "string"
Example

setalias gdsuser %GDSROOT/gdsuser

Notes
  • String can contain reference to other aliases and environment variables.
Related %{} showalias
Catagory miscellaneous environment

setenv
Menu non
Short Set environment-variable
Syntax setenv env-name string
Description Creates an environment-variable "env-name" with value "string"
Example

setenv HOME .

Notes
  • The environment, from which the program was started, is only modified during execution.
  • String can contain reference to other aliases and environment variables.
Related ${} showenv
Catagory miscellaneous environment

showalias
Menu non
Short Show alias variable
Syntax showalias alias_variable
Description The showalias command, without an alias(name), shows all defined aliases. The showalias command with a name shows that alias.
Example

showalias gdsroot

Related %{} setalias
Catagory miscellaneous environment

showenv
Menu non
Short Show alias variable
Syntax showalias environment_variable
Description The showenv command shows the contents of the "environment_variable" variable.
Example

showenv HOME

Notes
  • Environment variables MUST be typed in CAPITAL letters.
Related %{} setalias
Catagory miscellaneous environment

%{} OR %alias
Menu non
Short Use/Substitute alias
Syntax See Command BNF
Description Substitutes the internal alias "aliasname" with a string assigned earlier to this alias.
Example

loadfile %{datadir}myfile.cal

loadfile %{setupfile}

loadfile %{GDSROOT}/%HOME/myfile.cal gds-ii

%{COMMANDALIAS} arguments

Notes
  • Environment variables MUST be typed in CAPITAL letters.
Related setalias ${}
Catagory miscellaneous environment

${} OR $envvariable
Menu non
Short Use/Substitute alias
Syntax See Command BNF
Description Substitutes environment-variable "envname" with the stored string
Example

loadfile ${datadir}myfile.cal gds-ii

loadfile $GDSROOT/${HOME}/myfile.cal gds-ii

${DOLLARVARIABLE} argument

Notes
  • An environment variable can contain an empty string, but the variable MUST exist.
Related setenv showenv
Catagory misilanious environment

askfile
Menu /file/open/*
Short ask for a file name
Syntax

askfile "< TITLE > <DIALOG-TYPE> < FILE-MASKS > <DEF-DIR> <DEF-EXT> <FILE-ALIAS>"

Title Title of dialog box

Dialog-type Type of dialog box (OPEN or SAVE)

File-masks Mask for file listbox (All|*.*|Key-files|*.key)

Def-dir Directory to start in

Def-ext File-extention to show

File-alias alias to put filename in

Description Shows a dialog, with drive, directory and file boxes, to select or enter a file. For the selected file an alias is created (<File-alias>) containing the file name. This mechanism is used to be able to load or save the file from a process file by using the alias.
Example

askfile "Open GDS-II file OPEN GDS-II|*.gds;*.cal|All|*.*| C:\DATA\ CAL selectedfile"

(followed by, for example, 'loadfile %{selectedfile}')

Notes
  • Double-quotes are optional, use them when your string contains special characters, such as ';' (end of command)
Related loadfile
Catagory files interface

ask
Menu non
Short Asks for input string
Syntax

ask "<TITLE> <ALIAS>"

Title Title of the input dialog

Alias alias to put the input into File-alias alias to put filename in

Description Asks for input string to the user, the result will be set as an alias
Example

ask "Please give me some input" myaliasvar

Related showalias
Catagory interface

showfilename
Menu non
Short Show filename
Syntax

showfilename

Description output as a message the file that is currently in memory
Example

showfilename

Catagory interface

savevisible
Menu non
Short Only save visible layers
Syntax

savevisible <0>|<1>

Description Only the layers that are visible on the screen will be saved to a file e.g. GDSII or KEY etc, when using the savefile command.
Example

savevisible 0

Notes
  • When writing to a file, the current file remains in memory, to prevent data-loss.
Related savefile
Catagory interface settings

savefile
Menu/file/save/*
Short Save a file
Syntax

savefile <FILENAME> <FILETYPE>

Filename Path + name of the file

Filetype Type of file (gds-ii, key or flash)

Description Save a file to a certain type.
Example

savefile %{datadir}one.lay key

savefile /home/klaas/gdsuser/data/combiner.gds gds-ii

Notes
  • File type must be specified at all times. The extension can be anything at all.
Related loadfile
Catagory interface files

loadfile
Menu/file/load/*
Short Load a file
Syntax

loadfile <FILENAME> <FILETYPE>

Filename Path + name of the file

Filetype Type of file (gds-ii, key or flash)

Description Load a file of a certain type.
Example

loadfile %{datadir}one.lay key

loadfile /home/klaas/gdsuser/data/combiner.gds gds-ii

Notes
  • File type must be specified at all times. The extension can be anything at all.
Related savefile
Catagory interface files

mergefile
Menu/file/import/*
Short Loads a file and merges it with the one in memory
Syntax

mergefile <FILENAME> <FILETYPE>

Filename Path + name of the file

Filetype Type of file (gds-ii, key or flash)

Description Loads a file of the given type and merges it with the one in memory
Example

mergefile %{datadir}one.lay key

mergefile /home/klaas/gdsuser/data/combiner.gds gds-ii

Notes
  • File type must be specified at all times. The extension can be anything at all. This operation is only available when a file is in memory.
Related loadfile
Catagory interface files

closefile
Menu/file/close
Short Close the current (data)file in memory
Syntax

closefile

Description Close the current (data)file in memory
Example

closefile

Notes
  • Changes will be lost, use command savefile to save first
Related loadfile
Catagory interface files

loadsetup
Menu/file/load setup file
Short Load a setup or configuration file
Syntax

loadsetup <file>

Description Load a setup or configuration file. A setup file is not different from a process file. So it just contains a set of commands. But in this case it more meant for setting layers and factors for the program. Several setupfiles can exist, during startup the $HOME/gdsuser/config/user.set will always be used. Or if not available $GDSROOT/default/config/default.set.
Example

setalias setupfile "$HOME/aap.set"

loadsetup %{setupfile}

Notes
  • On closing the application, the current settings will be saved. This can be overruled by the command savesetuponexit
Related savesetup savesetuponexit
Catagory interface files

savesetup
Menu/file/save setup file
Short Save a setup or configuration file
Syntax

savesetup <file>

Description Save a setup or configuration file. A setup file is not different from a process file. So it just contains a set of commands. But in this case it more meant for setting layers and factors for the program. Several setupfiles can exist, during startup the $HOME/gdsuser/config/user.set will always be used. Or if not available $GDSROOT/default/config/default.set.
Example

setalias setupdir "$HOME"

savesetup %{setupdir}/aap.set

Notes
  • On closing the application, the current settings will be saved. This can be overruled by the command savesetuponexit
Related savesetuponexit loadsetup
Catagory interface files

loadprocess
Menu/Automatic/Load process file
Short Execute a processing file. This is a file containing pre-recorded commands and can be used as a macro.
Syntax

loadprocess <file>

Description Execute a processing file. This is a file containing pre-recorded commands and can be used as a macro.
Example

loadprocess %{procdir}automatic.prs

Notes
  • Settings may/can be changed during execution.
Related record
Catagory interface files automation

record
Menu/Automatic/Start process recording
Short Start/Stop process recording.
Syntax

record filename (to start recording)

record (to stop recording)

Description Start/Stop process recording. This function is used to record a macro file. While recording all (executed) actions are recorded to the file. When executing a process file, the record command will be ignored.
Example

record %{procdir}nothing.prs

record

Notes
  • This function overwrites an existing file (if it can).
Related loadprocess
Catagory interface files automation

keystring
Menunon
Short For drawing using a key file string. Handy in process files.
Syntax keystring '{' (<key-file elements>)* '}'
Description For drawing using a key file string. Handy in process files.
Example
     

          keystring {CIRCLE; LAYER 0;  WIDTH 0;  XY 1;\
             X 620.714; Y  188.116;   RADIUS 156.3;\
          ENDEL;\
          BOX; LAYER 0;  BOXTYPE 0;  WIDTH 0;  XY 5;\
             X 0;       Y 0;      X 500;   Y 0;\
             X 500;     Y 500;    X 0;     Y 500;\
             X 0;       Y 0;  \
          ENDEL;\
          TEXT; LAYER 0; \
          TEXTTYPE 0; PRESENTATION 0,2,1; STRANS 0,0,0; MAG 400; \
             XY 1; \
             X   1030000.000; Y  329000.000; \
          STRING "here some text"; \
          ENDEL;\
          PATH; LAYER 0; DATATYPE 0; WIDTH 100000; \
             XY 4; \
             X  57000.000; Y  70000.000;   X  160000.000; Y  70000.000;   \
             X 257000.000; Y 270000.000;   X 2160000.000; Y 270000.000;   \
          ENDEL;\
          BOUNDARY; LAYER 0;  DATATYPE 0; WIDTH 25000; \
             XY 7; \
             X   500000;  Y     89170;   X  500000; Y    0000;   \
             X     0000;  Y      0000;   X    0000; Y  500000;   \
             X   500000;  Y    500000;   X  500000; Y  287060;   \
             XM  773100;  YM   222900;   XO 620834; YO 188115;   \
             X   500000;  Y     89170; \
          ENDEL;}

          # Elements can be placed together in one key string like above, 
          # or seperate like below. Comment lines can also be added
          # (like this ;-)

          keystring {ARC; LAYER 0;  DATATYPE 0; WIDTH 100000;\
             XY 2; \
             X  1500000;  Y   287060; \
             XM 1773100;  YM  222900;  XO  1620834; YO 188115;   \
             X  1500000;  Y    89170; \
          ENDEL;}
		
Notes
  • Only the elements from Key files can be used inside a key string. The key elements are seperated by a semi-colon or a backslash character to continue on the next line.
Related defaultunit defaultaccur Key Bachus Nauer.
Catagory automation

defaultaccur
Menunon
Short Sets the default accuracy.
Syntax

defaultaccur <number>

Description Sets the default accuracy. This is used when a process file with key strings is read. When a file is in memory, the accuracy from that file is used. If not, the accuracy 'defaultaccur' will be used. Using a value of 0.01 means that two figures behind the comma will be displayed.
Example

defaultaccur 0.01

Notes
  • This value is only used when there's no file in memory.
Related defaultunit keystring
Catagory automation settings

defaultunit
Menunon
Short Sets the default unit.
Syntax

defaultunit <unit>

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description Sets the default unit. This is used when a process file with key strings is read. The numbers in the file will be interpreted with 'defaultunit' as multiplier instead of meters (=1).
Example

defaultunit um

Related defaultaccur keystring
Catagory automation settings

selected
Menunon
Short Only tread selected elements.
Syntax

selected <0>|<1>

Description When selected 1, the operations which don't need groups are performed only on selected elements in layers.
Example

selected 1

selected 0

Related delete flatten transform
Catagory operations settings

selectmarge
Menunon
Short Set selectmarge.
Syntax

selected <number>

Description The purpose of 'selectmarge' is that a user doesn't have to click exactly on a polygon to select it. 'Selectmarge' defines the percentage of the screenwidth a user can click next to a polygon and still select it.
Example

selectmarge 0.01

Related showfactorsdlg
Catagory settings

snapfactor
Menunon
Short Set snapfactor.
Syntax

snapfactor <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description At the beginning of a logical operation (i.e. AND, OR...) polygon segments shorter than 'snapfactor' are removed. Polygons that are closer to eachother than 'snapfactor' are connected to eachother.
Example

snapfactor {1.0 um}

snapfactor 1.0um

Related showfactorsdlg
Catagory settings operations

correctionfactor
Menunon
Short Set correctionfactor.
Syntax

correctionfactor <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the correction and makering functions, which create a ring around the polygons. For correction, this factor determines the width by which the polygon is enlarged or shrinked. A positive correctionfactor enlarges the polygon and a negative shrinks it. For makering, this factor determines half the width (radius) of the ring. The boundaries of the ring are this size smaller and larger than the original polygon.
Example

correctionfactor {5.5 um}

correctionfactor 5.5um

Related showfactorsdlg
Catagory settings operations

correctionaber
Menunon
Short Set correctionaber.
Syntax

correctionaber <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used when creating a ring around the boundaries of a polygon. It determines the accuracy of the segments of the ring.
Example

correctionaber {1.0 um}

correctionaber 1.0um

Related showfactorsdlg
Catagory settings operations

roundfactor
Menunon
Short Set roundfactor.
Syntax

roundfactor <number>

Description This variable is used when rounding sharp corners. An arc is calculated at the sharp edge of a polygon. If the distance of the sharp edge to the midpoint of arc is longer than arc-radius * roundfactor, then the edge is replaced by the arc.
Example

roundfactor 1.5

roundfactor 0

Related showfactorsdlg
Catagory settings operations

roundtype
Menunon
Short Set roundtype.
Syntax

roundtype <circle>|<medial>

Description This variable specifies the rounding type when creating a ring around a sharp edge. The rounding type is used when the distance of the new edge to the original is longer than 'roundfactor' * 'correctionfactor'. The circles must fit inside the enlarged/shrinked polygon. The Circle type creates a circle with the old edge as midpoint and 'correctionfactor' as radius. The Medial type creates a circle on the line between the old and new edge. The far most crossing of this circle with this help-line is laying at a distance of 'roundfactor' * 'correctionfactor' from the old edge.
Example

roundtype circle

Notes
  • NOT IMPLEMENTED YET Only Circle type is used !.
Related showfactorsdlg
Catagory settings operations

toarcrmin
Menunon
Short Set toarcrmin .
Syntax

toarcrmin <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the polygon to arc conversion function, and specifies the minimum radius of an arc.
Example

toarcrmin {50 um}

toarcrmin 50um

Related showfactorsdlg
Catagory settings operations

toarcrmax
Menunon
Short Set toarcrmax.
Syntax

toarcrmax <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the polygon to arc conversion function, and specifies the maximum radius of an arc.
Example

toarcrmax {50 um}

toarcrmax 50um

Related showfactorsdlg
Catagory settings operations

arcaccur
Menunon
Short Set arcaccur.
Syntax

arcaccur <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the polygon to arc conversion function, and specifies the maximum abberation of an arc to the original line-pieces.
Example

arcaccur {25 um}

arcaccur 25um

Related showfactorsdlg
Catagory settings operations

polyaccur
Menunon
Short Set polyaccur .
Syntax

polyaccur <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the arc/circle to polygon conversion function, and specifies the maximum abberation of a polygon to the original arc/circle.
Example

polyaccur {1 um}

polyaccur 1um

Related showfactorsdlg
Catagory settings operations

smoothaccur
Menunon
Short Set smoothaccur.
Syntax

smoothaccur <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the smoothen function, and specifies the maximum abberation the new polygon may have to the original.
Example

smoothaccur {5 um}

smoothaccur 5um

Related showfactorsdlg
Catagory settings operations

maxlinemerge
Menunon
Short Set maxlinemerge.
Syntax

maxlinemerge <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the smoothen function, and specifies the maximum length of a line-pieces where other lines may be merged to.
Example

maxlinemerge {5000 um}

maxlinemerge 5000um

Related showfactorsdlg
Catagory settings operations

displayaber
Menunon
Short Set displayaber.
Syntax

displayaber <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description This variable is used by the screendriver, and specifies the accuracy of displayed arcs and circles. Internally they are converted to line-pieces. This variable is the display version of 'polyaccur', which is the operation version. Too see the effect of a change in value, redraw the screen.
Example

displayaber {5 um}

displayaber 5um

Related showfactorsdlg polyaccur
Catagory settings operations

structhres
Menunon
Short Set structhres.
Syntax

structhres <number>

<number> integer number specifying pixels
Description This variable is used by the screendriver, and specifies when a structure will be drawn. If the structure boundingbox on the screen is less then the given number of pixels on the screen, only the boundingbox will be drawn. For huge drawings this will increase the drawing speed.
Example

structhres 100

Related showfactorsdlg
Catagory settings

primthres
Menunon
Short Set primthres.
Syntax

primthres <number> <true|false>

<number> integer number specifying pixels
Description This variable is used by the screendriver, and specifies when a primitive will be drawn. If the primitive boundingbox on the screen is less then the given number of pixels on the screen, only the boundingbox will be drawn if the second parameter is True. If the second parameter is False nothing will be drawn. For huge drawings this will increase the drawing speed.
Example

primthres 5

Related showfactorsdlg
Catagory settings

mirrorx
Menunon
Short Set mirrorx for transforms.
Syntax

mirrorx <0> <1>

Description Mirrorx sets the option for the transform and transform_a operations to mirror selected elements in the X-axis.
Example

mirrorx 0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory transform operations

mirrory
Menunon
Short Set mirrory for transforms.
Syntax

mirrorx <0> <1>

Description Mirrory sets the option for the transform and transform_a operations to mirror selected elements in the Y-axis.
Example

mirrory 0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory transform operations

movehor
Menunon
Short Set movehor for transforms.
Syntax

movehor <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description Specifies the distance structures are moved horizontal when the transform or transform_a operation is performed.
Example

movehor 0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory transform operations

movever
Menunon
Short Set movever for transforms.
Syntax

movever <number> [<unit>]

<unit> in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description Specifies the distance structures are moved vertical when the transform or transform_a operation is performed.
Example

movever 0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory transform operations

scale
Menunon
Short Set scale for transforms.
Syntax

scale <number>

Description Specifies the scale factor for the transform and transform_a operations.
Example

scale 2.0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a displayaber
Catagory transform operations

rotate
Menunon
Short Set rotate for transforms.
Syntax

rotate <number>

Description Specifies the rotation in degrees for the transform and transform_a operations.
Example

rotate 2.0

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a displayaber
Catagory transform operations

direction
Menunon
Short Set direction for transforms.
Syntax

direction <Clockwise>|<Counter clockwise>

Description Specifies the direction of the rotation for the transform and transform_a operations.
Example

direction Clockwise

direction {Cntr clockwise}

Related mirrorx mirrory movehor movever scale rotate direction transform transform_a displayaber
Catagory transform operations

showgroupsdlg
Menunon
Short Show group settings dialog (A, B and Destination)
Syntax

showgroupsdlg

Description Groups are used for several operations, like boolean operations. Shows the layers in group A, B and destination. Groups A and B contains a list of layernumbers, destination contains only one layer. You can set if the element in the ayers in the groups should be only selected elements or all. For the destination you can select either add to the destination or overwrite what is on that layer.
Example

showgroupsdlg

Related group_a group_b destination
Catagory groupoperations groups dialogs

group_a
Menunon
Short Set group A layers
Syntax

to set group_a to (selected) elements on given layers: group_a <layer_no> <layer_no> <layer_no> {True|False}

<layer_no> layer number (0-199)

if True is set, only selected elements in the layers will be used.

to make group_a empty:

group_a empty

to set group_a to the selected elements in the drawing:

group_a selected

Description Fill/clear layer-group A
Example

group_a 0 3 14 true

group_a 0 3 false

group_a empty

group_a selected

Related group_b destination
Catagory groupoperations groups

group_b
Menunon
Short Set group B layers
Syntax

to set group_b to (selected) elements on given layers: group_a <layer_no> <layer_no> <layer_no> {True|False}

<layer_no> layer number (0-199)

if True is set, only selected elements in the layers will be used.

to make group_b empty:

group_b empty

to set group_b to the selected elements in the drawing:

group_b selected

Description Fill/clear layer-group B
Example

group_b 0 3 14 true

group_b 0 3 false

group_b empty

group_b selected

Related group_a destination
Catagory groupoperations groups

destination
Menunon
Short Set destination layer
Syntax

to set destination layer: destination <layer_no> {True|False}

<layer_no> layer number (0-199)

True means add result to this layer, else overwrite the destination layer.

destination empty

Description Set destination layer for output of operations on layers.
Example

destination 3

destination empty

Related group_b group_a
Catagory groupoperations groups

flatten {one}
Menunon
Short remove structures hierarchy from (selected) elements
Syntax flatten
Description The datafile can consist of several structures and structure-references. Flatten expands all references in the visible structure to one (top)structure by copying the elements inside referenced structures to that level. Empty structures will be removed. If the selected flag is set, only selected elements will be flattened. "flatten one", Only removes one level of hierarchy.
Example

selected 1

flatten

flatten one

Notes
  • File may grow very large (in memory too)
Related selected
Catagory operations

delete
Menunon
Short delete (selected) elements
Syntax delete
Description Deletes in Visible structure contents, elements that are selected or all, depending if flag "selected" is set.
Example

delete

Notes
  • Only the elements inside the visible top structure are deleted. Selected References are also deleted, by first exploded to make them unique. This may lead to empty structures.
Related selected
Catagory operations

delete_a
Menunon
Short delete (selected) elements in group A
Syntax delete_a
Description Deletes in visible structure contents, elements specified in group A. Group A is specified with the group_a command. In case the onlyselected flag is set for group A, selected References are first exploded. The command only deletes elements,this may result in empty structures
Example

delete_a

Notes
  • A must be set. B and destination are ignored.
  • Only the elements inside the visible structure are deleted, references to other structures will be exploded first if onlyselected in the group is True.
Related group_a group_b destination
Catagory operations groupoperations

transform
Menunon
Short Transforms structure contents visible on screen.
Syntax transform
Description Transforms structure contents visible on screen. Uses the transformation settings.
Example

transform

Notes
  • Transformation can be undone with undotrans. Selected flag can be set to transform only the selected elements (also structure references)
Related selected mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory operations transform

undotrans
Menunon
Short Undo last transformation.
Syntax undotrans
Description Transforms elements back to old situation (before last transform).
Example

undotrans

Notes
  • Transformation can only be undone immediately after the transformation itself. When first an other command is chosen, 'undotrans' becomes unavailable.
Related mirrorx mirrory movehor movever scale rotate direction transform group_a group_b destination
Catagory operations transform

transform_a
Menunon
Short Transform elements in group A.
Syntax transform
Description Transforms in visible structure contents elements specified in group A. Uses the transformation settings.
Example

transform

Notes
  • A must be set. B and destination are ignored
  • Transformation can be undone with undotrans_a.
Related selected mirrorx mirrory movehor movever scale rotate direction transform transform_a
Catagory operations transform groupoperations

undotrans_a
Menunon
Short Undo last transformation on groups.
Syntax undotrans
Description Transforms elements back to old situation (before last transform).
Example

undotrans

Notes
  • Transformation can only be undone immediately after the transformation itself. When first an other command is chosen, 'undotrans' becomes unavailable.
Related mirrorx mirrory movehor movever scale rotate direction transform group_a group_b destination
Catagory operations groupoperations transform

makering
Menunon
Short Creates a ring around filled elements
Syntax makering
Description Creates a ring around the boundaries of elements defined in group A.
Example

makering

Notes
  • A and Desination set. B is ignored.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a destination correctionfactor correctionaber tolines polyaccur
Catagory groupoperations operations

correction
Menunon
Short Creates a ring around filled elements
Syntax correction
Description Creates a ring around the boundaries of elements defined in group A. And merges it with the original polygons. With a positive/negetive correction value you can enlarge/shrink the drawing with that value.
Example

correction

Notes
  • A and Desination set. B is ignored.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a destination correctionfactor correctionaber tolines polyaccur
Catagory groupoperations operations

copy_a
Menunon
Short Duplicates elements from group A to the layer in destination.
Syntax copy_a
Description Duplicates elements from group A to the layer in destination.
Example

copy_a

Notes
  • A and Desination set. B is ignored.
Related group_a destination
Catagory groupoperations operations

move_a
Menunon
Short Changes the layer-numbers of the elements in group A to the layer in destination.
Syntax move_a
Description Changes the layer-numbers of the elements in group A to the layer in destination.
Example

move_a

Notes
  • A and Desination set. B is ignored.
Related group_a destination
Catagory groupoperations operations

toarcs
Menunon
Short Convert polygons to arcs.
Syntax toarcs
Description Detects arcs in polygons and replaces those with segments. 'toarcrmax' and 'toarcrmin' as range for the radius. 'arcaccur' for maximum abberation between the arc and the polygon segments.
Example

toarcs

Notes
  • A and Desination set. B is ignored.
Related group_a destination tolines polyaccur toarcrmin toarcrmax arcaccur
Catagory groupoperations operations

tolines
Menunon
Short Convert arcs and circles to polygons.
Syntax tolines
Description Replaces arcs and circles, in a polygon, with line-pieces. 'polyaccur' determines the maximum abberation that between the polygon segments and the arc/circle.
Example

toarcs

Notes
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
  • A and Desination set. B is ignored.
Related group_a destination tolines polyaccur arcaccur
Catagory groupoperations operations

smoothen
Menunon
Short Removes glitches and short lines from polygons.
Syntax smoothen
Description Removes glitches and short lines from polygons. Uses 'smoothaccur' for maximum abberation of the smoothed polygon-segments to the originals. Uses 'maxlinemerge' for maximum line-length to merge lines to.
Example

smoothen

Notes
  • A and Desination set. B is ignored.
  • All elements that have a surface are converted to polygons. Polylines and polygons containing arcsegments are also converted. (Text does not have a surface and is not converted.)
Related group_a destination tolines polyaccur smoothaccur maxlinemerge
Catagory groupoperations operations

intersect
Menunon
Short Calculate intersections (Logical AND: A AND B)
Syntax intersect
Description Calculate the intersections (overlappings) between the elements in group A and B. 'snapfactor' determines the accuracy with which the calculations are performed, and 'polyaccur' for conversion of Arcs and Circles.
Example

intersect

Notes
  • A or B and destination must be set.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a group_b destination tolines polyaccur
Catagory groupoperations booleanoperations operations

merge
Menunon
Short Merges elements (Logical OR: A OR B)
Syntax merge
Description Merges the elements in group A and B (Logical OR of A and B) 'snapfactor' determines the accuracy with which the calculations are performed, and 'polyaccur' for conversion of Arcs and Circles.
Example

merge

Notes
  • A or B and destination must be set.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a group_b destination tolines polyaccur
Catagory groupoperations booleanoperations operations

a_subtract_b
Menunon
Short Subtraction (A - B)
Syntax a_subtract_b
Description Subtracts the contents of group B from those of group A (A-B). 'snapfactor' determines the accuracy with which the calculations are performed, and 'polyaccur' for conversion of Arcs and Circles.
Example

a_subtract_b

Notes
  • A or B and destination must be set.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a group_b destination tolines polyaccur
Catagory groupoperations booleanoperations operations

b_subtract_a
Menunon
Short Subtraction (B - A)
Syntax b_subtract_a
Description Subtracts the contents of group A from those of group B (B-A). 'snapfactor' determines the accuracy with which the calculations are performed, and 'polyaccur' for conversion of Arcs and Circles.
Example

b_subtract_a

Notes
  • A or B and destination must be set.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a group_b destination tolines polyaccur
Catagory groupoperations booleanoperations operations

exor
Menunon
Short Exor (Logical EXOR: A EXOR B)
Syntax exor
Description Exor (Logical EXOR: A EXOR B) Performs an exclusive-or operation between the contents of group A and B. This results in the differences between group A and B (i.e. overlappings are not copied). 'snapfactor' determines the accuracy with which the calculations are performed, and 'polyaccur' for conversion of Arcs and Circles.
Example

exor

Notes
  • A or B and destination must be set.
  • All elements that have a surface are converted to polygons. (Text does not have a surface and is not converted.)
Related group_a group_b destination tolines polyaccur
Catagory groupoperations booleanoperations operations

showlayerdlg
Menunon
Short Show layers dialog
Syntax showlayerdlg
Description Show the layers settings dialog, which can be used to set the layer settings.
Example

showlayerdlg

Related setlayer name visible selectable bordercolor fillcolor brush order
Catagory layers

setlayer
Menunon
Short Set active layer
Syntax

setlayer <layer_nr>

<layer_nr> is in [0..99]

Description Select a layer. This is needed before changing layersettings. This layer is also used for drawing upon.
Example

showlayerdlg

Related name visible selectable bordercolor fillcolor brush order
Catagory layers

name
Menunon
Short Set active layer name
Syntax

name <name> | "<name>"

Description Set the name of the selected layer.
Example

name "ape mockey"

name apemockey

Notes
  • First set active layer with setlayer
Related setlayer visible selectable bordercolor fillcolor brush order
Catagory layers

visible
Menunon
Short Set Layer Visibility On/Off
Syntax

visible 1 | 0 [all]

Description Select if the selected layer/all layers is/are visible or not.
Example

visible 1

visible 0 all

Notes
  • First set active layer with setlayer
Related setlayer name selectable bordercolor fillcolor brush order
Catagory layers

selectable
Menunon
Short Set Layer Selectability On/Off
Syntax

selectable 1 | 0 [all]

Description Select if the current layer/all layers is/are selectable or not.
Example

selectable 1

selectable 0 all

Notes
  • First set active layer with setlayer
Related setlayer name visible fillcolor brush order
Catagory layers

bordercolor
Menunon
Short Set layer border color
Syntax

bordercolor r g b

r g and b are in [0..255]

Description Defines the border color of the selected layer. This determines color of the borders around polygons and the color of text.
Example

bordercolor 0 0 0

bordercolor 0 255 0

Notes
  • First set active layer with setlayer
Related setlayer name visible bordercolor fillcolor brush order
Catagory layers

fillcolor
Menunon
Short Set layer border color
Syntax

fillcolor r g b

r g and b are in [0..255]

Description Defines the fill color of the selected layer. This determines the color with which polygons are filled.
Example

fillcolor 0 0 0

fillcolor 0 255 0

Notes
  • First set active layer with setlayer
Related setlayer name visible bordercolor brush order
Catagory layers

brush
Menunon
Short Set layer brush
Syntax

brush <brush_nr>

<brush_nr> is in [0..64]

Description Selects the fill pattern of the selected layer. This determines how polygons are filled on the screen.
Example

brush 23

Notes
  • First set active layer with setlayer
Related setlayer name visible bordercolor fillcolor order
Catagory layers

viewstructure
Menunon
Short Set View Structure
Syntax

viewstructure <structure_name>

Description Select a structure to make visible on the screen. All operations work on the visible structure.
Example

viewstructure "nameofstructure"

Notes
  • A file must be in memory, and the structure must be available.
Catagory display

drawoutline
Menunon
Short Set fill polygons on/off.
Syntax

drawoutline <0>|<1>

Description Drawoutline sets the option to Draw-only the outlines of the drawing, i.e. not to fill the primitives.
Example

drawoutline 1

Notes
  • If the polygons are visible but not filled, check the fill- color and pattern.
Catagory display

showcoords
Menunon
Short Set show coordinates on/off.
Syntax

showcoords <0>|<1>

Description Select if the mouse coordinates are shown in the statusbar.
Example

showcoords 1

Catagory display

showgrid
Menunon
Short Show grid on screen.
Syntax

showgrid <0>|<1>

Description Shows the grid on the screen using the gridsettings.
Example

showgrid 1

Related gridspace gridcolour gridplacement
Catagory display

gridspace
Menunon
Short Show grid on screen.
Syntax

gridspace <number< [<unit<]

<unit< in: pm, nm, um, mm, cm, dm, m, e, inch, ft

Description Specifies the distance between points, drawn as single pixels, horizontal and vertical.
Example

gridspace {5 mm}

Notes
  • When showgrid is on, call draw, to draw grid with the new settings.
Related showgrid gridcolour gridplacement
Catagory display

gridcolour
Menunon
Short Specify the colour of grid points
Syntax

gridcolour <r> <g> <b>

<r> <g> <b> are in [0..255]

Description Specifies the colour of gridpoints on the screen on white background.
Example

gridcolour 0 255 125

Notes
  • When showgrid is on, call draw to draw grid with the new settings.
Related showgrid gridspace gridplacement
Catagory display

gridplacement
Menunon
Short Specify the place of the grid
Syntax

gridplacement <0> | <1>

Description Specifies the place of the grid. When this value is 0, the grid is drawn on the background. When 1, the grid is drawn on the foreground.
Example

gridplacement 1

Notes
  • When showgrid is on, call draw to draw grid with the new settings.
Related showgrid gridspace gridcolour
Catagory display

zoom
Menunon
Short zoom in/out
Syntax

zoom <x_min> <y_min> <x_max> <y_max>

Description Zoom to the selected rectangle given in database units.
Example

zoom 3423.038632 16262.008107 7657.606047 13039.112088

Related zoomback zoomout zoomout2
Catagory display

zoomback
Menunon
Short zoom to prev zoom area
Syntax

zoomback

Description Zoom to the previous zooming coordinates from the zoom history.
Example

zoomback

Related zoom zoomout zoomout2
Catagory display

zoomout
Menunon
Short zoom to full drawing
Syntax

zoomout

Description Zoom to the first zooming coordinates in the zoom history, this selects full view of the current structure.
Example

zoomout

Related zoom zoomout2 zoomback
Catagory display

zoomout2
Menunon
Short zoom out 2 times current size
Syntax

zoomout2

Description zoom out 2 times current size, enables to zoomout to extend beyond the boundingbox of the full drawing.
Example

zoomout2

Related zoom zoomout zoomback
Catagory display

select
Menunon
Short selection of elements
Syntax

To (de)select an area:

select <x_min> <y_min> <x_max> <y_max> <mode>

To (de)select at a point:

select <x> <y> <mode>

To (de)select all:

select all <mode>

<mode>= true : select mode

<mode>= false: deselect mode

Description Selects elements (also references) in specified area or at given point. With point selection the elements are selected inside out (smallest first). In deselection mode this is the same.
Example

select 0 0 1000 2000 true

select 1000 2000 false

select all true

Related selectmarge
Catagory display

clearscreen
Menunon
Short clear the screen
Syntax

clearscreen <rgb>

<rgb> is the color value

Description Clearscreen fills the screen with color <rgb>.
Example

clearscreen 16777215

clearscreen 0

Catagory display

draw
Menunon
Short draw what is in memory
Syntax

draw

Description Clear the screen and then redraws the drawing.
Example

draw

Catagory display

print
Menunon
Short print screen
Syntax

print

Description Print what's on the screen.
Example

print

Catagory display

startpoint
Menunon
Short Sets the relative startpoint
Syntax

startpoint <x> <y>

Description Sets the relative startpoint to the selected coordinates. Used for calculating distance with relative points.
Example

startpoint -1000 -1500

Related relativepoint
Catagory display measure

relativepoint
Menunon
Short Sets the relative endpoint
Syntax

relativepoint <x> <y>

Description Sets the relative endpoint to the selected coordinates. Used for calculating distance to startpoint. When a relative point is defined, the 'distance' dialog appears (if it's not on the screen already). The properties calculated are: dx, dy, distance between start and endpoints and the angle of the line between the points.
Example

relativepoint 1200 -1500

Related relativepoint
Catagory display measure

addfile
Menunon
Short adds a file to the file history
Syntax

addfile <filename> <filetype>

Description This command adds a file to the file history. Maximum no. is 10 files, the 10th pushes out the 1st. added
Example

addfile /usr/users/pc/guest/hahohihuhe.cal gds-ii

Catagory files

pause
Menunon
Shortstops a process file
Syntax

pause <test to show>

Description This function shows a dialog with a message. Pressing <Enter> continues processing. Pause without a text shows a default message.
Example

pause "This is a great opportunity to get a cup of java!"

pause %{message_inside_alias}

Catagory automation

exit
Menunon
Shortexit program
Syntax

exit

Description Close data- and process-file(s) and exits program, usefull from a process file.
Example

exit

Catagory automation