Adds parameters for cone-shaped volume lights.
#include <AlConeLight.h> class AlConeLight: public AlVolumeLight AlConeLight(); virtual ~AlConeLight(); virtual AlObject* copyWrapper() const; statusCode create(); AlObjectType type() const; double arc() const; double coneEndRadius() const; statusCode setArc(double); statusCode setConeEndRadius(double);
A cone light allows light to exist inside the volume of a cone.
A cone light could be made similar to a spotlight by setting Concentric and radial to 0, directional to 1, decay to 0 and dropoff to slightly less than 1.
A cone light would make a good vortex field by setting the Radial to 1, concentric to .5, directional depending on whether the vortex is sucking up things or dropping them.
Constructs an AlConeLight wrapper object.
Deletes an AlConeLight wrapper object.
Creates all the DAG nodes for this light and adds them to the universe. The DAG nodes are position, look at and up, and a DAG node that groups these three together.
sSuccess - everything was successful
sInsufficientMemory - not enough memory available
sAlreadyCreated - light is already created
Returns the class identifier kConeLightType.
Returns the cone light’s arc (how much of the cone you actually have). This method returns -1 if the light is invalid.
Returns the cone light’s coneEndRadius. This defines the shape of the cone. This method returns -1 if the light is invalid.
Sets the arc of the light. The given arc must be in the range 0 to 360.
< double arc - portion of the sphere to use
sSuccess - setting arc succeeded
sInvalidObject - not a valid volume light
sFailure - setting the arc failed
sInvalidArgument - the arc was not in the range of 0 to 360
Sets the cone end radius of the light.
< cone_end_radius - radius to set
sSuccess - setting the radius succeeded
sInvalidObject - the current light is not a valid volume light
sFailure - setting the radius failed