This code package includes implementations of the papers "Rotational Symmetry Field Design on Surfaces" and "Interactive Visualization of Rotational Symmetry Fields on Surfaces", and was written by Jonathan Palacios.

It should be ready to build with Microsoft Visual C++ 2010. The actual program is in the folder wxNRoSy_Surface.

Some notes on using the actual program (I think that most of the controls are fairly self-explanatory after reading the first of the above papers, but some are a bit obfuscated and tips never hurt!):

* Rotate model with the left mouse button, translate with the middle, and zoom with the wheel. Right clicking on the surface is used to place/modify singularties.

* To design a field, set "Design Mode" to "Initialize". To edit an existing field, set it to "Edit". Attempt to move a singularity in the latter mode by dragging it to where you want it, and cancel two singularities of opposite index, by dragging one onto the other. This may not always work.

* Since the curvature tensor is a 2-RoSy field, it can only be loaded when the type of RoSy is a multiple of 2.

* "Save field" (in the file menu) can be used to output a ".rosy" file. The number of vertices and the type of RoSy ("N") is on the first line of this format. Every line thereafter corresponds to a vertex, and indicates one of the member vectors at that vertex. The other N-1 can be found by integer multiples of 2\pi/N of the first, in the tangent plane of the vertex.

Pen and Ink:

* t0 and t1 determine what regions of the surface have cross-hatches, single-hatches or no hatches, and the results of this can be seen by setting the view mode to "diffuse".

* dsep and dtest are explained in Hertzmann and Zorin's "Illustrating Smooth Surfaces Paper" and determin the density of the hatches.

* "Set single hatch direction" is used to store a 1- or 2-RoSy field that will determine which hatch to use in single hatch regions

I hope you find this code useful!

- Jonathan Palacios

