[WML-Source: LampButtons.wml][TOC][Part00]

[chapter]

[section]LampButtons

  [images/LampButtons.tga]

The settings in these ButtonsWindow visualise the Lamp DataBlock. The LampButtons are only displayed if the active Object is a Lamp. HotKey for LampButtons: F4.

  [images/LampBrowse.tga]

The DataButtons in the Header indicate what Lamp block is visualised.

[point]Lamp Browse (MenuBut)

Choose another Lamp block from the list provided.

[point]LA: (TextBut)

Give the current Lamp a new and unique name.

[point]Users (But)

If the Lamp Block is used by more than one Object, this button shows the total number of Objects. Press the button to make the Lamp "Single User". Then an exact copy is made.

[subsection]Lamp options

  [images/LampOptions.tga]

[point]Quad (TogBut)

The distance from the lamp is in inverse quadratic proportion to the intensity of the light. An inverse linear progression is standard (see also the buttons "Dist", "Quad1" and "Quad2").

[point]Sphere (TogBut)

The lamp only sheds light within a spherical area around the lamp. The radius of the sphere is determined by the "Dist" button.

[point]Shadows (TogBut)

The lamp can produce shadows. Shadow calculations are only possible with the Spot lamps. The render option "Shadows" must also be turned ON in the DisplayButtons. See also the shadow buffer buttons later in this section.

[point]Halo (TogBut)

The lamp has a halo. This only works with Spot lamps. The intensity of the halo is calculated using a conic section. With the option "Halo step:" it also uses the shadow buffer (volumetric rendering). The scope of the spot halo is determined by the value of "Dist".

[point]Layer (TogBut)

Only Objects in the same layer(s) as the Lamp Object are illuminated. This enables you to use selective lighting, to give objects an extra accent or to restrict the effects of the lamp to a particular space. It also allows to you keep rendering times under control.

[point]Negative (TogBut)

A lamp casts 'negative' light.

[point]OnlyShadow (TogBut)

For spot lamps (with "Shadow" ON), only the shadow is rendered. Light calculations are not performed and where there are shadows, the value of "Energy" is reduced.

[point]Square

Spotlamps can have square Spotbundles with this option. For a better control over shadows and for slide projector effects.

[subsection]Lamp types

  [images/LampTypes.tga]

[point]Lamp (RowBut)

The standard lamp, a point light source.

[point]Spot (RowBut)

The lamp is restricted to a conical space. The 3DWindow shows the form of the spotlight with a broken line. Use the sliders "SpotSi" and "SpotBl" to set the angle and the intensity of the beam.

[point]Sun (RowBut)

The light shines from a constant direction; the distance has no effect. The position of the Lamp Object is thus unimportant, except for the rotation.

[point]Hemi (RowBut)

Like "Sun", but now light is shed in the form of half a sphere, a hemisphere. This method is also called directional ambient. It can be used to suggest cloudy daylight.

  [images/LampDist.tga]

[point]Dist (NumBut)

For the lamp types "Lamp" and "Spot", the distance affects the intensity of the light. The standard formula is used for this:
D = "Dist" button, a = distance to the lamp.

Light intensity = D/(D + a).

This is an inverse linear progression. With the option "Quad", this becomes:

Light intensity = D/(D + a*a).

  [images/LampEnergyColor.tga]

[point]Energy (NumSli)

The intensity of the light. The standard settings in Blender assume that a minimum of two lamps are used.

[point]R, G, B (NumSli)

The red, green and blue components of the light.

  [images/LampSpotOptions.tga]

[point]SpotSi (NumSli)

The angle of the beam measured in degrees. Use for shadow lamp beams of less than 160 degrees.

[point]SpotBl (NumSli)

The softness of the spot edge.

[point]Quad1, Quad2 (NumSli)

The light intensity formula of a Quad Lamp is actually: Light intensity = D / (D + (quad1 * a) + (quad2 * a * a)) D = "Dist" button. a = distance to the lamp. The values of "quad1" and "quad2" at 1.0 produces the strongest quadratic progression. The values of "quad1" and "quad2" at 0.0 creates a special Quad lamp that is insensitive to distance.

[point]HaloInt (NumSli)

The intensity of the spot halo. The scope of the spot halo is determined by "Dist".

[point]Shadow Buffer

  [images/LampShadow.tga]

Blender uses a shadow buffer algorithm. From the spotlight, a picture is rendered for which the distance from the spotlight is saved for each pixel. The shadow buffers are compressed, a buffer of 1024x1024 pixels requires, on average, only 1.5 Mb of memory.

This method works quite quickly, but must be adjusted carefully. There are two possible side effects:

