HC_Insert_Area_Light

Key HC_Insert_Area_Light(int count, Point const points[], char const *listptr)
Key HC_Insert_Area_Light(int count, Point const points, char const listptr)

Inserts an area light.

Radiosity is an intensive, iterative calculation based on how light bounces around an environment – a light bulb (point light) near the ceiling lights up the ceiling brightly close to it, and less further away, and less down the walls and the floor. Some of the wall and floor areas are directly shadowed by furniture, but light bouncing off the first lit areas can add a little to those other areas, and a little more to the areas that were first lit. These newly lit/brightened areas now light up more, and so on until a limit is reached – either a number of iterations or the lighting levels have stabilized within a tolerance.

To this end, an area light is an emissive polygon – a polygon that is considered a single extended light source, such as the rectangular diffuser found on many fluorescent fixtures. Area lights do have an effect on the scene lighting - they are treated by the code as if they were one or two very wide spotlights with a falloff.

Parameters

count: – number of points

points: – float triples defining the area (count & points exactly as in Insert_Polygon)

options: – “front|back|both”, which determines which side(s) of the polygon emit light

Returns

The key to the inserted light, or -1 if an error occurred.