API Reference > OdDb Classes > OdDb3dSolid Class > OdDb3dSolid Methods > OdDb3dSolid::copyFace Method
OdDb3dSolid::copyFace Method
Collapse All
Syntax
C++
virtual OdResult copyFace(const OdDbSubentId & subentId, OdDbEntityPtr & newEntity);
Parameters
Parameters 
Description 
const OdDbSubentId & subentId 
[in] Face's subentity ID in the solid.  
OdDbEntityPtr & newEntity 
[in] Reference to a new entity containing a copy of the specified face.
 
Returns

Returns eOk if successful or an appropriate error code in other case.

Description

Copies the specified face as a separate entity (OdDbRegion or otherwise will be OdDbBody). 

 

Remarks

If face is planar, an OdDbRegion entity is created. Otherwise an OdDbBody entity is created. The properties of the resulting entity (color, layer, line type, lineweight) are inherited from the corresponding current document. 

The calling application is responsible for the memory located with the resulting entity. If the resulting entity is not appended to a database, it can cause a memory leak (if it is not deleted when it isn't needed anymore). 

This method is implemented only for Spatial modeler and returns eNotImplementedYet status for other modelers.

Group
Copyright © 2002–2020. Open Design Alliance. All rights reserved.
Send feedback about this topic