digital-creativity-labs/cuttingroom-v0.0

Cutting Room is a plugin for Unity developed by Digital Creativity Labs which allows creators to build and deploy Object Based Media productions.

Cutting Room

Cutting Room is a plugin for Unity developed by Digital Creativity Labs at the University of York which allows creators to build and deploy Object Based Media productions.

Getting Started

• Ensure that you have Git LFS installed.
• Clone the repository: https://github.com/Digital-Creativity-Labs/CuttingRoom.git
• Open the cloned project with Unity (2020.3.23f1 or above).
• Open the first sample tutorial: Assets/Samples/UnityVideo/1AtomicNarrativeObject/AtomicNarrativeObject.unity to learn the basics.
• Complete the remaining tutorials: Assets/Samples/UnityVideo
• Build your own productions and share them with us via one of our communities.

Documentation

API documentation can be found:

• Within the Docs directory of the repository.
• On Google Drive.

Samples

Samples are available within the Samples directory of the repository. These include samples using the Unity VideoPlayer component and also samples using the AVProVideo plugin (not included).

The sample Unity scenes provide an interactive demo on how to set up a Cutting Room production and also explain the functionality available within the tool.

Contributions

We love seeing pull requests with new features or bug fixes so please feel free to create these if you have something to share with us. Once received, we will examine each one and if satisfied, merge them into the main repository with our thanks.

Community

You can join us and other Cutting Room creators in the following communities:

• Join and discuss Cutting Room and Object Based Media on Slack.
• Create and read threads about Cutting Room on Reddit.
• Follow and tweet us @CuttingRoomOBM on Twitter.

Collaboration

We are always on the look out for new partners to work with to develop innovative and novel products using Cutting Room. If you would like to speak to us about a potential collaboration please reach out to us at [email protected].

Support

If you encounter an issue or just need clarification on existing functionality, please make us aware of this by submitting an issue through Github and we will do our best to provide assistance.

Creators

This tool was developed by Digital Creativity Labs at the University of York.

                                 

Copyright and Licence

Code and documentation copyright 2015-2022 Digital Creativity Labs and University of York.

Code is released under the Apache 2.0 Licence.

cuttingroom-v0.0's Issues

Readme assets.

Max Time To Sequence Ahead Issue

This is probably a bug caused by the way we’re hacking in pausing and skipping. However, I thought I’d report it anyway in case its not. I’ve found that the sequencer hangs and doesn’t schedule any more clips after playing some longer clips. We never noticed this before as we’d set all the lengths to 2 seconds for development, but not we’ve set them to correct length the film seems to stop halfway through at points.
It seems it’s not sequencing the next clip because playHeadTime is set to 0 and, therefore, this method returns false. It doesn’t happen for shorter clips, because maximumSecondsToSequenceAheadOfTime is set to 120 and so it’s longer than the layerEndTime
public bool CanSequence()
{
if (playheadTime + maximumSecondsToSequenceAheadOfTime > layerEndTime)
{
return true;
}
return false;
}
A fix is to set maximumSecondsToSequenceAheadOfTime to a bigger value. For example:
private const float maximumSecondsToSequenceAheadOfTime = 10000f;
As I say, probably a result of my hacking. But in case it is a bug more generally thought I’d report it.

Setup Guide

1. Install Unity Hub.
2. Open https://unity3d.com/get-unity/download/archive in your browser.
3. Select Unity 2020.x
4. Click Unity Hub on the most recent version in the list. This will open Unity Hub on your machine and you should accept the installation.
5. Once complete, close Unity Hub.
6. Download the Cutting Room project from Github from the following link: https://github.com/Digital-Creativity-Labs/CuttingRoom/releases/download/Internal-Test-v1.0/CuttingRoomEditor-c609fb5-Integrate-m2-v0.4.zip
7. Unzip onto your hard drive.
8. Open Unity Hub on your machine.
9. Click Projects on the left hand side of the window.
10. Click Add in the top right of the window.
11. Navigate to the unzipped folder and point it at the folder containing the unzipped files.
12. Once the project appears in the Projects list in Unity Hub, click the row containing the project name.
13. The Unity editor will open and you are now ready to develop using Cutting Room.