Format changes according to max line length.

Author: ArtifactForms

README.md

@@ -10,25 +10,45 @@ A _JAVA_ library to construct and manipulate geometry in Three-dimensional space
 
 ## Background / Intension
 
-This Java library began as a hobby project in 2015/2016.  I started it to deepen my understanding of creating and manipulating 3D geometry. This built upon knowledge I gained from an earlier internship with product design students. During that time, I was introduced to the programming language Processing.
-
-Processing captivated me from the start. Designed for visual learners, Processing is a great tool to get started with programming. You can learn more at processing.org. While Processing isn't strictly necessary, the library's core functionality is independent of the Processing environment. However, Processing offers a convenient way to visualize constructed meshes through its rendering pipeline, which leverages JAVA, JAVA2D, and OPENGL.
+This Java library began as a hobby project in 2015/2016.  I started it to
+deepen my understanding of creating and manipulating 3D geometry. This built
+upon knowledge I gained from an earlier internship with product design students.
+During that time, I was introduced to the programming language Processing.
+
+Processing captivated me from the start. Designed for visual learners,
+Processing is a great tool to get started with programming. You can learn more
+at processing.org. While Processing isn't strictly necessary, the library's
+core functionality is independent of the Processing environment. However,
+Processing offers a convenient way to visualize constructed meshes through its
+rendering pipeline, which leverages JAVA, JAVA2D, and OPENGL.
 
 ## Status Quo
-Currently, my primary focus is on refining the user documentation. As my understanding of code structure and architecture has evolved, I've been actively refactoring the codebase to maintain its cleanliness and organization. Smaller additions are made periodically.
+Currently, my primary focus is on refining the user documentation. As my
+understanding of code structure and architecture has evolved, I've been
+actively refactoring the codebase to maintain its cleanliness and organization.
+Smaller additions are made periodically.
 
-In essence, this codebase serves as a platform for learning and working with legacy code. I've embraced the challenge of working with existing code, viewing it as an opportunity to explore new testing approaches. Constructing tests around legacy code for refactoring purposes is a fascinating and valuable endeavor, in my opinion, an essential practice.
+In essence, this codebase serves as a platform for learning and working with
+legacy code. I've embraced the challenge of working with existing code, viewing
+it as an opportunity to explore new testing approaches. Constructing tests
+around legacy code for refactoring purposes is a fascinating and valuable
+endeavor, in my opinion, an essential practice.
 
 ## Future
 
-The scope of related topics is vast, and my list of potential features is accordingly expansive. Some of these are outlined under 'Planned Features'.
+The scope of related topics is vast, and my list of potential features is 
+accordingly expansive. Some of these are outlined under 'Planned Features'.
 
 ## Core Features
 
-* **3D Geometry Creation and Manipulation** Build a wide range of 3D shapes and modify them using various operations.
-* **Customizable Mesh Creation:** Create custom shapes using a variety of mesh creation tools and modifiers.
-* **Extensible Framework:** Easily add new features and functionalities to the library.
-* **OBJ File Import and Export:** Import and export 3D models in the OBJ file format.
+* **3D Geometry Creation and Manipulation** Build a wide range of 3D shapes and
+modify them using various operations.
+* **Customizable Mesh Creation:** Create custom shapes using a variety of mesh
+creation tools and modifiers.
+* **Extensible Framework:** Easily add new features and functionalities to the
+library.
+* **OBJ File Import and Export:** Import and export 3D models in the OBJ file
+format.
 
 ## Showcase
 
@@ -54,15 +74,20 @@ Throwing some conway operations on a cube seed.
 ## Coordinate System
 
 The library is build up on a left-handed coordinate system.
-The decision was justified by using the 'Processing' rendering pipeline in the first place.
-But the core library is highly decoupled from the 'Processing' environment.
-So the library could be used independently.
+The decision was justified by using the 'Processing' rendering pipeline in the
+first place. But the core library is highly decoupled from the 'Processing'
+environment. So the library could be used independently.
 
 ## Mesh3D
 
-The following example shows how to work with the base mesh class. For this purpose we want to create a simple quad. The quad has four vertices, one for each
-corner. To make things a bit more explanatory we compose the quad out of two triangular faces. **Important:** This is just an example to illustrate the base concepts. The library already provides a convenient way to construct primitives and more complex shapes. But we dive into this at a later point. For now
-let's keep things simple. But also keep in mind that it might be useful to construct shapes by yourself in some cases.
+The following example shows how to work with the base mesh class. For this 
+purpose we want to create a simple quad. The quad has four vertices, one for
+each corner. To make things a bit more explanatory we compose the quad out of 
+two triangular faces. **Important:** This is just an example to illustrate the 
+base concepts. The library already provides a convenient way to construct 
+primitives and more complex shapes. But we dive into this at a later point. 
+For now let's keep things simple. But also keep in mind that it might be useful 
+to construct shapes by yourself in some cases.
 
 ```
 (-1, 0, -1)     (1, 0, -1)
@@ -88,7 +113,8 @@ Mesh3D mesh = new Mesh3D();
 
 ### Vertex Coordinates
 
-Next we determine the shape's coordinates in Three-Dimensional space. In this case the shape lies flat on the xz plane, so each y-coordinate is 0.0f.
+Next we determine the shape's coordinates in Three-Dimensional space. 
+In this case the shape lies flat on the xz plane, so each y-coordinate is 0.0f.
 
 ```java
 mesh.add(new Vector3f(1, 0, -1));
