techCreateLayer

techCreateLayer( 
d_techID
x_layerNumber
t_layerName 
[ t_layerAbbrev ]
) 
=> d_layerID / nil

Description

Creates a layer in the specified technology database. ASCII technology file location: techLayers subsection in the layerDefinitions section; it lists the layers that can be used. If a techLayers subsection does not exist, this function creates one with the specified data.

Applications that display layer names do not always have room to display the entire name. The optional abbreviation expands your control over what is displayed in narrow fields. Depending upon the width of the field for displaying the layer name, an application displays whichever of the following fits:

• The full layer name
• The layer name truncated to fit (if no abbreviation is specified)
• The abbreviation
• The abbreviation truncated to fit

For more information about the techLayers section, see techLayers in the Virtuoso Technology Data ASCII Files Reference.

Arguments

d_techID	The database identifier of the technology database.
x_layerNumber	The layer number. Valid values: A unique integer from 0 through 194 and from 256 through 231-1 (layers numbered 195 through 255 are system-reserved layers)
t_layerName	The layer name. Valid values: Any string
t_layerAbbrev	An optional abbreviation of the layer name. Valid values: Any string of seven characters or less

Value Returned

d_layerID	The database identifier that is used internally to identify the technology database and layer.
nil	The technology database does not exist; the layer is not created.

Example

techCreateLayer(techID 15 "metal1" "met1")

Creates a layer with the layer number 15, the layer name metal1, and the layer abbreviation met1.

Return to top