Lighting Profiles.tbl

This feature requires FreeSpace Open

List of Tables and related code files
* Notes Modular Tables
** Notes tables which only use modular tables
Ai.tbl*	/ai/aicode.cpp
Ai_profiles.tbl*	/ai/ai_profiles.cpp
Animation.tbl**	/model/modelanimation.cpp
Armor.tbl*	/ship/ship.cpp
Asteroid.tbl*	/asteroid/asteroid.cpp
Autopilot.tbl*	/autopilot/autopilot.cpp
Cheats.tbl*	/cheats_table/cheats_table.cpp
Colors.tbl*	/globalincs/alphacolors.cpp
Curves.tbl*	/math/curves.cpp
Controlconfigdefaults.tbl	/controlconfig/controlsconfigcommon.cpp
Credits.tbl*	/menuui/credits.cpp
Cutscenes.tbl*	/cutscene/cutscenes.cpp
Decals.tbl**	/decals/decals.cpp
Fireball.tbl*	/fireball/fireballs.cpp
Fonts.tbl*	/graphics/font.cpp
Game_settings.tbl*	/mod_table/mod_table.cpp
Glowpoints.tbl*	/model/modelread.cpp
Help.tbl*	/gamehelp/contexthelp.cpp
Hud_gauges.tbl*	/hud/hudparse.cpp
Icons.tbl*	/mission/missionbriefcommon.cpp
Iff_defs.tbl*	/iff_defs/iff_defs.cpp
Keywords.tbl*	Not In Codebase
Lighting_Profiles.tbl*	/lighting/lighting_profiles.cpp
Lightning.tbl*	/nebula/neblightning.cpp
Mainhall.tbl*	/menuui/mainhallmenu.cpp
Medals.tbl*	/stats/medals.cpp
Messages.tbl*	/mission/missionmessage.cpp
Mflash.tbl*	/weapon/muzzleflash.cpp
Music.tbl*	/gamesnd/eventmusic.cpp
Nebula.tbl*	/nebula/neb.cpp
Objecttypes.tbl*	/ship/ship.cpp
Options.tbl*	Not In Codebase
Particle effects(-part.tbm)**	/particle/effects...
Post_processing.tbl	/graphics/gropenglpostprocessing.cpp
Rank.tbl*	/stats/scoring.cpp
Scpui.tbl*	Not In Codebase
Scripting.tbl*	/parse/scripting.cpp
Ships.tbl*	/ship/ship.cpp
Sexps.tbl**	/parse/sexp/sexp_lookup.cpp
Sounds.tbl*	/gamesnd/gamesnd.cpp
Species_defs.tbl*	/species_defs/species_defs.cpp
Species.tbl*	/menuui/techmenu.cpp
Ssm.tbl*	/hud/hudartillery.cpp
Stars.tbl*	/starfield/starfield.cpp
Strings.tbl*	/localization/localize.cpp
Tips.tbl*	/menuui/playermenu.cpp
Traitor.tbl*	/stats/scoring.cpp
Tstrings.tbl*	/localization/localize.cpp
Virtual_pofs.tbl*	/model/modelreplace.cpp
Weapon_expl.tbl*	/weapon/weapons.cpp
Weapons.tbl*	/weapon/weapons.cpp

The lighting_profiles.tbl provides controls for the game's lighting and rendering pipeline. The current version only allows fixed settings, but expansion to allow runtime adjustment and swapping between different profiles is planned.

This table is one of the Modular Tables and can be extended with xxx-ltp.tbm

#DEFAULT PROFILE

FS2 Open, 22.0:

This section defines the settings used by default. Entries may be included in any order, and the section must by closed by a #END DEFAULT PROFILE line.

$Tonemapper:

FS2 Open, 22.0:

Sets the algorithm used for the tonemapping stage of rendering. See Tonemapping for more information on what this means in detail and comparisons of the options.

• Syntax: Str
• Options:
  • Linear: Simple clamping and gamma correction. Not recommended in most cases.
  • Uncharted 2: FSO's default tonemapper, a filmic look created by John Hable for the game of the same name. This option can also be selected with simply "uncharted"
  • ACES: A filmic tonemapper that is the default for Unreal Engine 4, based on film industry standards. Good for high contrasts, has the quirk that it quite visibly desaturates bright colored lights towards white. This is especially visible in Freespace with red Shivan glows, which are bright enough to turn orange.
  • ACES Approximate: A simplification of ACES featuring more saturated bright colors and faster rendering. Does not desaturate bright colors.
  • Cineon: Another filmic option, similar to ACES it provides high contrast and vibrant colors, it preserves deep blacks but isn't quite as aggressive as ACES on dimly lit scenes.
  • Reinhard Extended: A version of a common tonemapper that acts on luminance
  • Reinhard Jodie: Another version of Reinhard that makes bright colors less saturated than Reinhard Extended
  • PPC: Piecewise power curve, a configurable curve meant to give artists flexible and simple control over the look. Applies to pixel luminance. Configuration options are also available in this table. See [1] for detailed breakdown of what this is doing.
  • PPC RGB: As with PPC, except applying to each color channel individually rather than combined luminance.

$Exposure:

FS2 Open, 22.0:

The rendered scene is multiplied by this value before being tonemapped. Conceptually similar to the exposure time on a camera, higher numbers mean a brighter scene. By using lower exposure and higher values for static lights you could create a otherwise similar scene with more muted lights from ship glows, level backgrounds and weapons fire, or conversely using dim lights and high exposure would emphasize those other light sources.

• Syntax: Float
• Default: 4.0

$PPC Toe Strength:

FS2 Open, 22.0:

