Data Structures

struct  A3DPhysicalPropertiesData
 Physical property settings. More...
 

Functions

A3DStatus A3DComputeFaceArea (const A3DTopoFace *pFace, const A3DTopoContext *pBrepDataTopoContext, A3DDouble *pArea)
 Function to compute the surface of the current A3DTopoFace. The current TopoContext is needed in order to get the correct current scale. More...
 
A3DStatus A3DComputeModelFilePhysicalProperties (const A3DAsmModelFile *p, A3DPhysicalPropertiesData *psPhysicalProperties)
 Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a modelfile, typically an assembly. Data is returned in the modelfile unit, without density. More...
 
A3DStatus A3DComputePhysicalProperties (const A3DRiBrepModel *p, const A3DVector3dData *psScale, A3DPhysicalPropertiesData *psPhysicalPropertiesData)
 Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a BrepModel. More...
 
A3DStatus A3DComputePolyBrepPhysicalProperties (const A3DRiPolyBrepModel *p, const A3DVector3dData *psScale, A3DPhysicalPropertiesData *psPhysicalPropertiesData)
 Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a PolyBrepModel. An optional scale, psScale, can be used. It can be either uniform or not. Physical properties will be computed after having scaled the geometrical data in the A3DRiPolyBrepModel. More...
 

Detailed Description

Version
5.2

Function Documentation

◆ A3DComputePhysicalProperties()

A3DStatus A3DComputePhysicalProperties ( const A3DRiBrepModel p,
const A3DVector3dData psScale,
A3DPhysicalPropertiesData psPhysicalPropertiesData 
)

Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a BrepModel.

To obtain the values in the unit of the model file, pass the scaling of the B-rep in the psScale parameter.

Note that since 11.2, the input psPhysicalPropertiesData structure now has a couple of input parameters with which precision can be adjusted, in addition to the new return values.

The value of psScale should be the cumulative scaling that results from traversing the assembly tree from the root to the designated B-rep, multiplying the scaling of the current node by the cumulative scaling of all of its parent nodes.

The inertia matrices are provided relative to the computed gravity centers, with respect to the global X, Y and Z directions.

Parameters
[in]pThe input B-rep model.
[in]psScaleThe optional scale.
[out]psPhysicalPropertiesDataThe computed physical properties.
Returns
A3D_SUCCESS
A3D_INITIALIZE_NOT_CALLED
A3D_INVALID_ENTITY_NULL
A3D_INVALID_ENTITY_TYPE
A3D_RI_BREPMODEL_CANNOT_ACCESS_GEOMETRY
A3D_TOOLS_COMPUTE_UV_FAILURE
A3D_ERROR
A3D_INCOMPATIBLE_FUNCTION_WITH_KEEP_PARSED_ENTITY_MODE
A3D_TOOLS_TESSELLATION_ISSUE
A3D_TOOLS_PHYSICALPROPERTIES_FAILURE
Version
5.2

◆ A3DComputeFaceArea()

A3DStatus A3DComputeFaceArea ( const A3DTopoFace pFace,
const A3DTopoContext pBrepDataTopoContext,
A3DDouble pArea 
)

Function to compute the surface of the current A3DTopoFace. The current TopoContext is needed in order to get the correct current scale.

Parameters
[in]pFaceThe input A3DTopoFace.
[in]pBrepDataTopoContextThe corresponding A3DTopoContext of the current A3DTopoBrepData who is owing the A3DTopoFace.
[out]pAreaThe surface of the A3DTopoFace in the current unit.
Returns
A3D_SUCCESS
A3D_INVALID_ENTITY_TYPE
A3D_INVALID_ENTITY_NULL
A3D_INITIALIZE_NOT_CALLED
A3D_ERROR
A3D_TOOLS_TESSELLATION_ISSUE
Version
7.0

◆ A3DComputePolyBrepPhysicalProperties()

A3DStatus A3DComputePolyBrepPhysicalProperties ( const A3DRiPolyBrepModel p,
const A3DVector3dData psScale,
A3DPhysicalPropertiesData psPhysicalPropertiesData 
)

Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a PolyBrepModel. An optional scale, psScale, can be used. It can be either uniform or not. Physical properties will be computed after having scaled the geometrical data in the A3DRiPolyBrepModel.

Note that since 11.2, the input psPhysicalPropertiesData structure now has a couple of input parameters with which precision can be adjusted, in addition to the new return values.

The inertia matrices are provided relative to the computed gravity centers, with respect to the global X, Y and Z directions.

Parameters
[in]pThe input poly B-rep model.
[in]psScaleThe optional scale.
[out]psPhysicalPropertiesDataThe wanted physical properties.
Returns
A3D_SUCCESS
A3D_INVALID_ENTITY_TYPE
A3D_INVALID_ENTITY_NULL
A3D_INITIALIZE_NOT_CALLED
A3D_ERROR
A3D_INCOMPATIBLE_FUNCTION_WITH_KEEP_PARSED_ENTITY_MODE
A3D_TOOLS_TESSELLATION_ISSUE
A3D_TOOLS_PHYSICALPROPERTIES_FAILURE
Version
6.1

◆ A3DComputeModelFilePhysicalProperties()

A3DStatus A3DComputeModelFilePhysicalProperties ( const A3DAsmModelFile p,
A3DPhysicalPropertiesData psPhysicalProperties 
)

Function to compute the physical properties (surface area, volume and gravity center, and since 11.2 the surfacic gravity center and the surfacic and volumic inertia matrix) of a modelfile, typically an assembly. Data is returned in the modelfile unit, without density.

Note that since 11.2, the input psPhysicalPropertiesData structure now has a couple of input parameters with which precision can be adjusted, in addition to the new return values.

The inertia matrices are provided relative to the computed gravity centers, with respect to the global X, Y and Z directions. The return values are provided in the modelfile's unit. The surfacic quantities take into account all representation items, whereas the ones for which the volume was not computed will not be used for the volumic quantities. Note that density is not taken into account. Return values are purely volumic or surfacic. For models with a constant density different than 1 unit of weight per unit of volume, results must be adjusted: matrices must be multiplied by the density of the input CAD file.

Parameters
[in]pThe input modelfile.
[out]psPhysicalPropertiesThe physical properties.
Returns
A3D_SUCCESS
A3D_INITIALIZE_NOT_CALLED
A3D_INVALID_ENTITY_NULL
A3D_RI_BREPMODEL_CANNOT_ACCESS_GEOMETRY
A3D_TOOLS_COMPUTE_UV_FAILURE
A3D_ERROR
A3D_INCOMPATIBLE_FUNCTION_WITH_KEEP_PARSED_ENTITY_MODE
A3D_TOOLS_TESSELLATION_ISSUE
A3D_TOOLS_PHYSICALPROPERTIES_FAILURE
Version
5.2