Difference between revisions of "ImagePathFunctions"

From The Battle for Wesnoth Wiki
(Flip Function)
(Document RC(a=b) and CROP image path functions of SVN trunk)
Line 10: Line 10:
  
 
== Re-Color Function ==
 
== Re-Color Function ==
May be used to change some colors in an image
+
May be used to change some colors in an image.
 
=== Syntax ===
 
=== Syntax ===
 
'''~RC(''' ''source color palette'' '''>''' ''color range ID'' ''')'''
 
'''~RC(''' ''source color palette'' '''>''' ''color range ID'' ''')'''
 
*''source color palette'' - the first parameter is a source color palette, usually magenta. Do not surround this parameter with quotes.
 
*''source color palette'' - the first parameter is a source color palette, usually magenta. Do not surround this parameter with quotes.
*''color range ID'' - this is the second parameter,signifying the ID of a color range defined in the file ''data/team-colors.cfg'' (or it may be a custom ID for a color range defined locally).   
+
*''color range ID'' - this is the second parameter, signifying the ID of a color range defined in the file ''data/team-colors.cfg'' (or it may be a custom ID for a color range defined locally).   
 +
 
 +
{{DevFeature}} In the development version, the following syntax changes the RC function behavior for simply replacing colors matching the source color palette with colors of the target color palette:
 +
 
 +
'''~RC(''' ''source color palette'' '''=''' ''target color palette'' ''')'''
  
 
=== Example ===
 
=== Example ===
Line 39: Line 43:
 
=== Syntax ===
 
=== Syntax ===
 
'''~GS( )'''
 
'''~GS( )'''
 +
 +
== Crop Function {{DevFeature}} ==
 +
Extracts a rectangular section of an image file.
 +
=== Syntax ===
 +
'''~CROP(x,y,width,height)'''
 +
* ''x'',''y'': top-left corner coordinates for the rectangular section extracted. Must be greater or equal than zero, and inside the image's bounds.
 +
* ''width'': width of the selected region. Must be less than or equal to the original image's width.
 +
* ''height'': height of the selected region. Must be less than or equal to the original image's height.
  
 
[[Category:WML Reference]]
 
[[Category:WML Reference]]

Revision as of 23:20, 7 September 2008

Image Path Functions provide a simple method for WML coders to alter the way their specified images will be displayed in the game. All of the function parameters are included at the end of an image path and should not contain any spaces or special characters (other than those specified here).

Team-Color Function

In Wesnoth version 1.2, the only Image Path Function was ~TC(), which took two comma-separated parameters: the team number and the source color palette. The valid values for both of these parameters are defined in the file data/team-colors.cfg

Syntax

~TC( team number , source color palette )

  • team number - this is the first parameter, a number 1-9 signifying the team number of a unit. Number 1 typically means the red team, 2 typically means the blue team, and so on (unless the scenario color settings for any side have been altered).
  • source color palette - the second parameter is a source color palette, usually magenta. Do not surround this parameter with quotes.

Re-Color Function

May be used to change some colors in an image.

Syntax

~RC( source color palette > color range ID )

  • source color palette - the first parameter is a source color palette, usually magenta. Do not surround this parameter with quotes.
  • color range ID - this is the second parameter, signifying the ID of a color range defined in the file data/team-colors.cfg (or it may be a custom ID for a color range defined locally).

Template:DevFeature In the development version, the following syntax changes the RC function behavior for simply replacing colors matching the source color palette with colors of the target color palette:

~RC( source color palette = target color palette )

Example

In the following example, the magenta regions in an elvish captain's image are turned a healthy shade of green:

     [message]
           speaker=narrator
           image=units/elves-wood/captain.png~RC(magenta>green)
           message=_ "Now I am on the green team."
     [/message]

The IDs of the color ranges may be the lowercased English name of the palette's base color (e.g. 'red', 'brown', etc.). They may also be numeric color indices from the palette WML included with the game, but this is not recommended

Flip Function

May be used to flip an image horizontally and/or vertically

Syntax

~FL( optional argument list )

  • vertical - if the string "vert" is found anywhere in the argument list, the image will be flipped vertically.
  • horizontal - if the string "horiz" is found anywhere in the argument list, the image will be flipped horizantally.
  • if the argument list is empty, the image will only be flipped horizantally.

Greyscale Function

May be used to greyscale the image (turn to black and white)

Syntax

~GS( )

Crop Function Template:DevFeature

Extracts a rectangular section of an image file.

Syntax

~CROP(x,y,width,height)

  • x,y: top-left corner coordinates for the rectangular section extracted. Must be greater or equal than zero, and inside the image's bounds.
  • width: width of the selected region. Must be less than or equal to the original image's width.
  • height: height of the selected region. Must be less than or equal to the original image's height.