Load Module

Types

	A3DRWParamsGeneralData
	A3DRWParamsPmiData
	A3DRWParamsTessellationData
	A3DRWParamsSearchDirData
	A3DRWParamsAssemblyData
	A3DRWParamsMultiEntriesData
	A3DRWParamsCatiaV4Data
	A3DRWParamsCatiaV5Data
	A3DRWParamsUnigraphicsData
	A3DRWParamsProEData
	A3DRWValidationPropertiesThresholdData
	A3DRWParamsStepData
	A3DRWParamsIGESData
	A3DRWParamsIFCData
	A3DRWParamsJTData
	A3DRWParamsParasolidData
	A3DRWParamsSolidworksData
	A3DRWParamsInventorData
	A3DRWParamsRhinoData
	A3DRWParamsRevitData
	A3DRWParamsSolidEdgeData
	A3DRWParamsSpecificLoadData
	A3DRWParamsIncrementalLoadData
	A3DRWParamsLoadData
	A3DStream3DPDFData
	`A3DEReadGeomTessMode`
	`A3DEUnits`
	`A3DETessellationLevelOfDetail`
	`A3DProESessionColorType`
	`A3DProEReadConstructEntities`
	`A3DProEFamilyTables`
	`A3DEStepNameFromNAUO`
	`A3DEJTReadTessellationLevelOfDetail`
	`EA3DRevitPhysicalProperties`
	`EA3DRevitLinks`
	`EA3DRevitMultiThreadedMode`
	`A3DERevitLevelOfDetail`

Fields

	`kA3DReadGeomOnly`
	`kA3DReadGeomAndTess`
	`kA3DReadTessOnly`
	`kA3DUnitPoint`
	`kA3DUnitInch`
	`kA3DUnitMillimeter`
	`kA3DUnitCentimeter`
	`kA3DUnitPicas`
	`kA3DUnitFoot`
	`kA3DUnitYard`
	`kA3DUnitMeter`
	`kA3DUnitKilometer`
	`kA3DUnitMile`
	`kA3DUnitMicroInch`
	`kA3DUnitMil`
	`kA3DUnitAngstrom`
	`kA3DUnitNanometer`
	`kA3DUnitMicron`
	`kA3DUnitDecimeter`
	`kA3DUnitDekameter`
	`kA3DUnitHectometer`
	`kA3DUnitGigameter`
	`kA3DUnitAstronomical`
	`kA3DUnitLightYear`
	`kA3DUnitParsec`
	`kA3DUnitUSSurveyFoot`
	`kA3DUnitUSSurveyInch`
	`kA3DUnitUSSurveyYard`
	`kA3DUnitUSSurveyMile`
	`kA3DUnitUnknown`
	`kA3DTessLODExtraLow`
	`kA3DTessLODLow`
	`kA3DTessLODMedium`
	`kA3DTessLODHigh`
	`kA3DTessLODExtraHigh`
	`kA3DTessLODUserDefined`
	`kA3DTessLODControlledPrecision`
	`kA3DLastCreoVersionSessionColor`
	`kA3DHExchangeSessionColor`
	`kA3DFileVersionSessionColor`
	`A3DProEReadConstructEntities_AsDatum`
	`A3DProEReadConstructEntities_Yes`
	`A3DProEReadConstructEntities_No`
	`A3DProEFamTabAcceleratorFileOnly`
	`A3DProEFamTabOrUseTessellation`
	`A3DProEFamTabOrUseWireAndGeneric`
	`kA3DStepNameFromNAUO_ID`
	`kA3DStepNameFromNAUO_NAME`
	`kA3DStepNameFromNAUO_DESCRIPTION`
	`kA3DJTTessLODLow`
	`kA3DJTTessLODMedium`
	`kA3DJTTessLODHigh`
	`kA3DRevitPhysicalProperties_NotComputed`
	`kA3DRevitPhysicalProperties_Computed`
	`kA3DRevitLinks_LoadAll`
	`kA3DRevitLinks_IgnoreAll`
	`kA3DRevitLinks_IgnoreRevit`
	`kA3DRevitLinks_IgnoreDwg`
	`kA3DRevitLinks_IgnoreIFC`
	`kA3DRevitMultiThreadedMode_Disabled`
	`kA3DRevitMultiThreadedMode_LoadingEnabled`
	`kA3DRevitMultiThreadedMode_RegenerationEnabled`
	`kA3DRevitMultiThreadedMode_LoadingAndRegenerationEnabled`
	`kA3DRevitLODDefault`
	`kA3DRevitLODCoarse`
	`kA3DRevitLODMedium`
	`kA3DRevitLODFine`

