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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85
// Copyright Colin Sherratt 2014 // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! `Genmesh`'s is a library that offers ways to generate and manipulate vertex streams. //! //! The core problem that this library solves is to find a nice way to build meshes that //! does not just result in throwing all the vertices and indices into a `Vec<T>` and //! calling it done. While doing so is simple from a library writers point of view, the //! consumer will often have to translate that buffer to the format that they need before //! it can be used. This produces needless buffering that can be avoided. //! //! `Genmesh`'s solution is to utilize the `Iterator` trait to build a vertex processing //! pipeline. The `Iterator` trait has a number of useful functions like `zip`, `map` and //! `collect` that are useful in themselves. `Genmesh` includes a number of traits that //! can be used with the built in `Iterator` traits to build the meshes that your engine //! needs. //#![deny(missing_docs)] extern crate cgmath; pub use poly::{ Quad, Triangle, Polygon, Vertices, VerticesIterator, MapToVertices, MapVertex, Line, Lines, EmitLines, }; pub use triangulate::{ EmitTriangles, Triangulate, TriangulateIterator }; pub use indexer::{ Indexer, LruIndexer }; pub use neighbors::{ Neighbors }; mod triangulate; mod poly; mod indexer; mod generator; mod neighbors; mod cube; mod cylinder; mod plane; mod sphere; /// a collection of utilties that can be used to build /// meshes programmatically pub mod generators { pub use generator::{ SharedVertex, IndexedPolygon, SharedVertexIterator, IndexedPolygonIterator, }; pub use cube::Cube; pub use cylinder::Cylinder; pub use plane::Plane; pub use sphere::SphereUV; }