Mark Stock

Rocktools

Rocktools is a collection of Unix tools for the creation and manipulation of open or closed triangular meshes in 3D space. It is especially adept at detailing triangular meshes according to three-dimensional random walks. It is written in ANSI C and only requires libpng and the standard C libraries to compile.

I must thank Steven Pigeon for his program POVRockGen 1.0 [link broken], which gave me the idea for creating rocktools. Please see it if you are a POV user.

Files

The current version of Rocktools is 0.9. You can download it here: rocktools_0.9.tar.gz. On a Unix system, just run the following commands:
tar -xzf rocktools_0.9.tar.gz;
cd rocktools_0.9;
make


An older version exists for DOS: download dos-exe-0.3a.zip, which includes precompiled DOS executables of the version 0.3a programs, courtesy of Anthony D'Agostino.

Features

Rocktools includes the following programs

• rockconvert can convert obj, raw, msh, or tin files into raw, rad, pov, obj, tin, or rib files; surface normals and texture coordinates are not always preserved
• rockcreate creates simple (10-40 polygon) rock-like triangle meshes, it is ideal for creating starter meshes, but relies on a third-party program called hull (included) to operate; see the rockcreate options page
• rockdetail recursively roughens a triangular mesh by splitting each triangle into three or four new triangles; see the rockdetail options page; NEW for v0.8: new spline-fitting and perturb-all-nodes schemes result in much higher-quality meshes, see images below
• rockerode iteratively erode a triangular mesh file, moving mass from hills and elevated areas, and creating valleys and watersheds
• rocksmooth removes sharp corners via a Laplacian smoothing filter and calculates surface normals; see the rocksmooth options page
• rocktrim selectively trims triangles from a triangle mesh file based on bounds in global x, y, and z directions
• rockxray will create a PGM or PNG "x-ray" or density image of a mesh
• NEW for v0.8 rockmarker is designed to write out simple markers (spheres or rectangles) aligned to and upon a triangle mesh

Images

An 8-level detailing of an icosahedron illustrating the distance-dependent detaling option; the command was rockdetail icosahedron0.obj -d 8 -dt .1 1 0 0 -oobj > partial8a.obj

A 7-level detailing of a hexagon using the edge-clamping feature; the command was rockdetail hex0.obj -seed 12 -ce -d 7 -n 0.2 -b 0 -oobj > hex7b.obj

A 7-level detailing of a simple rock

Here's a view of the results of the rockerode tool. The erosion algorithm still needs work.

This image is a preview of the threshholding feature in rockdetail. It shows selective triangle splitting based on distance from an arbitrary viewpoint.

A MPEG animation made by varying the rockdetail parameters (1.6 MB), thanks to Jeff Balcerski

Output of rockxray with the "-s" (surface) option

Output of rockxray with the "-v" (volume) option

Future plans

Future versions of Rocktools may include the following:

• More realistic erosion behavior (lakes, waterfalls, landslides)
• Less reliance on "hull" for rock creation
• More tools and input/output formats
• Volume-conserving smoothing

Please e-mail me if you'd like to see some particular feature in Rocktools, or if you use it to make something creative.

References

Rocktools has been used in the following research:

C.L. Lin and J.D. Miller, 3D characterization and analysis of particle shape using X-ray microtomography (XMT), Powder Technology 154 (1) 61-69, (2005) [link]