rpt - GitLite

KO | EN

gitlite — search

#python #react #llm #go #android #machine-learning #rust #linux #macos #java #windows #kubernetes #pytorch #mcp

rpt

(★ 430)

A physically-based path tracer

파일 탐색기

최종 버전 다운로드 (.zip)

- basic.rs
- compound.rs
- cornell.rs
- cylinder.rs
- cylinder.stl
- dragon.rs
- fractal_spheres.rs
- fractal_teapots.rs
- glass.rs
- lego.rs
- lego.zip
- marbles.rs
- metal.rs
- monomial-old.obj
- monomial.obj
- monomial_glass.rs
- pegasus.rs
- pegasus.zip
- rustacean.obj
- rustacean.rs
- simple_video.rs
- sphere.rs
- spheres.rs
- teapot.obj
- teapot.rs
- wine_glass.obj
- wine_glass.rs
- - particle_state.rs
  - particle_system.rs
- - cube.rs
  - mesh.rs
  - monomial_surface.rs
  - plane.rs
  - sphere.rs
- buffer.rs
- camera.rs
- color.rs
- environment.rs
- io.rs
- kdtree.rs
- lib.rs
- light.rs
- material.rs
- object.rs
- ode.rs
- renderer.rs
- scene.rs
- shape.rs
.gitignore
Cargo.toml
LICENSE-APACHE
LICENSE-MIT
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ekzhang/rpt

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd rpt

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo run --example basic

빌드 후 바로 실행까지 진행합니다.

cargo test

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rpt

[![Latest Version](https://img.shields.io/crates/v/rpt.svg)](https://crates.io/crates/rpt)
[![API Documentation](https://docs.rs/rpt/badge.svg)](https://docs.rs/rpt)

This is a physically based, CPU-only rendering engine written in Rust. It uses path tracing to generate realistic images of 3D scenes.

![Demo renders](https://i.imgur.com/3J6B3cx.jpg)
![Demo video](https://i.imgur.com/UTS3Yo8.gif)

## Features

- Simple declarative API, 100% Safe Rust
- Supports .OBJ, .MTL, and .STL file formats
- Uses unbiased path tracing for physically-based light transport
- Uses a microfacet BSDF model with multiple importance sampling
- Uses kd-trees to accelerate ray intersections
- Supports direct light sampling and emissive materials
- Supports HDRI environment maps
- Supports depth of field
- Supports iterative rendering, variance estimation, and firefly reduction
- Supports physics simulation with numerical integrators and particle systems
- Uses all CPU cores concurrently, scaling linearly up to 96 cores

## Quickstart

First, clone the repository. The library containing path tracing code is located inside `src/`. Example code and scenes are located in `examples/`. To compile and run `examples/basic.rs`, use the command:

```bash
cargo run --example basic
```

To run tests, use:

```bash
cargo test
```

### Library Usage

To use `rpt` as a library, add the following to your `Cargo.toml`:

```toml
[dependencies]
rpt = "0.2"
```

Here's a simple scene that demonstrates the basics of the API.

```rust
use rpt::*;

fn main() {
    let mut scene = Scene::new();

scene.add(Object::new(sphere())); // default red material
    scene.add(
        Object::new(plane(glm::vec3(0.0, 1.0, 0.0), -1.0))
            .material(Material::diffuse(hex_color(0xAAAAAA))),
    );
    scene.add(Light::Object(
        Object::new(
            sphere()
                .scale(&glm::vec3(2.0, 2.0, 2.0))
                .translate(&glm::vec3(0.0, 12.0, 0.0)),
        )
        .material(Material::light(hex_color(0xFFFFFF), 40.0)),
    ));

let camera = Camera::look_at(
        glm::vec3(-2.5, 4.0, 6.5),
        glm::vec3(0.0, -0.25, 0.0),
        glm::vec3(0.0, 1.0, 0.0),
        std::f64::consts::FRAC_PI_4,
    );

Renderer::new(&scene, camera)
        .width(960)
        .height(540)
        .max_bounces(2)
        .num_samples(100)
        .render()
        .save("output.png")
        .unwrap();
}
```

![Example output](https://i.imgur.com/RioQyXf.png)

This code can also be found in `examples/sphere.rs`. Note that the shadow is correctly tinted red due to [global illumination](https://en.wikipedia.org/wiki/Global_illumination). See the detailed [API documentation](https://docs.rs/rpt) for information about all of the features, and feel free to learn from the other examples!

## References

- [Physically Based Rendering, 3rd ed.](http://www.pbr-book.org/)
- [CS 348B: Image Synthesis Techniques](https://graphics.stanford.edu/courses/cs348b/)
- [Microfacet Models for Refraction through Rough Surfaces](https://www.graphics.cornell.edu/~bjw/microfacetbsdf.pdf)
- [Scratchapixel: Global Illumination and Path Tracing](https://www.scratchapixel.com/lessons/3d-basic-rendering/global-illumination-path-tracing)
- [SIGGRAPH '10 Notes on Physically-Based Shading](https://renderwonk.com/publications/s2010-shading-course/hoffman/s2010_physically_based_shading_hoffman_a_notes.pdf)
- Inspired by: [fogleman/pt](https://github.com/fogleman/pt), [hunterloftis/pbr](https://github.com/hunterloftis/pbr)

## Samples

![Dragon](https://i.imgur.com/UEWtPDi.png)
![Cornell box](https://i.imgur.com/K7H8rz4.png)
![Pegasus](https://i.imgur.com/sBKAboG.png)
![Lego plane](https://i.imgur.com/BMVCnZ7.png)
![Fractal spheres](https://i.imgur.com/4aO9A2o.png)
![Rustacean](https://i.imgur.com/zZgl7jE.png)
![Wine glass](https://i.imgur.com/8EAmwuq.png)
![Spheres](https://i.imgur.com/jyNpLN5.png)

## Acknowledgements

This project was built by [Eric Zhang](https://github.com/ekzhang) and [Alexander Morozov](https://github.com/scanhex). We'd like to thank [Justin Solomon](https://people.csail.mit.edu/jsolomon/), Yuanming Hu, Lingxiao Li, and Dmitriy Smirnov for teaching an excellent computer graphics class at MIT.

Some of the examples use free 3D models and image assets available on the Internet. Links are provided in comments in the source code, where used.