File Output Wildcards
==================================

What if you want to quickly set up a file different output path for all your ``scenes`` / ``cameras`` / ``view layers`` ?

| Wildcards are tokens that you can add to your output file path in Blender.
| **They will be automatically replaced** by the related property name in the output file path.

It’s a time saver since you don’t have to specify a unique path for each item.
Set it up only once and each item gets a unique path based on the selected ``scenes`` / ``cameras`` / ``view layers``.

BRQ wildcards are additional tokens that complement Blender’s built-in `file output template variables. <https://docs.blender.org/manual/en/latest/files/file_paths.html>`_


BRQ 5 now uses **Blender 5 File Output Template Variables**  
(see: Blender manual → `File Paths. <https://docs.blender.org/manual/en/latest/files/file_paths.html>`_)

Supported template variables:
''''''''''''''''''''''''''''''''''''''''''''

- ``{scene_name}`` : selected scene name  
- ``{camera_name}`` : selected camera name  
- ``{viewlayer_name}`` : selected view layer name  
- ``{blend_name}`` : current .blend file name  
- ``{blend_dir}`` : directory of current .blend file  
- ``{blend_name_lib}`` : library .blend file name  
- ``{blend_dir_lib}`` : directory of library .blend file  
- ``{fps}`` : scene frame rate  
- ``{resolution_x}`` : render resolution X  
- ``{resolution_y}`` : render resolution Y


.. raw:: html

    <div style="text-align: center;">
        <a href="_static/img/screenshots/wildcards-example.png">
            <img src="_static/img/screenshots/wildcards-example.png" alt="" class=""/>
        </a>
        <div class="figure-caption">
          In green the computed output path for the current item (MyProject.blend).
        </div>
    </div>

Example:
''''''''''''''''''''''''''''''''''''''''''''

Assuming you have a project called ``room`` with 3 cameras ``Main-camera``, ``Picture-camera``, ``Window-camera``

.. tab:: Save to different folders

    | In the Blender output settings, enter the desired tokens for the output path :

    ``C:\Users\user_name\room\{camera_name}\animation.png``

    When all cameras are added to the queue, BRQ expands the file output paths to:

    - ``C:\Users\user_name\room\Main-camera\animation.png``  
    - ``C:\Users\user_name\room\Picture-camera\animation.png``  
    - ``C:\Users\user_name\room\Window-camera\animation.png``  

.. tab:: Save to different files

    | In the Blender output settings, enter the desired tokens for the output path :

    ``C:\Users\user_name\room\animation-{camera_name}.png``

    When adding all cameras to the queue, BRQ expands them to:

    - ``C:\Users\user_name\room\animation-Main-camera.png``  
    - ``C:\Users\user_name\room\animation-Picture-camera.png``  
    - ``C:\Users\user_name\room\animation-Window-camera.png``