# [`glfbo3d`][]
 
 A [C++11][] test of [OpenGL][] \>=3.2 3D [Framebuffer Objects (FBOs)][].
 
 [`glfbo3d`][] consists of a single test that demonstrates usage of 3D
 [Framebuffer Objects (FBOs)][].
 
 [`glfbo3d`]: https://git.rcrnstn.net/rcrnstn/glfbo3d
 [C++11]: https://en.wikipedia.org/wiki/C++11
 [OpenGL]: https://www.opengl.org
 [Framebuffer Objects (FBOs)]: https://www.khronos.org/opengl/wiki/Framebuffer_Object

 ## Dependencies
 
 Private (tests):
 
 -   [OpenGL][], system (e.g. [`libgl1-mesa-dev`][]).
 -   [OpenGL Extension Wrangler (GLEW)][], system (e.g. [`libglew-dev`][]).
 -   [OpenGL Mathematics (GLM)][], system (e.g. [`libglm-dev`][]).
 -   [`glshader`][], downloaded as part of the CMake configure step.
 -   [`gltest`][], downloaded as part of the CMake configure step.
 
 Private (transitive):
 
 -   [GLFW][], system (e.g. [`libglfw3-dev`][]).
 -   [`str`][], downloaded as part of the CMake configure step.
 
 [OpenGL Extension Wrangler (GLEW)]: http://glew.sourceforge.net
 [OpenGL Mathematics (GLM)]: https://glm.g-truc.net
 [GLFW]: https://www.glfw.org
 [`libgl1-mesa-dev`]: https://packages.debian.org/search?keywords=libgl1-mesa-dev
 [`libglew-dev`]: https://packages.debian.org/search?keywords=libglew-dev
 [`libglm-dev`]: https://packages.debian.org/search?keywords=libglm-dev
 [`libglfw3-dev`]: https://packages.debian.org/search?keywords=libglfw3-dev
 [`glshader`]: https://git.rcrnstn.net/rcrnstn/glshader
 [`gltest`]: https://git.rcrnstn.net/rcrnstn/gltest
 [`str`]: https://git.rcrnstn.net/rcrnstn/str
 
 ## Build system
 
 There are several ways to use this library in a [CMake][]-based project:
 
 -   Use [`FetchContent`][] to download it and import the targets automatically
     as part of the configure step:
 
     ```cmake
     include(FetchContent)
     FetchContent_Declare(glfbo3d
         GIT_REPOSITORY https://git.rcrnstn.net/rcrnstn/glfbo3d
     )
     FetchContent_MakeAvailable(
         glfbo3d
     )
     ```
 
 -   Bundle it and import the targets with [`add_subdirectory`][].
 
 -   Use [`find_package`][] (requires that the library is [packaged](#packaging)
     or [installed](#installing)).
 
 As usual, use [`target_link_libraries`][] to declare the dependency.
 
 [CMake]: https://cmake.org
 [`FetchContent`]: https://cmake.org/cmake/help/latest/module/FetchContent.html
 [`add_subdirectory`]: https://cmake.org/cmake/help/latest/command/add_subdirectory.html
 [`find_package`]: https://cmake.org/cmake/help/latest/command/find_package.html
 [`target_link_libraries`]: https://cmake.org/cmake/help/latest/command/target_link_libraries.html
 
 ### Configure and generate
 
 To configure and generate a build tree, use `cmake`:
 
 ```sh
 cmake -B build
 ```
 
 [`cmake`]: https://cmake.org/cmake/help/latest/manual/cmake.1.html#generate-a-project-buildsystem
 
 ### Build
 
 To build, use [`cmake --build`][]:
 
 ```sh
 cmake --build build
 ```
 
 [`cmake --build`]: https://cmake.org/cmake/help/latest/manual/cmake.1.html#build-a-project
 
 ### Test
 
 To run tests, use [`ctest`][]:
 
 ```sh
 (cd build && ctest --verbose)
 ```
 
 [`ctest`]: https://cmake.org/cmake/help/latest/manual/ctest.1.html
 
 ### Package
 
 To package, use [`cpack`][]:
 
 ```sh
 (cd build && cpack)
 ```
 
 [`cpack`]: https://cmake.org/cmake/help/latest/manual/cpack.1.html
 
 ### Install
 
 To install onto the current system, use [`cmake --install`][]:
 
 ```sh
 cmake --install build
 ```
 
 [`cmake --install`]: https://cmake.org/cmake/help/latest/manual/cmake.1.html#install-a-project
 

 ## License
 
 Licensed under the [ISC license][] unless otherwise noted, see the
 [`LICENSE`](LICENSE) file.
 
 [ISC license]: https://choosealicense.com/licenses/isc/