summaryrefslogtreecommitdiffstats
path: root/dev/MinGfx/doc/api.md
diff options
context:
space:
mode:
authorunknown <paulx161@umn.edu>2021-02-03 14:22:28 -0600
committerunknown <paulx161@umn.edu>2021-02-03 14:22:28 -0600
commit9b83919815f6a6ce5d73da1c28483970d0ca5589 (patch)
tree4558864445dccc1605e5315e0bb11c46d2018da1 /dev/MinGfx/doc/api.md
parentAdded worksheet and support code for assignment 2 (diff)
downloadcsci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar.gz
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar.bz2
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar.lz
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar.xz
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.tar.zst
csci4611-9b83919815f6a6ce5d73da1c28483970d0ca5589.zip
added dev/MinGfx/
Diffstat (limited to 'dev/MinGfx/doc/api.md')
-rw-r--r--dev/MinGfx/doc/api.md64
1 files changed, 64 insertions, 0 deletions
diff --git a/dev/MinGfx/doc/api.md b/dev/MinGfx/doc/api.md
new file mode 100644
index 0000000..58c78eb
--- /dev/null
+++ b/dev/MinGfx/doc/api.md
@@ -0,0 +1,64 @@
+API - MinGfx Programming Reference Organized by Topic {#api}
+==========
+
+# API by Topic
+
+| Application Class |
+|-------------------|
+| [GraphicsApp](@ref mingfx::GraphicsApp) |
+
+
+| 3D Models |
+|-----------|
+| [QuickShapes](@ref mingfx::QuickShapes) |
+| [Mesh](@ref mingfx::Mesh) |
+
+
+| Color and Textures |
+|--------------------|
+| [Color](@ref mingfx::Color) |
+| [Texture2D](@ref mingfx::Texture2D) |
+
+
+| Graphics Math |
+|---------------|
+| [Matrix4](@ref mingfx::Matrix4) |
+| [Point2](@ref mingfx::Point2) |
+| [Point3](@ref mingfx::Point3) |
+| [Vector2](@ref mingfx::Vector2) |
+| [Vector3](@ref mingfx::Vector3) |
+| [Ray](@ref mingfx::Ray) |
+| [Quaternion](@ref mingfx::Quaternion) |
+| [GfxMath](@ref mingfx::GfxMath) |
+
+
+| Shader Programs |
+|-----------------|
+| [DefaultShader](@ref mingfx::DefaultShader) |
+| - [DefaultShader::LightProperties](@ref mingfx::DefaultShader::LightProperties) |
+| - [DefaultShader::MaterialProperties](@ref mingfx::DefaultShader::MaterialProperties) |
+| [ShaderProgram](@ref mingfx::ShaderProgram) |
+
+
+| User Interface |
+|----------------|
+| [CraftCam](@ref mingfx::CraftCam) |
+| [UniCam](@ref mingfx::UniCam) |
+
+
+| File I/O and System Routines |
+|------------------------------|
+| [Platform](@ref mingfx::Platform) |
+
+
+
+
+# Coding Style
+
+The library follows the [Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html), in part as an example for students, since this style is also used in several courses. There are several things that programmers who are not familiar with the Google style might find unusual. These are the most common style rules to note:
+- C++ source filenames are all lowercase with underscores, and a .cc extension is used instead of .cpp.
+- Variable names are all lowercase with underscores.
+- Class member variables are named the same as regular variables but with a trailing _, as in my\_member\_var\_.
+- Functions start with capital letters unless they are small getter or setter methods.
+- There are many other rules, a solid discussion of pros/cons, and an automated style checker [here](https://google.github.io/styleguide/cppguide.html).
+