summaryrefslogtreecommitdiffstats
path: root/sdk/rwsdk/include/d3d8/rtltmap.h
diff options
context:
space:
mode:
Diffstat (limited to 'sdk/rwsdk/include/d3d8/rtltmap.h')
-rw-r--r--sdk/rwsdk/include/d3d8/rtltmap.h601
1 files changed, 601 insertions, 0 deletions
diff --git a/sdk/rwsdk/include/d3d8/rtltmap.h b/sdk/rwsdk/include/d3d8/rtltmap.h
new file mode 100644
index 00000000..1a53b185
--- /dev/null
+++ b/sdk/rwsdk/include/d3d8/rtltmap.h
@@ -0,0 +1,601 @@
+
+/**
+ * \defgroup rtltmap RtLtMap
+ * \ingroup rttool
+ *
+ * Lightmap Generation Toolkit for RenderWare.
+ */
+
+#ifndef RTLTMAP_H
+#define RTLTMAP_H
+
+/*===========================================================================*
+ *--- Includes --------------------------------------------------------------*
+ *===========================================================================*/
+
+#include "rwcore.h"
+#include "rpworld.h"
+
+#include "rpltmap.h"
+
+
+/**
+ * \ingroup rtltmap
+ * \typedef RtLtMapIlluminateSampleCallBack
+ * \ref RtLtMapIlluminateSampleCallBack is the callback to be called, from
+ * within \ref RtLtMapIlluminate, for groups of samples in the objects
+ * currently being illuminated.
+ *
+ * For lightmapped objects, samples are grouped on a per-polygon basis and
+ * for vertex-lit objects, samples are grouped on a per-object basis (see
+ * \ref RtLtMapObjectFlags).
+ *
+ * This callback will receive an array of color values to fill in, each
+ * representing one sample in the current object - this may correspond to
+ * a texel in the current object's lightmap or the prelight colour of a
+ * vertex, depending on whether the object is lightmapped and/or vertex-lit.
+ * It will receive positions (in world-space) for each sample and the normal
+ * vector (again, in world-space) of each sample (normals are interpolated
+ * across polygons for non-flat-shaded materials. See \ref RtLtMapMaterialFlags).
+ * For lightmap samples (not vertex-lighting samples), it will receive
+ * barycentric coordinates within the current polygon. It will also receive
+ * a list of RpLights affecting the current object.
+ *
+ * The barycentric coordinates may be used, for example, to allow a callback
+ * to easily import existing lighting data (e.g from previously generated
+ * lightmaps in a different format, or from an art package with lighting
+ * functionality).
+ *
+ * NOTE: The alpha channel of the RwRGBA results array must NOT be modified.
+ * These values are used internally and their modification may result in
+ * unwanted visual artifacts in the resulting lighting solution.
+ *
+ * The default RtLtMapIlluminateSampleCallBacks supplied with RtLtMap is
+ * \ref RtLtMapDefaultSampleCallBack. This callback performs point and area
+ * lighting (the area lights use are those passed to \ref RtLtMapIlluminate).
+ *
+ * \param results A pointer to an array of \ref RwRGBA sample color values
+ * \param samplePositions A pointer to an array of \ref RwV3d values specifying the
+ * world-space positions of each of the samples in the results array
+ * \param baryCoords A pointer to an array of \ref RwV3d values specifying the
+ * barycentric coordinates (within the current polygon) of
+ * each of the samples in the results array
+ * \param numSamples The length of the results, samplePositions, baryCoords and normals arrays
+ * \param lights An array of pointers to \ref RpLight's affecting the current object
+ * \param numLights The length of the lights array
+ * \param normals A pointer to an array of \ref RwV3d values specifying the
+ * world-space, unit normals of each of the samples in the results array
+ *
+ * \return A pointer to the results array on success, NULL otherwise
+ *
+ * \see RtLtMapIlluminate
+ * \see RtLtMapIlluminateVisCallBack
+ * \see RtLtMapIlluminateProgressCallBack
+ */
+typedef RwRGBA *(*RtLtMapIlluminateSampleCallBack)(RwRGBA *results,
+ RwV3d *samplePositions,
+ RwV3d *baryCoords,
+ RwUInt32 numSamples,
+ RpLight **lights,
+ RwUInt32 numLights,
+ RwV3d *normals);
+
+/**
+ * \ingroup rtltmap
+ * \typedef RtLtMapIlluminateVisCallBack
+ * \ref RtLtMapIlluminateVisCallBack is the callback to be called, from
+ * within \ref RtLtMapIlluminate, to determine the visibility between a
+ * sample and a light.
+ *
+ * This callback is called for all samples in the current
+ * \ref RtLtMapLightingSession and for each light source which may
+ * potentially affect each of those samples (this may not be all the
+ * lights in the scene, as some hierarchical culling is performed).
+ * Each sample may represent a texel in the current object's lightmap
+ * or the prelight color of a vertex, depending on whether the object
+ * is lightmapped and/or vertex-lit (see \ref RtLtMapObjectFlags).
+ *
+ * The callback will receive a pointer to the world of the current
+ * \ref RtLtMapLightingSession (this may be used to perform intersection
+ * tests), the world-space position of the sample, the world-space
+ * position of the light, a pointer to a light and a pointer to an
+ * \ref RwRGBAReal result value.
+ *
+ * If the light pointer is NULL, this means that the current light
+ * is an area light (as opposed to an \ref RpLight), of an internal
+ * format. The area lights use are those passed to \ref RtLtMapIlluminate.
+ *
+ * The callback should return FALSE to signify that the light is wholly
+ * occluded w.r.t the sample position, otherwise it should return TRUE.
+ * Partial degrees of (color-frequency-dependent) occlusion may be
+ * expressed by modifying the RwRGBAReal value. This defaults to bright
+ * white but may be reduced to signify that the light from the light
+ * source should be attenuated. This could be used to take into account
+ * light-filtering objects in the scene (such as coloured glass or fog).
+ *
+ * The default RtLtMapIlluminateVisCallBack supplied with RtLtMap is
+ * \ref RtLtMapDefaultVisCallBack. This callback performs visibility
+ * tests using the line-intersection tests from \ref rtintersect. It tests
+ * for occlusion by RpWorldSectors and RpAtomics and it respects the
+ * relevant \ref RtLtMapObjectFlags and \ref RtLtMapMaterialFlags but it
+ * does not filter light; visibility is determined to be either one or zero.
+ *
+ * \param world The world of the current RtLtMapLightingSession
+ * \param result An RwRGBAReal value to attentuate this light's
+ * contribution to the current sample
+ * \param samplePos The world-space positiuon of the sample
+ * \param lightPos The world-space positiuon of the light
+ * \param light A pointer to the light (NULL if it is an are light)
+ *
+ * \return TRUE if the light is visible from the sample, FALSE if it is occluded
+ *
+ * \see RtLtMapIlluminate
+ * \see RtLtMapIlluminateSampleCallBack
+ * \see RtLtMapIlluminateProgressCallBack
+ */
+typedef RwBool (*RtLtMapIlluminateVisCallBack)(RpWorld *world,
+ RwRGBAReal *result,
+ RwV3d *samplePos,
+ RwV3d *lightPos,
+ RpLight *light);
+
+/**
+ * \ingroup rtltmap
+ * \typedef RtLtMapIlluminateProgressCallBack
+ * \ref RtLtMapIlluminateProgressCallBack is the callback to be called, from
+ * within \ref RtLtMapIlluminate, to allow a user to track lighting progress.
+ *
+ * The progress callback will be called at several stages during lighting,
+ * with a different 'message' parameter value used at each stage (see
+ * \ref RtLtMapProgressMessage). It will be called at the very start of
+ * lighting (for a given \ref RtLtMapLightingSession), before any samples
+ * are lit. It will also be called at the very end of lighting, after all
+ * samples have been lit. It will be called before and after each lighting
+ * 'slice' (see \ref RtLtMapIlluminate) and also after each group of
+ * samples have been lit.
+ *
+ * For lightmapped objects, samples are grouped on a per-polygon basis and
+ * for vertex-lit objects, samples are grouped on a per-object basis (see
+ * \ref RtLtMapObjectFlags).
+ *
+ * The progress callback will receive a RwReal value specifying the percentage
+ * of samples already lit in the current \ref RtLtMapLightingSession (see
+ * \ref RtLtMapLightingSessionGetNumSamples).
+ *
+ * By returning FALSE, the progress callback may cause early termination of
+ * the current lighting 'slice' (this may be used, for example, to keep
+ * the time spent lighting each slice fairly constant).
+ *
+ * There is no default progress callback supplied with RtLtMap.
+ *
+ * \param message A \ref RtLtMapProgressMessage identifying the stage
+ * of the current call to the progress callback
+ * \param value The percentage of samples already lit in the
+ * current \ref RtLtMapLightingSession
+ *
+ * \return FALSE to immediately terminate lighting, otherwise TRUE
+ *
+ * \see RtLtMapIlluminate
+ * \see RtLtMapIlluminateSampleCallBack
+ * \see RtLtMapIlluminateVisCallBack
+ */
+typedef RwBool (*RtLtMapIlluminateProgressCallBack)(RwInt32 message,
+ RwReal value);
+
+
+/**
+ * \ingroup rtltmap
+ * \ref RtLtMapProgressMessage is an enumerated type identifying the different
+ * stages at which the \ref RtLtMapIlluminateProgressCallBack may be called
+ * from within \ref RtLtMapIlluminate.
+ *
+ * \see RtLtMapIlluminateProgressCallBack
+ * \see RtLtMapIlluminate
+ */
+enum RtLtMapProgressMessage
+{
+ rtLTMAPPROGRESSNAMESSAGE = 0,
+
+ rtLTMAPPROGRESSSTART = 1, /**< This is issued at the beginning of
+ * an incremental lighting session */
+ rtLTMAPPROGRESSSTARTSLICE = 2, /**< This is issued at the beginning of every
+ * slice in an incremental lighting session */
+ rtLTMAPPROGRESSUPDATE = 3, /**< This is issued after the lighting of each
+ * lightmapped triangle or vertex-lit object */
+ rtLTMAPPROGRESSENDSLICE = 4, /**< This is issued at the end of every slice
+ * in an incremental lighting session */
+ rtLTMAPPROGRESSEND = 5, /**< This is issued at the end of an
+ * incremental lighting session */
+
+ rtLTMAPPROGRESSFORCEENUMSIZEINT = 0x7FFFFFFF
+};
+typedef enum RtLtMapProgressMessage RtLtMapProgressMessage;
+
+typedef struct RtLtMapLightingSession RtLtMapLightingSession;
+/**
+ * \ingroup rtltmap
+ * \typedef RtLtMapLightingSession
+ * The \ref RtLtMapLightingSession structure holds information to be passed to
+ * \ref RtLtMapIlluminate. It is used to parameterize the lighting process.
+ *
+ * The \ref RtLtMapLightingSession structure encapsulates a set of objects and
+ * keeps track of the proportion of samples, within that set, that have already
+ * been lit by calls to \ref RtLtMapIlluminate. Each call performs lighting for
+ * one 'slice' of the whole 'session'. If the camera member is non-NULL, it is
+ * important that the camera is not moved between lighting slices.
+ *
+ * The \ref RtLtMapLightingSession is also passed to
+ * \ref RtLtMapLightMapsCreate, \ref RtLtMapLightMapsClear,
+ * \ref RtLtMapLightMapsDestroy and \ref RtLtMapAreaLightGroupCreate,
+ * though not all of the session structure's member will be used in
+ * each of these cases.
+ *
+ * \see RtLtMapIlluminate
+ * \see RtLtMapLightMapsCreate
+ * \see RtLtMapLightMapsClear
+ * \see RtLtMapLightMapsDestroy
+ * \see RtLtMapAreaLightGroupCreate
+ */
+struct RtLtMapLightingSession
+{
+ RpWorld *world; /**< This world is that in which collisions are performed
+ * during illumination (for the purposes of lighting
+ * visibility determination) */
+ RwCamera *camera; /**< An optional pointer to a camera. The camera's frustum
+ * may be used to cull objects and/or triangles from the
+ * set of those to be processed. */
+ RpWorldSector **sectorList; /**< An optional array of \ref RpWorldSector pointers,
+ * specifying which sectors in the world to light. If
+ * this is NULL, then all sectors in the world (or those
+ * inside the optional camera's frustum) will be lit. */
+ RwInt32 numSectors; /**< The length of the sectorList array. If this is set to
+ * '-1' then none of the sectors in the world will be lit. */
+ RpAtomic **atomicList; /**< An optional array of \ref RpAtomic pointers,
+ * specifying which atomics to light. If this is NULL
+ * then all atomics in the world (or those inside the
+ * optional camera's frustum) will be lit. */
+ RwInt32 numAtomics; /**< The length of the atomicList array. If this is set to
+ * '-1' then none of the atomics in the world will be lit. */
+ RwUInt32 startSample; /**< Lighting for the current 'slice' should begin with this
+ * sample. It is the user's responsibility to increment this
+ * value after each slice. Note that partial lighting is
+ * quantized to be per-polygon (for lightmapped objects).
+ * startSample will always be rounded down, not up. */
+ RwUInt32 numSamples; /**< This specifies how many lightmap samples should be lit.
+ * If it is left zero then all samples in the current set
+ * of objects will be lit. Note that partial lighting is
+ * quantized to be per-polygon (for lightmapped objects).
+ * numSamples will always be rounded up, not down. */
+ RwUInt32 totalSamples;/**< This specifies how many lightmap samples will be lit in
+ * total for the world specified (this is filled in by
+ * \ref RtLtMapIlluminate, not the calling function). */
+ RtLtMapIlluminateSampleCallBack sampleCallBack; /**< A \ref RtLtMapIlluminateSampleCallBack
+ * to use during lighting. If this is left
+ * NULL, the default callback will be used. */
+ RtLtMapIlluminateVisCallBack visCallBack; /**< A \ref RtLtMapIlluminateVisCallBack
+ * to use during lighting. If this is left
+ * NULL, the default callback will be used. */
+ RtLtMapIlluminateProgressCallBack progressCallBack; /**< A \ref RtLtMapIlluminateProgressCallBack
+ * to use during lighting. If this is left
+ * NULL, no progress callback will be used. */
+};
+
+/**
+ * \ingroup rtltmap
+ * \ref RtLtMapMaterialFlags is an enumerated type specifying the different
+ * lightmap-related flags which may be applied to materials. These values
+ * will be taken into consideration within \ref RtLtMapIlluminate.
+ *
+ * \see RtLtMapMaterialGetFlags
+ * \see RtLtMapMaterialSetFlags
+ * \see RtLtMapMaterialGetAreaLightColor
+ * \see RtLtMapMaterialSetAreaLightColor
+ * \see RtLtMapMaterialGetLightMapDensityModifier
+ * \see RtLtMapMaterialSetLightMapDensityModifier
+ * \see RtLtMapMaterialGetAreaLightDensityModifier
+ * \see RtLtMapMaterialSetAreaLightDensityModifier
+ * \see RtLtMapMaterialSetAreaLightRadiusModifier
+ * \see RtLtMapMaterialGetAreaLightRadiusModifier
+ * \see RtLtMapIlluminate
+ * \see RtLtMapAreaLightGroupCreate
+ * \see RtLtMapIlluminateVisCallBack
+ */
+enum RtLtMapMaterialFlags
+{
+ rtLTMAPMATERIALNAFLAG = 0,
+
+ rtLTMAPMATERIALLIGHTMAP = 1, /**< This material should be lightmapped
+ * [for non-lightmapped materials within lightmapped objects,
+ * texel values will be set to (0, 0, 0) (or (255, 255, 255) if
+ * the rtLTMAPMATERIALAREALIGHT flag is present, so that light-
+ * emitting textures appear as bright as the light which they are
+ * emittering) and the mesh may be 'shrunk' in UV-space so as not
+ * to waste lightmap texels] */
+ rtLTMAPMATERIALAREALIGHT = 2, /**< This material is an area light emitter
+ * (see \ref RtLtMapAreaLightGroupCreate) */
+ rtLTMAPMATERIALNOSHADOW = 4, /**< This material does not block light */
+ rtLTMAPMATERIALSKY = 8, /**< This material blocks everything but directional
+ * lights, to allow sky polygons to occlude geometry
+ * and yet emit directional light (sky or sun light,
+ * being as if cast from an infinite distance) */
+ rtLTMAPMATERIALFLATSHADE = 16, /**< This material will be lit as if flat-shaded
+ * (polygon normals will be used during illumination) */
+
+ rtLTMAPMATERIALFLAGFORCEENUMSIZEINT = 0x7FFFFFFF
+};
+typedef enum RtLtMapMaterialFlags RtLtMapMaterialFlags;
+
+/**
+ * \ingroup rtltmap
+ * \ref RtLtMapObjectFlags is an enumerated type specifying the different
+ * lightmap-related flags which may be applied to world sectors and
+ * atomics. These values will be taken into consideration within
+ * \ref RtLtMapLightMapsCreate and \ref RtLtMapIlluminate.
+ *
+ * \see RtLtMapAtomicGetFlags
+ * \see RtLtMapAtomicSetFlags
+ * \see RtLtMapWorldSectorGetFlags
+ * \see RtLtMapWorldSectorSetFlags
+ * \see RtLtMapLightMapsCreate
+ * \see RtLtMapIlluminate
+ * \see RtLtMapIlluminateVisCallBack
+ */
+enum RtLtMapObjectFlags
+{
+ rtLTMAPOBJECTNAFLAG = 0,
+
+ rtLTMAPOBJECTLIGHTMAP = 1, /**< This object is to be lightmapped */
+ rtLTMAPOBJECTVERTEXLIGHT = 2, /**< This object's vertex prelight colours should
+ * be lit within \ref RtLtMapIlluminate. */
+ rtLTMAPOBJECTNOSHADOW = 4, /**< This object does not cast shadows (useful, for
+ * example, for moving objects for which dynamic
+ * shadows are to be rendered - such as doors) */
+
+ rtLTMAPOBJECTFLAGFORCEENUMSIZEINT = 0x7FFFFFFF
+};
+typedef enum RtLtMapObjectFlags RtLtMapObjectFlags;
+
+/* Area-lighting stuff:*
+ ***********************/
+
+/**
+ * \ingroup rtltmap
+ * \typedef RtLtMapAreaLightGroup
+ * \ref RtLtMapAreaLightGroup is a structure which acts as a container
+ * for area lights created by a call to \ref RtLtMapAreaLightGroupCreate.
+ * The containers may be chained and passed to \ref RtLtMapIlluminate.
+ * Each container has an optional pointer to a RwFrame which is used to
+ * transform the contained area lights relative to the world of the current
+ * \ref RtLtMapLightingSession and relative to each other (such that, for
+ * example, lights from multiple worlds, which are connected by portals,
+ * or which are composed of atomics and not world sectors, may be used
+ * within a single call to \ref RtLtMapIlluminate).
+ *
+ * \see RtLtMapAreaLightGroupCreate
+ * \see RtLtMapAreaLightGroupDestroy
+ * \see RtLtMapIlluminate
+ * \see RtLtMapIlluminateVisCallBack
+ */
+typedef struct RtLtMapAreaLightGroup RtLtMapAreaLightGroup;
+struct RtLtMapAreaLightGroup
+{
+ RwSList *meshes; /**< A list of hierarchically-grouped area lights */
+ RwFrame *frame; /**< An (optional) pointer to a frame (owned by something else)
+ * whose LTM specifies the coordinate system of this container,
+ * relative to the world of the current \ref RtLtMapLightingSession. */
+ RtLtMapAreaLightGroup *next; /**< A pointer for chaining are light groups together */
+};
+
+/* Area light triangles are grouped by source mesh (this may change) */
+typedef struct LtMapAreaLightMesh LtMapAreaLightMesh;
+struct LtMapAreaLightMesh
+{
+ RwUInt32 flags; /* To hold hierarchical visibility culling flags,
+ * relevant to the object/triangle *currently* being lit. */
+ RpMaterial *material; /* The emitter material, containing colour, etc */
+ RwSphere sphere; /* Each mesh has an associated center and radius */
+ RwReal ROI; /* Centred on the above sphere, the R.O.I. of the
+ * samples in this mesh (a conservative estimate) */
+ RwSList *triangles; /* A list of the area light triangles in this mesh */
+};
+
+/* Area light samples are grouped by source triangle */
+typedef struct LtMapAreaLight LtMapAreaLight;
+struct LtMapAreaLight
+{
+ RwUInt16 flags; /* To hold hierarchical visibility culling flags,
+ * relevant to the object/triangle *currently* being lit. */
+ RwUInt16 numSamples; /* Number of area light samples in this triangle */
+ RwReal areaPerSample; /* (triangleArea / numSamples) for this triangle */
+ RwPlane plane; /* This 'area light' is a triangle, this is its plane. */
+ RwSphere sphere; /* This bounds the triangle's points in world-space (it's
+ * not worth storing 3 points, coarse culling is fine) */
+ RwV3d *lights; /* Array of area light sample positions (in world-space) */
+};
+
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif /* __cplusplus */
+
+
+/* Lightmap creation functionality: */
+extern RtLtMapLightingSession *
+RtLtMapLightMapsCreate(RtLtMapLightingSession *session,
+ RwReal density, RwRGBA *color);
+
+extern void
+RtLtMapLightMapsDestroy(RtLtMapLightingSession *session);
+extern RpAtomic *
+RtLtMapAtomicLightMapDestroy(RpAtomic *atomic);
+extern RpWorldSector *
+RtLtMapWorldSectorLightMapDestroy(RpWorldSector *sector);
+
+extern RwReal
+RtLtMapGetVertexWeldThreshold(void);
+extern RwBool
+RtLtMapSetVertexWeldThreshold(RwReal threshold);
+
+extern RwUInt32
+RtLtMapLightMapGetDefaultSize(void);
+extern RwBool
+RtLtMapLightMapSetDefaultSize(RwUInt32 size);
+
+extern RwUInt32
+RtLtMapAtomicGetLightMapSize(RpAtomic *atomic);
+extern RpAtomic *
+RtLtMapAtomicSetLightMapSize(RpAtomic *atomic, RwUInt32 size);
+extern RwUInt32
+RtLtMapWorldSectorGetLightMapSize(RpWorldSector *sector);
+extern RpWorldSector *
+RtLtMapWorldSectorSetLightMapSize(RpWorldSector *sector, RwUInt32 size);
+
+extern RwUInt32
+RtLtMapAtomicGetFlags(RpAtomic *atomic);
+extern RpAtomic *
+RtLtMapAtomicSetFlags(RpAtomic *atomic, RwUInt32 flags);
+extern RwUInt32
+RtLtMapWorldSectorGetFlags(RpWorldSector *sector);
+extern RpWorldSector *
+RtLtMapWorldSectorSetFlags(RpWorldSector *sector, RwUInt32 flags);
+
+
+/* Lightmap illumination functionality: */
+extern RwUInt32
+RtLtMapIlluminate(RtLtMapLightingSession *session,
+ RtLtMapAreaLightGroup *lights);
+
+extern RwReal
+RtLtMapGetSliverAreaThreshold(void);
+extern RwBool
+RtLtMapSetSliverAreaThreshold(RwReal threshold);
+
+extern RwRGBA *
+RtLtMapDefaultSampleCallBack(RwRGBA *results,
+ RwV3d *samplePositions,
+ RwV3d * __RWUNUSED__ baryCoords,
+ RwUInt32 numSamples,
+ RpLight **lights,
+ RwUInt32 numLights,
+ RwV3d *normals);
+
+extern RwBool
+RtLtMapDefaultVisCallBack(RpWorld *world,
+ RwRGBAReal __RWUNUSED__ *result,
+ RwV3d *samplePos,
+ RwV3d *lightPos,
+ RpLight __RWUNUSED__ *light);
+
+extern RtLtMapLightingSession *
+RtLtMapLightingSessionInitialize(RtLtMapLightingSession *session,
+ RpWorld *world);
+
+extern RwInt32
+RtLtMapLightingSessionGetNumSamples(RtLtMapLightingSession *session);
+extern RwInt32
+RtLtMapWorldSectorGetNumSamples(RpWorldSector *sector);
+extern RwInt32
+RtLtMapAtomicGetNumSamples(RpAtomic *atomic);
+
+extern RtLtMapLightingSession *
+RtLtMapImagesPurge(RtLtMapLightingSession *session);
+extern RpAtomic *
+RtLtMapAtomicImagePurge(RpAtomic *atomic);
+extern RpWorldSector *
+RtLtMapWorldSectorImagePurge(RpWorldSector *sector);
+
+extern RtLtMapLightingSession *
+RtLtMapLightMapsClear(RtLtMapLightingSession *session, RwRGBA *color);
+extern RpAtomic *
+RtLtMapAtomicLightMapClear(RpAtomic *atomic, RwRGBA *color);
+extern RpWorldSector *
+RtLtMapWorldSectorLightMapClear(RpWorldSector *sector, RwRGBA *color);
+
+
+/* Material/area-lighting functionality: */
+extern RtLtMapAreaLightGroup *
+RtLtMapAreaLightGroupCreate(RtLtMapLightingSession *session, RwReal density);
+extern RwBool
+RtLtMapAreaLightGroupDestroy(RtLtMapAreaLightGroup *lights);
+
+extern RwUInt32
+RtLtMapMaterialGetFlags(RpMaterial *material);
+extern RpMaterial *
+RtLtMapMaterialSetFlags(RpMaterial *material, RwUInt32 flags);
+
+extern RwReal
+RtLtMapMaterialGetLightMapDensityModifier(RpMaterial *material);
+extern RpMaterial *
+RtLtMapMaterialSetLightMapDensityModifier(RpMaterial *material, RwReal modifier);
+
+extern RwRGBA
+RtLtMapMaterialGetAreaLightColor(RpMaterial *material);
+extern RpMaterial *
+RtLtMapMaterialSetAreaLightColor(RpMaterial *material, RwRGBA color);
+
+extern RwReal
+RtLtMapMaterialGetAreaLightDensityModifier(RpMaterial *material);
+extern RpMaterial *
+RtLtMapMaterialSetAreaLightDensityModifier(RpMaterial *material, RwReal modifier);
+
+extern RwReal
+RtLtMapMaterialGetAreaLightRadiusModifier(RpMaterial *material);
+extern RpMaterial *
+RtLtMapMaterialSetAreaLightRadiusModifier(RpMaterial *material, RwReal modifier);
+
+extern RwUInt32
+RtLtMapGetMaxAreaLightSamplesPerMesh(void);
+extern RwBool
+RtLtMapSetMaxAreaLightSamplesPerMesh(RwUInt32 maxSamples);
+extern RwReal
+RtLtMapGetAreaLightDensityModifier(void);
+extern RwBool
+RtLtMapSetAreaLightDensityModifier(RwReal modifier);
+extern RwReal
+RtLtMapGetAreaLightRadiusModifier(void);
+extern RwBool
+RtLtMapSetAreaLightRadiusModifier(RwReal modifier);
+extern RwReal
+RtLtMapGetAreaLightErrorCutoff(void);
+extern RwBool
+RtLtMapSetAreaLightErrorCutoff(RwReal tolerance);
+
+
+
+/* Texture-saving functionality: */
+extern RwTexDictionary *
+RtLtMapTexDictionaryCreate(RtLtMapLightingSession *session);
+
+extern const RwChar *
+RtLtMapGetDefaultPrefixString(void);
+extern RwBool
+RtLtMapSetDefaultPrefixString(RwChar *string);
+
+extern RwUInt32
+RtLtMapGetLightMapCounter(void);
+extern RwBool
+RtLtMapSetLightMapCounter(RwUInt32 value);
+
+
+#if (defined(SKY2_DRVMODEL_H) || defined(NULLSKY_DRVMODEL_H))
+
+/* PS2-specific functionality: */
+extern RwTexture *RtLtMapSkyLightMapMakeDarkMap(RwTexture *lightMap);
+
+extern RwTexture *RtLtMapSkyBaseTextureProcess(RwTexture *texture);
+extern RpAtomic *RtLtMapSkyAtomicBaseTexturesProcess(RpAtomic *atomic);
+extern RpWorldSector *
+RtLtMapSkyWorldSectorBaseTexturesProcess(RpWorldSector *sector);
+extern RtLtMapLightingSession *
+RtLtMapSkyBaseTexturesProcess(RtLtMapLightingSession *session);
+
+#endif /* (defined(SKY2_DRVMODEL_H) || defined(NULLSKY_DRVMODEL_H)) */
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* RTLTMAP_H */
+
+