Toe Strength adjusts how dark the shadows of a scene are. The higher the toe strength, the darker, and harder to distinguish from black, dark areas in the scene become. Conversely, a low value means that lowly lit objects are easier to distinguish from full black and eachother, but setting it too low can make areas that should be black look greyish. This setting is very sensitive to exposure. If you lower exposure, you will want to lower toe strength to get some visibility back.

• Syntax: Float
• Default: 0.5

$PPC Toe Length:

FS2 Open, 22.0:

Toe length adjusts the area in which Toe Strength does it's thing. A very low setting will mean that only the darkest areas of the image are affected by the toe strength setting and vice-versa.

• Syntax: Float
• Default: 0.5

$PPC Shoulder Length:

FS2 Open, 22.0:

Shoulder length adjusts how gradual the overexposure compensation works. A higher setting means a smoother transition from "visibly bright" to "blindingly bright", at the cost of making the image less vivid.

• Syntax: Float
• Default: 0.5

$PPC Shoulder Strength:

FS2 Open, 22.0:

Shoulder strength adjusts how strongly the tonemapper compensates for bright areas. A high value means that brighter areas will be made less bright. A low value means that there's more "blindingly bright" areas in the scene.

• Syntax: Float
• Default: 0.0

$PPC Shoulder Angle:

FS2 Open, 22.0:

Shoulder angle adjusts the compensation for overshoot: When the image becomes too bright for the tonemapper to handle, a higher setting here will try to bring the detail in those overly bright areas back, whilst a lower setting allows for a "bloom" effect.

• Syntax: Float
• Default: 0.1

$Missile light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of dynamic lights for missile weapons (any weapon using a model rather than a laser bitmap or beam).
• Syntax: See Adjustable values

$Missile light radius:

FS2 Open, 22.2:

• An Adjustable value applied to the light radius dynamic lights for missile weapons (any weapon using a model rather than a laser bitmap or beam). +Default: is used for any such weapons not given specific sizes in the weapon tables.
• Syntax: See Adjustable values
• Default values: +default: 20

$Laser light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of dynamic lights for laser weapons(weapons using a laser bitmap).
• Syntax: See Adjustable values

$Laser light radius:

FS2 Open, 22.2:

• An Adjustable value applied to the light radius dynamic lights for laser weapons (weapons using a laser bitmap). +Default: is used for any such weapons not given specific sizes in the weapon tables.
• Syntax: See Adjustable values
• Default values: +default: 100

$Beam light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of dynamic lights for beam weapons.
• Syntax: See Adjustable values

$Beam light radius:

FS2 Open, 22.2:

• An Adjustable value applied to the light radius dynamic lights for beam weapons. Unless set otherwise on the specific weapon this is multiplied by the beam's width. +Default: is used for any such weapons not given specific sizes in the weapon tables.
• Syntax: See Adjustable values
• Default values: +default: 37.5

$Tube light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of all tube lights, such as light cast by beam weapons. It is applied after any more specific adjustments such as $Beam light brightness:
• Syntax: See Adjustable values

$Tube light radius:

FS2 Open, 22.2:

• An Adjustable value applied to the radius of all tube lights, such as light cast by beam weapons. It is applied after any more specific adjustments such as $Beam light radius:.
• Syntax: See Adjustable values

$Point light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of all point lights, such as light cast by non-beam weapons. It is applied after any more specific adjustments such as $laser light brightness:
• Syntax: See Adjustable values

$Point light radius:

FS2 Open, 22.2:

• An Adjustable value applied to the radius of all point lights, such as light cast by non-beam weapon. It is applied after any more specific adjustments such as $laesr light radius:.
• Syntax: See Adjustable values
• Default values: +multiplier: 1.25

$Cone light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of all cone lights. It is applied after any more specific adjustments that might exist.
• Syntax: See Adjustable values

$Cone light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of all cone lights. It is applied after any more specific adjustments that might exist.
• Syntax: See Adjustable values
• Default values: +multiplier: 1.25

$Directional light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of all directional lights, such as level suns.
• Syntax: See Adjustable values

$Ambient light brightness:

FS2 Open, 22.2:

• An Adjustable value applied to the brightness of ambient level lighting.
• Syntax: See Adjustable values

#END DEFAULT PROFILE

FS2 Open, 22.0:

Required to close the default profile section.

Adjustable values

Many profile values allow for a flexible set of configurable adjustments to existing values. These are applied to their inputs in a specific order and will be listed here in that order they, but can be defined in the tables in any order.

+default:

FS2 Open, 22.2:

• For values that can be configured more specifically elsewhere, such as the sizes of dynamic weapon lights. Defaults are only meaningful for those proprties that list one in their default settings.
• Syntax: Float

+Multiplier:

FS2 Open, 22.2:

• The input value will be multiplied by this amount
• Syntax: Float

+Adjustment:

FS2 Open, 22.2:

• This amount will be added to the input value. Negative values allow for downward adjustments.
• Syntax: Float

+Minimum:

FS2 Open, 22.2:

• Inputs below this amount will be set to it.
• Syntax: Float

+Maximum:

FS2 Open, 22.2:

• Inputs above this amount will be set to it.
• Syntax: Float

Sample Entry

#DEFAULT PROFILE

$Tonemapper: Uncharted 2
$Exposure: 4.0

$Missile Light Radius:
  +Base: 20

$Laser Light Radius:
  +Base: 100

$Beam Light Radius:
  +Base: 37.5

$Point Light Radius:
  +Multiplier: 1.25

$Cone Light Radius:
  +Multiplier: 1.25

#END DEFAULT PROFILE

References

1. Filmic Tonemapping with Piecewise Power Curves, John Hable
2. Tone Mapping, 64
3. Filmic Tonemapping Operators, John Hable