Functions

`A3DStatus`	`A3DAsmModelFileLoadFromFile`
`A3DStatus`	`A3DAsmModelFileLoadFromPrcStream`
`A3DVoid`	`A3DRWParamsPrcReadHelperFree`
`A3DStatus`	`A3DAsmModelFileLoadFromPrcFile`
`A3DStatus`	`A3DGet3DPDFStreams`
`A3DStatus`	`A3DPDFGetStreams`

Detailed Description

group a3d_read: Loads the model file with information from the input CAD file.

Type Documentation

enum A3DEReadGeomTessMode

A3DSDKReadWrite.

ReadingMode of the model file. Set which kind of content should be read.

Version: 3.0

Values:

enumerator kA3DReadGeomOnly: In this mode, Exchange will avoid reading or generating tessellation on B-rep. Faceted elements from the native file will still be imported.

enumerator kA3DReadGeomAndTess: Mixed mode: In this mode, the B-rep and faceted elements are read from the native file. Tessellation is then generated from B-rep elements.

enumerator kA3DReadTessOnly

In this mode, all faceted elements from the native file are read. If present, the native tessellation of the B-rep is read exclusively. Native tessellation is the display list integrated in the CAD file (only available for CATIA V5, Solidworks, 3DXML, and Inventor).

There are some side effects: The tessellation may be not up-to-date with the geometry, the assembly tree can be different, and hidden objects may be missed.

If an element contains only B-rep, tessellation is generated from the B-rep and subsequently the B-rep is removed to save memory.

enum A3DEUnits

Unit used in the model file.

Version: 3.0

Values:

enumerator kA3DUnitPoint: Point.

enumerator kA3DUnitInch: Inch.

enumerator kA3DUnitMillimeter: Millimeter.

enumerator kA3DUnitCentimeter: Centimeter.

enumerator kA3DUnitPicas: Picas.

enumerator kA3DUnitFoot: Foot.

enumerator kA3DUnitYard: Yard.

enumerator kA3DUnitMeter: Meter.

enumerator kA3DUnitKilometer: Kilometer.

enumerator kA3DUnitMile: Mile.

enumerator kA3DUnitMicroInch: Micro Inch.

enumerator kA3DUnitMil: Mil.

enumerator kA3DUnitAngstrom: Angstrom.

enumerator kA3DUnitNanometer: Nanometer.

enumerator kA3DUnitMicron: Micron.

enumerator kA3DUnitDecimeter: Decimeter.

enumerator kA3DUnitDekameter: Dekameter.

enumerator kA3DUnitHectometer: Hectometer.

enumerator kA3DUnitGigameter: Gigameter.

enumerator kA3DUnitAstronomical: Astronomical.

enumerator kA3DUnitLightYear: Light year.

enumerator kA3DUnitParsec: Parsec.

enumerator kA3DUnitUSSurveyFoot: US Survey foot.

enumerator kA3DUnitUSSurveyInch: US survey inch.

enumerator kA3DUnitUSSurveyYard: US survey yard.

enumerator kA3DUnitUSSurveyMile: US survey mile.

enumerator kA3DUnitUnknown: Unknown.

enum A3DETessellationLevelOfDetail

Structure to specify the level of detail of the tessellation.

See A3DRWParamsTessellationData parameters. When a level is given, the Chord Height Ratio (A3DRWParamsTessellationData::m_dChordHeightRatio) and Wireframe Chord Angle (A3DRWParamsTessellationData::m_dAngleToleranceDeg) change to preset values for the selected level.

Version: 3.0

Values:

enumerator kA3DTessLODExtraLow

Extra Low level: when selected, these members are automatically defined with the following values:

enumerator kA3DTessLODLow

Low level: when selected, these members are automatically defined with the following values:

enumerator kA3DTessLODMedium

