brickmake [-maxerror eps] [-radiusscale scale] [-maxdepth depth] [-ignorenormals 0|1] [-omitgeometry 0|1] [-addpn 0|1] [-addpresence 0|1] [-progress 0|1|2] [-newer 0|1] pointcloudfiles brickmapfile
brickmake reads one or more files in Pixar's point cloud file format and generates a brick map file representing the same data. A brick map is a tiled MIP map representation of 3D data.
-maxerror specifies the amount of error that can be tolerated in the brick map. This is a trade-off between accuracy and file size. The default value is 0.002 (approximately half of 1/255).
-radiusscale specifies a scaling factor applied to all point radii. For values higher than 1, the effect is that a blurrier, smaller brick map is created. The default value is 1. Using values lower than 1 is not recommended.
-maxdepth specifies an (integer) maximum depth of the brick map. This can be used to reduce the size of the brick map. The default value is 15.
-ignorenormals if set to 1, indicates that all data should be stored in the brick map as if their normal was (0,0,0). The default is 0 (off).
-omitgeometry if the brick map is only intended for use as a 3D texture -- and not intended to be used as a geometric primitive for rendering -- the information about which voxels have geometry in them can be omitted. This can reduce the brick map file size: if the data are uniform or very smooth (or a high -maxerror value is used) the reduction can be dramatic, but for rapidly varying data (and low -maxerror values) the reduction is usually only 5 to 10 percent. The default value for omitgeomety is 0 (off), i.e. the geometry is not omitted, and the brick map can be used as a geometric primitive.
-addpn if the brick map is intended for use as a geometric primitive, having P and N data available as brick map channels will result in much higher quality rendering. If set to 1, this will automatically add P and N data channels to the brick map.
-addpresence if the brick map is intended for volume rendering (rendering a blobby primitive based on data in the volume brick map), it is necessary to add a channel that expresses how large a fraction of each voxel contains data (and, conversely, how much is empty space). If this command-line option is set to 1, a "_presence" channel is added to the brick map. The data values in this channel are between 0 and 1.
-progress: if set to 1, a few progress lines will be written out during brickmap creation. If set to 2, more verbose information is given. The default is 0 (off).
-newer: If set to 1, only compute brick map if source file is newer than destination file. The default is 0 (off).
|
Pixar Animation Studios
|