VRED

Shotgun Engine for VRED

Shotgun Integration for VRED
Latest Version: v2.0.2 (prod)
For our version numbers, we follow the Semantic Versioning standard.
System Name: tk-vred

Please Note: This document describes functionality only available if you have taken control over a Toolkit configuration. Please refer to the Shotgun Integrations User Guide for more details.

The Shotgun engine for VRED establishes a bridge between the Shotgun Pipeline Toolkit apps and VRED Pro and VRED Design. It also contains a PySide distribution, designed to connect QT inside VRED. This makes it possible to write apps, using Python and PySide, that run inside the engine.

Supported Application Versions

This item has been tested and is known to be working on the following application versions: 2020. Please note that it is perfectly possible, even likely, that it will work with more recent releases, however it has not yet been formally tested with these versions.

Overview Video

The following video gives a quick overview of features and functionality.

Documentation

The Shotgun engine for VRED contains a standard platform for integrating Shotgun Apps into VRED. It is lightweight and straight forward and adds a Shotgun menu to the VRED menu.

Information for App Developers

PySide

The Shotgun engine for VRED contains a PySide installation, and will activate this whenever this is necessary.

VRED Project Management

Whenever the Shotgun engine for VRED starts, it will set the VRED Project to point at a location defined in the settings for this engine. This means that the Project may also change when a new file is opened. The details relating to how the VRED project is set based on a file can be configured in the configuration file, using the template system.

Installation and Updates

Adding this Engine to the Shotgun Pipeline Toolkit

If you want to add this engine to Project XYZ, and an environment named asset, execute the following command:

> tank Project XYZ install_engine asset tk-vred

Updating to the latest version

If you already have this item installed in a project and you want to get the latest version, you can run the update command. You can either navigate to the tank command that comes with that specific project, and run it there:

> cd /my_tank_configs/project_xyz
> ./tank updates

Alternatively, you can run your studio tank command and specify the project name to tell it which project to run the update check for:

> tank Project XYZ updates

Collaboration and Evolution

If you have access to the Shotgun Pipeline Toolkit, you also have access to the source code for all apps, engines and frameworks in Github where we store and manage them. Feel free to evolve these items; use them as a base for further independent development, make changes (and submit pull requests back to us!) or simply tinker with them to see how they have been built and how the toolkit works. You can access this code repository at https://github.com/shotgunsoftware/tk-vred.

Special Requirements

  • You need Shotgun Pipeline Toolkit Core API version v0.18.116 or higher to use this.

Configuration

Below is a summary of all the configuration settings used. These settings need to be defined in the environment file where you want to enable this App or Engine.

render_template

Type: template

Description: Template to use to determine where to set the VRED render images. This should be a string specifying the template to use but can also be empty if you do not wish the VRED render path to be automatically set.

file_usage_hook

Type: hook

Default Value: default_file_usage

Description: Hook to customize behaviour on file change and file close.

Release Notes

Welcome to the release notes for this Engine. Below you will find an overview of all the changes we did for each release. We try to be as detailed as possible and include all bugs we have fixed, features we have added and things that may have changed. If you have questions about a particular release, don't hesitate to contact our support team!

v2.0.2

Fixed Bugs

  • Be sure to create the render folder when setting up the render path and remove the render_path attribute.
  • "Import VRED scene" doesn't have the expected behavior.
  • Publish Menu in VRED is displayed as submenu.
  • Remove tk-framework-locking from engine dependencies.

Improvements

  • Clean hook to remove unused "Load" action.
  • Improve the way to set render path in VRED.
  • Improve publish workflow for VRED renders.
  • Clean the OSB publish plugin in VRED.
  • Add start_version_control publish plugin to VRED engine.
  • Examine all publish_plugins for VRED.
  • Remove LMV translation in vred publish process.
  • Move the collector logic from tk-config to tk-vred engine.
  • Remove old plugin which is not used anymore (replaced by vred_publish_file_osb.py).
  • Get the render path in a more cleaner way and move the template logic to the method which set the render path.
  • Clean hook to remove unused actions in tk-multi-loader2 app.
  • Add new hook to deal with VRED actions in Shotgun Panel.

v2.0.1

Fixed bugs

  • Fixed a bug with the plugin in 2020.2. VRED was crashing in the launch step because the engine was starting before the bootstrap process had completed.

  • Fixed a bug with Shotgun menu. It was not loading when VRED language was switched to Japanese/Chinese.

v2.0.0

Whats New:

Overall cleanup of the engine code to maintain toolkit standards and make public.

Feature/Polish:

  • Make tk-framework-locking an optional dependency
  • Removed the about app and created software_credits files in each app/engine/framework repo
  • Change hooks from tk-multi-breakdown, tk-multi-loader2, tk-multi-snapshot, tk-multi-workfiles2 and tk-multi-shotgunpanel to match existing Shotgun tk-default-config2 hook structure
  • Remove unnecessary code in hooks
  • Add custom exception for errors
  • Move common operations from engine to tk_vred/operations.py
  • Implemented dynamic Shotgun menu loading
  • Improved popup notification when loading in multiple files from the Loader
  • Removed vred_bootstrap.py and migrated all requirements (ex. SHOTGUN_ENABLE, VRED_SCRIPT_PLUGINS) to startup.py script
  • Remove the unnecessary pyside folder from resources
  • Replace tank command with the newer sgtk command
  • Move icons to an official icons folder
  • Replace product token with code_name token
  • Add sg_uploaded_movie for each Version from Publisher via VRED
  • Remove hard coded path for VRED to access LMV translator

Fixed Bugs:

Fixed a bug where if you created a scene from a CustomEntity, the Shotgun components would not load correctly.

v1.0.1

First release of VRED engine.

Follow