3ds Max C++ API Reference
LightState Struct Reference

This structure describes the properties of a light. More...

#include <object.h>

+ Inheritance diagram for LightState:

Public Member Functions

 LightState ()
 

Public Attributes

LightType type
 One of the following values from enum LightType:
OMNI_LGT - Omnidirectional
SPOT_LGT - Spot (cone)
DIRECT_LGT - Directional (parallel)
AMBIENT_LGT - Global. More...
 
Matrix3 tm
 The transformation matrix of the light. More...
 
Color color
 The color of the light (its intensity). More...
 
float intens
 The multiplier applied to the color. More...
 
float hotsize
 The hotspot size in degrees. More...
 
float fallsize
 The hotspot falloff size in degrees. More...
 
int useNearAtten
 Nonzero if near attenuation is used; otherwise zero. More...
 
float nearAttenStart
 The near attenuation start value. More...
 
float nearAttenEnd
 The near attenuation end value. More...
 
int useAtten
 Nonzero if (far) attenuation is used; otherwise zero. More...
 
float attenStart
 The (far) start attenuation value. More...
 
float attenEnd
 The (far) end attenuation value. More...
 
int shape
 One of the following values:
RECT_LIGHT, CIRCLE_LIGHT. More...
 
float aspect
 The aspect ratio of the light. More...
 
BOOL overshoot
 TRUE if the light supports overshoot; otherwise FALSE. More...
 
BOOL shadow
 TRUE if shadows are on; otherwise FALSE. More...
 
BOOL on
 TRUE if the light is on; otherwise FALSE. More...
 
BOOL affectDiffuse
 TRUE if affect diffuse is on; otherwise FALSE. More...
 
BOOL affectSpecular
 TRUE if affect specular is on; otherwise FALSE. More...
 
BOOL ambientOnly
 
DWORD extra
 

Additional Inherited Members

- Static Public Member Functions inherited from MaxHeapOperators
static UtilExport voidoperator new (size_t size)
 Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e)
 Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate arrays of objects. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport void operator delete (void *ptr)
 Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, void *placement_ptr)
 Placement new operator. More...
 
static UtilExport void operator delete (void *ptr, void *placement_ptr)
 Placement delete operator. More...
 
static UtilExport voidaligned_malloc (size_t size, size_t alignment)
 Allocates memory on a specified alignment boundary. More...
 
static UtilExport voidaligned_realloc (void *ptr, size_t size, size_t alignment)
 Reallocates memory on a specified alignment boundary. More...
 
static UtilExport void aligned_free (void *ptr)
 Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More...
 

Detailed Description

This structure describes the properties of a light.

See also
Class GenLight, Class LightObject, Class Color, Class Matrix3

Constructor & Destructor Documentation

◆ LightState()

LightState ( )
inline
3031  {
3032  useAtten = 0;
3033  useNearAtten = 0;
3034  attenStart = 0.0f;
3035  nearAttenStart = 0.0f;
3036  attenEnd = 0.0f;
3037  nearAttenEnd = 0.0f;
3038  extra = 0x0000;
3039  intens = 0.0f;
3040  shadow = 0;
3041  fallsize = 0.0f;
3042  on = 0;
3043  affectDiffuse = 0;
3044  ambientOnly = 0;
3045  overshoot = 0;
3046  shape = 0;
3047  type = OMNI_LGT;
3048  affectSpecular = 0;
3049  aspect = 0.0f;
3050  hotsize = 0.0f;
3051  }
@ OMNI_LGT
Definition: LightTypeEnums.h:12
BOOL affectDiffuse
TRUE if affect diffuse is on; otherwise FALSE.
Definition: object.h:3025
BOOL on
TRUE if the light is on; otherwise FALSE.
Definition: object.h:3023
LightType type
One of the following values from enum LightType: OMNI_LGT - Omnidirectional SPOT_LGT - Spot (cone) ...
Definition: object.h:2990
float intens
The multiplier applied to the color.
Definition: object.h:2996
BOOL ambientOnly
Definition: object.h:3028
BOOL overshoot
TRUE if the light supports overshoot; otherwise FALSE.
Definition: object.h:3019
BOOL shadow
TRUE if shadows are on; otherwise FALSE.
Definition: object.h:3021
float aspect
The aspect ratio of the light.
Definition: object.h:3017
float attenEnd
The (far) end attenuation value.
Definition: object.h:3012
float hotsize
The hotspot size in degrees.
Definition: object.h:2998
float fallsize
The hotspot falloff size in degrees.
Definition: object.h:3000
DWORD extra
Definition: object.h:3029
float nearAttenStart
The near attenuation start value.
Definition: object.h:3004
float nearAttenEnd
The near attenuation end value.
Definition: object.h:3006
int useNearAtten
Nonzero if near attenuation is used; otherwise zero.
Definition: object.h:3002
int shape
One of the following values: RECT_LIGHT, CIRCLE_LIGHT.
Definition: object.h:3015
int useAtten
Nonzero if (far) attenuation is used; otherwise zero.
Definition: object.h:3008
BOOL affectSpecular
TRUE if affect specular is on; otherwise FALSE.
Definition: object.h:3027
float attenStart
The (far) start attenuation value.
Definition: object.h:3010

Member Data Documentation

◆ type

LightType type

One of the following values from enum LightType:
OMNI_LGT - Omnidirectional
SPOT_LGT - Spot (cone)
DIRECT_LGT - Directional (parallel)
AMBIENT_LGT - Global.

◆ tm

Matrix3 tm

The transformation matrix of the light.


◆ color

Color color

The color of the light (its intensity).


◆ intens

float intens

The multiplier applied to the color.


◆ hotsize

float hotsize

The hotspot size in degrees.


◆ fallsize

float fallsize

The hotspot falloff size in degrees.


◆ useNearAtten

int useNearAtten

Nonzero if near attenuation is used; otherwise zero.

◆ nearAttenStart

float nearAttenStart

The near attenuation start value.

◆ nearAttenEnd

float nearAttenEnd

The near attenuation end value.

◆ useAtten

int useAtten

Nonzero if (far) attenuation is used; otherwise zero.


◆ attenStart

float attenStart

The (far) start attenuation value.


◆ attenEnd

float attenEnd

The (far) end attenuation value.


◆ shape

int shape

One of the following values:
RECT_LIGHT, CIRCLE_LIGHT.

◆ aspect

float aspect

The aspect ratio of the light.


◆ overshoot

BOOL overshoot

TRUE if the light supports overshoot; otherwise FALSE.


◆ shadow

BOOL shadow

TRUE if shadows are on; otherwise FALSE.


◆ on

BOOL on

TRUE if the light is on; otherwise FALSE.


◆ affectDiffuse

BOOL affectDiffuse

TRUE if affect diffuse is on; otherwise FALSE.


◆ affectSpecular

BOOL affectSpecular

TRUE if affect specular is on; otherwise FALSE.


◆ ambientOnly

BOOL ambientOnly

◆ extra

DWORD extra