A3DCopyAndAdaptBrepModel
-
A3DStatus
A3DCopyAndAdaptBrepModel(const A3DEntity *p, const A3DCopyAndAdaptBrepModelData *psSetting, A3DEntity **const pp) A3DStatusA3DCopyAndAdaptBrepModel(constA3DEntity* p, constA3DCopyAndAdaptBrepModelData* psSetting,A3DEntity** pp)Copy and adapt B-rep parameters.
The B-rep used by HOOPS Exchange may not be completely compatible with modeling systems that do not support the full range of B-rep as employed by PRC. This function attempts to convert PRC B-rep into a format that is compatible with your system.
In order to use this function, you create an
A3DCopyAndAdaptBrepModelDatastructure and configure it to create a new B-rep model using entities you are able to support. The function can transform predetermined surface types and curves to NURBS. It also can process parametric curves and 3D curves, as well as split periodic parametric surfaces.A3DCopyAndAdaptBrepModel()creates a new, independent B-rep model. To free the allocated memory, the model must be manually deleted by callingA3DEntityDelete()after use. If the new B-rep model is inserted into an existing model tree, however, ownership is transferred to the model tree and explicit deletion of the model is no longer required.A3DCopyAndAdaptBrepModelwill perform the following steps:For each face, the bearing surface and the 3D curves are converted
Surfaces are reduced in size
Cross-period UV curves are deleted if necessary
Faces are split at periodic seams and/or mid-parameter for closed surfaces
Final UV curves are computed
A second surface shrink is performed with new UV parameters
Final 3D curves are computed
When the function A3DCopyAndAdaptBrepModel returns an error, you may try to set the parameters m_bSplitFaces and/or m_bForceComputeUV to ‘false’ and retry the conversion.
Return Values
A3D_BREPDATA_CANNOT_GETBOUNDINGBOX: if the bounding box could not be computed
A3D_COEDGE_BAD_ORIENTATION_DATA: if input coedge orientation data is incorrect
A3D_CRV_INVALID_PARAMETER: if
psSetting->m_puiAcceptableCurvescontains a value that is not a supportedkA3DTypeCrv*typeA3D_ERROR: on a general, unclassified error
A3D_EXCEPTION: if an exception was caught during processing
A3D_INCOMPATIBLE_FUNCTION_WITH_KEEP_PARSED_ENTITY_MODE: if the input was read in Keep Parsed Entities mode, which is not supported by this function
A3D_INITIALIZE_BAD_VALUES: if initialization led to bad internal values for globals; this is a fatal error requiring the program to be reinitialized
A3D_INITIALIZE_NOT_CALLED: if the library has not been initialized via
A3DDllInitializeA3D_INVALID_ENTITY_NULL: if
porppis nullA3D_INVALID_ENTITY_TYPE: if
pis of an invalid entity typeA3D_INVALID_LICENSE: if the current license does not allow this function
A3D_LOOP_BAD_ORIENTATION_DATA: if input loop orientation data is incorrect
A3D_NOT_IMPLEMENTED: if the requested operation is not yet implemented
A3D_SHELL_BAD_ORIENTATION_DATA: if input shell orientation data is incorrect
A3D_SRF_INVALID_PARAMETERS: if
psSetting->m_puiAcceptableSurfacescontains a value that is not a supportedkA3DTypeSurf*typeA3D_SUCCESS: returned on success
A3D_TOOLS_COMPUTE_3D_FAILURE: if computing a 3D space curve fails
A3D_TOOLS_COMPUTE_UV_FAILURE: if computing a space parametric (UV) curve fails
A3D_TOOLS_NURBSCONVERT_3D_FAILURE: if converting a 3D space curve fails
A3D_TOOLS_NURBSCONVERT_GENERAL_FAILURE: on a general, unclassified NURBS conversion failure
A3D_TOOLS_NURBSCONVERT_SURFACE_FAILURE: if converting a surface to NURBS fails
A3D_TOOLS_NURBSCONVERT_UV_FAILURE: if converting a space parametric (UV) curve fails
A3D_TOOLS_SPLIT_FAILURE: if splitting a surface at a seam fails
A3D_TOPO_CONSISTENCY: if the input topology has a consistency problem
A3D_TOPO_GEOMETRY_MISSING: if the input topology is missing geometry
A3D_TOPO_NON_CONNEX_SHELL: if a shell in the input topology is non-connex
A3D_TOPO_OPEN_SOLID: if the input solid is invalid, containing edges without neighbors
A3D_TOPO_VERTICES_MISSING: if the input topology is missing vertices
A3D_TOPO_WRONG_TOLERANCES: if tolerances on edges, vertices, or faces are invalid or inconsistent
Parameters
p: A pointer to the source B-rep entity
psSetting: The structure that defines which types of B-rep you would like to convert to
pp: A pointer to the result B-rep entity or entities
Returns
A3D_SUCCESSon success, or an error code on failure