DG Kernel (ActiveX) Documentation


Skip Navigation Links.
Start page
Quick Start
Search Page
Installation
What is new
Upgrading Native Apps
Licensing
Collapse ModelsModels
Collapse DG Kernel ControlsDG Kernel Controls
Collapse API ReferenceAPI Reference
Interface List
Vector Space
Collapse General GeometryGeneral Geometry
Collapse ModelModel
Collapse ViewView
Collapse General ComputingGeneral Computing
Collapse Samples and TutorialsSamples and Tutorials
Collapse GraphicsGraphics
Collapse Math ObjectsMath Objects
Collapse DeprecatedDeprecated
Redistribution
Model Viewer
Open Source
Support
Skip Navigation Links Go to DGKC docs Search Documentation


IMeshBuilder_KC Interface

SetCurrentNormal
SetCurrentColor
AddVertex
AddSimplex
AddQuad
Reset

The interface is implemented by Mesh Builder object created when this interface is queried from mesh via IMesh or other related interface. Mesh Builder is a temporary object which simplifies construction of a mesh. To save memory it is not recommended keeping a reference to this interface as it duplicates the data copied to the mesh object

Example: To build a thetrahedral:

Query IMesh > IMeshBuilder_KC and call (C#):

iBuilder.AddVertex(0, 0, 0); //0
iBuilder.AddVertex(1, 0, 0); //1
iBuilder.AddVertex(0, 1, 0); //2
iBuilder.AddVertex(0, 0, 1); //3
iBuilder.AddSimplex(0, 2, 1); //x,y plane
iBuilder.AddSimplex(0, 1, 3);
iBuilder.AddSimplex(0, 3, 2);
iBuilder.AddSimplex(1, 2, 3);
iMeshMods.FixupNormals(30, 0);    //IMesh > IMeshMods

See also Interface List


HRESULT SetCurrentNormal(double vx, double vy, double vz)

Defines the normal to be used for the following AddVertex() calls. The default is a zero vector. If normals are not supplied via this method the surface lighting may not be correct. In the case consider calling IMeshMods.FixupNormals() in the end of mesh construction process

HRESULT SetCurrentColor(float red, float green, float blue, float alpha)

Not implemented in this version


HRESULT AddVertex(double x, double y, double z, int* indxOut)

Adds the vertex to the mesh and returns its zero-based index, which one less than the number of AddVertex() calls since acquiring this interface or last Reset() call,  to be used in AddSimplex() or AddQuad() calls below


HRESULT AddSimplex(int i0, int i1, int i2)

Adds a new simplex to the mesh. i0, i1, i2 are indices (= returned from) of the related AddVertex() calls


HRESULT AddQuad(int i0, int i1, int i2, int i3)

Adds a new simplex to the mesh. i0, i1, i2, i3 are indices (= returned from) of the related AddVertex() calls


HRESULT Reset()

Clears all data from previous calls and returns to the initial state. This does not affect any changes to the underlying mesh done during previous calls