Stars.tbl

From FreeSpace Wiki
Revision as of 20:47, 21 May 2007 by ARSPR (talk | contribs) (Stars)
Jump to: navigation, search

Stars.tbl is used to define available background graphics, all the stars or suns that create colored light for the game and used debris animations.

General Format

  • Stars.tbl consist of several sections
  • Between different sections #End must be used
  • Background graphics
    • Defines the available background graphics (nebulas, planets, etc.)
  • Stars
    • Defines the stars
  • Non-nebula debris
    • Defines animation for non-nebula mode
  • Nebula debris
    • Defines animation for nebula mode
  • #End
    • Must be included to the end of the stars.tbl

Background graphics

  • Background graphics use the names of their respective graphic files
  • Background graphics can be defined in to different forms:
    • $Bitmap:
      • This entry type is used for transparent objects such as background nebulas
      • Syntax: Name
    • $BitmapX:
      • This entry type is used for non transparent objects such as planets
    • Syntax: Name

Stars

  • Stars are defined with several different parameters.
    • $Sun:
      • Defines the name of the used star
      • Syntax: Name
    • $SunGlow:
      • Defines the bitmap or animation used as a glow for the star
      • Syntax: Name
    • $SunRGBI:
      • Defines the color of the sun as well as it's intensity
      • Syntax: Value Value Value Value, (red, green, blue and intensity respectively)
    • $SunSpecularRGB:
      • Defines the color of the sun specuular lighting if it is to be different from $SunRGBI: values
      • Syntax: Value Value Value, (red, green and blue respectively)
    • $Flare:
      • Defines lens flare effect.
      • +FlareCount:
        • Defines number of lens flare effects attached yo the sun, if the value is omitted then 1 is used as a default number of flare effects.
        • Syntax: Value
      • $FlareTextureN:
        • Defines the name of the bitmap used for the particular ( N ) lens flare texture.
        • Syntax: Name
      • For each (defined in +FlareCount:) lens flare effect
        • $FlareGlowX:
          • Defines the Xth lens flare effect.
          • +FlareTexture:
            • Defines the texture used for the lens flare effect.
            • Syntax: Value, number of the texture defines in $FlareTextureN:.
          • +FlarePos:
            • Defines the position of the lens flare effect, relative value
            • Syntax: Value
          • +FlareScale:
            • Defines the scaling factor used for the lens flare effect.
            • Syntax: Value
    • $NoGlare:
      • Disables blinding in that sun.
      • Syntax: Just put $NoGlare: without any parameters

Non-nebula debris

  • There must always be four (4) of these
    • $Debris:
      • Defines the animations used for the debris
      • Syntax: Name

Nebula debris

  • There must always be four (4) of these
    • $DebrisNeb:
      • Defines the animations used for the debris
      • Syntax: Name

Sample

   $Bitmap:      dneb01
  #end
   $Sun:         SunWhite
   $Sunglow:     Sunglow01
   $SunRGBI:     1.0 1.0 1.0 1.0
  #end
   $Debris:      debris01
   $Debris:      debris02
   $Debris:      debris03
   $Debris:      debris04
  #end
   $DebrisNeb:   gas
   $DebrisNeb:   gas
   $DebrisNeb:   gas
   $DebrisNeb:   gas
  #end
  #end