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

lxAbutGetNeighbors

lxAbutGetNeighbors(
{ ld_instId | d_instId }
[ ?direction { 'up | 'down | 'left | 'right | 'horizontal | 'vertical | 'all } ]
[ ?depth { 0 ... INT_MAX } ]
[ ?stopGroup d_stopGroup ]
[ ?select { t | nil } ]
)
=> ld_instId / nil

Description

Returns the list of instance IDs found by traversing from an instance list, or an instance, through the associated abutment groups, in the supplied direction.

The traversal can be restricted by providing a maximum traversal depth. A value of 0 or nil indicates no restriction. If an abutment group object is supplied via the ?stopGroup argument, the group is not traversed. The ?select argument, when true, selects the returned instances.

Arguments

ld_instId | d_instId

List of instance IDs, or a single instance ID.

?direction

The direction in which the abutment groups are traversed.

The default is 'all.

?depth

Integer specifying the maximum depth of traversal. If set to 0 or nil, the traversal is unrestricted.

The default is 0.

?stopGroup d_stopGroup

Database ID of the abutment group object that should not be traversed.

?select

Selects the returned instances when set to t.

Value Returned

ld_instId

The list of abutted instances found.

nil

No abutted instances were found.

Example

lxAbutGetNeighbors( inst1 ?direction 'right ?depth 5 ?stopGroup group1 )

Return to top
 ⠀
X