std-getpt


Synopsis

(std-getpt <ele>)

Description

Returns the first point or the definition point of the entity. This is NOT the same as (STD-GETVAL 10 ele) for some elements.

For a POLYLINE or LWPOLYLINE it returns the first vertex, to return the group code 10 of the main entity of POLYLINE use (STD-GETVAL 10 ele) instead.

For an ARC it returns the arc startpoint, and not the center.

For all other entities it returns the value of the dxf group code 10, the definition point.

It may be used with entity types, entget-lists or entsel picklists.

Note

The implementation calls STD-ENTGET on ename or entsel arguments which uses an entget caching mechanism, because ENTGET is usually slow. But this speed gain may fool return values on deleted entities.

Arguments

ele: Either an entity type, entget-list or entsel picklist.

Return Value

Either a 3D point or nil.

Side Effects

None. It may set an internal *ENTGET-CACHE* symbol, but direct access is forbidden.

Module

(std-require 'STDENT)

Defined in STDENT