ISurfacePointKC Interface
- GetPoint
- GetItem
- Offset
ISurfacePointKC gives access to SurfacePoint objects, which represents a point on
surface of any object. In addition to coordinates of the point SurfacePoint
contains information about the object, which owns the surface and extended
information about the surface around the point.
At the time of introduction of this interface in v31 ISurfacePointKC is returned
form IPick.GetSurfacePointAt used
mainly as an abstract dispatch interface, from which more specific interfaces,
related to specific type of surface can be queried. IMeshPointKC is the main specification
of SurfacePoint
HRESULT GetPoint( DIPoint* point )
point- [out] 3D Coordinates of the
point
- Remarks:
Returns 3D coordinates of the point. In most cases coordinates are relative to
the local frame of the entity (object) which owns the mesh
HRESULT GetItem( IItem** item )
- Remarks:
Returns IItem implemented by the object on surface
of which the point lies. Query ISection from
IItem to get extended information related to the object
HRESULT Offset(double offset)
If the point belongs to a surface, it will be offset by the specified distance (can be negative) along the normal at the point
or the average of normals when there are several (corner or edge). The call is ignored if the point does not belong to any surface.
The entity reference and other related information will remain unchanged (Only coordinates of the point are modified) despite
the offset point geometrically will not belong to the surface anymore. This means that strictly speaking the point will be invalid and should be discarded as soon as possible
|