noDetailedRowCol
cdba noDetailedRowCol boolean { t | nil }
Description
Determines the syntax of mosaic tile objects in the value returned by the dbGetTrueOverlaps SKILL function.
The default is nil, which means that dbGetTrueOverlaps generates a list of mosaic tiles if they are found in the search area and if the g_doRowCol argument is set to t. The list of mosaic tiles is generated using the following syntax, where the row and column indexes for the mosaics are also printed:
; case #1 flat design
(db:MOSAIC_ID
((db:MOSAIC_ID 0 0)
(db:MOSAIC_ID 0 1)
(db:MOSAIC_ID 1 0)
(db:MOSAIC_ID 1 1))
If mosaics are nested and multiple levels are queried (startLevel != stopLevel), the list syntax for the stop level when noDetailedRowCol is set to nil is:
; case #2 nested mosaics
(db:PARENT_MOSAIC_ID
((db:PARENT_MOSAIC_ID 0 0) db:CHILD_MOSAIC_ID)
(db:CHILD_MOSAIC_ID 0 0)
(db:CHILD_MOSAIC_ID 0 1)
(db:CHILD_MOSAIC_ID 1 0)
(db:CHILD_MOSAIC_ID 1 1)
((db:PARENT_MOSAIC_ID 0 1) db:CHILD_MOSAIC_ID)
(db:CHILD_MOSAIC_ID 0 0)
(db:CHILD_MOSAIC_ID 0 1)
(db:CHILD_MOSAIC_ID 1 0)
(db:CHILD_MOSAIC_ID 1 1)
((db:PARENT_MOSAIC_ID 1 0) db:CHILD_MOSAIC_ID)
(db:CHILD_MOSAIC_ID 0 0)
(db:CHILD_MOSAIC_ID 0 1)
(db:CHILD_MOSAIC_ID 1 0)
(db:CHILD_MOSAIC_ID 1 1)
((db:PARENT_MOSAIC_ID 1 1) db:CHILD_MOSAIC_ID)
(db:CHILD_MOSAIC_ID 0 0)
(db:CHILD_MOSAIC_ID 0 1)
(db:CHILD_MOSAIC_ID 1 0)
(db:CHILD_MOSAIC_ID 1 1)
)
When noDetailedRow is set to t, the dbGetTrueOverlaps SKILL function prints the result in the legacy format that does not print the row and column index for the mosaics in a flat design (case #1):
(db:MOSAIC_ID)
For nested mosaics, (case #2), the nested mosaic tiles are not printed if noDetailedRowCol is set to t:
(db:PARENT_MOSAIC_ID
((db:PARENT_MOSAIC_ID 0 0) db:CHILD_MOSAIC_ID)
((db:PARENT_MOSAIC_ID 0 1) db:CHILD_MOSAIC_ID)
((db:PARENT_MOSAIC_ID 1 0) db:CHILD_MOSAIC_ID)
((db:PARENT_MOSAIC_ID 1 1) db:CHILD_MOSAIC_ID)
)
GUI Equivalent
Examples
envGetVal("cdba" "noDetailedRowCol")
The following examples show how the output of the dbGetTrueOverlaps SKILL function changes based on how noDetailedRowCol environment variable is specified.
envSetVal("cdba" "noDetailedRowCol" 'boolean nil)
;case #1 Flat Design
> dbGetTrueOverlaps(cv cv~>bBox t 0 t)
(db:0x1909ce1a ; 2x2 top mosaic
(db:0x1909ce1a 0 0) ; 2x2 child mosaics
(db:0x1909ce1a 0 1)
(db:0x1909ce1a 1 0)
(db:0x1909ce1a 1 1)
)
; case #2 (nested mosaics)
> dbGetTrueOverlaps(cv cv~>bBox t 1 t)
(db:0x1909ce1a ; 2x2 top mosaic
((db:0x1909ce1a 0 0) db:0x1909cd9a) ; 2x2 child mosaic
(db:0x1909cd9a 0 0) ; 2x2 child mosaic tile
(db:0x1909cd9a 0 1)
(db:0x1909cd9a 1 0)
(db:0x1909cd9a 1 1)
((db:0x1909ce1a 0 1) db:0x1909cd9a) ; 2x2 child mosaic
(db:0x1909cd9a 0 0) ; 2x2 child mosaic tile
(db:0x1909cd9a 0 1)
(db:0x1909cd9a 1 0)
(db:0x1909cd9a 1 1)
((db:0x1909ce1a 1 0) db:0x1909cd9a) ; 2x2 child mosaic
(db:0x1909cd9a 0 0) ; 2x2 child mosaic tile
(db:0x1909cd9a 0 1)
(db:0x1909cd9a 1 0)
(db:0x1909cd9a 1 1)
((db:0x1909ce1a 1 1) db:0x1909cd9a) ; 2x2 child mosaic
(db:0x1909cd9a 0 0) ; 2x2 child mosaic tile
(db:0x1909cd9a 0 1)
(db:0x1909cd9a 1 0)
(db:0x1909cd9a 1 1)
)
envSetVal("cdba" "noDetailedRowCol" 'boolean t)
; case #1 flat design
> dbGetTrueOverlaps(cv cv~>bBox t 0 t)
(db:0x1909ce1a ; 2x2 top mosaic
)
; case #2 (nested mosaics)
> dbGetTrueOverlaps(cv cv~>bBox t 1 t)
(db:0x1909ce1a ; 2x2 top mosaic
((db:0x1909ce1a 0 0) db:0x1909cd9a) ; 2x2 child mosaics
((db:0x1909ce1a 0 1) db:0x1909cd9a)
((db:0x1909ce1a 1 0) db:0x1909cd9a)
((db:0x1909ce1a 1 1) db:0x1909cd9a)
)
Related Topics
Return to top