bzlogo(6D)

NAME
     bzlogo - convert SGI images to the logo format for bz

SYNOPSIS
     bzlogo imgfile logofile [ -left | -right ] [ stepsize ]

DESCRIPTION
     Bzlogo converts an SGI RGB image file to a format that bz(6D) can load.
     The stepsize option allows some control over the refinement of the
     result.  The default value is 2.  If the program fails, try increasingly
     higher values until it succeeds.

     The left and right options indicate that the logo should appear as is on
     the left and right side of the tank, respectively, and should be flipped
     on the opposite side.  This allows logos to be built that have a
     preferred direction with respect to the front of the tank.

LOGO FILE FORMAT
     The logo file is an ASCII file and describes a set of triangluar meshes.
     The format is as follows:

               # BZLOGO Version 1.1
               optional_global_qualifier
               command
               number_of_points
               X-Y 1
               X-Y 2
                ...
               X-Y n
               command
               number_of_points
               X-Y 1
               X-Y 2
                ...
               X-Y n
                ...
               command

     In the above, command can be any of the following:

     BGNTMESH
             Starts a triangular mesh sequence.  This must be the first
             command.

     SWAPTMESH
             Performs a swaptmesh and continues on with new points.

     ENDBGNTMESH
             Ends one triangular mesh and starts a new one.

     RETENDTMESH
             Ends the logo and is the final command processed.

     The line indicated above by optional_global_qualifier can be absent or
     replaced by one of the following:

     LEFTSIDE
             Indicates that the logo should appear as described on the left
             side of the tank and reversed when displayed on the right side.

     RIGHTSIDE
             Indicates that the logo should appear as described on the right
             side of the tank and reversed when displayed on the left side.

     An example file which describes a forward-pointing-arrow is shown below.

               # BZLOGO Version 1.1
               RIGHTSIDE
               BGNTMESH
                  3
                  161 50
                  161 79
                  161 39
               SWAPTMESH
                  1
                  161 172
               SWAPTMESH
                  4
                  158 168
                  158 86
                  3 168
                  147 86
               SWAPTMESH
                  1
                  7 86
               SWAPTMESH
                  2
                  0 89
                  0 165
               SWAPTMESH
                  2
                  0 154
                  0 96
               ENDBGNTMESH
                  3
                  255 125
                  247 118
                  247 132
               SWAPTMESH
                  6
                  168 211
                  168 43
                  161 215
                  161 39
                  161 204
                  161 172
               RETENDTMESH

SEE ALSO
     bz(6D), bzviewlogo(6D).