@@ -122,8 +148,9 @@ The added vertices are now at an indexed position within the mesh.
      2              1
 ```
 
-Knowing the index of each vertex makes adding faces a piece of cake. We only have to take care of the winding order. In this case the winding order
-is counter-clockwise with all face normals pointing up towards negative y.
+Knowing the index of each vertex makes adding faces a piece of cake. We only 
+have to take care of the winding order. In this case the winding order is 
+counter-clockwise with all face normals pointing up towards negative y.
 
 ```java
 mesh.addFace(0, 1, 3);
@@ -134,14 +161,16 @@ mesh.addFace(1, 2, 3);
 
 ### Modify the mesh
 
-Now we have a mesh constisting of four vertices and two triangular faces. This could be retrieved by using:
+Now we have a mesh constisting of four vertices and two triangular faces. 
+This could be retrieved by using:
 
 ```java
 int vertexCount = mesh.getVertexCount();
 int faceCount = mesh.getFaceCount();
 ```
 
-We can modify the present mesh by using so called _Modifiers_. Each modifier derives from the root interface `IMeshModifier`.
+We can modify the present mesh by using so called _Modifiers_. 
+Each modifier derives from the root interface `IMeshModifier`.
 
 ```java
 package mesh.modifier;
@@ -168,18 +197,27 @@ modifier.modify(mesh);
 
 Effortless Shape Creation with Mesh Creators
 
-The library provides a variety of Mesh Creators to simplify the construction of various shapes. These creators employ the Factory Method or Builder design pattern, allowing for a flexible and streamlined approach.
+The library provides a variety of Mesh Creators to simplify the construction of 
+various shapes. These creators employ the Factory Method or Builder design
+pattern, allowing for a flexible and streamlined approach.
+
+While similar to a classic builder, Mesh Creators offer a unique combination of
+features:
 
-While similar to a classic builder, Mesh Creators offer a unique combination of features:
+* **Getters and Setters:** Access and modify the creator's internal state using
+getters and setters, providing fine-grained control over the mesh creation
+process.
 
-* **Getters and Setters:** Access and modify the creator's internal state using getters and setters, providing fine-grained control over the mesh creation process.
 * **Chaining is not supported:**
 
-With over 100 Mesh Creators categorized for easy access, you can quickly and efficiently build a wide range of 3D shapes. For a comprehensive overview, refer to our documentation: [Mesh Creators](documentation/documentation.md)
+With over 100 Mesh Creators categorized for easy access, you can quickly and 
+efficiently build a wide range of 3D shapes. For a comprehensive overview,
+refer to our documentation: [Mesh Creators](documentation/documentation.md)
 
 Core of Mesh Creators: The IMeshCreator Interface
 
-Every Mesh Creator in the library adheres to the IMeshCreator interface. The following code snippet illustrates this foundational interface:
+Every Mesh Creator in the library adheres to the IMeshCreator interface.
+The following code snippet illustrates this foundational interface:
 
 ```java
 package mesh.creator;
@@ -193,7 +231,9 @@ public interface IMeshCreator {
 }
 ```
 
-To get a little more specific we can plug the quad example code into a custom creator to illustrate the overall concept.
+To get a little more specific we can plug the quad example code into a custom 
+creator to illustrate the overall concept.
+
 Let's have a look at our example code again.
 
 ```java
@@ -209,7 +249,8 @@ mesh.addFace(0, 1, 3);
 mesh.addFace(1, 2, 3);
 ```
 
-First we move our example code into the factory method of a custom mesh creator class and simply return the mesh.
+First we move our example code into the factory method of a custom mesh 
+creator class and simply return the mesh.
 
 ```java
 import mesh.Mesh3D;
@@ -231,7 +272,8 @@ public class MyQuadCreator implements IMeshCreator {
 }
 ```
 
-Let's assume we want to generalize the code a bit further. We introduce a parameter for the vertex coordinates named _halfSize_.
+Let's assume we want to generalize the code a bit further. We introduce a 
+parameter for the vertex coordinates named _halfSize_.
 
 ```java
 import mesh.Mesh3D;
@@ -293,7 +335,9 @@ creator.setSize(4);
 mesh = creator.create();
 ```
 
-This explains the overall concept of mesh creators pretty well. You should now have an idea how to use existing creators and implement your own custom ones.
+This explains the overall concept of mesh creators pretty well. You should now
+have an idea how to use existing creators and implement your own custom ones.
+
 See also: [Mesh Creators](documentation/documentation.md)
 
 ## Planed features
@@ -304,5 +348,6 @@ See also: [Mesh Creators](documentation/documentation.md)
 
 ## Licence
 
-[MIT](https://github.com/ArtifactForms/MeshLibCore/blob/master/LICENSE) License Copyright (c) 2022 Simon Dietz
+[MIT](https://github.com/ArtifactForms/MeshLibCore/blob/master/LICENSE)
+License Copyright (c) 2022 Simon Dietz