First draft public version

Author: lwjglgamedev

GLOSSARY.md

@@ -0,0 +1 @@
+# Glossary

README.md

@@ -0,0 +1,42 @@
+# 3D Game Development with LWJGL 3
+
+This online book will introduce the main concepts required to write a 3D game using the LWJGL 3 library.
+
+[LWJGL](http://www.lwjgl.org/) is a Java library that provides access to native APIs used in the development of graphics \(OpenGL\), audio \(OpenAL\) and parallel computing \(OpenCL\) applications. This library leverages the high performance of native OpenGL applications while using the Java language.
+
+My initial goal was to learn the techniques involved in writing a 3D game using OpenGL. All the information required was there in the internet but it was not organized and sometimes it was very hard to find and even incomplete or misleading.
+
+I started to collect some materials, develop some examples and decided to organize that information in the form of a book.
+
+[Table of contents](SUMMARY.md).
+
+You can also check my Vulkan book [here](https://github.com/lwjglgamedev/vulkanbook).
+
+## Source Code
+
+The source code of the samples of this book is in [GitHub](https://github.com/lwjglgamedev/lwjglbook).
+
+The source code for the book itself is also published in [GitHub](https://github.com/lwjglgamedev/lwjglbook-bookcontents).
+
+## License
+
+The book is licensed under [Attribution-ShareAlike 4.0 International \(CC BY-SA 4.0\)](http://creativecommons.org/licenses/by-sa/4.0/)
+
+The source code for the book is licensed under [Apache v2.0](https://www.apache.org/licenses/LICENSE-2.0 "Apache v2.0")
+
+## Support
+
+If you like the book please rate it with a start and share it. If you want to contribute with a donation you can do a donation:  
+[![Paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5MH9AA9TPQQBN)
+
+## Comments are welcome
+
+Suggestions and corrections are more than welcome \(and if you do like it please rate it with a star\). Please send them using the discussion forum and make the corrections you consider in order to improve the book.
+
+## Author
+
+Antonio Hernández Bejarano
+
+## Special Thanks
+
+To all the readers that have contributed with corrections, improvements and ideas.

SUMMARY.md

@@ -0,0 +1,24 @@
+# Summary
+
+* [Introduction](README.md)
+* [Chapter 01 - First steps](chapter-01/chapter-01.md)
+* [Chapter 02 - The Game Loop](chapter-02/chapter-02.md)
+* [Chapter 03 - Our first triangle](chapter-03/chapter-03.md)
+* [Chapter 04 - Render a quad](chapter-04/chapter-04.md)
+* [Chapter 05 - Perspective projection](chapter-05/chapter-05.md)
+* [Chapter 06 - Going 3D](chapter-06/chapter-06.md)
+* [Chapter 07 - Textures](chapter-07/chapter-07.md)
+* [Chapter 08 - Camera](chapter-08/chapter-08.md)
+* [Chapter 09 - Loading more complex models (Assimp)](chapter-09/chapter-09.md)
+* [Chapter 10 - GUI (Imgui)](chapter-10/chapter-10.md)
+* [Chapter 11 - Lights](chapter-11/chapter-11.md)
+* [Chapter 12 - Sky Box](chapter-12/chapter-12.md)
+* [Chapter 13 - Fog](chapter-13/chapter-13.md)
+* [Chapter 14 - Normal Mapping](chapter-14/chapter-14.md)
+* [Chapter 15 - Animations](chapter-15/chapter-15.md)
+* [Chapter 16 - Audio](chapter-16/chapter-16.md)
+* [Chapter 17 - Cascade shadow maps](chapter-17/chapter-17.md)
+* [Chapter 19 - Deferred Shading](chapter-19/chapter-19.md)
+* [Chapter 20 - Indirect drawing (static models)](chapter-20/chapter-20.md)
+* [Chapter 21 - Indirect drawing (animated models) and compute shaders](chapter-21/chapter-21.md)
+* [Appendix A - OpenGL Debugging](appendix-a/appendix-a.md)

appendix-a/appendix-a.md

@@ -0,0 +1,51 @@
+# Appendix A - OpenGL Debugging
+
+Debugging an OpenGL program can be a daunting task. Most of the times you end up with a black screen and you have no means of knowing what’s going on. In order to alleviate this problem we can use some existing tools that will provide more information about the rendering process.
+
+In this annex we will describe how to use the [RenderDoc](https://renderdoc.org/ "RenderDoc") tool to debug our LWJGL programs. RenderDoc is a graphics debugging tool that can be used with Direct3D, Vulkan and OpenGL. In the case of OpenGL it only supports the core profile from 3.2 up to 4.5.
+
+So let’s get started. You need to download and install the RenderDoc version for your OS. Once installed, when you launch it you will see something similar to this.
+
+![RenderDoc](/appendix-a/renderdoc.png)
+
+The first step is to configure RenderDoc to execute and monitor our samples. In the “Capture Executable” tab we need to setup the following parameters:
+
+* **Executable path**: In our case this should point to the JVM launcher \(For instance, “C:\Program Files\Java\jdk-XX\bin\java.exe”\).
+* **Working Directory**: This is the working directory that will be setup for your program. In our case it should be set to the target directory where maven dumps the result. By setting this way, the dependencies will be able to be found \(For instance, "D:/Projects/booksamples/chapter-18/target"\).
+* **Command line arguments**: This will contain the arguments required by the JVM to execute our sample. In our case, just passing the jar to be executed \(For instance, “-jar chapter-18-1.0.jar”\).
+
+![Exec arguments](/appendix-a/exec_arguments.png)
+
+There are many other options int this tab to configure the capture options. You can consult their purpose in [RenderDoc documentation](https://renderdoc.org/docs/index.html "RenderDoc documentation"). Once everything has been setup you can execute your program by clicking on the “Launch” button. You will see something like this:
+
+![Sample](/appendix-a/sample.png)
+
+Once launched the process, you will see that a new tab has been added which is named “java \[PID XXXX\]” \(where the XXXX number represents the PID, the process identifier, of the java process\).
+
+![Java process](java_process.png)
+
+From that tab you can capture the state of your program by pressing the “Trigger capture” button. Once a capture has been generated, you will see a little snapshot in that same tab.
+
+![Capture](capture.png)
+
+If you double click on that capture, all the data collected will be loaded and you can start inspecting it. The “Event Browser” panel will be populated will all the relevant OpenGL calls executed during one rendering cycle.
+
+![Event browser](event_browser.png)
+
+You can see, the following events:
+* Three depth passes for the cascade shadows.
+* The geometry pass.  If you click over a glDrawELements event, and select the “Mesh” tab you can see the mesh that was drawn, its input and output for the vertex shader.
+* The lighting pass.
+
+You can also view the input textures used for that drawing operation \(by clicking the “Texture Viewer” tab\).
+
+![Texture inputs](texture_inputs.png)
+
+In the center panel, you can see the output, and on the right panel you can see the list of textures used as an input. You can also view the output textures one by one. This is very illustrative to show how deferred shading works.
+
+![Texture outputs](texture_outputs.png)
+
+As you can see, this tool provides valuable information about what’s happening when rendering. It can save precious time while debugging rendering problems. It can even display information about the shaders used in the rendering pipeline.
+
+![Pipeline state](pipeline_state.png)
+