Previous:Cylindrical Main Index Next:Dents
The density_file
pattern is a 3-D bitmap pattern that occupies a unit cube from location <0,0,0> to <1,1,1>. The data file is a raw binary file format created for POV-Ray called df3
format. The syntax provides for the possibility of implementing other formats in the future. This pattern was originally created for use with halo
or media
but it may be used anywhere any pattern may be used. The syntax is:
- pigment {density_file df3
"filename.df3" [interpolate
Type] [PIGMENT_MODIFIERS...] }
where "filename.df3" is a file name of the data file.
As a normal pattern, the syntax is
- normal {density_file df3
"filename.df3" [,
Bump_Size]
interpolate
Type] [NORMAL_MODIFIERS...]
}
The optional float Bump_Size should follow the file name and any other modifiers follow that.
The df3
format consists of a 6 byte header of three 16-bit integers with high order byte first. These three values give the x,y,z size of the data in pixels (or more appropriately called voxels). This is followed by x*y*z unsigned integer bytes of data. The data in the range of 0 to 255 is scaled into a float value in the range 0.0 to 1.0. It remains at 0.0 for all areas beyond the unit cube. The pattern occupies the unit cube regardless of the dimensions in voxels.
The interpolate
keyword may be specified to add interpolation of the data. The default value of zero specifies no interpolation. A value of one specifies tri-linear interpolation.
See the sample scenes for data file include\spiral.df3
,and the scenes which use it: scenes\textures\surfaces\densfile.pov
, scenes\interior\media\galaxy.pov
for examples.
Previous:Cylindrical Main Index Next:Dents