Difference between revisions of "Colors.tbl"

From FreeSpace Wiki
Jump to: navigation, search
(General Format)
(Updated with new info pertaining to team colors)
Line 1: Line 1:
{{TableVersion|7809}}
+
{{TableVersion|9058}}
  
The '''colors.tbl''' allows editing of the default color values used for text in various game locations.
+
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.
  
  
Line 11: Line 11:
 
*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).
 
*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).
 
*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==
 
==Possible Colors==
Line 42: Line 45:
 
*However, any colors included must be included in the order specified above, otherwise they will be skipped.
 
*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.
 
*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 102: Line 106:
 
$UI Light Pink: (184 161 161 255)
 
$UI Light Pink: (184 161 161 255)
 
$UI Pink: (228 190 190 255)
 
$UI Pink: (228 190 190 255)
 +
 +
#End
 +
</pre>
 +
 +
==Example Team Color using table==
 +
This example table is provided by TAP.
 +
<pre>
 +
#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
 
#End

Revision as of 04:44, 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

General Format

  • Colors.tbl simply starts with "#Start Colors" (without the quotes)
  • 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
  • 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

Syntax and Usage

  • 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

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

#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)
$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 Team Color using table

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