This is an introduction to the folder structure that Mistika VR will create in your computer:


Note: In some cases you may have old names created by older versions, and they are indicated between parenthesis (). 


Base folders:


During the installation (and also in the initial dialog appearing when opening Mistika VR) two base folders are defined: 


- SGO Data/Media (Material): This is the base folder where the rendered media files are created.


- SGO Data/Projects (Work):  This is the base folder where all the projects are created. A project contains all the work that you do for a production ( not including the rendered media, which is defined in the point above).     


You can change the location of those folders at any time, in the Paths dialog appearing when opening Mistika VR.  They are sepparated because in general they have different needs:   Project files are small but they should be in the most reliable and proteted disk, and make backpups often because it is all your work.  Meanwhile,  the media files (rendered media and camera files) should be located in the fastest storage available for you.  Rendered files do not require backups as you can re-render them easily (as long as you keep the  RENDER folder explained below)   


For collaborative workflows, when using multiple systems or multple Mistika products it is highly recommended to share those folders between all the systems, and use the same ones for all the products.


Project subfolders:


When you create a new project it will  contain several sub-folders. Most of them are not relevant for Mistika VR, but they need to be there so different SGO products (Mamba, Mistika Ultima...) can work with the same project.


The relevant project folders and project  files for Mistika VR users are only these:


- ProjectName/DATA


This is where your sequences are saved, including all the stitch information.  All the work you do to a sequence is saved in a .vrenv file. 


A same project can have several .vrenv files (as many as you create with the  "File->Save as" menu). This permits to have multiple sequences of a complex production,  or multiple versions of a same stitch. 


- ProjectName/DATA/RENDER


This point is for advanced users and for programmers. Most users will not need to use these files, but it is documented here as a reference:

 

Every time  you render (or when you use the "Add to render queue" button),  a render job file ( .rnd file) is created under the DATA/RENDER/RenderName folder for each shot, and they contain all the information that is passed to the renderer.   A .rnd file is like the .vrenv file, but split into shots (one .rnd per shot). 


A sidecar .clp file is also created with each .rnd file. It contains the metadata of the new media file that will be created when rendering the .rnd file. 

In those files you will find all the render metadata that was not defined in the .vrenv , including  the render resolution, render path, and render format. 


Apart from rendering with the interface, you can use the .rnd files in two ways:


 * Mistika Command Line Interface (CLI). The "mistika -r" CLI permits to launch the background render as a command line (  mistika -r PathToRnd ). 


 * The "Add to render queue" permits to create the rnd files and then call a user scripts for each one passing the rnd and some other metadata to them. For example, the integration with Smedge and other render farms use those files to submit the render jobs.


Also, the .rnd files are interesting in case that you need to repeat a render exactly as it was made (for example if you have deleted the rendered media to make space). For which you can use any of the above methods.


Note: All the files mentioned above ( .vrenv, .rnd, .clp, ...) are just text files . You want to manipulate them with your own scripts for better integration in your workflows.  You can find more details in the  article about Mistika syntax in the knowledge base.


Global application settings  and camera presets folder. ( SGO AppData/VR  folder)


The software also needs a global folder to save configuration files and global settings that do not depend on a specific project.  This is the SGO AppData/VR  folder in your user account (on Windows, it is located in %UserData%/SGO AppData ).  Most of the files inside are not intended for direct user manipulation, but it has  some interesting files that you may need to be aware, which is this:


SGO AppData/VR/etc/CameraPresets 


 It contains the camera presets describing all the known camera rigs.  Very often  SGO or  Mistika VR users publish new camera presets  before they appear in new releases (typically in the Mistika VR Presets forum ), and you can install them by simply placing them in this folder. 


 SGO AppData/VR/runBatch.cfg 


This is the runBatch configuration file for the <Add to render queue> button, and it is created first time than this tool is used. It is explained in  the integration with Smedge and other render farms document.


Lastly, some configuration files are shared between all the Mistika applications, and they located in  this folder:



 SGO AppData/shared 


The content of this folder depends on the installed products.  In general, Mistika VR users not using other Mistika applications do not need to do anything with them, just be aware that they exist as this folder will need to be shared between all the applications of the Mistika family.