Difference between revisions of "Nebula.tbl"

From FreeSpace Wiki
Jump to: navigation, search
(initial page commit)
 
 
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Nebula.tbl is used to define the various nebula bitmaps and poofs.
+
{{SCP_table}}
 +
{{TableVersionGit|2024-08-26|91a673ac586a57e8f7793f08985b6f17a7fd1aa7}}
 +
{{Tables}}
 +
The '''nebula.tbl''' is used to define the various nebula bitmaps and poofs.
 +
 
 +
This table is one of the [[Modular Tables]] and can be extended with xxx-neb.tbm
  
 
==Format==
 
==Format==
*Table begins with list of all bitmaps available for the nebulas
+
*Table begins with list of all bitmaps available for the nebulae
 
*Section ends with '''#end'''
 
*Section ends with '''#end'''
 
*Second section is a list of nebula poofs that also ends with '''#end'''
 
*Second section is a list of nebula poofs that also ends with '''#end'''
 +
  
 
==+Nebula:==
 
==+Nebula:==
 
*Defines the graphics used for the nebula bitmaps
 
*Defines the graphics used for the nebula bitmaps
*Syntax: ''string''
+
*Syntax: '''String'''
 +
 
  
 
==+Poofs:==
 
==+Poofs:==
 
*Defines the used nebula poofs
 
*Defines the used nebula poofs
*Syntax: ''string''
+
*Syntax: '''String'''
 +
 
 +
 
 +
==$Name:==
 +
{{Table214|
 +
*Defines a named poof with more configuration option than retail poofs.
 +
*Syntax: '''String'''
 +
}}
 +
===+nocreate===
 +
{{Table224|
 +
*Allows editing of the nebula entry without creating a new entry}}
 +
===$Bitmap:===
 +
{{Table214|
 +
*The filename for the poof bitmap. Required for a named poof.
 +
*Syntax: '''''String''''', filename
 +
}}
 +
===$Scale:===
 +
{{Table214|
 +
*The radius of a spawned named poof.
 +
*Syntax: '''(Float)''' or '''(Float Float)''', meters, will pick a random value between the two specified values, or the value if only one is specified
 +
{{Table242|
 +
*Syntax is now a [[Parsed random range]].
 +
}}
 +
*Default value: (175)
 +
}}
 +
===$Density:===
 +
{{Table214|
 +
*On average, how much space in every dimension between two named poofs.
 +
Note: This is scaled depending on how many poofs are active, as to not change total perceived density regardless of how many poofs are active
 +
*Syntax: '''Float''', meters
 +
*Default value: 110
 +
}}
 +
===$Alignment:===
 +
{{Table242|
 +
*This is a directional vector which will cause the poofs to align themselves in the specified world direction. With 0, 1, 0, all the poofs will point the top of their bitmap in the global up direction.
 +
*Syntax: Vector, three floats, x-axis, y-axis, z-axis, respectively
 +
}}
 +
===$Rotation:===
 +
{{Table214|
 +
*How much the spawned named poof will rotate over time.
 +
*Syntax: '''(Float)''' or '''(Float Float)''', degrees per second, will pick a random value between the two specified values, or the value if only one is specified
 +
{{Table242|
 +
*Syntax is now a [[Parsed random range]].
 +
}}
 +
*Default value: (-3.7, 3.7)
 +
}}
 +
===$View Distance:===
 +
{{Table214|
 +
*The maximum distance at which this named poof can be visible
 +
*Syntax: '''Float''', meters
 +
*Default value: 250
 +
}}
 +
===$Alpha:===
 +
{{Table214|
 +
*The opacity of the spawned named poof.
 +
*Syntax: '''(Float)''' or '''(Float Float)''', will pick a random value between the two specified values, or the value if only one is specified
 +
{{Table242|
 +
*Syntax is now a [[Parsed random range]].
 +
}}
 +
*Default value: (0.8)
 +
}}
  
 
==Sample==
 
==Sample==

Latest revision as of 18:49, 19 September 2024

This feature requires FreeSpace Open

Revision information.....

FSO Git Commit: Date: 2024-08-26 SHA: 91a673ac586a57e8f7793f08985b6f17a7fd1aa7
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 nebula.tbl is used to define the various nebula bitmaps and poofs.

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

Format

  • Table begins with list of all bitmaps available for the nebulae
  • Section ends with #end
  • Second section is a list of nebula poofs that also ends with #end


+Nebula:

  • Defines the graphics used for the nebula bitmaps
  • Syntax: String


+Poofs:

  • Defines the used nebula poofs
  • Syntax: String


$Name:

FS2 Open, 21.4:
  • Defines a named poof with more configuration option than retail poofs.
  • Syntax: String

+nocreate

FS2 Open, 23.0:
  • Allows editing of the nebula entry without creating a new entry

$Bitmap:

FS2 Open, 21.4:
  • The filename for the poof bitmap. Required for a named poof.
  • Syntax: String, filename

$Scale:

FS2 Open, 21.4:
  • The radius of a spawned named poof.
  • Syntax: (Float) or (Float Float), meters, will pick a random value between the two specified values, or the value if only one is specified
FS2 Open, 24.2:
  • Default value: (175)

$Density:

FS2 Open, 21.4:
  • On average, how much space in every dimension between two named poofs.

Note: This is scaled depending on how many poofs are active, as to not change total perceived density regardless of how many poofs are active

  • Syntax: Float, meters
  • Default value: 110

$Alignment:

FS2 Open, 24.2:
  • This is a directional vector which will cause the poofs to align themselves in the specified world direction. With 0, 1, 0, all the poofs will point the top of their bitmap in the global up direction.
  • Syntax: Vector, three floats, x-axis, y-axis, z-axis, respectively

$Rotation:

FS2 Open, 21.4:
  • How much the spawned named poof will rotate over time.
  • Syntax: (Float) or (Float Float), degrees per second, will pick a random value between the two specified values, or the value if only one is specified
FS2 Open, 24.2:
  • Default value: (-3.7, 3.7)

$View Distance:

FS2 Open, 21.4:
  • The maximum distance at which this named poof can be visible
  • Syntax: Float, meters
  • Default value: 250

$Alpha:

FS2 Open, 21.4:
  • The opacity of the spawned named poof.
  • Syntax: (Float) or (Float Float), will pick a random value between the two specified values, or the value if only one is specified
FS2 Open, 24.2:
  • Default value: (0.8)

Sample

  • Retail FreeSpace 2 table
+Nebula:			nbackblue1
+Nebula:			nbackblue2
+Nebula:			nbackcyan
+Nebula:			nbackgreen
+Nebula:			nbackpurp1
+Nebula:			nbackpurp2
+Nebula:			nbackred
+Nebula:			nbackblack

#end

+Poof:				PoofGreen01
+Poof:				PoofGreen02
+Poof:				PoofRed01
+Poof:				PoofRed02
+Poof:				PoofPurp01
+Poof:				PoofPurp02

#end