Zyzyl's Multi-cam Switcher tool

This is work-in-progress, please don't edit right now!

This multi-cam switcher tool dramaticaly enhances filming or streaming workflows for people wanting to play with multiple camera angles. It allows you to easily create, fine tune, and switch between all of your camera angles. The major improvement over the standard Neos streaming UI is the ability to preview all your available shots at all times!

The tool can be found in this public folder insert public folder link along with documentation and a copy of the license. The tool is free to use for any purpose and you may edit and redistribute it as well. The only requirement is that you must provide reasonable attribution to Zyzyl as the tool's creator if you use it or release a modified version.

Instructions

Quick Start

1. Spawn the multi-cam switcher tool and your Neos streaming camera.
2. Put your camera in the green camera anchor on the right hand side of the UI.
3. Add new viewpoints by using one of the 'Create New' button options.
4. You can switch the active viewpoint (indicated by a red border) by laser clicking on any of the preview screens as long as your streaming camera is in the anchor.
5. You can fine tune all types of view point using the settings (click the cogwheel button in the header of each preview screen). For static viewpoints you can also grab the blue camera visual to do general positioning.
6. When you're finished setting up, you can leave editing mode by pressing the 'Disable editing' button on the lower toolbar. Disabling editing locks most things from being changed and prevents any stray laser clicks from messing up your shots!
7. Lastly you can hide the multi-cam switcher UI from the stream camera using the InteractiveCameraObjectExcludeTip (see here for details).

Happy filming!

Getting the Multi-cam Switcher tool

The tool is available from this public folder insert public folder link. If you copy and paste that record URL into the Neos window it will spawn a copy of the public folder which you can save to your inventory. Inside the public folder there is (in order):

• The Multi-cam Switcher tool
• A variant of this documentation
• A copy of the insert license text
• A copy of the Neos InteractiveCameraObjectExcludeTip included for convenience (this is not covered by the above license and Zyzyl did not create it - it's a part of the Neos codebase).

You can spawn out any of the above items by double clicking on the inventory icon. It's recommended to always get the tool from the public folder (rather than saving your own copy) to ensure that you get the most up-to-date version.

Tool layout

The tool is composed of 3 major parts. There is the upper UI piece called the 'Display', the lower UI piece called the 'Toolbar', and the green camera anchor which sits on the right of the tool when empty. The display UI contains the viewpoint preview screens and the 'Create New' option buttons. The display and toolbar automatically adjust their size depending on various factors (e.g. preview screens being added to the display).

Note that only the user who spawned the tool can interact with the display and toolbar UI buttons.

Setting up

Anchoring the streamer camera

The multi-cam switcher tool works by moving the attached camera anchor between the viewpoint positions. This is how it switches your stream camera's viewpoint, so you need to have your camera set into the camera anchor for the tool to work. Once your streaming camera has spawned, you can anchor it by aiming your laser at the green camera anchor and pressing the trigger. If successful the camera will move to the anchor's position. For a great general overview of the Neos streaming camera, see ProbablePrime's tutorial series: part 1, part 2, and part 3.

Creating new viewpoints

You can add new viewpoints by using one of the four option buttons on the 'Create New' screen on the display. The '1st person view', '3rd person front view', and '3rd person back view' viewpoints will be positioned relative to a specified user. The 'Static view' viewpoints remain stationary relative to the world root unless deliberately moved. When any new viewpoint is created a corresponding preview screen is created on the display.

When adding a new '1st person view', '3rd person front view', or '3rd person back view' you will be prompted to input a username. Start typing until "Matched: target username" appears in green text below the text entry box. The user matching will attempt to match partial names and is case insensitive. If multiple users have usernames which share some letters you may need to type in the full name to ensure the correct match. Once the desired user is matched, click on the green 'Create' button. To isntead return to the 'Create New' screen, press the red 'Cancel' button.

When a new static viewpoint is added a blue viewpoint visual indicator spawns on the left side of the UI. This can be grabbed and moved into position but it does not act as a Neos camera anchor (despite appearing similar).