techSetLayerFunction

techSetLayerFunction( 
d_techID 
tx_layer
g_function
) 
=> t / nil

Description

When the specified layer is not already assigned a function (material), sets the function assignment in the specified technology database. If the layer is already assigned a function, techSetLayerFunction returns a message to that effect and does not update the technology database. ASCII technology file location: functions subsection in the layerRules section; it assigns functions to layers. If a functions subsection does not exist, this function creates one with the specified data.

Arguments

d_techID	The database identifier of the technology database.
tx_layer	The layer name or layer number or a list containing the layer name and purpose.
g_function	The layer function.

Value Returned

t	The function was set.
nil	The technology database does not exist, the layer is not defined in the technology database, the requested function is not a valid function, or the layer already has another function assigned to it.

Example

techSetLayerFunction(tfID "metal1" "metal")
=> t

Assigns the layer function metal to the layer metal1 in the technology database identified by tfID.

techSetLayerFunction(tfID "Nwell" "pwell")
=> *WARNING* techSetLayerFunction: layer "Nwell" already has function: nwell
nil

Does not make the requested function assignment because the layer is already assigned a function.

techSetLayerFunction(tfID "Metal1" "unknown")
=> *WARNING* techSetLayerFunction: Illegal function specified "unknown"
nil

Does not make the requested function assignment because the specified function is not a valid function.

Return to top