techCreateLP

techCreateLP( 
d_techID
l_layerPurpose
t_lpName
) 
=> d_lpID / nil

Description

Creates a named layer-purpose pair in the specified technology database. Layer-purpose pairs are used to define how layers are displayed. A layer is paired with a purpose, assigned a display packet and display attributes (in the techDisplays subsection in the layerDefinitions section of the ASCII technology file).

techCreateLP defines the layer-purpose pair with defaults in the techLayerPurposePriorities and techDisplays subsections of the layerDefinitions section.

This function returns a database identifier for the layer-purpose pair. You use the identifier with the techSetLPAttr and techSetLPPacketName functions to update the defaults and to specify how the layer-purpose pair appears in your designs. The layer and purpose you specify must be defined in the technology database before you can create a layer-purpose pair.

For more information about the techLayerPurposePriorities subsection of the technology file, see techLayerPurposePriorities in Virtuoso Technology Data ASCII Files Reference. For more information about the techDisplays subsection of the technology file, see techDisplays in Virtuoso Technology Data ASCII Files Reference.

The defaults set by this function are as follows:

Technology File Subsection	Argument	Default
techLayerPurposePriorities	Priority	0
techDisplays	Packet	defaultPacket
	Visibility	t
	Selectability	t
	Contributes to changed layer	t
	Drag enable	t
	Valid	t

Arguments

d_techID	The database identifier of the technology database.
l_layerPurpose	A list of the layer name or number and purpose name or number. The list has the following syntax: list( tx_layer tx_purpose )
t_lpName	The name of the layer-purpose pair. Valid values: Must be the same name as the layer name

Value Returned

d_lpID	The database identifier for the layer-purpose pair.
nil	The technology database does not exist or the layer or purpose is not defined in the technology database; the layer-purpose pair is not created.

Example

techCreateLP(tfID("nwell" "drawing") "nwell")
=> db:18483792

Creates a layer-purpose pair named newell with the nwell layer and the drawing purpose in the technology database identified by tfID. Returns the database identifier. Also updates technology subsections in the database with information about the new layer-purpose pair as illustrated by the ASCII syntax below:

techLayerPurposePriorities(
( nwell drawing)
      .
      .
      .
)

techDisplays
( nwell drawing defaultPacket t t t t t)
      .
      .
      .
)

Return to top