{"id":19865246,"url":"https://github.com/voithos/quarkgl","last_synced_at":"2025-05-02T05:31:33.104Z","repository":{"id":23191118,"uuid":"98384637","full_name":"voithos/quarkGL","owner":"voithos","description":"A subatomic OpenGL graphics library.","archived":false,"fork":false,"pushed_at":"2023-07-03T16:50:50.000Z","size":98019,"stargazers_count":107,"open_issues_count":2,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-06T23:05:05.065Z","etag":null,"topics":["graphics-programming","opengl","pbr","rendering"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voithos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-26T05:52:25.000Z","updated_at":"2025-03-31T18:54:43.000Z","dependencies_parsed_at":"2024-11-12T15:34:35.298Z","dependency_job_id":null,"html_url":"https://github.com/voithos/quarkGL","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voithos%2FquarkGL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voithos%2FquarkGL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voithos%2FquarkGL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voithos%2FquarkGL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voithos","download_url":"https://codeload.github.com/voithos/quarkGL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251992858,"owners_count":21677021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graphics-programming","opengl","pbr","rendering"],"created_at":"2024-11-12T15:21:51.213Z","updated_at":"2025-05-02T05:31:28.096Z","avatar_url":"https://github.com/voithos.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# quarkGL\n\nA subatomic OpenGL graphics library and playground.\n\n[Demo video](https://www.youtube.com/watch?v=rbC2D_ayePI\u0026ab_channel=voithoz)\n\n[![render preview](model_render/preview.png)](https://www.youtube.com/watch?v=rbC2D_ayePI\u0026ab_channel=voithoz)\n\n## Features\n\n- Core\n  - Shader loader \u0026 include system\n  - Model loading via Assimp\n  - Mesh and shader primitives\n  - Framebuffer and texture system\n  - Light, uniforms, and texture registry\n  - Reusable GLSL shader library\n- Rendering\n  - Blinn-Phong lighting model\n  - PBR lighting model (Cook-Torrance GGX)\n  - Deferred shading\n  - Runtime IBL, reflection probe prefiltering functions\n  - Shadow mapping\n  - Normal mapping\n  - Compute shaders\n  - SSAO\n  - Instanced rendering\n- Post-processing\n  - HDR support\n  - Bloom\n  - Tone mapping\n  - Gamma correction\n  - FXAA\n- Model viewer\n  - Camera system with fly and orbit controls\n  - ImGui renderer UI\n- Debugging\n  - Debug event integration\n  - Render pass debug groups\n\nSee [examples](examples/) for sample screenshots.\n\n## Building\n\nquarkGL uses [Bazel](https://bazel.build/) as its build system. To begin, first\n[install Bazel](https://docs.bazel.build/install.html).\n\nBazel needs some platform-specific flags, which you can see in the\n`.bazelrc.\u003cplatform\u003e` files. Copy the one for your platform, for example:\n\n```\n$ cp .bazelrc.windows .bazelrc\n```\n\nFor Linux, to be able to actually compile the dependencies, run the following to\ninstall the appropriate tools and headers (on Ubuntu/Debian):\n\n```\n$ sudo apt-get install build-essential xorg-dev libgl1-mesa-dev libglu1-mesa-dev\n```\n\nTo get the linter, also run:\n\n```\n$ sudo apt-get install clang-tidy\n```\n\nYou can build and run the main model renderer, which uses many of the features\nof the library.\n\n```\n$ bazel run //model_render -- --model path/to/model.gltf\n```\n\nOr you can check out any of the other [examples](examples/).\n\n## Developing\n\nIn addition to the build tooling, you may also want to build a\n[compilation database](http://clang.llvm.org/docs/JSONCompilationDatabase.html)\nin order to enable the linter and semantic completion in your editor.\n\nUse\n[bazel-compilation-database](https://github.com/grailbio/bazel-compilation-database)\nto extract the `compile_commands.json` file.\n\n```\n$ bazel-compdb -s\n```\n\nOnce the `compile_commands.json` file exists, run the following to execute the\nlinter:\n\n```\n$ ./run_linter.sh\n```\n\n## About\n\nThis library was built as a way to learn modern OpenGL and graphics techniques.\nNote that it is _not_ production capable, although parts may be useful as a\nreference.\n\nA big thank you goes to the wonderful tutorials by Joey de Vries at\n[learnopengl.com](https://learnopengl.com), and to the wider graphics community!\n\n## Open Source\n\nquarkGL uses several open source libraries itself. Thanks goes to the following\nprojects that were used:\n\n- GLFW\n- GLAD\n- GLM\n- stb_image\n- assimp\n- Dear ImGui\n- imGuIZMO.quat\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoithos%2Fquarkgl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoithos%2Fquarkgl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoithos%2Fquarkgl/lists"}