lxCreateGroupArray
lxCreateGroupArray(
d_cvId
l_figList
[ ?name t_name ]
[ ?rows x_rows ]
[ ?columns x_cols ]
[ ?X x_xValue ]
[ ?Y x_yValue ]
[ ?orients l_orientList ]
[ ?mode 'pitch | 'spacing ]
[ ?lpp l_refLPP ]
)
=> d_groupArrayId / nil
Description
Creates a group array with the specified parameters.
Arguments
|
d_cvId
|
Database ID of the cellview in which the group array is to be created.
|
|
l_figList
|
List of figures for the first cell of the group array. Copies of the figures are repeated depending on the rows and columns specified for the group array.
|
|
?name t_name
|
Name of the group array.
|
|
?rows x_rows
|
Number of rows in the group array.
|
|
?columns x_cols
|
Number of columns in the group array.
|
|
?X x_xValue
|
Spacing added between cells of the group array in the X direction. Spacing is applied based on the mode specified.
|
|
?Y x_yValue
|
Spacing added between cells of the group array in the Y direction. Spacing is applied based on the mode specified.
|
|
?orients l_orientList
|
|
|
Orientation pattern used for the group array. If the pattern is smaller than the given rows and columns in the group array, the pattern is repeated from left to right and bottom to top. The bottom-most row in the pattern is considered as the first row.
|
|
?mode 'pitch | 'spacing
|
|
|
Mode used for applying spacing between group array cells. Valid values are 'pitch and 'spacing.
-
'
pitch: Lets you specify the distance that is measured between the same-edge corners of cells. For example, the distance between the left edges of two cells. -
'
spacing: Lets you specify the distance that is measured between the adjacent or closest edges of cells. For example, the distance between the top edge of a cell and the lower edge of another cell.
|
|
?lpp l_refLPP
|
Specifies the layer-purpose pair used for computing the bounding box of the cells in a group array. The combined bounding box of the geometries on the specified reference layer-purpose pair is used for calculating the spacing between cells.
|
Value Returned
|
d_groupArrayId
|
Database ID of the group array upon successful creation.
|
|
nil
|
The group array could not be created.
|
Example
The following code creates a rectangle in the current cellview and saves its database ID in rect. Then, the rectangle is used to create a 2x2 group array named myGroupArray with the specified parameters. After the group array is created, 0x2ab9941a is returned as its database ID and is saved in groupArray1.
cv=geGetEditCellView()
rect = dbCreateRect(cv list("Poly" "drawing") list(list(-5 0) list(0 5)))
groupArray1=lxCreateGroupArray(cv list(rect) ?name "myGroupArray" ?rows 2 ?columns 2 ?X 2 ?Y 3 ?orients list("R0") ?mode 'spacing ?lpp list("Poly" "drawing"))
==> 0x2ab9941a
Related Topics
Group Arrays
Group Array SKILL Functions
Return to top
