Glowpoints.tbl

From FreeSpace Wiki
Revision as of 03:52, 30 December 2021 by EatThePath (talk | contribs) (+light)
Jump to: navigation, search

Revision information.....

FSO Git Commit: Date: 2015-05-12 SHA: 5dfbc6d292
Note: Please update the revision information when the page is updated. If your edit had nothing to do with new code entries then please do not edit the revision information


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 glowpoints.tbl defines glowpoint lights for ships under the new deferred lighting renderer.

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

General Format

  • glowpoints.tbl currently has only one section: #Glowpoint overrides.
    • Optional entries, if omitted, leave it as it was defined in the model (if applicable) or use the specified default value.
    • The end of the section is indicated with #End.

Glowpoint Override Entry

$Name:

  • Specifies the name of the glowpoint override (to be referenced in the $Glowpoint overrides: entry of a ship).
  • Syntax: String

+nocreate

  • (optional) In Modular Tables, the name can be followed by the line +nocreate to prevent the game from creating an incomplete entry by leaving the entry unread unless it already exists (either in glowpoints.tbl or an earlier-parsed *-gpo.tbm file) by the time this *-gpo.tbm is read.
    • Important note: At present, if an existing preset is overwritten, everything will be reset to default values and must be specified again.

$On:

  • (optional) Ignored if standard blinking is used.
  • Syntax: Boolean

$Displacement time:

  • (optional) Displacement time for blinking (e.g. for Orion runway lights).
  • Syntax: Integer

$On time:

  • (optional) Amount of time the glowpoint stays on.
  • Syntax: Integer

$Off time:

  • (optional) Amount of time the glowpoint stays off.
  • Syntax: Integer

$Texture:

  • (optional) Specifies the name of the texture to use, or "none" for glowpoints that should only be light sources.
  • Syntax: String

$Type:

  • (optional) Defines what type of glowpoint this is (generally always 0).
  • Syntax: Integer

$Pulse type:

  • (optional) Specifies an interpolation of the glowpoint brightness with the given interpolation function.
  • Syntax: one of Sine, Cosine, Triangle, or ShiftedTriangle

$Pulse period:

  • (optional) The period of the selected interpolation function. The lower the value the faster the pulsing.
  • Syntax: Float
  • Default Value: Two times the “On time” from the model or table.

$Pulse amplitude:

  • (optional) Amplitude of the pulse function (unused with ShiftedTriangle).
  • Syntax: Float
  • Default Value: 0.5

$Pulse bias:

  • (optional) This is added to the function so one can control the minimum and maximum value (unused with ShiftedTriangle).
  • Syntax: Float
  • Default Value: 0.5

$Pulse exponent:

  • (optional) This raises the function to the given power to modify the look of the function (unused with ShiftedTriangle).
  • Syntax: Float
  • Default Value: 1.0

+light

  • (optional) Makes this glowpoint emit light. Further defined via additional sub-entries
  • If +light is used, $Light color: is required

$Light radius multiplier:

  • (optional) Multiplied by the radius of the glowpoint to get the radius of the light.
  • Syntax: Float
  • Default Value: 15.0

$Light color:

  • Specifies the RGB values for the light.
  • Syntax: Int, Int, Int (0 - 255)

$Light mix color:

  • (optional) Requires $Pulse type:. Instead of dimming the light by the glowpoint intensity, linearly interpolates between $Light color: and $Light mix color: (cross-fade).
  • Syntax: Int, Int, Int (0 - 255)
  • Default Value: 0, 0, 0

+lightcone

  • (optional) Makes this light a cone. Further defined via additional sub-entries
  • If +lightcone is used, $Cone direction: is required

$Cone angle:

  • (optional) Defines how wide this lightcone is.
  • Syntax: Float (0 - 180)
  • Default Value: 90.0

$Cone direction:

  • The direction the cone points in, in submodel space.
  • Syntax: (Float, Float, Float)

+dualcone

  • (optional) Allows the light cone to shine in both the direction specified and in the opposite direction.

+rotating

  • (optional) Makes this light cone rotate. Further defined via additional sub-entries, both required.
$Rotation axis:
  • The axis of rotation, in submodel space.
  • Syntax: (Float, Float, Float)
$Rotation speed:
  • Speed of rotation, specified as the number of rotations per minute.
  • Syntax: Float