Skip to content

Commit

Permalink
require 'dot' in website workflow test. Add helpful links
Browse files Browse the repository at this point in the history
Signed-off-by: Peter Hillman <[email protected]>
  • Loading branch information
peterhillman committed Mar 20, 2024
1 parent 10e0aa4 commit 9fb4d16
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 2 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/website_workflow.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ jobs:
- name: Install doxygen & imagemagick
# Need imagemagick for convert, to convert "Test Image" exrs to jpgs
# Need openexr for exrheader
run: sudo apt-get install -y doxygen imagemagick openexr
run: sudo apt-get install -y doxygen imagemagick openexr dot
- name: Install sphinx requirements
run: pip3 install -r website/requirements.txt
- name: Configure
Expand Down
24 changes: 23 additions & 1 deletion website/SceneLinear.rst
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ more natural. The images above illustrate this. The first version of the image
presents the pixels with the same color and intensity that the real objects had [#f1]_
This particular scene has low enough contrast and subtle enough colors that monitors
are capable of displaying it faithfully.
The second image is a JPEG created by the camera using its built-in tone mapping of the image. This image
The second image is a JPEG created by the camera using its built-in tone mapping giof the image. This image
looks more pleasing, even though the colors are no longer faithful to those
originally observed.

Expand Down Expand Up @@ -247,6 +247,28 @@ subsequent steps applied before being displayed.
}


Color management resources
==========================

`OpenColorIO <https://opencolorio.org/>`_ (OCIO) is a framework providing
software libraries to apply color transformations based on a configuration.
Since the same config is shared by all OCIO-compatible software, color
conversions can be applied consistently when working with the same images in
multiple software packages.

The `Academy Color Encoding System (ACES) <https://acescentral.com/>`_ defines
standard workflows to convert from raw camera images to scene-linear images, and
a standard tone mapping system for convert to output referred images.
OpenColorIO configs are available which implement the necessary conversions.
ACES image files (specified by SMPTE ST2065-4) are scene-linear OpenEXR
images

`OpenImageIO <https://github.com/AcademySoftwareFoundation/OpenImageIO>`_
provides a library and command line tools for loading and saving images in
multiple formats, including OpenEXR, and supports image processing with
OpenColorIO.


.. rubric:: Footnotes
.. [#f1] The colors in the first image will be rendered as observed on monitors which are calibrated for sRGB
with a maximum intensity of 62 cd/m :superscript:`2`. Most monitors will display the colors accurately but slightly too bright.

0 comments on commit 9fb4d16

Please sign in to comment.