[point]Bufsi 512, 768, 1024, 1536, 2560 (RowBut)

The size of the buffer in pixels. The value of DisplayButtons->Percentage (100%, 75%, ...) is multiplied by this.

[point]ClipSta, ClipEnd (NumBut)

Seen from the spot lamp: everything closer than ClipSta always has light; everything farther away than ClipEnd always has shadow. Within these limits, shadows are calculated. The smaller the shadow area, the clearer the distinction the lamp buffer can make between small distances, and the fewer side effects you will have. It is particularly important to set the value of ClipSta as high as possible.

[point]Samples (NumBut)

The shadow buffer is 'sampled'; within a square area a test is made for shadow 3*3, 4*4 or 5*5 times. This reduces aliasing.

[point]Halo step (NumBut)

A value other than zero in the button "Halo step" causes the use of the shadow detection (volumetric rendering) for Halos. Low values cause better results and longer rendering times. A value of "8" works fine in most cases.

[point]Soft (NumBut)

The size of the sample area. A large "Soft" value produces broader shadow edges.

[point]Texture Channels

  [images/LampTextureChannels.tga]

[point]Texture name (RowBut)

A Lamp has six channels with which Textures can be linked. Each channel has its own mapping, i.e. the manner in which the texture works on the lamp. The settings are in the buttons described below.

[point]Mapping: coordinates input.

  [images/LampMapCoordInput.tga]

Each Texture has a 3D coordinate (the texture coordinate) as input. The starting point is always the global coordinate of the 3D point that is seen in the pixel to be rendered. A lamp has three options for this.

[point]Object Name (TextBut)

The name of the Object that is used for the texture coordinates. If the Object does not exist, the button remains empty.

[point]Object (RowBut)

Each Object in Blender can be used as a source for texture coordinates. To do this, an inverse transformation is applied to the global coordinate, which gives the local Object coordinate. In this way, the texture is linked with the position, size and rotation of the Object.

[point]Glob (RowBut)

The global coordinate is passed on to the texture.

[point]View (RowBut)

The view vector of the lamp; the vector of the global coordinate to the lamp, is passed on to the texture. If the lamp is a Spot, the view vector is normalised to the dimension of the spot beam, allowing use of a Spot to project a 'slide'.

[point]Mapping: transform coordinates.

  [images/LampMapTransform.tga]

Use these buttons to adjust the texture coordinate more finely.

[point]dX, dY, dZ (NumBut)

The extra translation of the texture coordinate.

[point]sizeX, sizeY, sizeZ (NumBut)

The extra scaling of the texture coordinate.

[point]Texture Block

  [images/LampTextureBlock.tga]

[point]TE: (TextBut)

The name of the Texture block. The name can be changed with this button.

[point]Texture Browse (MenuBut)

Select an existing Texture from the list provided, or create a new Texture Block.

[point]Clear (But)

The link to the Texture is erased.

[point]Users (But)

If the Texture Block has multiple users, this button shows the total number of users. Press the button to make the Texture "Single User". Then an exact copy is made.

[point]Auto Name (But)

Blender assigns a name to the Texture.

[point]Mapping: Texture input settings.

  [images/LampMapTexInput.tga]

These buttons pass extra information to the Texture.

[point]Stencil (TogBut)

Normally, textures are executed one after the other and placed over each other. A second Texture channel can completely replace the first. This option sets the mapping to stencil mode. No subsequent Texture can have an effect on the area the current Texture affects.

[point]Neg (TogBut)

The inverse of the Texture is applied.

[point]RGBtoInt (TogBut)

With this option, an RGB texture (affects colour) is used as an Intensity texture (affects a value).

[point]R, G, B (NumSli)

The colour with which an Intensity texture blends with the current colour.

[point]DVar (NumSli)

The value with which the Intensity texture blends with the current value.

[point]Mapping: output to.

  [images/LampMapTexOutputTo.tga]

[point]Col (TogBut)

The texture affects the colour of the lamp.

[point]Mapping: output settings.

These buttons adjust the output of the Texture.

[point]Blend (RowBut)

The Texture mixes the values.

[point]Mul (Rowbut)

The Texture multiplies the values.

[point]Add (RowBut)

The Texture adds the values.

[point]Sub (RowBut)

The Texture subtracts the values.

[point]Col (NumSli)

The extent to which the texture affects the colour.

[point]Nor (NumSli)

The extent to which the texture affects the normal (not important here).

[point]Var (NumSli)

The extent to which the texture affects the value (a variable, not important here).
-cw- Last modified: Tue Oct 24 15:08:09 CEST 2000