Action:
|
Returns the index of the given entity as listed in debug output.
|
|
Filename:
|
kern/kern_scm/dbg_scm.cxx
|
|
Syntax:
|
(entity:dindex given-entity [containing-entity])
|
|
Arg Types:
|
given-entity
|
entity
|
|
containing-entity
|
entity
|
|
Returns:
|
integer | boolean
|
|
Description:
|
Returns the index of the given entity as listed in debug output when the containing entity is debugged.
|
|
|
When a given containing entity does not actually contain the given entity, FALSE is returned.
|
|
|
given-entity specifies the entity whose index has to be returned.
|
|
|
containing-entity specifies the entity that contains the
given-entity. If no containing entity is given, the top level owner of the
given-entity is used.
|
|
Example:
|
; entity:dindex
|
|
; Create a block and get its index value.
|
|
(define b (solid:block
|
|
|
(position -10 -10 -10) (position 10 10 10)))
|
|
;; b
|
|
(entity:dindex (pick:face (ray (position 0 0 0)
|
|
|
(gvector 1 0 0))))
|
|
;; 5
|