pfpalettize(1pf) IRIS Performer 2.2 Reference Pages pfpalettize(1pf)
NAME
pfpalettize - IRIS Performer texture palettizer
SYNOPSIS
pfpalettize [ options ] infile1 [ infile2 ... ]
DESCRIPTION
pfpalettize is one of the sample programs distributed with the IRIS
Performer high-performance graphics library. pfpalettize loads one or
more files into an IRIS 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
Page 1
pfpalettize(1pf) IRIS Performer 2.2 Reference Pages pfpalettize(1pf)
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
Page 2