~wahn/rs-pbrt

630100d0c7015d1dade515d4eb4b8167437f338c — Jan Walter 3 months ago 29fab43 v0.9.4
Prepare v0.9.4 release.
M Cargo.lock => Cargo.lock +1 -1
@@ 822,7 822,7 @@ dependencies = [

[[package]]
name = "rs_pbrt"
version = "0.9.3"
version = "0.9.4"
dependencies = [
 "atom",
 "atomic",

M Cargo.toml => Cargo.toml +1 -1
@@ 2,7 2,7 @@
authors = ["Jan Walter <jan@janwalter.com>"]
edition = "2018"
name = "rs_pbrt"
version = "0.9.3"
version = "0.9.4"
license = "MIT OR Apache-2.0"
readme = "README.md"
repository = "https://github.com/wahn/rs_pbrt"

M README.md => README.md +1 -1
@@ 26,7 26,7 @@ https://www.rs-pbrt.org/doc/crates/rs_pbrt/index.html
```shell
> cargo build --release --no-default-features
> ./target/release/rs_pbrt --help
rs_pbrt 0.9.3
rs_pbrt 0.9.4
Parse a PBRT scene file (extension .pbrt) and render it

USAGE:

M docs/source/conf.py => docs/source/conf.py +2 -2
@@ 18,11 18,11 @@
# -- Project information -----------------------------------------------------

project = 'rs-pbrt'
copyright = '2020, Jan Douglas Bert Walter'
copyright = '2022, Jan Douglas Bert Walter'
author = 'Jan Douglas Bert Walter'

# The full version, including alpha/beta/rc tags
release = '0.9.3'
release = '0.9.4'


# -- General configuration ---------------------------------------------------

M docs/source/getting_started.rst => docs/source/getting_started.rst +33 -20
@@ 17,12 17,23 @@ Compiling rs_pbrt
Cloning the repository
----------------------

There are two repositories you can get the **Rust source code** from:
There are three repositories you can get the **Rust source code** from:

1. `GitHub repository`_
2. `Codeberg repository`_
1. `sourcehut repository`_
2. `GitHub repository`_
3. `Codeberg repository`_

Both should be exactly the same, but reported issues etc. might differ.
All three should be exactly the same, but reported issues etc. might differ.

sourcehut
.........

.. code:: shell

          # read-only
          git clone https://git.sr.ht/~wahn/rs-pbrt
          # read/write
          git clone git@git.sr.ht:~wahn/rs-pbrt

GitHub
......


@@ 106,24 117,25 @@ you get a simple **usage** message of the main executable ``rs_pbrt``:
          # relative path to executable rs_pbrt (assuming release build)
          ./target/release/rs_pbrt --help
          # output
          rs_pbrt 0.9.3
          rs_pbrt 0.9.4
          Parse a PBRT scene file (extension .pbrt) and render it
          

          USAGE:
              rs_pbrt [OPTIONS] <path>
          

          FLAGS:
              -h, --help       Prints help information
              -V, --version    Prints version information
          

          OPTIONS:
                  --cropx0 <cropx0>        Specify an image crop window <x0 x1 y0 y1> [default: 0.0]
                  --cropx1 <cropx1>        Specify an image crop window <x0 x1 y0 y1> [default: 1.0]
                  --cropy0 <cropy0>        Specify an image crop window <x0 x1 y0 y1> [default: 0.0]
                  --cropy1 <cropy1>        Specify an image crop window <x0 x1 y0 y1> [default: 1.0]
              -t, --nthreads <nthreads>    use specified number of threads for rendering [default: 0]
              -s, --samples <samples>      pixel samples [default: 0]
          
                  --cropx0 <cropx0>            Specify an image crop window <x0 x1 y0 y1> [default: 0.0]
                  --cropx1 <cropx1>            Specify an image crop window <x0 x1 y0 y1> [default: 1.0]
                  --cropy0 <cropy0>            Specify an image crop window <x0 x1 y0 y1> [default: 0.0]
                  --cropy1 <cropy1>            Specify an image crop window <x0 x1 y0 y1> [default: 1.0]
              -i, --integrator <integrator>    ao, directlighting, whitted, path, bdpt, mlt, sppm, volpath
              -t, --nthreads <nthreads>        use specified number of threads for rendering [default: 0]
              -s, --samples <samples>          pixel samples [default: 0]

          ARGS:
              <path>    The path to the file to read



@@ 134,7 146,7 @@ The **version** can be checked by:
          # print version number
          ./target/release/rs_pbrt --version
          # output
          rs_pbrt 0.9.3
          rs_pbrt 0.9.4

Your first rendered image
=========================


@@ 147,8 159,8 @@ render a `PNG`_ image (currently always being called ``pbrt.png``):
          # specifing an input file
          ./target/release/rs_pbrt ~/git/gitlab/rs-pbrt-test-scenes/pbrt/cornell_box/cornell_box.pbrt
          # output
          pbrt version 0.9.3 (unknown) [Detected 4 cores]
          Copyright (c) 2016-2021 Jan Douglas Bert Walter.
          pbrt version 0.9.4 (unknown) [Detected 4 cores]
          Copyright (c) 2016-2022 Jan Douglas Bert Walter.
          Rust code based on C++ code by Matt Pharr, Greg Humphreys, and Wenzel Jakob.
          Film "image"
            "integer xresolution" [500]


@@ 156,8 168,9 @@ render a `PNG`_ image (currently always being called ``pbrt.png``):
          Sampler "sobol"
            "integer pixelsamples" [8]
          Integrator "path"
          Integrator "path"
          Rendering with 4 thread(s) ...
          1024 / 1024 [=======================================================================] 100.00 % 191.65/s 
          1024 / 1024 [=======================================================================] 100.00 % 176.58/s
          Writing image "pbrt.png" with bounds Bounds2i { p_min: Point2i { x: 0, y: 0 }, p_max: Point2i { x: 500, y: 500 } }

The resulting image should look like this:


@@ 217,6 230,7 @@ provided scenes!

.. _install Rust: https://www.rust-lang.org/tools/install
.. _rustup: https://github.com/rust-lang-nursery/rustup.rs
.. _sourcehut repository: https://git.sr.ht/~wahn/rs-pbrt
.. _GitHub repository: https://github.com/wahn/rs_pbrt
.. _Codeberg repository: https://codeberg.org/wahn/rs_pbrt
.. _its documentation: https://doc.rust-lang.org/cargo


@@ 225,4 239,3 @@ provided scenes!
.. _PNG: https://en.wikipedia.org/wiki/Portable_Network_Graphics
.. _scene files: https://gitlab.com/jdb-walter/rs-pbrt-test-scenes
.. _Wiki: https://gitlab.com/jdb-walter/rs-pbrt-test-scenes/wikis/home


M docs/source/license.rst => docs/source/license.rst +2 -2
@@ 13,7 13,7 @@ at your option.
MIT license
-----------

Copyright (c) 2016-2020 Jan Douglas Bert Walter
Copyright (c) 2016 Jan Douglas Bert Walter

Permission is hereby granted, free of charge, to any
person obtaining a copy of this software and associated


@@ 230,7 230,7 @@ APPENDIX: How to apply the Apache License to your work.
   same "printed page" as the copyright notice for easier
   identification within third-party archives.

Copyright 2016-2020 Jan Douglas Bert Walter
Copyright 2016 Jan Douglas Bert Walter

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.

M src/bin/rs_pbrt.rs => src/bin/rs_pbrt.rs +1 -1
@@ 901,7 901,7 @@ fn main() {
        "pbrt version {} ({}) [Detected {} cores]",
        VERSION, git_describe, num_cores
    );
    println!("Copyright (c) 2016-2021 Jan Douglas Bert Walter.");
    println!("Copyright (c) 2016-2022 Jan Douglas Bert Walter.");
    println!("Rust code based on C++ code by Matt Pharr, Greg Humphreys, and Wenzel Jakob.");
    let (mut api_state, mut bsdf_state) = pbrt_init(
        pixelsamples,