p.ppm(1)		      Grass User's Manual		      p.ppm(1)



NNAAMMEE
       pp..ppppmm  - Reads portable pixmap (ppm) files created by PPM utilities.
       _(_G_R_A_S_S _P_a_i_n_t_/_P_r_i_n_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       pp..ppppmm
       pp..ppppmm hheellpp
       pp..ppppmm [--ff] [iinnppuutt==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       This  program, _p_._p_p_m, reads a user-specified portable pixmap (ppm) file
       and outputs it to the currently selected printer (see  _p_._s_e_l_e_c_t).   The
       _i_n_p_u_t ppm file should be one that has been created using the PPM utili-
       ties developed by Jeff Poskanzer.  These utilities can  import  various
       image  formats  (including  Sun	raster, X Windows pixmaps, and others)
       into the PPM formats _p_p_m (color pixmaps), _p_g_m (grey  scale  maps),  and
       _p_b_m (black and white bit-maps).


       If  the	image doesn't fit the output device, it won't get printed.  If
       you want the image printed (but clipped), use the pp..ppppmm --ff  option,  or
       scale the input using _p_p_m_s_c_a_l_e, or rotate the image using _p_p_m_r_o_t_a_t_e (if
       it will fit that way -- otherwise you might have to scale it as	well).
       If  the	image  doesn't	fit, _p_._p_p_m will tell you what scaling value to
       enter to _p_p_m_s_c_a_l_e that will make it fit.



EEXXAAMMPPLLEESS
       If the user is running GRASS under SunOS, the following	command  could
       be used to send a monitor screen image to the printer:


       ssccrreeeenndduummpp || rraassttttooppppmm || pp..ppppmm





       If you are running suntools, the user might type:


       sslleeeepp 1100;; ssccrreeeenndduummpp || rraassttttooppppmm || ppppmmrroottaattee 9900 || pp..ppppmm



       The UNIX _s_l_e_e_p command allows you time to arrange the frames before the
       screen dump starts.  The _p_p_m_r_o_t_a_t_e is usually needed  because  the  Sun
       screens	are  wider  than  they	are long (and wider than 1024 pixels -
       which is the width of most of our printers).


       If you are running X, the user might type:


       xxwwdd || xxwwddttooppppmm || ppppmmrroottaattee 9900 || pp..ppppmm


NNOOTTEESS
       This program only supports the ppm binary format (P6).


       Maximum color level is 255.  If the ppm file has more color levels, use
       _p_p_m_c_s_c_a_l_e to reduce the number of colors.


       No scaling is done.  Use _p_p_m_s_c_a_l_e to change image size.


       No rotation is done.  Use _p_p_m_r_o_t_a_t_e to rotate the image.

SSEEEE AALLSSOO
       See also:


       The  PPM utilities _p_p_m_r_o_t_a_t_e (rotates ppm images), _p_p_m_s_c_a_l_e (scales ppm
       images for printing), _r_a_s_t_t_o_p_p_m (converts a Sun raster file to ppm for-
       mat), and _x_w_d_t_o_p_p_m (converts an X Windows dump file to ppm format).


       The  SunOS  program  _s_c_r_e_e_n_d_u_m_p	(dumps the image on the color graphics
       monitor into a file in Sun raster file format).


       The X program _x_w_d (dumps the image in an X window into a file in X win-
       dow dump [xwd] format).


       The GRASS programs

       _d_._s_a_v_e

       _p_._m_a_p

       _p_._s_e_l_e_c_t

       _p_a_r_s_e_r

AAUUTTHHOORR
       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory


       This program uses the PPM utilities, developed by Jeff Poskanzer.

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_4 _$



GRASS 5.0							      p.ppm(1)
