pfpalettize(1pf)

NAME
     pfpalettize - OpenGL Performer texture palettizer

SYNOPSIS
     pfpalettize [ options ] infile1 [ infile2 ... ]

DESCRIPTION
     pfpalettize is one of the sample programs distributed with the OpenGL
     Performer high-performance graphics library.  pfpalettize loads one or
     more files into an OpenGL Performer scene graph, searches for all
     textures and palettizes them according to defaults or options specified,
     and then writes the resulting scene graph to an output file and writes
     the newly created palettized textures out to new palettized image files.




   pfpalettize command line options
              -h                         - "Usage" message


              -m <margin>                - Enabel mimpapping and specify margin surrounding
                                           tiles in palettes

                  There is often a need for a space between textures in the palette
                  due to "bleeding" between adjacent textures at high magnification
                  levels.  margin is a the number of pixels to be placed around
                  each original texture.  The space between adjacent textures then
                  becomes 2 * margin.  Space is filled in with a repeated pixel
                  from the edge of the texture that has been palettized.

                  Keep in mind that texture palettes must be of a power of 2.  Thus,
                  there exists a trade-off for textures originally sized by dimensions
                  which are a power of 2 and that would otherwise fit neatly within a
                  larger container.  Space is wasted when margins are added.  The
                  trade-off is between quality (if textures are view up-close) and
                  resource (texture memory) usage.

              -M <ext>,<mode>,<value>       -Set converter mode (default value is 1)
                  pfb modes
                  1 -> PFPFB_SAVE_TEXTURE_IMAGE
                        0 - save only file names, not images (default)
                        1 - save texture images in pfb file
                  2 -> PFPFB_SAVE_TEXTURE_PATH
                        0 - save only texture image file name (default)
                        1 - save full path of texture image file
                  3 -> PFPFB_SHARE_GS_OBJECTS
                        0 - don't share graphics state objects
                        1 - share graphics state objects (default)
                  4 -> PFPFB_COMPILE_GL
                        0 - don't make compiled gl objects (default)
                        1 - always make compiled gl objects
                        2 - make compiled gl objects as saved
                  5 -> PFPFB_SAVE_TEXTURE_PFI
                        0 - don't convert .rgb texture images to .pfi (default)
                        1 - convert .rgb texture images to .pfi


              -o <file.ext>             - Write scene in .ext format

                  If not specified is "out.pfb" by default.  Since texture coordinates
                  will be affected during palettization, the input database or model
                  with the modified texture coordinates should be stored.  Any Performer
                  loader that can also store can be specified by file extension.

                  For example,

                      % pfPalettize -o cow.pfb cow.obj

                  will store the database in "pfb" format.


              -p <prefix>                - Textures will be saved to "<prefix>###.rgba"

                  If not specified is "texture###.rgba", where ### is a sequence of
                  numbers.  New textures are created as a result of palettization.
                  These textures are stored for referral by the new database.  Any
                  string specified in prefix will be prepended to the sequence number
                  and "rgba" extension and will be used as the name of the file they
                  are written to and as the name of the pfTexture when loaded.

                  For example,

                      % pfPalettize -p /usr/tmp/Images/myNewImages town_ogl.pfb

                  will store the new texture palette myNewImages001.rgba to the directory
                  /usr/tmp/Images.

              -w <sSize,tSize>           - Maximum palette size

                  If not specified, sSize and tSize are set to 512.  This specifies the
                  maximum width and height to make the new palettes.  This size is
                  decreased by half until the least possible area is wasted.





SEE ALSO
     performer, pfconv