Environment functions
GRIDSNAP Purpose
Menu command Syntax
Parameters yesno Description
Example
Chapter 8 Macros
Use this command to change the grid snap settings.
Grid (Options menu) GRIDSNAP yesno
Your choice of the values $$YES and $$NO.
You can change the grid snap settings used in GerbTool.
Note that the macros themselves do not make use of the grid.
The following macro turns on grid snap.
GRIDSNAP $$YES
OrCAD Layout for Windows GerbTool User~s Guide 175
GRIDVISIBLE
Purpose Menu command Syntax
Parameters yesno Description
Example
Use this command to to change the visibility of the GerbTool grid.
Grid (Options menu) GRIDVISIBLE yesno
Your choice of the values $$YES and $$NO.
You can change the grid visibility settings used in GerbTool. Note that the macros themselves do not make use of the grid.
The following macro turns on grid visibility.
GRIDVISIBLE $$YES
176 DrCAD Layout for Windows Gerb Tool User's Guide
HILICOLORS
Use this command to change the highlight colors used by the system.
A text string indicating the color to use when highlighting items while using the Item Info command (Query menu).
A text string indicating the color to use when highlighting items while using the Select command (Edit menu).
A text string indicating the color to use when performing a DRC.
Use this function to change the highlight colors that are used by the system. The color string can be any of the colors given in the color file COLORRGB, even if these colors are not available in GerbTool's color chooser. Since this is a block command, only the variables that you want to change need to be used.
The following macro sets the color used to display DRC errors and select groups.
HILI COLORS
OreAD Layout for Windows Gerb Tool User's Guide 177
LAVERN
Use this commadn to change the settings of a particular Gerber layer.
FLASH COLOR string
DRAWCOLOR string
An expression indicating the layer to process.
A text string indicating the filename to associate with this layer.
A text string indicating the layer name to associate with this layer.
A text string indicating the aperture list name to associate with this layer.
VISIBILITY An expression used to control the visibility of this layer.
Valid values are: 0 (off), 1 (on), and 2(ref).
FLASHCOLOR A text string indicating the color to use when displaying flashes from this layer.
DRAWCOLOR A text string indicating the color to use when displaying draws from this layer.
TYPE A text string indicating the type for this layer. Valid values are Top, Bottom, Inner, Plane, Composite.
POLARITY A text string indicating the polarity of this layer in
composite formats such as extended Gerber. Valid settings are dark and clear.
178 OrCAD Layout for Windows Gerb Tool User's Guide
KEY
An expression used to indicate the key field used for this layer in composite formats such as extended Gerber.
A text string used to indicate the file type for this layer.
This variable is for future expansion and as such the only valid value currently is Gerber.
A quad of expressions used to set the extents of this layer.
Note that these settings are only temporary, and can be changed when another function is called.
An expression used to indicate the net id for this layer. This value is used to determine layer to layer netlist accuracy, and should not generally be modified.
An expression used to indicate whether the layer should be included in a virtual panelization and step and repeat patterns.
Use this function to set many of the parameters concerning individual layers in GerbTool. Since this is a block command, only the variables that you want to change need to be used.
The following example obtains the visibility of a layer, stores it in the layers net id and then turns the visibility of the layer off. The stored information can then be used later to restore the layers visibility to its original condition. Note how only the variables for the information we want to change are included in the command.
GetLayer $Layer,$fn,$ln,$an,$vis,$fc, \
$dc,$type,$pol,$key,$ft, \
#save true visibility
o
#turn the layers vis offDrCAD Layout for Windows GerbTool User's Guide 179
MAPPATH
Purpose Menu command Syntax
Parameters path Description
Example
Use this command to change the location that GerbTool uses to fmd aperture lists.
None
MAP PATH path
A string defining the new path.
This function accepts a character string and uses it to change the path GerbTool uses to find its aperture lists.
This can be used to change the location where files are to be saved or loaded from.
The following example changes directory where GerbTool looks for aperture lists to a temporary one.
MA,PPATH "C:\temp\aperturs"
180 DrCAD Layout for Windows Gerb Tool User's Guide
NETID
Use this command to change the net id number for a layer.
None NETID exp
An expression representing the new value to set the netid to.
Use this function to set the net ID value for the currently active layer. Since these values are only used internally to keep the layer to layer net lists in sync, there are few instances where you should attempt to modify this value. One thing this function can be used for in a macro is for storing information with a layer, that can be retrieved and used later. Doing this destroys the layer to layer netlist information however, and the macro writer should be sure to warn you of this fact.
The following example obtains the visibility of a layer, stores it in the layers net id and then turns the visibility of the layer off.
The stored information can then be used later to restore the layer's visibility to its original condition.
GetLayer $Layer,$fn,$ln,$an,$vis,$fc,$dc, \
$type,$pol,$key,$ft, $lx,$ly,$ux, \
$uy $netid
OrCAD Layout for Windows GerbTool User's Guide 181