readme.txt for pants folder
----------------------------

Pants texture
---------------

Starting from OOTP 23 it is also possible to adjust the pants texture of the team.

Whenever pants are "painted" for the first time when starting a new game or changing the pants design, the game creates a texture based on one of the templates (default_pants_*.png), which you can find in the folder /data/pants. Don't change those files!

If you want to create customized textures for certain teams, do the following:

- go to folder /data/pants
- make a copy of one of the default pants template files
- rename the copy to pants_TEAMNAME_TEAMNICKNAME.png (change TEAMNAME and TEAMNICKNAME to your team's names)
Remove all dots in the team name and nickname, and replace all spaces with underlines.
- edit the file as you like.

You can leave the new pants texture file in the folder (/data/pants). This will allow all new leagues you create in OOTP to use the texture for a team with the same name. 

Or, if you prefer to use the texture in a single save only, then move the file to that league's save folder (/data/saved_games/GAMENAME/pants). Then only teams in only that saved game will use the new texture.

When the game looks for a texture, it will first look in the league folder and use a texture file if it exists. If there is no file, it will look into the global folder (/data/pants) and if it finds a texture file for the team there, it will be copied into the league folder and used from there in the future.
If no file is found at all, the game will load one randomly selected template file (/data/pants/default_pants_*.png) and "paint" the texture using the team colors.

Pants normal map
-------------------

In addition to the pants texture starting from OOTP 23 there is an optional normal map file.
The normal map enhances the pants texture by adding details through faking lighting of bumps and dents.

Unlike the pants texture it is not "painted", when creating new pants, but rather copied without any change.

So far there is a single normal map file (/data/pants/default_pants_normal_map.png) that will be used for all pants in the game.

Changing this file in /data/pants will affect all pants for all new games, changing its copy in /data/saved_games/GAMENAME/pants will affect only that saved game.

Pants logo file + individual colors
-------------------

Pants don't have a logo attached to them. Hence, there is no logo file for the pants to be loaded.

Individual colors can be defind by the color codes in the team main logo filename or in an additional csv file "TEAMNAME_TEAMNICKNAME_color_settings.csv". 

See /data/logos/_readme.txt for more details.


Alternate uniforms properties
-------------------

Besides colors for home and away pants it is now also possible to specify colors codes and other properties in the filenames of alternate uniform textures.

The scheme is:

pants_TEAMNAME_TEAMNICKNAME_ALTERNATEUNIFORMNAME__WEEKDAYS_HA-SWITCHES_COLOR1_COLOR2_COLOR3.png

where

TEAMNAME		is the name of the team.
TEAMNICKNAME		is the nickname of the team.
ALTERNATEUNIFORMNAME	is the name of the alternate uniform.
WEEKDAYS 		are the weekdays the selected uniform will be used. 3 letter per day (Mon, Tue, Wed, Thu, Fri, Sat, Sun), can be specified individually: MonSun, in a range: Mon-Fri, Sun-Tue, or both: Wed-SatMon. The order does not matter.
HA-SWITCHES		set "h" to use the selected uniform for home games, "a" for away games, both "ha" for home and away games, or leave it blank to not change the existing options.
COLOR1-3		are the max. 3 colors of the pants in HEX (6 characters, 3x 00-FF) or RGB (9 characters, 3x 000-255) color codes. No prefixes are needed that are used in logo filename (C1H etc.). First color will change pants main color, second the belt color and third the pin stripes color in that order.

Note the double underscore ("__") after the name of the alternate uniform. This is needed as both the team name and uniform name can consist of several words.
As the home-away switches and weekdays are a uniform (contains ballcap, jersey, pants ...) property, changing these values when loading a pants texture will change it also for other items (ballcap, jersey ...) of this uniform.
All codes and names are optional. The codes will be parsed and used while loading a texture through the uniforms dialog in the game only when a double underscore ("__") is found in the filename.


Examples: 

- pants_city_nickname_alt_123__Fri-MonSun_h_ff4422_007755.png		when loading this texture the selected uniform will be changed to be worn on Friday, Saturday, Sunday and Monday for home games. Pants main color will be changed to ff4422 and visor color to 007755, pin stripes color will remain the same.
- something__TueThu.png							when loading this texture the selected uniform will be changed to be worn on Tuesday and Thursday, home-away options will remain the same, colors stay unchanged.
- pants_city_alt__Wed_ha_123123123.png					when loading this texture the selected uniform will be changed to be worn on Wednesday for home and away games. Pants main color will be changed to 123123123.

Note that theses codes will not be parsed when automatically load/update uniforms through an XML file, see /data/colors/_readme.txt for more details.