man > pamtosrf(1)

Pamtosrf User Manual(1)                General Commands Manual               Pamtosrf User Manual(1)

NAME
       pamtosrf - convert a sequence of Netpbm images to a SRF image file



SYNOPSIS
       pamtosrf [-verbose] [netpbmfile]



DESCRIPTION
       This program is part of Netpbm(1).

       pamtosrf  reads a Netpbm image stream as input and produces a an SRF image file as output.  I
       don't know exactly what SRF is, but on popular use of it is  in  Garmin  vehicle  information
       files, which tell a GPS receiver how to depict a vehicle on its display.

       An  SRF file can contain multiple images; each image in a multi-image Netpbm input stream be‐
       comes one image in the SRF.

       pamtosrf does not care how many images there are or what their  dimensions  or  content  are.
       However,  a  Garmin  vehicle information file has specific requirements, so if you don't make
       your Netpbm input conform, neither will your SRF output.  For such a file,  you  should  have
       two  image:  the first for 3D oblique views of the vehicle and the second for overhead views.
       Each image is a horizontal concatenation of 36 square images, each rotated  10  degrees  from
       the  previous, thereby covering the full 360 degree circle.  You could create this concatena‐
       tion with pamcat -lr and you could create the individual views with pnmrotate.

       One way to use pamtosrf is to get an SRF file, convert it to PAM  with  srftopam,  manipulate
       it, then convert it back with pamtosrf.

       netpbmfile  is the input stream, which defaults to Standard Input.  Output is always on Stan‐
       dard Output.



OPTIONS
       In addition to the options common to all programs based on libnetpbm  (most  notably  -quiet,
       see ]8;;index.html#commonoptions\ Common Options]8;;\ ), pamtosrf recognizes the following command line option:



       -verbose
              Issue informational messages about the input and the conversion process.





SEE ALSO
       •

              srftopam(1)

       •

              pamcat(1)

       •

              pam(1)



HISTORY
       srftopam was new in Netpbm 10.55 (June 2011).

       It was contributed by Mike Frysinger.

DOCUMENT SOURCE
       This  manual  page  was  generated by the Netpbm tool 'makeman' from HTML source.  The master
       documentation is at

              http://netpbm.sourceforge.net/doc/pamtosrf.html

netpbm documentation                         27 May 2011                     Pamtosrf User Manual(1)