.. |render_shelf| image:: ../images/render/shelf.png

.. |ipr| image:: ../images/render/ipr.png
.. |ipr_stop| image:: ../images/render/ipr_stop.png
.. |open_wit| image:: ../images/render/open_wit.png
.. |render| image:: ../images/render/render.png
.. |render_settings| image:: ../images/render/render_settings.png

Rendering 
=========

The rendering module offers three modes: 
Preview, IPR (Interactive Progressive Rendering), and Disk Render. 

Render attributes are configured via a render network accessed through the Render Settings menu.

Additionally, the module supports Arbitrary Output Variables (AOVs) and Render Products, 
enabling users to fine-tune output configurations and isolate specific elements of the 
scene for post-processing.

The render shelf has the following options:

|render_shelf|

.. list-table:: 
    :header-rows: 1
    :widths: 10, 90

    * - Icon
      - Option 
    * - |open_wit|
      - Open Render View
    * - |render|
      - Preview Render
    * - |ipr|
      - Ipr Render (Interactive Progressive Rendering)
    * - |ipr_stop|
      - Stop Render
    * - |render_settings| 
      - Render Settings

Before starting the render process, it is necessary to set the preferences using the 
Render Settings menu. The description of the Render Settings options is given on the 
following page:

.. toctree:: 
    :maxdepth: 1

    render_settings.rst

Render Delegates
----------------

The application supports Arnold, Renderman, and Cycles for rendering.
For more information on working with these renderers, see the following section:

.. toctree::
  :maxdepth: 0

  render_delegates.rst

Viewing the output images
-------------------------

The results of rendering are displayed in the Render View window.
The information about Wit is provided in the following section:

.. toctree:: 
  :maxdepth: 1

  render_view.rst

Rendering Types 
---------------
Preview Render 
~~~~~~~~~~~~~~~~~

|render| Render Preview mode allows rendering the current state of the scene without saving the output image to disk. 

The results are displayed in Render View window, showcasing special effects, geometry, and lighting. 

Images are only outputted in the Render View, without creating files, saving disk space and 
simplifying settings testing.

Disk Render 
~~~~~~~~~~~~~~

Disk Render allows you to save the image or sequence of scene frames to the specified path. 
it supports such image output formats as PNG, JPEG, TIFF. 

Recording using multi-channel formats like EXR or HDR is also available, supporting the output of 
additional lighting passes, cryptomatte, and normals into the resulting file. 

In the ``render_output`` attribute settings, you can specify the directory path where the file will be saved, 
the file name, followed by the frame number and its extension delimited by the ``.`` symbol.

For example:

.. code-block:: python 
    
    /renders/scene1.1001.exr

IPR Render 
~~~~~~~~~~~~~

Interactive Progressive Rendering (IPR) mode Provides real-time feedback during scene editing. 
When changes are made, affected parts of the scene are re-rendered, allowing for immediate visualization and adjustments. 
This iterative feedback loop facilitates precise scene tuning.