Add Blender projects to the queue
==================================

.. note::
    BRQ will always use the .blend file you originnaly added to the queue. No copy will be done, this means that if you modify your project in Blender after adding it the queue and you hit ``RENDER`` the modified file will be used.

How to add Blender projects
''''''''''''''''''''''''''''''''''

- Drag & Drop you .blend files directly in the BRQ window 
- If using the :ref:`BRQ Add-On <BRQ Blender Add-On>`, in Blender add the currently opened project by click on ``Render ‣ Add to Blender Render Queue``
- Use the shortcut ``Ctrl-O / ⌘-O``

.. tip::
    MacOs users can use the main menu bar and navigate to ``File ‣ Open``


Items field description
''''''''''''''''''''''''''''''''''
File name
    The blend file name

    .. tip:: 
        Click it to reveal the file in the explorer

Status
    A message indicating if the item is pending, rendering, done or has failed

    .. tip:: 
        Click the status message to reveal the rendered file in the explorer

Scene
    Select the scene you want to use

Camera
    Select the camera you want to render

View Layer
    Select the view layer you want to render, leave it to default value to respect Blender settings

Range
    The frame range to render out.
    
    Examples:
        - Range: **1-20**
        - Single frame: **5**
        - Specific frames: **1,25,89**
        - Every 10 frames: **10th**
        - 10 frames evenly distributed: **10f**


Reorder your items
''''''''''''''''''''''''''''''''''

Items in the queue will be rendered sequentially from the top one to the bottom one, skipping those disabled whith the toggle button.
You can reorder items in the queue by using the handle at the right of each items.

.. raw:: html

    <div style="text-align: center;">
        <a href="_static/img/screenshots/queue-reorder.png">
            <img src="_static/img/screenshots/queue-reorder.png" alt="" class=""/>
        </a>
        <div class="figure-caption">
          Drag & Drop items to reorder the queue.
        </div>
    </div>


Context menu
''''''''''''''''''''''''''''''''''

Right click an item to show the context menu and get access to all features.

.. raw:: html

    <div style="text-align: center;">
        <a href="_static/img/screenshots/context-menu.png">
            <img src="_static/img/screenshots/context-menu.png" alt="" class=""/>
        </a>
        <div class="figure-caption">
          Right clicking the item offers new options.
        </div>
    </div>


Look at Output Settings
''''''''''''''''''''''''''''''''''

Selecting an item in the queue displays all its render options in a **static panel on the right side** of the interface.  

The panel gives you direct access to:

- **Engine**  
- **Format** (file format, color depth, transparency, etc.)  
- **Output File** (path and template variables)  
- **Custom Python Expression** (Run a custom script before/after rendering)

.. tip::
    Clicking the output path lets you specify another location.  
    This path is **used only by BRQ** and is **not written back to your .blend file**.

.. raw:: html

    <div style="text-align: center;">
        <a href="_static/img/screenshots/properties-panel.png">
            <img src="_static/img/screenshots/properties-panel.png" alt="" class=""/>
        </a>
        <div class="figure-caption">
          The right-side panel provides a clear overview of Engine, Format, Output File, and Custom Python Expression settings.
        </div>
    </div>