Glowpoints.tbl

From FreeSpace Wiki
Revision as of 03:32, 14 May 2015 by AdmiralRalwood (talk | contribs) (Changing TableVersionGit date references from MM/DD/YY to YYYY-MM-DD because it more closely matches Nightly build revision info (also, less US-centric; see RFC 3339 et al.).)
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


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

List of Tables

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:

$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:

$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:
$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