Skip to content
On this page

class SurfaceMapper

ISurfaceMapper creates a mapping image between two user-defined geometries. The mapper basically looks for the source geometry in the inverse normal direction from the outwardly offset destination geometry, and maps pixels accordingly. This means that you can modify the normals of the destination geometry to adjust the search direction to your liking. The geometries can either be set as IGeometryDatas or as the root nodes of scenes. If both are set, the scene is used. If only a single source or a destination is set, or if the source and destination are the same scene or geometry, the surface mapper will map the mesh onto itself.

Properties

PropertyDescription
DestinationGeometryThe destination geometry data.
DestinationSceneThe scene used for the surface transfer destination.
NameThe name of the SurfaceMapper object. (Inherited from Object)
RecalculateSearchDirectionIf set, the search direction from the destination mesh to the source mesh will be determined by an internal normal calculation with the specified hard edge angle. If false, the search direction will be determined by the existing normals of the destination geometry.
SearchDirectionHardEdgeAngleThe hard edge angle in degrees. If RecalculateSearchDirection is on, the search direction from the destination mesh to the source mesh will be determined by an internal normal calculation with the specified hard edge angle. If false, the search direction will be determined by the existing normals of the destination geometry.
SearchDistanceThe search distance. If the source geometry is found within this distance from the destination geometry, it will be mapped. If negative, it will be set to a sane default internally, based on the mesh size.
SearchOffsetThe search offset. This is how far out from the destination geometry the search for the source geometry will begin, propagating inwardly for the length of SearchDistance. If negative, it will be set to a sane default internally, based on the mesh size.
SourceGeometryThe source geometry data.
SourceSceneThe scene used for the surface transfer source.

Methods

MethodDescription
AddObserverAdds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)
GetClassGet the name of the SurfaceMapper class. (Inherited from Object)
GetMappingImageThe mapping image.
GetMappingImageSettingsThe mapping image settings. Currently, the only applicable settings for this mapper is texcoordlevel, texcoordname, size, and supersampling settings.
IsAReturns true if SurfaceMapper is a or is a descendant of the class named as the type parameter. (Inherited from Object)
IsNullReturns true if the SurfaceMapper object is invalid. (Inherited from Object)
IsSameObjectAsReturns true if the SurfaceMapper object is valid. (Inherited from Object)
NonNullReturns true if the SurfaceMapper object is valid. (Inherited from Object)
PrintInfoPrints the content/info of the SurfaceMapper object to the log. (Inherited from Object)
RemoveObserverRemoves a previously added observer object. (Inherited from Object)
RunSurfaceMappingRuns the surface mapping.

Static methods

MethodDescription
IsClassAReturns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)
SafeCastSafeCast makes sure the input object is of a class that can be cast into spSurfaceMapper, and if this is the case, returns the object cast into spSurfaceMapper. (Inherited from Object)

Properties details

DestinationGeometry

The destination geometry data.

DestinationScene

The scene used for the surface transfer destination.

Name

The name of the SurfaceMapper object. (Inherited from Object)

RecalculateSearchDirection

If set, the search direction from the destination mesh to the source mesh will be determined by an internal normal calculation with the specified hard edge angle. If false, the search direction will be determined by the existing normals of the destination geometry.

SearchDirectionHardEdgeAngle

The hard edge angle in degrees. If RecalculateSearchDirection is on, the search direction from the destination mesh to the source mesh will be determined by an internal normal calculation with the specified hard edge angle. If false, the search direction will be determined by the existing normals of the destination geometry.

SearchDistance

The search distance. If the source geometry is found within this distance from the destination geometry, it will be mapped. If negative, it will be set to a sane default internally, based on the mesh size.

SearchOffset

The search offset. This is how far out from the destination geometry the search for the source geometry will begin, propagating inwardly for the length of SearchDistance. If negative, it will be set to a sane default internally, based on the mesh size.

SourceGeometry

The source geometry data.

SourceScene

The scene used for the surface transfer source.

Methods details

AddObserver

Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)

GetClass

Get the name of the SurfaceMapper class. (Inherited from Object)

GetMappingImage

The mapping image.

GetMappingImageSettings

The mapping image settings. Currently, the only applicable settings for this mapper is texcoordlevel, texcoordname, size, and supersampling settings.

IsA

Returns true if SurfaceMapper is a or is a descendant of the class named as the type parameter. (Inherited from Object)

IsNull

Returns true if the SurfaceMapper object is invalid. (Inherited from Object)

IsSameObjectAs

Returns true if the SurfaceMapper object is valid. (Inherited from Object)

NonNull

Returns true if the SurfaceMapper object is valid. (Inherited from Object)

PrintInfo

Prints the content/info of the SurfaceMapper object to the log. (Inherited from Object)

RemoveObserver

Removes a previously added observer object. (Inherited from Object)

RunSurfaceMapping

Runs the surface mapping.

Static methods details

IsClassA

Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)

SafeCast

SafeCast makes sure the input object is of a class that can be cast into spSurfaceMapper, and if this is the case, returns the object cast into spSurfaceMapper. (Inherited from Object)