How do I load an OBJ file in Quartz?

Use the Mesh component in QML with the source file path; for complex scenes, the scene2qml tool converts models to QML hierarchies, though multiple objects are merged into one mesh during import.

Quartz vs Blender Cycles for offline rendering?

Quartz is tailored for real-time path tracing within Qt applications with a declarative QML workflow, while Blender Cycles is a more mature, feature-rich offline renderer with broader 3D asset support and community tools.

Does Quartz work on AMD graphics cards?

No, Quartz requires NVIDIA GPUs with Vulkan RTX extensions like VK_NV_ray_tracing, so it's incompatible with AMD or integrated graphics, limiting hardware compatibility.

How to set up depth of field in a Quartz QML scene?

Enable the thin lens model in the Camera component by adjusting properties like aperture and focus distance in the QML file, as referenced in the features list for cinematic effects.

Can Quartz be used for real-time game rendering?

While it offers interactive camera controls, Quartz is a path tracer focused on physical accuracy, which may not achieve the high frame rates needed for fast-paced games; it's better for visualization or prototyping.

What are the system requirements for Quartz?

Requires a NVIDIA GPU with Vulkan extensions VK_KHR_swapchain, VK_NV_ray_tracing, and VK_EXT_descriptor_indexing, along with Qt 5.12+, Vulkan SDK 1.1.92+, and Assimp 4.1+ for model loading.

Open-Awesome

Quartz

LGPL-3.0C++v1.0.0

A physically based GPU path tracing renderer with a declarative ES7-like scene description language, powered by Qt 3D, NVIDIA RTX, and Vulkan.

GitHub

447 stars23 forks0 contributors

What is Quartz?

Quartz is a physically based GPU path tracing renderer that uses a declarative ES7-like scene description language. It provides real-time ray tracing capabilities through a standalone application and integrates as a drop-in replacement for Qt 3D's rasterization renderer, enabling high-quality visualizations and interactive 3D scene exploration.

Target Audience

Graphics developers and 3D artists working with Qt 3D applications who need real-time path tracing, as well as researchers or hobbyists interested in GPU-accelerated ray tracing with accessible scene authoring.

Value Proposition

Developers choose Quartz for its integration with Qt 3D, leveraging familiar QML workflows while accessing cutting-edge Vulkan RTX ray tracing. Its declarative scene language simplifies complex rendering setups, and it offers a standalone tool for offline or interactive rendering without commercial software dependencies.

Overview

Vulkan RTX path tracer with a declarative ES7-like scene description language.

Use Cases

Best For

Integrating real-time path tracing into Qt 3D applications
Creating high-quality offline renders with physically based materials
Prototyping and visualizing 3D scenes with interactive camera controls
Educational projects exploring GPU ray tracing and Vulkan RTX
Converting complex 3D models to declarative QML scene hierarchies
Developing custom rendering pipelines with a focus on physical accuracy

Not Ideal For

Projects requiring cross-platform GPU support beyond NVIDIA RTX hardware
Teams needing immediate access to advanced rendering features like normal mapping or transmission
Applications not built on Qt or unwilling to adopt QML for scene description
Scenarios where denoising or other post-processing effects are critical for production rendering

Pros & Cons

Pros

Declarative Scene Authoring

Uses QML based on ES7 for intuitive scene definition, integrated with Qt 3D, as shown in the 'Hello, World' example with entity hierarchies and property bindings.

Physically Accurate Rendering

Implements unidirectional path tracing with multiple importance sampling and a metalness-based BRDF, enabling high-quality light transport simulation for realistic images.

Seamless Qt 3D Integration

Acts as a drop-in replacement for Qt3DRender with analogous APIs, allowing easy adoption in existing Qt applications without major code changes.

Standalone Rendering Tool

Includes a standalone application for loading QML scenes with interactive camera controls, progressive preview, and support for HDR/LDR image formats.

Cons

Incomplete Feature Set

The README lists planned features like normal mapping, transmission, and denoising as unimplemented, limiting its utility for advanced rendering projects.

NVIDIA-Only Hardware Lock-in

Requires NVIDIA GPUs with specific Vulkan extensions (VK_NV_ray_tracing), excluding users with AMD, Intel, or other non-NVIDIA graphics hardware.

Complex Build and Setup

Building involves multiple prerequisites (Qt, Assimp, Vulkan SDKs), environment variable configuration, and manual shader compilation, increasing barrier to entry.

Frequently Asked Questions

Related Projects

imgui

Dear ImGui: Bloat-free Graphical User interface for C++ with minimal dependencies

ncnn is a high-performance neural network inference framework optimized for the mobile platform

Stars23,573

Forks4,465

Last commit2 days ago

Bgfx

Cross-platform, graphics API agnostic, "Bring Your Own Engine/Framework" style rendering library.

Stars17,307

Forks2,114