Product Documentation
Virtuoso Parameterized Cell SKILL Reference
Product Version IC23.1, August 2023

pcGetPathRefPoint

pcGetPathRefPoint(
d_cvId
l_objectVertices
l_pathVertices
t_endpoint
l_offset
)
=> l_newObjVertices / nil

Description

Creates a list of coordinates representing the object specified by the l_objectVertices argument when offset from the specified endpoint of the parameterized path, where the offset is defined by l_offset and the path is defined l_pathVertices.

Arguments

d_cvId

The database ID of the cellview containing the parameterized path.

l_objectVertices

List of coordinates determining the object that is offset from the parameterized path, in one of the following formats: list( '( x1 y1 ) '( x2 y2 ) ... '( xn yn ) )
list( x1:y1 x2:y2 ... xn:yn )

l_pathVertices

List of coordinates identifying the parameterized path, in one of the following formats: list( '( x1 y1 ) '( x2 y2 ) ... '( xn yn ) )
list( x1:y1 x2:y2 ... xn:yn )

t_endpoint

String specifying an endpoint of the parameterized path.

Valid Values: "first" or "last"

Default: none

l_offset

List specifying the distance by which the object is offset from the endpoint of the parameterized path, where the elements of the list are integers or floating-point numbers.

Valid Values: list of integers and/or floating-point numbers, or nil

Default: none

Value Returned

l_newObjVertices

List of coordinates specifying the object as located in relationship to the specified endpoint of the parameterized path, offset by the specified distance. The list is in the following format:

( (x y) (x y) ... (x y) )

where x and y can be an integer or floating-point number.

nil

The function did not complete successfully.

Examples

obj =  list( 4.0:1.0 5.0:1.0 5.0:2.5 6.5:2.5 6.5:-0.5 4.0:-0.5 )
path = list( 0:0 0:9 )
ref =  pcGetPathRefPoint( geGetEditCellView() obj path "last" nil )
    => (       (4.0 10.0)
                (5.0 10.0)
                (5.0 11.5)
                (6.5 11.5)
                (6.5 8.5)
                (4.0 8.5)
          )

The example specifies the original object with the variable obj and the parameterized path with the variable path. The pcGetPathRefPoint function then determines the new coordinates for the object in relationship to the last endpoint of the path, with no offset.


Return to top
 ⠀
X