de_add_layer()

Adds a layer definition to the current set of layers. A layer definition consists of a layer name, number, color, fill pattern, line style, plotting mode, visible/invisible flag, protected/unprotected flag, IGES number, GDSII Stream number, layer binding list, and layer type. The order in which layers are added, using this command, determines their priority. Returns: none.

See also: de_remove_all_layers(), de_set_layer(), de_get_layer_attribute().

Syntax:

de_add_layer(layerName, num, gds2num, igesNum, color, pattern, lineStyle, plotMode, protected, visible, bindingList, layerType);

where

layerName is the layer name. This must be unique-the name defaults is reserved. The name can be any number of alpha-numeric characters. The only punctuation character that can be used is an underscore.

num is the layer number. This must be a unique, positive integer. Layer 0 is reserved.

gds2num is the GDSII Stream layer number. This must be a positive integer between 0 and 63.

igesNum is the IGES layer number. This must be a positive integer between 1 and 256.

color is the layer color number. This must be a positive integer. This should be between 0 and the number of colors defined in the eecolor.cfg file.

pattern is the layer pattern number. This must be a positive integer. This should be between 0 and the number of fill patterns defined in the eefill.cfg file.

lineStyle is the layer line style number; an integer between 0 and 6, where:

• 0 = solid line
• 1 = dotted line
• 2 = double dotted line
• 3 = short dash line
• 4 = short dot dash line
• 5 = long dash line
• 6 = long dot dash line

plotMode is the layer plot mode number; an integer between 0 and 2, where:

• 0 = outline plot mode
• 1 = filled
• 2 = both

protected is the layer protect status, where:

• 0 = unprotected
• 1 = protected

visible is the layer visibility status, where:

• 0 = the layer is invisible
• 1 = the layer is visible

bindingList is a comma-separated list of quoted strings which are the names of all layers that a component on the layer being defined are allowed to attach to, where:

• Wildcard "*" = any or all layers
• Null = no layers

layerType is the type of layer, where:

• 1=Physical (normal layer)
• 2=Notes
• 4=DRC (layer for DRC results)

Example:

de_add_layer ("metal2", 10, 14, 14, 6, 3, 2, 1, 0, 0, "*", 1);

Where Used:

Schematic, Layout