Files toolbox¶
This toolbox shows how the scene objects are structured in sub-files, and allow changing this structure.
The view¶
The main scene file that is currently opened is shown by the top icon. This scene file may contain some objects (materials, instruments, geometries…) and also import other files, shown as child icons.
When objects have been modified, but the scene was not saved, these modified objects are shown in live edits at the bottom. They will move back to the main scene file as soon as you save your changes.
Object folders are not displayed as in the object toolbox. Instead, folder names are prefixed to the object name using the slash ‘/’ separator.
Object priorities¶
When an object with the same type and name is included in multiple files, only the active one is displayed in the object toolbox. In this view, each object version can be found under its own included file. The active one is the lowest one in the list, all other are shown with a greyed icon and are inactive or “shadowed”.
You can reorder all the items (imports and objects) that are immediately under the main scene file, by dragging and dropping them. This way, you change object priorities and which objects are active. After this action, you need to save the scene before starting a simulation.
Imported files¶
Importing a file¶
You can import a file in this toolbox, by right clicking on the main scene file, and selecting Import. This will bring the Import dialog
Changing import settings for a file¶
You can change import settings for an imported file by right clicking on it and selecting Import settings. You may also double click on the imported file.
This allows:
- Changing the object type filters
- Changing the object name prefixing
- Breaking the reference : this copies all imported objects to the scene and removes the import
See Import dialog for more information.
Removing an import¶
You can change import settings for an imported file by right clicking on it and selecting Remove reference.
Reloading an import¶
If an imported file has been modified in another program (such as another instance of Ocean, or a 3D CAD software with an exporter plugin), you can reload it by right clicking on it and selecting Reload.
Objects¶
Copying an object¶
You can copy an object to the clipboard by right clicking on it and selecting Copy. This is especially useful as you may do it on a shadowed object, which is not accessible in the object toolbox.
Reverting to a shadowed object¶
You can copy a shadowed object to the live edits, it then becomes the active object. Just right click on a shadowed object and select Revert to this version.
Cancelling object changes¶
If an object has been modified since the last scene save, it is shown in the live edits. You can cancel these changes by right-clicking on the object and selecting Revert edits