NAME

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

KEYWORDS

       raster, export

SYNOPSIS

       r.out.pov
       r.out.pov help
       r.out.pov map=string tga=string  [hftype=integer]   [bias=float]   [scale=float]   [--verbose]  [--quiet]

   Parameters:
       map=string
           Name of an existing raster map

       tga=string
           Name of output povray file (TGA height field file)

       hftype=integer
           Height-field type (0=actual heights 1=normalized)

       bias=float
           Elevation bias

       scale=float
           Vertical scaling factor

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.

EXAMPLE

       An example Povray script file may look like this:

       #include "shapes.inc"
       #include "colors.inc"
       #include "textures.inc"
       #declare Scale = 7;
       light_source { <40000, Scale*3000, 5000> color MainLight }

       camera {
          location < 23000, Scale*2000, 0>
          angle  90
          look_at < 23000, Scale*1400, 5000>
       }

       height_field  {
          tga "dem.lr.tga"
          smooth
          water_level 0.11  // 726 / 6553.6 = 0.111
           texture {
             pigment {
                 image_map { // image is always projected from -z, with front facing  +z, top to +Y
                    ppm "map.lr.ppm"
                    once
                 }
                 rotate x*90 // align map to height_field
             }
           }
          finish {
                 ambient 0.2         // Very dark shadows
                 diffuse 0.8         // Whiten the whites
                 phong 0.2           // shiny
                 phong_size 100.0    // with tight highlights
                 specular 0.5
                 roughness 0.05
          }
          scale < 14500, Scale*6553.6, 13000 >
          translate <18300, 0, 1100>
       }

AUTHOR

       Klaus D. Meyer, GEUM.tec GbR, eMail: GEUM.tec@geum.de

       Last changed: $Date: 2008-05-16 12:09:06 -0700 (Fri, 16 May 2008) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                    r.out.pov(1grass)