Difference between revisions of "Colors.tbl"

From FreeSpace Wiki
Jump to: navigation, search
(Updated with new info pertaining to team colors)
(Edited layout to match all of the other tables in the wiki)
Line 5: Line 5:
  
 
[[Tables|List of Tables]]
 
[[Tables|List of Tables]]
 +
==#Start Colors==
 +
This section currently defines a set of color overrides for the built-in colors. Is required by [[Colors.tbl##Team Colors|#Team Colors]].
  
==General Format==
+
===$Blue:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
  
*Colors.tbl simply starts with "#Start Colors" (without the quotes)
+
*Default Value: ( 93 93 128 255 )
*All following entries are of the form "$Color name: (R G B A)" (without the quotes, but with the brackets), where R, G, B, and A are red, green, blue and alpha values (between 0 and 255 inclusive).
 
*Colors.tbl must end with "#End" (without the quotes).
 
*If Team Colors are to be used, continue after heare and start with "#Team Colors"
 
*A single team color entry is of the form "$Team Name: <string>", "$Team Stripe Color: ( R G B )", "$Team Base Color: ( R G B )"
 
*Following the last entry, another "#End" is neccesary.
 
  
==Possible Colors==
 
  
*Blue
+
===$Bright Blue:===
*Bright Blue
+
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
*Green
+
*Valid Values: 0 - 255
*Bright Green
 
*Black
 
*Grey
 
*Silver
 
*White
 
*Bright White
 
*Violet Gray
 
*Violet
 
*Dim Red
 
*Red
 
*Bright Red
 
*Pink
 
*Light Pink
 
*Yellow
 
*Bright Yellow
 
*UI Light Green
 
*UI Green
 
*UI Light Pink
 
*UI Pink
 
  
==Syntax and Usage==
+
*Default Value: ( 185 185 255 255 )
 +
 
 +
 
 +
===$Green:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 0 120 0 255 )
 +
 
 +
 
 +
===$Bright Green:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 50 190 50 255 )
 +
 
 +
 
 +
===$Black:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 0 0 0 255 )
 +
 
 +
 
 +
===$Silver:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 160 160 160 255 )
 +
 
 +
 
 +
===$White:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 105 105 105 255 )
 +
 
 +
 
 +
===$Bright White:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 255 255 255 255 )
 +
 
 +
 
 +
===$Violet Gray:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 160 144 160 255 )
 +
 
 +
 
 +
===$Violet:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 192 104 192 255 )
 +
 
 +
 
 +
===$Dim Red:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 80 6 6 255 )
 +
 
 +
 
 +
===$Red:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 126 6 6 255 )
 +
 
 +
 
 +
===$Bright Red:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 200 0 0 255 )
 +
 
 +
 
 +
===$Pink:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 185 150 150 255 )
 +
 
 +
 
 +
===$Light Pink:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 230 190 190 255 )
 +
 
 +
 
 +
===$Yellow:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 255 255 122 255 )
 +
 
 +
 
 +
===$Bright Yellow:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 255 255 0 255 )
 +
 
 +
 
 +
===$UI Light Green:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 161 184 161 255 )
 +
 
 +
 
 +
===$UI Green:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 161 184 161 255 )
 +
 
 +
 
 +
===$UI Light Pink:===
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha )
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 184 161 161 255 )
 +
 
 +
 
 +
===$UI Pink:===
 +
*Syntax: '''Integer''' Red '''Integer''' Green '''Integer''' Blue '''Integer''' Alpha
 +
*Valid Values: 0 - 255
 +
 
 +
*Default Value: ( 228 190 190 255 )
 +
 
 +
 
 +
==#End==
 +
