Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

lceShortLocatorChaseAndSave

lceShortLocatorChaseAndSave(
d_winID
g_shapes
g_hierStart
t_viewName
)
=> t / nil

Description

Chases islands from the specified start shapes and saves them along with the shortest paths between their points of stickiness.

Arguments

d_winID

ID of the layout window in which you want the function to operate.

g_shapes

List of start shapes that are either in the current edited cellview or in the hierarchy that define the start from where the points of stickiness are chased and saved along their shortest path.

g_hierStart

Hierarchical start level at which the points of stickiness are chased. Any start shapes that are above the specified hierarchical level are ignored during the chase.

t_viewName

A string that represents the saved view name.

The library and cell name are the same as the current edited cellview.

Value Returned

t

At least one shape was saved in the specified view.

nil

No shape could be saved.

Examples

Example 1

winId = hiGetCurrentWindow()
geSelectPoint(winId 2:2.5)
r1 = css()
lceShortLocatorChaseAndSave(winId list(r1) 0 "shortLocator")

Chases islands from the specified top-level shape and saves the chased view as shortlocator.

Example 2

cv = geGetEditCellView(winId)
i0 = dbFindAnyInstByName(cv "i0")
r2 = nth(2 i0~>master~>shapes)
lceShortLocatorChaseAndSave(winLay list(r1 list(r2 list(i0))) 0 "shortLocator")

Chases islands from the specified shapes, r1 at top level and r2 in instance i0, and saves the chased view as shortlocator.

Example 3

m0 = dbFindAnyInstByName(i0~>master "M0")
r3 = nth(7 m0~>master~>shapes)
lceShortLocatorChaseAndSave(winLay list(r1 list(r2 list(i0)) list(r3 list(i0 list(m0 0 1)))) 0 "shortLocator")

Chases islands from the specified shapes, r1 at top level, r2 in instance i0, r3 in the tile 0:1 of mosaic i0.m0, and saves the chased view as shortlocator.


Return to top
 ⠀
X