.TH r.out.pov 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBr.out.pov\fR\fR  - Converts a raster map layer into a height-field file for POVRAY.
.SH KEYWORDS
raster, export
.SH SYNOPSIS
\fBr.out.pov\fR
.br
\fBr.out.pov help\fR
.br
\fBr.out.pov map\fR=\fIstring\fR \fBtga\fR=\fIstring\fR  [\fBhftype\fR=\fIinteger\fR]   [\fBbias\fR=\fIfloat\fR]   [\fBscale\fR=\fIfloat\fR]   [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Parameters:
.IP "\fBmap\fR=\fIstring\fR" 4m
.br
Name of an existing raster map
.IP "\fBtga\fR=\fIstring\fR" 4m
.br
Name of output povray file (TGA height field file)
.IP "\fBhftype\fR=\fIinteger\fR" 4m
.br
Height-field type (0=actual heights 1=normalized)
.IP "\fBbias\fR=\fIfloat\fR" 4m
.br
Elevation bias
.IP "\fBscale\fR=\fIfloat\fR" 4m
.br
Vertical scaling factor
.PP
.SH DESCRIPTION
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 values 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.
.SH EXAMPLE
An example Povray script file may look like this:
.PP
\fC
.DS
.br
#include "shapes.inc"
.br
#include "colors.inc"
.br
#include "textures.inc"
.br
.br
#declare Scale = 7;
.br
.br
light_source { <40000, Scale*3000, 5000> color MainLight }
.br
 
.br
camera {
.br
   location < 23000, Scale*2000, 0>
.br
   angle  90
.br
   look_at < 23000, Scale*1400, 5000>
.br
}
.br
 
.br
height_field  {
.br
   tga "dem.lr.tga"
.br
   smooth
.br
   water_level 0.11  // 726 / 6553.6 = 0.111
.br
    texture {
.br
      pigment {
.br
          image_map { // image is always projected from -z, with front facing  +z, top to +Y
.br
             ppm "map.lr.ppm"
.br
             once
.br
          }
.br
          rotate x*90 // align map to height_field
.br
      }
.br
    }
.br
   finish {
.br
          ambient 0.2         // Very dark shadows
.br
          diffuse 0.8         // Whiten the whites
.br
          phong 0.2           // shiny
.br
          phong_size 100.0    // with tight highlights
.br
          specular 0.5
.br
          roughness 0.05
.br
   }
.br
   scale < 14500, Scale*6553.6, 13000 >
.br
   translate <18300, 0, 1100>
.br
}
.br
.DE
\fR
.SH AUTHOR
Klaus D. Meyer, GEUM.tec GbR, eMail: \fIGEUM.tec@geum.de\fR
.PP
\fILast changed: $Date: 2008-05-16 21:09:06 +0200 (Fri, 16 May 2008) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team