ptxmake - convert pointcloud file into ptexture file

SYNOPSIS

ptxmake

[-fedfile name]

[-depth byte or short or half or float]

[-splat none or diffusion or smooth or area]

[-newer 0 or 1]

[-verbose]

[-outofcore]

[-help]

ptcfilename channelname ptxfilename

DESCRIPTION

ptxmake converts a given channel of a point cloud file into a ptexture file by projecting UV sets in the point cloud file onto faces in the ptexture file.

In order to use ptxmake to project the face data, the point cloud must contain the u, v, faceid coordinates stored in the P (point) value - in other words, the bake3d call used to generate the point cloud should look like this:

bake3d(bakefile, "mypointcloud", point(u,v,faceid), ...)

Although not required, it is best to use a "face-edge-data" file (fedfile) to describe the connectivity of the faces in a ptexture file. The ptexture() call cannot filter the results well without the connectivity data. This file can be created using a RIF plugin called RifFaceEdgeData.

Several algorithms are provided for the projection process, and the diffusion method is the default. It is very robust in cases of sampling that can have widely different point densities per face with no particulare structure; also, the hole filling takes care of cases where the leaking of black samples can occur if the face has discontinuities.

OPTIONS

-depth depth

Specifies the bit depth of the output ptexture. Valid arguments to this option are: byte, short, half, and float. If not specified, the default depth is "half".

-fedfile fedfilename

Specifies the name of a face-edge data file that describes the connectivity information between faces and edges of the ptexture being created. The face-edge data file can be generated from a RIF plugin called RifFaceEdgeData.

-newer 0|1

Only generates a new ptexture file, if the point cloud file is newer than the existing ptexture file.

-outofcore

For larger data sets, ptxmake will stream intermediate steps to lower the memory footprint at the cost of extra creation time.

-splat mode

Determines the algorithm used to splat points onto the image plane. Valid choices are:

• none: points are drawn as single pixels directly on the image plane, left over areas are left black
• diffusion: points are drawn as single pixels are drawn directly on the image plane, left over areas are filled in using diffusion
• smooth: like diffusion, except that a filter kernel is also applied
• area: points are drawn as rectangles on the image plane with their area determined by their radii stored in the point cloud file

If not specified, the default splat mode is: diffusion .

-verbose

Causes progress to be written to stdout as the ptexture is being created. The default is to not produce verbose output.

SEE ALSO

ptxinfo(1) ptxview(1)