Skip to content

Latest commit

 

History

History
28 lines (17 loc) · 2.51 KB

README.md

File metadata and controls

28 lines (17 loc) · 2.51 KB
Raw

QuasiTiler

This a modification to the QuasiTiler v0.2 by Eugenio Durand. The original source code, on which this project is built, can be downloaded from here. This project is licensed under the terms of the GNU General Public License.

How to run it:

  1. Compile the source code by executing compile.cmd (for Windows) or compile.sh (for Mac/Linux). (You only need to do it once.)
  2. Run the program by executing run.cmd (for Windows) or run.sh (for Mac/Linux).

For an excellent explanation about the how the program works, please consult an article written by the original author, Eugenio Durand, of this program.

Modifications made:

  • All floats are replaced by doubles to increase precision.
  • Greatly improved rendering speed.
  • Allow an option for displaying the centroid of tiles.
  • An export/ folder will be created at the first run-time. The coordinates of the included vertices, the projected vertices, the "generator" and the offset vector are exported into the text files vertices.txt, tiles.txt, generator.txt and offset.txt respectively. The contents in the export files will be updated every time the tiling in the program is updated.

What's inside each export text file?

tiles.txt: Each line contains the information a tile on the projection plane. The first column provides the shape of the tile and the second column column provides the orientation of the tile. The last two columns contains the coordinates of the centroid of the tile.

vertices.txt: Each line contains the coordinates of an included vertex in the ambient space (or superspace), separated by a tab ('\t').

projected_vertices.txt: Each line contains the 2D coordinates of an included vertex projected onto the projection plane, separated by a tab ('\t').

generator.txt: A generator is a set of two vectors defining the direction (or orientation) of the projection plane. There are two lines in the file. Each line contains the coordinates of a vector in the generator in the ambient space, separated by a tab ('\t').

offset.txt: This file has only one line which contains the coordinates of the offset vector, i.e. a point in ambient space at which the project plane goes through. Oddly enough, the original program only allows the offset to be within the first two dimensions of the ambient space. So there are always two coordinates in this file and the rest should be treated as zeros.