Skip to content

Syphon for Unity Pro 4.0 1.0 Public Beta 2 a17 (avoid flickering)

Latest
Compare
Choose a tag to compare
@brianchasalow brianchasalow released this 04 Nov 18:58

Syphon for Unity Pro 4.0
1.0 Public Beta 2 a17

This is an ongoing work. Please report any and all crashes/freezes, preferably including crash logs

https://github.com/Syphon/Unity3D/issues

If Unity freezes, see http://www.thexlab.com/faqs/activitymonitor.html the section entitled 'sampling a process' and send us that log.

If Unity crashes, see http://echoone.com/bugreports/console.html and send the relevant log.

More features to be added soon. If there's something missing that you want, let us know.

Instructions

Open the .unitypackage to import to an existing project, or simply create a new project and import the unity package into that. When creating a new project, you may want to tick the checkbox in "File/Build Settings/Player Settings/Resolution and Presentation/Run in Background." See SyphonServerAndClient.unity as the provided demo scene.

Add a Syphon.cs to your main camera. this will act as your Syphon manager.

(For new users)
Syphon Server:

  1. if you want to simply output the existing Unity scene camera as a syphon server, add a SyphonServerTexture to any camera in your scene. For basic setups, use this.

Syphon Client:
Add a SyphonClientTexture to any object in your scene.
On the SyphonClientTexture, in the public inspector fields, add the name and appName of the client you just added.

(For advanced users)
Syphon Server:
if you want to output a custom resolution video texture (i.e., 3072x768 for a triplehead, etc) add a SyphonServerTextureCustomResolution to the main camera in your scene. If you want a quick way to use Unity as a control surface, where its GUI is only visible inside the Unity app itself, additionally take a look at the code in ControlSurfaceExample. See the unity scene SyphonServerCustomResolution.unity for a demo.

If you don't care about the alpha channel, and want to ensure your Syphon output texture looks the same as it does in the Unity game view, put a SyphonServerAlphaOne script on the camera.

SyphonClient:
if you want to use a Projector as a Syphon client, add the SyphonClientTextureProjector script to a gameObject that has a Projector on it, and then in its public inspector fields, add the name and appName of the client.

Take a look at the code in SyphonClientTexture.cs's ApplyTexture() method to see how to add additional functionality- adding the texture to projectors, bump maps, etc.

Syphon for Unity is published under a BSD license. See the included License.txt file.

Syphon for Unity3D - Brian Chasalow (Unity 3D integration and scripting), Tom Butterworth (bangnoise) and Anton Marini (vade).

http://syphon.v002.info

Release Notes:
a17: fixes for Unity 5.2 using new plugin API, avoids flickering
a16: bugfix for Oculus support in builds
a15: added Oculus Rift DK2 compatibility.
a14: added a SyphonServerAlphaOne script to optionally set alpha == 1 for the Syphon Server RenderTexture.
a13: fix SyphonClientObject issue with not rendering under rare instances due to cachedTexID == 0
a12: added SyphonClientTextureProjector script, and made it so that SyphonClientTexture adds the mainTexture on all materials on a gameObject, not just the first
a11: added a custom resolution syphon example, and fixed a rare threading issue on syphon exit or creation.
a10: fixed a bug with OnRetireServer crashing with OpenFrameworks servers exiting.
a9: fixed some Unity 4.2 texture creation and 64 bit issues. uses custom Syphon framework with multithreading changes.