Classes | Enumerations | Functions

mapextraction Namespace Reference

Classes

class   Component
  This class represents a component in map extraction, like Displacement, Ambient occlusion, etc... More...
class   DisplacementComponent
  This class represents the displacement component. More...
class   VectorDisplacementComponent
  This component represents the vector displacement component. More...
class   NormalComponent
  This class represents the normal vector component. More...
class   AmbientOcclusionComponent
  This class represents the ambient occlusion component. More...
class   PaintLayerScanComponent
  This class represents the paint layer scanner component. This component simply samples a paint layer over the source surface. More...
class   SculptLayerScanComponent
  This class represents the sculpt layer scanner component. This component samples a sculpt layer at the given point on the source mesh. More...
class   Extractor
  This class represents the central module of the extraction. More...

Enumerations

enum   UtilizerType { utilTexture, utilPtex, utilVertex, utilUnknown }
 

This is the type of the final result for map extaction. This controls where the reference points are located on the target mesh.

More...
enum   LocateMethod { locRaycast, locSubdivision, locCustom, locUnknown }
 

This is the method Mudbox uses to pair sourface points on the target mesh to surface points on the source mesh.

More...
enum   Space {
  spaceWorld, spaceObject, spaceTangent, spaceRawTangent,
  spaceNormal, spaceUnknown
}
 

Coordinate space used in varoius places during extraction.

More...
enum   VertexAction {
  vaVertexColor, vaMove, vaDisplace, vaFreeze,
  vaSculptLayerMask, vaUnknown
}
 

This is the action which happens with each vertex after extraction. This is only valid if the utilizer type is set to vertex.

More...
enum   Antialiasing {
  aaOff, aa2X, aa4X, aa6X,
  aa8X, aaUnknown
}
 

Type of the antialiasing applied to extracted textures. This is only valid if utilizer type is set to texture.

More...
enum   Sampling { sampleFurthestOutside, sampleFurthestInside, sampleClosesToTarget, sampleUnknown }
 

How the intersection point is chosen when there are multiple candidates. This is only valid if locate method is set to raycast.

More...
enum   Quality {
  qualFastest, qualFast, qualNormal, qualGood,
  qualBest, qualUnknown
}
 

Quality of ambient occlusion extraction.

More...
enum   Resolution {
  res256, res512, res1024, res2048,
  res4096, resUnknown
}
 

Resolution of a texture map. This is always square.

More...
enum   Compatibility { compMaya, compMax, compUnknown }
 

Compatibility of the extracted normal map.

More...

Functions

MEADLL class Extractor  CreateNewOperation (void)
  Creates a new extractor node.
MEADLL int  OperationCount (void)
  Returns the number of extractor nodes in the scene.
MEADLL class Extractor  OperationByIndex (int iIndex)
  Returns a given existing extractor node.

Enumeration Type Documentation

This is the type of the final result for map extaction. This controls where the reference points are located on the target mesh.

Enumerator:
utilTexture 
utilPtex 

Traditional textures, which are saved as plain image files (jpg, png, etc..), one for each tile. Target mesh needs texture coordinates.

utilVertex 

Extracting to a ptex file.

utilUnknown 

Extracting data to vertices of the target mesh.

In this case the result is not a file, but some kind of operation on the target mesh, based on the result of the extraction. This is not exposed on the UI currently, but can be used programmatically.

Definition at line 25 of file MapExtractorAPI.h.

This is the method Mudbox uses to pair sourface points on the target mesh to surface points on the source mesh.

Enumerator:
locRaycast 
locSubdivision 

With this method, mudbox fires a ray which crosses the target mesh in the desired point, and the direction is the same as the opposite of the.

surface normal. Mudbox then finds the intersection of this ray, and the source mesh.

locCustom 

This method can only be used, if the target mesh and the source mesh are subdivision levels of the same object (or they have the.

matching topology). Mudbox calculates the point pairs based on this subdivision relationship.

locUnknown 

This method can only be used, when there is a precalculated relationship between the source and target mesh.

This is the case for example, after retopology, the new mesh can be used as target, the old mesh can be used as source.

Definition at line 35 of file MapExtractorAPI.h.

enum Space

Coordinate space used in varoius places during extraction.

Enumerator:
spaceWorld 
spaceObject 

World space (or global space).

spaceTangent 

Object space, which is always related to some mesh in the scene.

spaceRawTangent 

This is a special space, which is changing over the mesh, so it also depends on a location.

For more details, look for various tangent space documentation on the internet, like: Lengyel, Eric. �Computing Tangent Space Basis Vectors for an Arbitrary Mesh�. Terathon Software 3D Graphics Library, 2001. http://www.terathon.com/code/tangent.html

spaceNormal 

Same as above, but the tangent and bitangent remains unnormalized and their direction is not aligned to the surface normal.

The length of the surface normal is changed to the geometric average of the length of the tangent and bitangent vectors.

spaceUnknown 

This is a special space used in displacement map extraction. Used only internally.

Examples:
MeshDisplace/displacer.h.

Definition at line 47 of file MapExtractorAPI.h.

This is the action which happens with each vertex after extraction. This is only valid if the utilizer type is set to vertex.

Enumerator:
vaVertexColor 
vaMove 

Each vertex gets a new vertex color asigned, based on the calculated data.

vaDisplace 

The vertex position is modified based on the extracted data (the data as a vector is added to the current vertex position).

vaFreeze 

Move the vertex along the surface normal.

vaSculptLayerMask 

Change the vertex freeze value based on the extracted data.

vaUnknown 

Change the mask for the given sculpt layer based on the extracted data.

Definition at line 61 of file MapExtractorAPI.h.

Type of the antialiasing applied to extracted textures. This is only valid if utilizer type is set to texture.

Enumerator:
aaOff 
aa2X 
aa4X 
aa6X 
aa8X 
aaUnknown 

Definition at line 72 of file MapExtractorAPI.h.

enum Sampling

How the intersection point is chosen when there are multiple candidates. This is only valid if locate method is set to raycast.

Enumerator:
sampleFurthestOutside 
sampleFurthestInside 

The furthest is chosen, outside of the target mesh.

sampleClosesToTarget 

The furthest is chosen, inside the target mesh.

sampleUnknown 

The closest to the target mesh is chosen.

Definition at line 83 of file MapExtractorAPI.h.

enum Quality
enum Resolution

Resolution of a texture map. This is always square.

Enumerator:
res256 
res512 
res1024 
res2048 
res4096 
resUnknown 

Definition at line 103 of file MapExtractorAPI.h.

Compatibility of the extracted normal map.

Enumerator:
compMaya 
compMax 
compUnknown 

Definition at line 114 of file MapExtractorAPI.h.


Function Documentation

MEADLL class Extractor mapextraction::CreateNewOperation ( void  )

Creates a new extractor node.

Examples:
MeshDisplace/displacer.cpp.
MEADLL int mapextraction::OperationCount ( void  )

Returns the number of extractor nodes in the scene.

MEADLL class Extractor mapextraction::OperationByIndex ( int  iIndex )

Returns a given existing extractor node.