Difference between revisions of "Glowpoints.tbl"
From FreeSpace Wiki
(Initial documentation for glowpoints.tbl, based on the original GlowpointSpec document and poking around the relevant code.) |
(Document default off feature) |
||
| (4 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{TableVersionGit|05 | + | {{TableVersionGit|2015-05-12|5dfbc6d292}} |
| − | + | {{Tables}} | |
The '''glowpoints.tbl''' defines glowpoint lights for ships under the new deferred lighting renderer. | 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 | This table is one of the [[Modular Tables]] and can be extended with xxx-gpo.tbm | ||
| − | |||
| − | |||
=General Format= | =General Format= | ||
| Line 26: | Line 23: | ||
* (optional) Ignored if standard blinking is used. | * (optional) Ignored if standard blinking is used. | ||
*Syntax: '''''Boolean''''' | *Syntax: '''''Boolean''''' | ||
| + | |||
| + | ==$Default Off:== | ||
| + | {{Table232| | ||
| + | * (optional) Defaults the glowpoint as being OFF on mission start or model load. | ||
| + | *Syntax: '''''Boolean'''''}} | ||
==$Displacement time:== | ==$Displacement time:== | ||
| Line 72: | Line 74: | ||
==+light== | ==+light== | ||
| − | * (optional) Makes this glowpoint emit light. Further defined via additional sub-entries: | + | * (optional) Makes this glowpoint emit light. Further defined via additional sub-entries |
| + | * If +light is used, '''''$Light color:''''' is required | ||
| + | |||
| + | ===$Light intensity:=== | ||
| + | {{Table224| | ||
| + | * (optional) The intensity of the light (brightness). | ||
| + | *Syntax: '''''Float''''' | ||
| + | *Default Value: 1.0}} | ||
===$Light radius multiplier:=== | ===$Light radius multiplier:=== | ||
| Line 89: | Line 98: | ||
===+lightcone=== | ===+lightcone=== | ||
| − | * (optional) Makes this light a cone. Further defined via additional sub-entries: | + | * (optional) Makes this light a cone. Further defined via additional sub-entries |
| + | * If +lightcone is used, '''''$Cone direction:''''' is required | ||
====$Cone angle:==== | ====$Cone angle:==== | ||
| Line 104: | Line 114: | ||
====+rotating==== | ====+rotating==== | ||
| − | * (optional) Makes this light cone rotate. Further defined via additional sub-entries | + | * (optional) Makes this light cone rotate. Further defined via additional sub-entries, both required. |
=====$Rotation axis:===== | =====$Rotation axis:===== | ||
Latest revision as of 18:51, 12 February 2023
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
Contents
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
$Default Off:
FS2 Open, 23.2:
- (optional) Defaults the glowpoint as being OFF on mission start or model load.
- 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 intensity:
FS2 Open, 23.0:
- (optional) The intensity of the light (brightness).
- Syntax: Float
- Default Value: 1.0
$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