User Tools

Site Tools


This is an old revision of the document!



Warning: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"? in /homepages/18/d28239263/htdocs/cafu/docs/inc/parser/handler.php on line 1552

The New Light Tool

The New Light tool is used to place light entities and is actually a subpart of the New Entity tool. The difference is, that the New Light tool can only place light entities, whereas the New Entity tool can place all entities.

Lights are used to illuminate a map and come in two forms:

Static lights: These lights are precalculated by the editor when compiling a map. Lightmaps are built to define wich parts of the level textures are illuminated and shadowed.

Dynamic lights: These lights are placed in the editor but their illumination and shadow casting is calculated dynamically by the engine during runtime. This makes them perfect to calculate light and shadow with movable objects, which is impossible with static lights. It is also possible to move the lightsource itself, which makes this a very flexible lightsource, but has also very high processing costs.

You can activate the New Light tool using the related icon in the toolbar or by pressing SHIFT+L.

The Tool Options Bar

In the options bar of the New Light tool you can choose what light you want to create.

There are 2 options available:

  • PointLight: A static lightsource from which lightmaps are calculated.
  • PointLightSource: A dynamic lightsource which is handled by the engine at runtime.

Creating a light

To create a lightsource, you can click on a location in the 3D view where the lightsource is instantly created.

If you click in the 2D views a point is created, which can be properly positioned before creating the lightsource by pressing the ENTER key.

Configuring a light

To configure the properties of a light source, you have so select the light with the Selection tool and choose Object Properties from the Edit menu or press ALT+ENTER.

The properties for the PointLight include:

  • Bank Heading Pitch (Y Z X): Headingvalues in degree for the coordinate systems axis
  • Opening Angle: Opening angle of this lightsource
  • Intensity red/green/blue: Intensity of the different light colors

The properties for the PointLightSource include:

  • Bank Heading Pitch (Y Z X): Headingvalues in degree for the coordinate systems axis
  • Dyn. light radius: Radius of light dissemination
  • Dyn. light diffuse color: Color of diffuse light
  • Dyn. light specular color: Color of specular light

New Light tool keyboard shortcuts

  • ENTER
    • create lightsource after placing it in a 2D view
  • ESC
    • switch back to the Selection tool
  • ALT+ENTER
    • if lightsource selected → open its properties dialog
mapping/cawe/editingtools/newlight.1191847361.txt.gz · Last modified: 2013-01-07 12:07 (external edit)