mptMarkersToMaskColors

mptMarkersToMaskColors(
l_purposes 
g_drawingPurpose 
d_cellViewID 
[ g_locked ]
[ g_removeMarker ]
[ g_recolorAll ]
[ g_save ]
)
=> t / nil

Description

Transforms the shapes in the given cellview to the drawing purpose and assigns color to each shape based on its original marker purpose. This function works hierarchically on a layout. By default, the assigned color is locked and the marker purpose shapes are removed.

Arguments

l_purposes	The list of one or more purposes for mask1Color, mask2Color, mask3Color, and mask4Color markers, in that order.
g_drawingPurpose	The purpose of the drawing layer.
d_cellViewID	The database ID of the cellview on which the marker to mask color translation is to be performed hierarchically.
g_locked	Specifies whether the color state is locked on the shapes that are transformed by this function. Valid values: t or nil. The default is t.
g_removeMarker	Specifies whether the marker purpose shapes are removed by this function. Valid values: t or nil. The default is t.
g_recolorAll	Specifies whether all the cellviews are recolored by this function. Valid values: t or nil. The default is t.
g_save	Specifies whether all the modified cellviews in the hierarchy are saved automatically. Valid values: t or nil. The default is nil.

Values Returned

t	The color information for the shapes is transformed.
nil	The color information for the shapes is not transformed.

Example

mptMarkersToMaskColors( list( "boundary" "fill" "hole" ) "drawing" geGetEditCellView() )

Transforms the shapes in the current edit cellview on boundary, fill, and hole purposes to the drawing purpose and assigns them mask1Color, mask2Color, and mask3Color, respectively. The color state for the transformed shapes is locked and the marker purpose shapes are removed.

mptMarkersToMaskColors( list( "boundary" "hole" ) "drawing" geGetEditCellView() nil nil)

Transforms the shapes in the current edit cellview on boundary and hole purposes to the drawing purpose and assigns them mask1Color and mask2Color, respectively. The color state for the transformed shapes is unlocked and the marker purpose shapes are not removed.

Return to top