Action:
|
Gets a list of tvertices from an entity or list of entities.
|
|
Filename:
|
kern/kern_scm/ent_scm.cxx
|
|
APIs:
|
api_get_tvertices
|
|
Syntax:
|
(entity:tvertices entity-list [include-pat])
|
|
Arg Types:
|
entity-list
|
entity | (entity ... )
|
|
include-pat
|
integer
|
|
Returns:
|
(tvertex ... )
|
|
Description:
|
This extension returns a list of all of the tvertices from the entity or list of entities. If no tvertices are found, this extension returns an empty list.
|
|
|
entity-list specifies an entity or an entity list.
|
|
|
The parameter
include-pat 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:tvertices
|
|
; Create a block
|
|
(define block (solid:block (position -10 -10 -10)
|
|
|
(position 10 10 10)))
|
|
;; block
|
|
(iso)
|
|
;; #[view 1049018]
|
|
(zoom-all)
|
|
;; #[view 1049018]
|
|
; display the block's edges and make one tolerant
|
|
(view:edges #t)
|
|
;; #[view 1049018]
|
|
(define block_edges (entity:edges block))
|
|
;; block_edges
|
|
(define tol_edge (list-ref block_edges 0))
|
|
;; tol_edge
|
|
(entity:set-color tol_edge 3)
|
|
;; ()
|
|
; get the tolerant coedge, edge, and vertices
|
|
(entity:tcoedges block)
|
|
;; ()
|
|
(entity:tedges block)
|
|
;; ()
|
|
(entity:tvertices block)
|
|
;; ()
|