r.out.pov(1)	       Grass User's Manual	     r.out.pov(1)



NNAAMMEE
       r.out.pov  -  Converts  a  raster map layer into a height-
       field file for POVRAY.

	(GRASS Raster Data Export Program)

SSYYNNOOPPSSIISS
       rr..oouutt..ppoovv

       rr..oouutt..ppoovv hheellpp

       rr..oouutt..ppoovv   [-h]    mmaapp==name    ttggaa==name    [hhffttyyppee==value]
       [bbiiaass==value] [ssccaallee==value]

DDEESSCCRRIIPPTTIIOONN
       r.out.pov  converts  a  user-specified  raster  map  layer
       (map==name)  into   a   height-field   file   for   POVray
       (tga==name).  The  hftype==value  option  (where  value is
       either 0 or 1) specifies the height-field type.	When  the
       user  enters  0	the  output  will  be  actual heights. If
       entered 1 the cell-values will be normalized. If hftype is
       0  (actual  heights) the bias==value can be used to add or
       substract a value from heights. Use scale==value to  scale
       your  heights by value. The GRASS program r.out.pov can be
       used to create height-  field  files  for  Persistence  of
       Vision (POV) raytracer. POV can use a height-field defined
       in Targa (.TGA) image file format where the RGB pixel val-
       ues  are  24  bits  (3  bytes).	A 16 bit unsigned integer
       height-field value is assigned  as  follows:  RED  =  high
       byte, GREEN = low byte, BLUE = empty.



PPaarraammeetteerrss::
       mmaapp==name Name of an existing raster map layer.

	ttggaa==name  Name	of  TARGA  outputfile (one should add the
       extension

	hhffttyyppee==value 0=actual heights, 1=normalized heights.

	bbiiaass==value Bias which is added or substracted to heights.

	ssccaallee==value Value to stretch or shrink elevations.

	_r_._o_u_t_._p_o_v can be run either non-interactively or interac-
       tively.	The program will be run non-interactively if  the
       user  specifies	the name of a raster map layer and a name
       for tga (output), using the form


       r.out.pov map=inname tga=outname

	where inname is the name of a raster map layer to be con-
       verted  to POV format, and outname is the name of the out-
       putfile. Further optional values can be entered.

	Alternately, the user can simply type  _r_._o_u_t_._p_o_v  on  the
       command line, without program arguments. In this case, the
       user will be prompted for parameter values using the stan-
       dard  GRASS parser interface described in the manual entry
       for parser.


       r.out.pov map=elevation tga=out.tga



AAUUTTHHOORR
       Klaus Meyer, GEUM.tec GbR, eMail: _G_E_U_M_._t_e_c_@_g_e_u_m_._d_e



NNOOTTIICCEE
       This program is part of the contrib section of  the  GRASS
       distribution.   As such, it is externally contributed code
       that has not been examined or  tested  by  the  Office  of
       GRASS Integration.

       _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					     r.out.pov(1)
