This is the documentation for Enlighten.
class Enlighten IPrecompInputGeometry
class Enlighten::IPrecompInputGeometry
└>Geo::IGeoSerialisable
└>Geo::IGeoReleasable
Handle to the InputGeometry.
Functions
Name | Description |
---|---|
AddMesh(IPrecompInputMesh *, const PrecompMeshProperties *) | Adds a Mesh to the geometry. |
AddMesh(const Geo::GeoRefReleasePtr< IPrecompInputMesh > &, const PrecompMeshProperties *) | Adds a Mesh to the geometry. |
Create() | Create a new IPrecompInputGeometry. This create function is primarily for serialisation purposes. |
GetClampUvs() | Accessor for the current clamping behaviour. |
GetHighQualityProjection() | Accessor for the current projection behaviour. |
GetId() | Returns the globally unique ID of this geometry. |
GetInputAtlasRectangleSizeOverride(Geo::s32 &, Geo::s32 &) | Get the override of the output lightmap resolution. |
GetMeshArray() | Read-only access to the meshes in this geometry. |
GetMeshArray() | Modifiable access to the meshes in this geometry. |
GetMeshPropertiesArray() | Read-only access to the properties of the meshes in this geometry. |
GetMeshPropertiesArray() | Write access to the properties of the meshes in this geometry. |
GetMeshSimplificationAutoOrientation() | Get the packer rotation flag. |
GetMinChartSizeInBlocks() | Get the minimum chart size in precompute blocks. |
GetName() | Gets the globally unique name of this geometry. |
GetNumLods() | Get number of Lods packing should generate for this input geometry. |
GetNumMeshes() | How many meshes in this geometry object. |
GetOutputPixelSize() | Get the output lightmap resolution. This is the unscaled output pixel size - bear in mind that instances of this geometry may apply scaling. |
GetPrecompBlockSize() | Get the precompute block size. |
GetTerrainU() | Get the U projection direction for terrain geometry. |
GetTerrainV() | Get the V projection direction for terrain geometry. |
GetUvSimpMaxNumSimplifications() | UV Simplification: get a maximum number of simplification to make. |
GetUvSimpNumIterationsPerSimplification() | UV Simplification: get the number of iterations to allow per simplification. |
IsTerrain() | Returns true is this Geometry is a terrain geometry. |
Load(IGeoInputStream &, Geo::u32) | Load an instance of this class from an IGeoInputStream. |
Release() | Free this object that was created within the Enlighten libraries. |
Save(IGeoStream &, Geo::u32) | Save an instance of this class to an IGeoStream. |
SetClampUvs(bool) | Set whether projected vertices should be clamped within the target chart when possible. |
SetHighQualityProjection(bool) | Set whether the projection should be done using uniform sampling of the mesh surface instead of only using the mesh vertices. |
SetId(Geo::GeoGuid) | Sets the globally unique ID of this geometry. |
SetIsTerrain(bool) | Set whether this geometry is part of the terrain. |
SetMeshSimplificationAutoOrientation(bool) | Enable/disable packer rotation. |
SetMinChartSizeInBlocks(Geo::s32) | Set the minimum chart size in precompute blocks. |
SetName(const char *) | Sets the globally unique name of this geometry. |
SetNumLods(Geo::s32) | Set number of Lods packing should generate for this input geometry. |
SetOutputPixelSize(float) | Set the output lightmap resolution. |
SetOutputPixelSize(float, Geo::s32, Geo::s32) | Set the output lightmap resolution. |
SetPrecompBlockSize(Geo::s32) | Set the precompute block size. |
SetTerrainU(Geo::v128 const &) | Set the U projection direction for terrain geometry. |
SetTerrainV(Geo::v128 const &) | Set the V projection direction for terrain geometry. |
SetUvSimpMaxNumSimplifications(Geo::s32) | UV Simplification: set a maximum number of simplification to make. |
SetUvSimpNumIterationsPerSimplification(Geo::s32) | UV Simplification: set the number of iterations to allow per simplification. |
virtual Geo::s32 Enlighten::IPrecompInputGeometry::AddMesh
public: Geo::s32 AddMesh
(
IPrecompInputMesh * mesh,
const PrecompMeshProperties * properties
)
Adds a Mesh to the geometry.
Returns
Returns the internal array index the mesh as added as (-1 means fail). To save unnecessary copies this call takes ownership of the mesh pointer. This object will be responsible for freeing the resource when it's not longer in use - do not hang onto this pointer. (Note the lack of a const qualifier). It does take a copy of the properties data though. It is the clients responsibility to manage this resource. The caller should make a note of the returned index. You should use this index to lookup the generated uvs in the compiled packed geometry object, if required by the mesh properties.
See Also
virtual Geo::s32 Enlighten::IPrecompInputGeometry::AddMesh
public: Geo::s32 AddMesh
(
const Geo::GeoRefReleasePtr< IPrecompInputMesh > & mesh,
const PrecompMeshProperties * properties
)
Adds a Mesh to the geometry.
Returns
Returns the internal array index the mesh as added as (-1 means fail). To save unnecessary copies this call takes a reference-counted pointer to the mesh. Any other references to the mesh must also go through a Geo::GeoRefReleasePtr. It does take a copy of the properties data though. It is the clients responsibility to manage this resource. The caller should make a note of the returned index. You should use this index to lookup the generated uvs in the compiled packed geometry object, if required by the mesh properties.
See Also
static IPrecompInputGeometry* Enlighten::IPrecompInputGeometry::Create
public: IPrecompInputGeometry * Create()
Create a new IPrecompInputGeometry. This create function is primarily for serialisation purposes.
virtual bool Enlighten::IPrecompInputGeometry::GetClampUvs
public: bool GetClampUvs() const
Accessor for the current clamping behaviour.
virtual bool Enlighten::IPrecompInputGeometry::GetHighQualityProjection
public: bool GetHighQualityProjection() const
Accessor for the current projection behaviour.
virtual Geo::GeoGuid Enlighten::IPrecompInputGeometry::GetId
public: Geo::GeoGuid GetId() const
Returns the globally unique ID of this geometry.
virtual void Enlighten::IPrecompInputGeometry::GetInputAtlasRectangleSizeOverride
public: void GetInputAtlasRectangleSizeOverride
(
Geo::s32 & fixedAtlasWidth,
Geo::s32 & fixedAtlasHeight
) const
Get the override of the output lightmap resolution.
virtual const IPrecompInputMesh* const* Enlighten::IPrecompInputGeometry::GetMeshArray
public: const IPrecompInputMesh *const * GetMeshArray() const
Read-only access to the meshes in this geometry.
virtual IPrecompInputMesh* const* Enlighten::IPrecompInputGeometry::GetMeshArray
public: IPrecompInputMesh *const * GetMeshArray()
Modifiable access to the meshes in this geometry.
virtual const PrecompMeshProperties* Enlighten::IPrecompInputGeometry::GetMeshPropertiesArray
public: const PrecompMeshProperties * GetMeshPropertiesArray() const
Read-only access to the properties of the meshes in this geometry.
virtual PrecompMeshProperties* Enlighten::IPrecompInputGeometry::GetMeshPropertiesArray
public: PrecompMeshProperties * GetMeshPropertiesArray()
Write access to the properties of the meshes in this geometry.
virtual bool Enlighten::IPrecompInputGeometry::GetMeshSimplificationAutoOrientation
public: bool GetMeshSimplificationAutoOrientation() const
Get the packer rotation flag.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetMinChartSizeInBlocks
public: Geo::s32 GetMinChartSizeInBlocks() const
Get the minimum chart size in precompute blocks.
virtual const char* Enlighten::IPrecompInputGeometry::GetName
public: const char * GetName() const
Gets the globally unique name of this geometry.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetNumLods
public: Geo::s32 GetNumLods() const
Get number of Lods packing should generate for this input geometry.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetNumMeshes
public: Geo::s32 GetNumMeshes() const
How many meshes in this geometry object.
virtual float Enlighten::IPrecompInputGeometry::GetOutputPixelSize
public: float GetOutputPixelSize() const
Get the output lightmap resolution. This is the unscaled output pixel size - bear in mind that instances of this geometry may apply scaling.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetPrecompBlockSize
public: Geo::s32 GetPrecompBlockSize() const
Get the precompute block size.
virtual Geo::v128 const& Enlighten::IPrecompInputGeometry::GetTerrainU
public: Geo::v128 const & GetTerrainU() const
Get the U projection direction for terrain geometry.
virtual Geo::v128 const& Enlighten::IPrecompInputGeometry::GetTerrainV
public: Geo::v128 const & GetTerrainV() const
Get the V projection direction for terrain geometry.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetUvSimpMaxNumSimplifications
public: Geo::s32 GetUvSimpMaxNumSimplifications() const
UV Simplification: get a maximum number of simplification to make.
virtual Geo::s32 Enlighten::IPrecompInputGeometry::GetUvSimpNumIterationsPerSimplification
public: Geo::s32 GetUvSimpNumIterationsPerSimplification() const
UV Simplification: get the number of iterations to allow per simplification.
virtual bool Enlighten::IPrecompInputGeometry::IsTerrain
public: bool IsTerrain() const
Returns true is this Geometry is a terrain geometry.
virtual bool Geo::IGeoSerialisable::Load
public: bool Load
(
IGeoInputStream & stream,
Geo::u32 section
)
Load an instance of this class from an IGeoInputStream.
The stream must be ready to read from. You can load sections of an object by passing a bitmask representing the desired sections rather than Iff::AllSectionsMask, which will load all sections. It is also safe to call this method on an object multiple times with different section arguments to load multiple parts.
virtual void Geo::IGeoReleasable::Release
public: void Release()
Free this object that was created within the Enlighten libraries.
Expect this to behave in a similar way to calling 'delete(this)'
virtual bool Geo::IGeoSerialisable::Save
public: bool Save
(
IGeoStream & stream,
Geo::u32 section
) const
Save an instance of this class to an IGeoStream.
The stream must be ready to write to. You can save sections of an object by passing a bitmask representing the desired sections rather than Iff::AllSectionsMask, which will save all sections that are available.
virtual void Enlighten::IPrecompInputGeometry::SetClampUvs
public: void SetClampUvs
(
bool b
)
Set whether projected vertices should be clamped within the target chart when possible.
See the technical user manual for more details on this control. Defaults to true.
virtual void Enlighten::IPrecompInputGeometry::SetHighQualityProjection
public: void SetHighQualityProjection
(
bool b
)
Set whether the projection should be done using uniform sampling of the mesh surface instead of only using the mesh vertices.
For meshes with triangles significantly larger than the output pixel size this may result in better results especially in cases of small overhangs in the detail mesh. Defaults to false.
virtual void Enlighten::IPrecompInputGeometry::SetId
public: void SetId
(
Geo::GeoGuid id
)
Sets the globally unique ID of this geometry.
virtual void Enlighten::IPrecompInputGeometry::SetIsTerrain
public: void SetIsTerrain
(
bool isTerrain
)
Set whether this geometry is part of the terrain.
Terrain is treated specially by the precompute pipeline. If given Geometry is set to be terrain geometry, then it also needs to have, terrainU and terrainV directions set.
virtual void Enlighten::IPrecompInputGeometry::SetMeshSimplificationAutoOrientation
public: void SetMeshSimplificationAutoOrientation
(
bool enabled
)
Enable/disable packer rotation.
Set this to enable or disable UV chart rotations while packing. In mesh simplification, the packing can attempt to orient UV charts to the horizontal axis which improves the packing quality. However, in cases where UVs have been sensibly authored previous to this step, this may be undesirable. The default is false.
virtual void Enlighten::IPrecompInputGeometry::SetMinChartSizeInBlocks
public: void SetMinChartSizeInBlocks
(
Geo::s32 size
)
Set the minimum chart size in precompute blocks.
virtual void Enlighten::IPrecompInputGeometry::SetName
public: void SetName
(
const char * name
)
Sets the globally unique name of this geometry.
virtual void Enlighten::IPrecompInputGeometry::SetNumLods
public: void SetNumLods
(
Geo::s32 numLods
)
Set number of Lods packing should generate for this input geometry.
virtual void Enlighten::IPrecompInputGeometry::SetOutputPixelSize
public: void SetOutputPixelSize
(
float size
)
Set the output lightmap resolution.
This gives the atlas packing stage a guide to how many pixels it should assign to this geometry. It defines the length of one edge of a radiosity pixel given in world units (as defined by the geometry).
virtual void Enlighten::IPrecompInputGeometry::SetOutputPixelSize
public: void SetOutputPixelSize
(
float size,
Geo::s32 fixedAtlasWidth,
Geo::s32 fixedAtlasHeight
)
Set the output lightmap resolution.
Defines the length of one edge of a radiosity pixel given in world units (as defined by the geometry) and also explicitly set how many pixels should be assigned.
Parameters
size | Length of one edge of output pixel; other system parameters are multiples of this. |
|
fixedAtlasWidth | Force explicit atlas width. |
|
fixedAtlasHeight | Force explicit atlas height. |
Note
The override is enabled when both the width and height are greater than zero.
virtual void Enlighten::IPrecompInputGeometry::SetPrecompBlockSize
public: void SetPrecompBlockSize
(
Geo::s32 size
)
Set the precompute block size.
This defines the granularity of the packing algorithm and also the minimum resulting chart size in pixels. The precompute block size needs to be 2 or a multiple of 4. NOTE: All geometries of one system need to use the same value.
virtual void Enlighten::IPrecompInputGeometry::SetTerrainU
public: void SetTerrainU
(
Geo::v128 const & terrainU
)
Set the U projection direction for terrain geometry.
virtual void Enlighten::IPrecompInputGeometry::SetTerrainV
public: void SetTerrainV
(
Geo::v128 const & terrainV
)
Set the V projection direction for terrain geometry.
virtual void Enlighten::IPrecompInputGeometry::SetUvSimpMaxNumSimplifications
public: void SetUvSimpMaxNumSimplifications
(
Geo::s32 maxSimplificiations
)
UV Simplification: set a maximum number of simplification to make.
Once this number of simplifications have been found the process will stop trying to find others and continue with the rest of the uv generation and projection as normal. The algorithm will tend to find the most significant simplifications first, so this can be used to limit the amount of time and effort put into less interesting simplifications. Must be at least 1. The default is 100.
virtual void Enlighten::IPrecompInputGeometry::SetUvSimpNumIterationsPerSimplification
public: void SetUvSimpNumIterationsPerSimplification
(
Geo::s32 numIterations
)
UV Simplification: set the number of iterations to allow per simplification.
Greater iteration counts tend to find better simplifications, but take longer. Must be at least 1. The default is 300.