forked from smurn/jPLY
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.txt
52 lines (37 loc) · 2.22 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
PLY - Polygon File Format
=========================
Java library to read files in the PLY format.
---------------------------------------------
jPLY is a library to read PLY files in a simple way. It has *complete support
for all features* offered by the PLY format. jPLY is using the
*Apache 2 License* so feel free to use it for open or closed source projects.
Get your bearings:
---------------------------------------------
* http://jply.smurn.org/download.html Download links and instructions for Maven users.
* http://jply.smurn.org/manual.html A quickstart manual on how jPLY works.
* http://jply.smurn.org/apidocs/index.html jPLY is fully documented, use it!
* http://jply.smurn.org/plyformat.html A short description what (and in which structure)
might be stored in PLY files. Read this if you want to know if PLY is the
right format for your needs. It is not a specification of the file format but
a more high-level description.
* http://jply.smurn.org/consoledemo/index.html a very small demo application
reading a PLY file and dumping some of the information in it to the console.
* http://jply.smurn.org/lwjgldemo/index.html a OpenGL demo showing how to
use jPLY to render a PLY model.
* https://github.com/smurn/jPly/issues Just open a ticket if something is unclear.
* And of course feel free to contribute! The source is on github: https://github.com/smurn/jPly.
What is PLY, and when to use it?
---------------------------------------------
PLY is a file format designed to store polygon meshes. Other than formats
such as COLLADA that can describe complete scenes,
PLY only stores meshes.
This simplicity makes PLY attractive where the complexity of or VRML
would be troubling. For example when developing demo application or when
testing 3D applications in the early developing stage one needs a simple
and reliable way to load geometry.
The PLY format is great in such use-cases since it is simple enough that
it can be written by hand if one needs to test a particular geometry. But there
is also a huge collection of PLY files available in the Internet, ranging
from an eight vertex cube to multi-billion triangle scans of Michelangelo
statues. The famous Stanford bunny and the Utah teapot are of course also
available.