techOrderLPPriorityInContext

techOrderLPPriorityInContext(
tx_techfileLibName 
l_orderLpps
) 
=> t / nil

Description

Defines the relative priority for a dynamic set of layer-purpose pairs (LPPs) to be drawn on the canvas. The larger the number, the higher the priority and the lower the LPP is in the list. The LPP with the highest priority is drawn on top of all other LPPs.

This function is most useful when multiple technology databases are arranged in a technology graph. The LPPs specified are expected to exist in the graph rooted at the specified technology database. The function can be run on any variant of the process stack. It silently ignores any layers that are not present. Technology files on disk are not changed.

Arguments

tx_techfileLibName
	The technology file library name.
l_orderLpps	An ordered list of layer-purpose pairs to be drawn on the canvas. The list has the following syntax: list ( list( tx_layer tx_purpose n_priority) … ) where, tx_layer is the layer name or number. tx_purpose is the purpose name or number. n_priority is the priority in which the specified LPPs are drawn on the canvas.

Value Returned

t	The priority of LPPs was updated as specified.
nil	The technology database does not exist.

Example

Assume that the total LPPs in the effective technology database of topTech is 250 and that these LPPs are at the following positions:

• "Metal1" "drawing" is at 40.
• "Metal2" "drawing" is at 50.
• "Metal3" "drawing" is at 60.

The function is called as follows:

techOrderLPPriorityInContext("topTech"
    list(
     list("Metal1" "drawing" 1)
  list("Metal2" "drawing" 2)
  list("Metal3" "drawing" 3) 
  )
)

The positions are updated as follows:

• "Metal3" "drawing" is at the last position.
• "Metal2" "drawing" is at the second position from below.
• "Metal1" "drawing" is at the third position from below.

Return to top