================
Render Delegates
================

The Render Delegate is selected in the :ref:`Render Settings<docs/render/render_settings:render attributes>`.
The list of the available parameters of the renderer depends on the selected Render Delegate.
The render delegate selection is accessible for both Viewport and final renders.

Cycles 
------

The application includes a bundled Cycles renderer. 
To enable Cycles, run the ``loki.cycles.bat`` script located in the application directory.  
This will run the application instance with Cycles available as a selectable Render Delegate.

.. note:: 
  **Loki** includes a bundled version of Cycles 3.5.0. It is recommended to use the bundled version 
  for optimal performance and stability.

Arnold
------

**1. Configure Arnold Path:**

Before launching the application, you need to specify the path to your Arnold installation in the 
``loki.arnold.bat`` file. Open this file with a text editor and uncomment the line that sets the Arnold path.  
Make sure to replace ``C:\Program Files\arnold-7.2.1.0\bin`` with the actual path to your Arnold installation directory.  

.. note:: 
  **Loki** is designed for use with Arnold 7.2.1.0. While other versions might function, 
  compatibility is not guaranteed.

.. code-block:: bat
  :emphasize-lines: 4

    @echo off
    setlocal
    REM Uncomment the line below and insert a path to Arnold binaries
    set PATH=C:\Program Files\arnold-7.2.1.0\bin;%PATH%
    set PXR_PLUGINPATH_NAME=%~dp0/plugin/arnold;%PXR_PLUGINPATH_NAME%
    if "%PXR_USDMTLX_STDLIB_SEARCH_PATHS%"=="" (
        set PXR_USDMTLX_STDLIB_SEARCH_PATHS=%~dp0/materialx/libraries
    )
    call "%~dp0bin\loki.exe" %*

**2. Launch the Application:**

After saving the changes to ``loki.arnold.bat``, double-click the file to launch the application. 
The Arnold render delegate will now be available for use.

Renderman 
---------

**1. Configure RenderMan Path (RMANTREE):**

Before launching the application, you need to set the ``RMANTREE`` environment variable to point to your RenderMan 
installation directory. 

Open the ``loki.renderman.bat`` file with a text editor and uncomment the line that sets ``RMANTREE``. 
And set path to your RenderMan installation. 

.. note:: 
  **Loki** is designed for use with RenderManProServer-24.3. 
  While other versions might function, compatibility is not guaranteed.

.. code-block:: bat
  :emphasize-lines: 4

    @echo off
    setlocal
    REM Uncomment the line below and insert a path to RenderMan root directory
    set RMANTREE=C:\Program Files\Pixar\RenderManProServer-24.3
    if "%RMANTREE%"=="" (
        echo "ERROR: RMANTREE is not defined."
        exit /b -1
    )
    set PATH=%~dp0\plugin\renderman;%PATH%
    set PXR_PLUGINPATH_NAME=%~dp0/plugin/renderman;%PXR_PLUGINPATH_NAME%
    if "%PXR_USDMTLX_STDLIB_SEARCH_PATHS%"=="" (
        set PXR_USDMTLX_STDLIB_SEARCH_PATHS=%~dp0/materialx/libraries
    )
    call "%~dp0bin\loki.exe" %*

**2. Launch the Application:**

After saving the changes to ``loki.renderman.bat``, double-click the file to launch the application. 
The RenderMan render delegate will now be available for use.