./examples/Plot3Dv3/Balloons.inc

ScPovPlot3D/Balloons.inc [ Modules ]

AUTHOR

  Janusz Opiła Ph.D.
   jmo@agh.edu.pl, janusz.opila@gmail.com
   Dept. of Applied Informatics
   AGH Univ. of Science & Technology. Cracow, Poland
   Maintained by Janusz Opiła Ph.D.

   Use 'Declare=Debug=1' on command line to see debugging messages

PURPOSE

Macros for representation 3D scattered data as spheres proportional to value in specific space point

   Fig.[Balloons] Representation of 3D scalar field V=V(x,y,z) by balloon's method 
COPYRIGHT
   GNU GPL v.3 License
   (c) 2012-now by Janusz Opiła Ph.D.
   AGH University of Science and Technology




Balloons.inc/ScatterBalloonData() [ Main macros ]

[ Top ] [ Balloons.inc ] [ Main macros ]
PURPOSE
  this macro creates chart for data in the form of z=f(x1, x2, x3) where z is marked as the radius of the sphere, uses SphereOnColumn() macro 

SYNOPSIS
172 ScatterBalloonData(string filename InFileName, float er0, pfunction sigma, float columnRad) 

INPUTS
  InFileName - Data file name - for format see example 'Baloons.dat'
  er0        - minimum radius of spheres, base radius
  sigma      - pointer to inline function taking one float returning float, its goal is to scale radii to reasonable range
  columnRad  - radius of column

SEE ALSO
  SphereOnColumn(), ScalingFunction()

EXAMPLE
179 ScatterBalloonData("Balloons.dat", .710, ScalingFunction, 0.05)       




Balloons.inc/SphereOnColumn() [ Main macros ]

[ Top ] [ Balloons.inc ] [ Main macros ]
PURPOSE
   Draws sphere on top o column (or bottom if below zero XY plane )

SYNOPSIS
141 SphereOnColumn(3Dvector Center, float Rs, float Rc)

INPUTS
   Center - center of the sphere in POVRay coordinates
   Rs     - radius of the sphere
   Rc     - radius of the cylinder 

SEE ALSO
   Nothing yet




Balloons.inc/ScalingFunction() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
  Inline function scaling radius of sphere from real value V(x,y,z) to fit it in a reasonable range

INPUTS
  this function takes one float argument 

SEE ALSO
  ScatterBalloonData(), "function()" definition in POVRay manual, function pointers

EXAMPLE
163 #declare ScalingFunction  = function (rr) { 5*ln(abs(rr))+0.1 }   // default function - one may declare his own




Balloons.inc/SetColor() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
   Sets default color for different items:

   SetColor( color vector FullColour )

   SetRGBColor( float R, float G, float B) - for RGB definition style

   SetRGBFTColor( float R, float G, float B, float F, float T) for RGBFT definition

   SetRGBFTColor_1( float R, float G, float B, float F, float T) and

   SetRGBFTColor_2( float R, float G, float B, float F, float T)  two-color RGBFT items






Balloons.inc/SetDZero() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
   Sets value of DZerovariable




Balloons.inc/SetInterior() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
   declares texure for the item

SYNOPSIS
93 SetInterior(interiordef)




Balloons.inc/SetTexture() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
   declares texure for the item

SYNOPSIS
82 SetTexture(texturedef)




Balloons.inc/SetVScale() [ Helper macros ]

[ Top ] [ Balloons.inc ] [ Helper macros ]
PURPOSE
   Sets value of VScale variable




Balloons.inc/DeclareLevel [ Variables ]

[ Top ] [ Balloons.inc ] [ Variables ]
PURPOSE
   DeclareLevel determines what is defined:

   0 = colour only

   2 = also texture

   4 = complete material


   this value is valid until next "Set...()" declaration is met

SOURCE
58 #declare DeclareLevel = 0;




Balloons.inc/DZero [ Variables ]

[ Top ] [ Balloons.inc ] [ Variables ]
PURPOSE
  minimal minimal float number assumed not beiing equal zero
  application of this value depends on algorithm employed

SOURCE
106 #declare DZero = 1E-4;    




Balloons.inc/VScale [ Variables ]

[ Top ] [ Balloons.inc ] [ Variables ]
PURPOSE
  minimal distance between grid & random point, 
  this value is valid until "SetDzero()"

SOURCE
123 #declare VScale = 1.0;    // Surface enhancement along vertical axis (negative values allowed ;)