|
Action:
|
Gets the coedges from an entity or list of entities.
|
|
|
Filename:
|
kern/kern_scm/ent_scm.cxx
|
|
|
Syntax:
|
(entity:coedges entity-list [include-pat])
|
|
|
Arg Types:
|
entity-list
|
entity | (entity ... )
|
|
include-pat
|
integer
|
|
|
Returns:
|
(coedge ... )
|
|
|
Description:
|
This extension returns a list of all of the coedges from the entity or list of entities. If no coedges are found, this extension returns an empty list.
|
|
|
entity-list specifies an entity or an entity list.
|
|
|
include-pat is an optional argument that determines how this function deals with patterned objects. By default, patterned objects are included in the list of entities. The user may specify any one of the following through this argument:
|
|
|
0
|
patterned objects are created if they do not already exist, and are included in the list.
|
|
1
|
only those patterned objects that have already been created are included in the list.
|
|
2
|
no patterned objects besides seed pattern objects are included in the list.
|
|
|
Example:
|
; entity:coedges
|
|
; Create a solid block.
|
|
(define block1
|
|
|
(solid:block (position 0 0 0)
|
|
|
(position 10 10 10)))
|
|
;; block1
|
|
; Get a list of the block's coedges.
|
|
(entity:coedges block1)
|
|
;; (#[entity 3 1] #[entity 4 1] #[entity 5 1]
|
|
;; #[entity 6 1] #[entity 7 1] #[entity 8 1]
|
|
;; #[entity 9 1] #[entity 10 1] #[entity 11 1]
|
|
;; #[entity 12 1] #[entity 13 1] #[entity 14 1]
|
|
;; #[entity 15 1] #[entity 16 1] #[entity 17 1]
|
|
;; #[entity 18 1] #[entity 19 1] #[entity 20 1]
|
|
;; #[entity 21 1] #[entity 22 1] #[entity 23 1]
|
|
;; #[entity 24 1] #[entity 25 1] #[entity 26 1])
|