IFXAuthorGeomCompiler

The IFXAuthorGeomCompiler interface simplifies the creation of Shockwave 3D§ model resources by taking mesh geometry data and producing fully-populated model resources. The AuthorGeomCompiler manages mesh conversion (see IFXMeshCompiler), multiresolution mesh generation, vertex re-mapping, streaming re-ordering, and model resource construction. The resulting model resource contains high performance, material partitioned, vertex-array aligned mesh representations (see IFXMesh) as well as multiresolution update records (see IFXUpdates) for continuous and dynamic level of detail. All geometry data that has been compiled is ordered and ready for streaming.

IFXAuthorGeomCompilerParams is a structure with a CreateNeighborMesh Boolean flag. If TRUE, an IFXNeighborMesh, which allows Toon and Subdivision Surfaces technology to be applied, is created for the model. If FALSE, this data is not created for the model.

Interface Methods

Description

Init

Initializes the compiler

SetMeshFactory

Specifies which mesh factory to use

Compile

Compiles the meshes


IFXAuthorGeomCompiler::Init(IFXSceneGraph* in_pSceneGraph)

Initializes the geometry compiler to work off the specified scenegraph.

Parameters:

in_pSceneGraph

The scenegraph for which the compiler is generating model resources.

Return Values

Comments:

Must be called before the Mesh compiler is used.


IFXAuthorGeomCompiler::SetMeshFactory(IFXMeshFactory* in_pMeshFactory);

Specifies which mesh factory is to be used to create IFXMeshes. If not called, a default mesh factory is called.

Parameters:

in_pMeshFactory

The new mesh factory to use.

Return Values

Comments:

A default mesh factory is provided; for normal usage this call should not be needed.


IFXAuthorGeomCompiler::Compile(IFXAuthorMeshGroup* in_pAuthorMeshGroup, IFXAuthorMRMParams* in_pMRMParams, IFXAuthorGeomCompilerParams* in_pCompilerParams, IFXAuthorBones* in_AuthorBones, IFXModelResource ** out_ppModelResource);

Converts an AuthorMesh, and optionally AuthorBones, into an IFXModelResource.

Parameters:

in_pAuthorMeshGroup

The mesh group to compile.

in_pMRMParams

Parameters to be set during the MRM process. This may be null, in which case a default set of reasonable parameters will be used.

in_pCompilerParams

Parameters to be set during the mesh compilation process. This may be null, in which case a default set of reasonable parameters will be used.

in_AuthorBones

The character animation bones for this model's resources. May be null, in which case no character animation modifier will be produced.

out_ppModelResource

The variable to receive the model resource created by the compilation process. Only valid if the return code is successful. Also returns an outstanding reference on the model resource, so it should be released when the calling code is finished with it.

Return Values

 

§See asterisked (*) statement at Legal Information © 2001 Intel Corporation.