geWindowToEditPoint

geWindowToEditPoint( 
w_windowId 
l_windowCellViewPoint 
) 
=> l_editCellViewPoint

Description

Translates coordinate values when you are using edit in place. geWindowToEditPoint applies the top-level cellview’s coordinates to the cellview being edited; geEditToWindowPoint does the reverse.

All SKILL functions apply to the cellview being edited in the current window. When you are editing in place, this cellview is not the same one as the top-level cellview being displayed in the window. Coordinate values passed to SKILL functions are always expressed with respect to the cellview being displayed, even when you are editing in place. Database access inquiries, however, always return coordinate values in terms of the coordinate system of the cellview being interrogated, regardless of the context that cellview is used in.

The role of geWindowToEditPoint and geEditToWindowPoint is to translate between the two coordinate systems.

geWindowToEditPoint expects an argument consisting of a coordinate pair list. It interprets the coordinates with respect to the coordinate system of the current edit-cellview and returns the corresponding list, taking all intermediate locations and transformations into account.

geWindowToEditPoint function performs the translation in the opposite direction. Given a coordinate pair list, it interprets the coordinates with respect to the window-cellview and returns the corresponding list expressed in terms of the edit-cellview’s coordinate system. You can use this function, for example, to determine where an object placed at a given location in the window-cellview is situated in the edit-cellview.

Arguments

w_windowId	Database ID of the window containing the cellview being edited.
l_windowCellviewPoint
	Coordinate pair expressed in window-cellview units (`geWindowToEditPoint`).

Value Returned

l_editCellViewPoint
	Coordinate pair expressed in edit-cellview units (`geWindowToEditPoint`).

Examples

Assume you are editing in place an instance placed at 12.5:10.25.

geWindowToEditPoint(window(4) 12.5:10.25)

Returns 0:0, because this is the origin of the instance.

geEditToWindowPoint( window(4) 0:0 )

Returns 12.5:10.25.

Virtuoso Studio Design Environment SKILL Reference
Product Version IC23.1, November 2023