Medium level: when selected, these members are automatically defined with the following values:

enumerator kA3DTessLODHigh

High level: when selected, these members are automatically defined with the following values:

enumerator kA3DTessLODExtraHigh

Extra High level: when selected, these members are automatically defined with the following values:

enumerator kA3DTessLODUserDefined

User Defined level: when selected, these members should be defined:

A3DRWParamsTessellationData::m_dChordHeightRatio if A3DRWParamsTessellationData::m_bUseHeightInsteadOfRatio is set to false,
A3DRWParamsTessellationData::m_dMaxChordHeight if A3DRWParamsTessellationData::m_bUseHeightInsteadOfRatio is set to true,
A3DRWParamsTessellationData::m_dAngleToleranceDeg. Be very careful when using A3DRWParamsTessellationData::m_dMaxChordHeight because a too small value would generate a huge tessellation.

enumerator kA3DTessLODControlledPrecision

Controlled Precision level: when selected, these members should be defined:

A3DRWParamsTessellationData::m_dAngleToleranceDeg,
A3DRWParamsTessellationData::m_dMaxChordHeight,
A3DRWParamsTessellationData::m_dMinimalTriangleAngleDeg.

Deprecated:

This is a deprecated feature.

enum A3DProESessionColorType

Used to control the default PMI color: If you load a Wildfire file and set kA3DFileVersionSessionColor to:

kA3DFileVersionSessionColor, the PMI with no color will be displayed in yellow;
kA3DLastCreoVersionSessionColor, the PMI with no color will be displayed in blue as in Creo 2 (for HOOPS Exchange 6.0);
kA3DHExchangeSessionColor, the PMI with no color will be displayed with the color you chose.

Version
6.1

Values:

enumerator kA3DLastCreoVersionSessionColor: Sets the default session color corresponding to the last version of Creo that HOOPS Exchange supports.

enumerator kA3DHExchangeSessionColor: Uses HOOPS Exchange default color.

enumerator kA3DFileVersionSessionColor: Lets the user define the color by using graphics parameters options ( A3DRWParamsPmiData::m_sDefaultColor).

enum A3DProEReadConstructEntities

Used to control the construction entities reading, entity such as sketch, curves…

Version: 8.2

Values:

enumerator A3DProEReadConstructEntities_AsDatum: Read wire according to the datum reading option

enumerator A3DProEReadConstructEntities_Yes: Read wire

enumerator A3DProEReadConstructEntities_No: Do not read wire

enum A3DProEFamilyTables

Used to select how to read family tables.

Version: 9.0

Values:

enumerator A3DProEFamTabAcceleratorFileOnly: Only use accelerator file. If there’s tessellation or a generic part, these will not be loaded, even if an accelerator file isn’t available.

enumerator A3DProEFamTabOrUseTessellation: If the accelerator file isn’t present, then search for the tessellation representation: if found, then use the tessellation. If an accelerator file or tessellation isn’t available, then nothing will be loaded.

enumerator A3DProEFamTabOrUseWireAndGeneric: If neither the accelerator file nor the tessellation representation is present, then use the generic or wire representation.

Warning

If using the generic or wire representation, be aware that the representation will not be what it should be! A generic part/wire is only a placeholder.

enum A3DEStepNameFromNAUO

Used to select which name to use from NEXT_ASSEMBLY_USAGE_OCCURRENCE as occurrence name.

Function Documentation

A3DStatus A3DAsmModelFileLoadFromFile(const A3DUTF8Char *pcFileName, const A3DRWParamsLoadData *pLoadParametersData, A3DAsmModelFile **ppModelFile)

Loads an A3DAsmModelFile from a physical file, returning a handle to the new model file.

Successfully calling this function will always create a new model file, even if the call is made several times with the same input path. Once loaded, a handle to the new model file is stored in ppModelFile and you can query its content with A3DAsmModelFileGet.

A3DRWParamsLoadData parameters;
A3D_INITIALIZE_DATA(A3DRWParamsLoadData, parameters);
A3DAsmModelFile* model_file = 0;

A3DStatus result = A3DAsmModelFileLoadFromFile("/path/to/file.stl", &parameters, &model_file);

assert(result == A3D_SUCCESS);
assert(model_file != 0);