# .imgToTigcc-rc
# This file controls how imtToTigcc converts images.

##### Image Conversion Options #####

# NumColors is the number of colors to use. This should be 2, 4, 7, or 8.
NumColors=4

# UseMask determines whether to create a mask (=1 where image is transparent)
# for each image.
UseMask=true

# TransparentColor is the color that is treated as transparent for creating the
# mask and is a white pixel in the image. It is specified as R,G,B (integers
# from 0 to 255). Leave blank for no transparent color.
TransparentColor=255,0,255

# MinOpaqueAlpha: for image formats with an alpha/transparency channel, this is
# the minimum alpha value that is treated as opaque: any pixel with alpha value
# lower than this is treated as transparent (masked out and white).
MinOpaqueAlpha=128

# ColorTransformation specifies how to move from 256 brightness levels down to
# <NumColors> shades of gray.
#     msb: use the most significant bits as the actual color bits (1 in B&W, 2
#         4-level grayscale, 3 in 7 or 8 level grayscale) [recommended]
#     levels=n1,n2,...: use numbers n1,n2,... as the dividers between colors:
#         0 to n1-1 is black, n1 to n2-1 is the next shade of gray, and so on
#         (there should be <NumColors>-1 numbers here)
ColorTransformation=msb

# BrightnessMapping controls how colors are converted to gray values. If your
# original image is in grayscale, then this option has no effect. Values:
#     maxchannel: the max of r, g, and b is used as the pixel brightness
#     average: (r+g+b)/3 is used as the brightness
#     yuv: (.299r+.587g+.114b) is used as the brightness; this gives a closer
#         approximation to how the human eye senses brightness.
BrightnessMapping=maxchannel

##### Input File Options #####

# InputFileMode specifies how imgToTigcc chooses what images to load.
#     inclusive: convert all image files in the current directory,
#         except those listed in InputExceptions.
#     exclusive: only convert the images listed listed in InputExceptions.
InputFileMode=inclusive

# InputExceptions is a list of files that are exceptions to the rule
# InputFileMode: if InputFileMode is 'inclusive', these files will not
# be converted; if it is 'exclusive', then these files are the only ones that
# will be converted.
# example: InputExceptions=image1.png,subdir/image2.png,"image with spaces.png"
InputExceptions=

# UseSubDirs determines whether to convert images in subdirectories of the
# current directory; if it is true, imgToTigcc will also search subdirectories
# of the current directory for images to convert.
UseSubDirs=false

##### Variable Name Options #####

# imgToTigcc creates the variable name of the c arrays by applying processing
# to the original filename; these options specify how input filenames map to
# variable names.

# DisallowedChars controls how to deal with characters in the input filename
# are not permitted in c variable names, such as ' ', '#', and '-'.
#     replace: replace disallowed characters with '_'
#     remove: remove disallowed characters from the variable name
DisallowedChars=replace

# RemoveExtensions removes the filename extension from the variable name, so
# file ship.png becomes variable ship; if false, it becomes ship_png
RemoveExtensions=true

# VarCase controls the case of the variable names
#     original: leave the original capitalization from the filenames
#     upper: convert all alphabetic characters to uppercase
#     lower: convert all alphabetic characters to lowercase
#     camel: convert variable names to camelCase
#     uppercamel: convert all variable names to UpperCamelCase
VarCase=original

# PlaneIdentifiers decides how to name the different planes of a grayscale
# image. numeric=0,1,...; words=Light, Medium, Dark
PlaneIdentifiers=numeric

##### Output File Options #####

# UseSingleFile, when true, will produce a single pair of output files (.h/.c)
# containing all of the converted images. When it is false, it will produce
# one .c/.h pair for each image converted; it will name these files the same as
# the variable name (specified in the variable name section)
UseSingleFile=true

# OutputFileName determines the output file name when UseSingleFile is true. If
# UseSingleFile is true, the output filenames will be <OutputFileName>.h and
# <OutputFileName>.c. This option isn't used when UseSingleFile is false.
OutputFileName=tiImageData