{"id":17049784,"url":"https://github.com/marzer/rt","last_synced_at":"2026-02-17T02:02:22.264Z","repository":{"id":206030891,"uuid":"667178972","full_name":"marzer/rt","owner":"marzer","description":"renderer/ray tracer framework.","archived":false,"fork":false,"pushed_at":"2025-04-08T10:00:39.000Z","size":213,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-15T11:24:32.119Z","etag":null,"topics":[],"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/marzer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-16T22:37:34.000Z","updated_at":"2025-02-26T12:19:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"8668f880-e9a1-4e0f-9760-18725924f6af","html_url":"https://github.com/marzer/rt","commit_stats":null,"previous_names":["marzer/rt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marzer/rt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marzer%2Frt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marzer%2Frt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marzer%2Frt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marzer%2Frt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marzer","download_url":"https://codeload.github.com/marzer/rt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marzer%2Frt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268543400,"owners_count":24267055,"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","status":"online","status_checked_at":"2025-08-03T02:00:12.545Z","response_time":2577,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-10-14T09:55:22.165Z","updated_at":"2026-02-17T02:02:22.209Z","avatar_url":"https://github.com/marzer.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rt\n\nRenderer/ray tracer test framework.\n\n\u003e ℹ\u0026#xFE0F; All commands in this readme assume CWD is the repository root.\n\n\u003cbr\u003e\u003cbr\u003e\n\n## Building and running\n\n### Prerequisites\n\n-   A C++20-capable compiler\n-   The [meson] build system\n-   A recent version of Python 3 (required by [meson]).\n\n#### Linux\n\nYou may need to install a bunch of packages for x11 and sdl2, e.g.:\n\n```sh\nsudo apt install xorg-dev libx11-dev libgl1-mesa-glx libsdl2-dev\n```\n\n### Creating a build directory\n\n```sh\n# windows with visual studio:\nmeson setup build --backend vs\n\n# everything else:\nmeson setup build\n```\n\n### Building\n\n```sh\ncd build \u0026\u0026 meson compile\n```\n\n### Running\n\n`rt` is a command-line application.\n\n```\nUsage: rt [--help] [--version] [--list] --scene \u003cpath\u003e --renderer \u003cname\u003e\n\nRenders a scene with a software renderer of your choosing.\n\nOptional arguments:\n  -h, --help      shows help message and exits\n  -v, --version   prints version information and exits\n  -l, --list      lists available renderers and exits\n  -s, --scene     scene TOML file [nargs=0..1] [default: \"\"]\n  -r, --renderer  renderer name [nargs=0..1] [default: \"mg_ray_tracer\"]\n```\n\nAvailable renderers are listed as part of the program's stdout during regular execution.\n\n\u003cbr\u003e\u003cbr\u003e\n\n## Misc\n\n### Redownloading subprojects\n\nDownloading of the required subproject dependencies should happen for you automatically, but if it doesn't (or you wish to force a re-download/update):\n\n```sh\nmeson subprojects download \u0026\u0026 meson subprojects update --reset\n```\n\n### Switching between Debug and Release builds\n\nThe default build config is Release (highly-optimized but poor debugging experience). If you wish to change to debug:\n\n```sh\ncd build \u0026\u0026 meson configure --buildtype debug\n```\n\n### Adding a new renderer\n\nRenderers are intended to be self-contained in single `.cpp` files in `src/renderers/`. The general process for adding a new one is as follows:\n\n1. Create your new renderer `.cpp` file in `src/renderers/` (use one of the existing ones as a template if necessary)\n2. Add the cpp file to the list in `src/renderers/meson.build`\n3. Build and test\n\n### Regenerating SoA types\n\nThe struct-of-arrays types are generated using [soagen]. Their code files are already present in the repository so\nyou won't need to do this, unless you wish to change them in some manner, in which case:\n\n```sh\n# initial soagen install\nsudo pip3 install soagen\n\n# regenerate files and update soagen.hpp\nsoagen src\\soa.toml --install vendor\n```\n\n\u003cbr\u003e\u003cbr\u003e\n\n[meson]: https://mesonbuild.com/Getting-meson.html\n[soagen]: https://marzer.github.io/soagen/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarzer%2Frt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarzer%2Frt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarzer%2Frt/lists"}