Required at the end of the [[Colors.tbl##Start Colors|#Start Colors]] section. No Exceptions.
 +
 
 +
 
 +
 
 +
==#Team Colors==
 +
Starts a new Team Colors section.
 +
{{Note|
 +
This section requires [[Colors.tbl##Start Colors|#Start Colors]] to be defined. The individual color overrides are optional.}}
 +
 
 +
 
 +
===$Team Name:===
 +
Defines a team name to use for a new color scheme.
 +
 
 +
 
 +
*Syntax: '''String'''
 +
 
 +
 
 +
====$Team Stripe Color:====
 +
Defines the RGB color for the team "stripe." This is applied to sections that go over the base color.
 +
 
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue )
 +
*Valid Values: ( 0 - 255, 0 - 255, 0 - 255 )
 +
 
 +
 
 +
====$Team Base Color:====
 +
Defines the RGB color for the base color of the crafts for a given team.
 +
 
 +
*Syntax: ( '''Integer''' Red '''Integer''' Green '''Integer''' Blue )
 +
*Valid Values: ( 0 - 255, 0 - 255, 0 - 255 )
 +
 
 +
 
 +
==#End==
 +
Required to end the [[Colors.tbl##Team Colors|#Team Colors]] section. No exceptions.
  
*All colors are optional (defaults will be used if the color is not specified).
 
*However, any colors included must be included in the order specified above, otherwise they will be skipped.
 
*Note that at this point colors.tbl only allows redefinition of the 22 pre-existing UI colors. New colors cannot be added as of yet.
 
*For team colors to be useable at all, one entry needs to exist here.
 
  
 
==Example Table==
 
==Example Table==
Line 51: Line 195:
 
<pre>
 
<pre>
 
#Start Colors
 
#Start Colors
 
;; This is colors.tbl. Here you can redefine the RGBA values for the 22 default colours for the UI.
 
;; Any redefining is optional, so you don't need to include all colors (the ones you skip will just use the default values).
 
;; However, any you DO redefine need to be placed in this order (and spelled this way):
 
 
;;$Blue
 
;;$Bright Blue
 
;;$Green
 
;;$Bright Green
 
;;$Black
 
;;$Grey
 
;;$Silver
 
;;$White
 
;;$Bright White
 
;;$Violet Gray
 
;;$Violet
 
;;$Dim Red
 
;;$Red
 
;;$Bright Red
 
;;$Pink
 
;;$Light Pink
 
;;$Yellow
 
;;$Bright Yellow
 
;;$UI Light Green
 
;;$UI Green
 
;;$UI Light Pink
 
;;$UI Pink
 
 
;;Redefine colors this way:
 
;;$Color Name: (RVALUE GVALUE BVALUE AVALUE) (the brackets are necessary!)
 
;;where RVALUE, GVALUE, BVALUE and AVALUE are integers between 0 and 255 inclusive
 
;;AVALUE is alpha value. Every default color just leaves this as 255, so if you're not sure, just use 255
 
 
 
$Blue: (93 93 128 255)
 
$Blue: (93 93 128 255)
 
$Bright Blue: (185 185 255 255)
 
$Bright Blue: (185 185 255 255)
Line 110: Line 221:
 
</pre>
 
</pre>
  
==Example Team Color using table==
+
==Example Table that has Team Colors==
 
This example table is provided by TAP.
 
This example table is provided by TAP.
 
<pre>
 
<pre>

Revision as of 06:04, 30 July 2012

Revision information.....

FSO Revision: 9058
Note: Please update the version when the page is updated. If your edit had nothing to do with new code entries then please do not edit the version


The colors.tbl allows editing of the default color values used for text in various game locations, as well as being used for team color declarations.


List of Tables

#Start Colors

This section currently defines a set of color overrides for the built-in colors. Is required by #Team Colors.

$Blue:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 93 93 128 255 )


$Bright Blue:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 185 185 255 255 )


$Green:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 0 120 0 255 )


$Bright Green:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 50 190 50 255 )


$Black:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 0 0 0 255 )


$Silver:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 160 160 160 255 )


$White:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 105 105 105 255 )


$Bright White:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 255 255 255 255 )


$Violet Gray:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 160 144 160 255 )


$Violet:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 192 104 192 255 )


$Dim Red:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 80 6 6 255 )


$Red:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 126 6 6 255 )


$Bright Red:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 200 0 0 255 )


$Pink:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 185 150 150 255 )


$Light Pink:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 230 190 190 255 )


$Yellow:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 255 255 122 255 )


$Bright Yellow:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 255 255 0 255 )


$UI Light Green:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 161 184 161 255 )


$UI Green:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 161 184 161 255 )


$UI Light Pink:

  • Syntax: ( Integer Red Integer Green Integer Blue Integer Alpha )
  • Valid Values: 0 - 255
  • Default Value: ( 184 161 161 255 )


$UI Pink:

  • Syntax: Integer Red Integer Green Integer Blue Integer Alpha
  • Valid Values: 0 - 255
  • Default Value: ( 228 190 190 255 )


#End

Required at the end of the #Start Colors section. No Exceptions.


#Team Colors

Starts a new Team Colors section.

Note: This section requires #Start Colors to be defined. The individual color overrides are optional.


$Team Name:

Defines a team name to use for a new color scheme.


  • Syntax: String


$Team Stripe Color:

Defines the RGB color for the team "stripe." This is applied to sections that go over the base color.

  • Syntax: ( Integer Red Integer Green Integer Blue )
  • Valid Values: ( 0 - 255, 0 - 255, 0 - 255 )


$Team Base Color:

Defines the RGB color for the base color of the crafts for a given team.

  • Syntax: ( Integer Red Integer Green Integer Blue )
  • Valid Values: ( 0 - 255, 0 - 255, 0 - 255 )


#End

Required to end the #Team Colors section. No exceptions.


Example Table

The values in this table are the code's default values.

#Start Colors
$Blue: (93 93 128 255)
$Bright Blue: (185 185 255 255)
$Green: (0 120 0 255)
$Bright Green: (50 190 50 255)
$Black: (0 0 0 255)
$Grey: (65 65 65 255)
$Silver: (160 160 160 255)
$White: (105 105 105 255)
$Bright White: (255 255 255 255)
$Violet Gray: (160 144 160 255)
$Violet: (192 104 192 255)
$Dim Red: (80 6 6 255)
$Red: (126 6 6 255)
$Bright Red: (200 0 0 255)
$Pink: (185 150 150 255)
$Light Pink: (230 190 190 255)
$Yellow: (255 255 122 255)
$Bright Yellow: (255 255 0 255)
$UI Light Green: (161 184 161 255)
$UI Green: (190 228 190 255)
$UI Light Pink: (184 161 161 255)
$UI Pink: (228 190 190 255)

#End

Example Table that has Team Colors

This example table is provided by TAP.

#Start Colors

#End

#Team Colors

$Team Name: Vaygr
   $Team Stripe Color:	( 26 26 26 )
   $Team Base Color:	( 230 230 230 )

$Team Name: Hiigaran
    $Team Stripe Color: ( 204 204 204 )
    $Team Base Color:   ( 93 141 170 ) 

$Team Name: Elite Vaygr
   $Team Stripe Color:	( 143 1 11 )
   $Team Base Color:	( 12 12 12 )

#End