man > pamtooctaveimg(1)

Pamtooctaveimg User Manual(1)          General Commands Manual         Pamtooctaveimg User Manual(1)

NAME
       pamtooctaveimg - convert a Netpbm image to a GNU Octave image


SYNOPSIS
       pamtooctaveimg [netpbmfile]


DESCRIPTION
       This program is part of Netpbm(1).

       pamtooctaveimg reads a Netpbm image as input and produces a GNU Octave  image file as output.

       An Octave image file (called "Octave's image format" in Octave documentation) is a particular
       kind of Octave data file.  It describes two matrices:



       •      the image itself as a list of indexes into a colormap, and

       •      the corresponding colormap as a list of {red, green, blue} triplets.


       An Octave data file is an ASCII text file that you use to import data to Octave.

       See the  Image Processing chapter  of the GNU Octave manual for details.

       pamtooctaveimg writes the output Octave image to Standard Output.


OPTIONS
       There  are no command line options defined specifically for pamtooctaveimg, but it recognizes
       the options common to all programs based on libnetpbm (See  Common Options .)


ARGUMENTS
       netpbmfile is the name of the file containing the input PNM or PAM image, or  -  to  indicate
       Standard Input.  If you don't specify netpbmfile, the input is from Standard Input.  pamtooc‐
       taveimg converts only the first image in the input stream.


EXAMPLES
          % pamtooctaveimg myimage.ppm > myimage.img
          % octave
          > [img,map] = loadimage("myimage.img");

          # (At this point, img is an X by Y matrix and map is a 3 by M matrix.)

          > imshow(img,map);   # Displays img with colormap map
          > [r,g,b] = ind2rgb(img,map);

          # (r, g, and b are now each X by Y matrices of color levels [0 to 1].)

          > [newimg,newmap] = rgb2ind(r,b,g);   # Swap the blue and green channels.
          > saveimage("newimage.ppm", newimg, "ppm", newmap);  # Save as a PPM file.



NOTES
       There  is no octavetopam program.  However, GNU Octave's saveimage command can save images in
       PPM format.


HISTORY
       pamtooctaveimg was new in Netpbm 10.39 (June 2007).


AUTHOR
       Copyright (C) 2007 Scott Pakin, scott+pbm AT pakin.org.


SEE ALSO
       octave(1), pam(1).

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/pamtooctaveimg.html

netpbm documentation                        27 June 2007               Pamtooctaveimg User Manual(1)