Skip to main content

7️⃣ Basic Toggle

For venues or other performance-heavy scenes, it might make sense to allow your users to disable LTCGI if they want.

To do so, the UdonSharp API has a function _SetGlobalState(bool) that you can use to enable or disable LTCGI at will. This function is somewhat heavy and shouldn't be called per-frame, but cheap enough that you can use it directly on user input (e.g. UI toggles or Interact).

The LTCGI unitypackage contains an example script (also listed below) that shows how to use this. Note that because the function has a parameter, it can not be called from Udon-Graph at this time.

You can find a prefab using this toggle on an interactable cube in the _pi_/_LTCGI folder called LTCGI Global Toggle Example.prefab. This can also be used to start LTCGI in disabled state.

⚠️ Note that disabling GameObjects or components with a screen or emitter on them is not supported, neither in editor nor in-game!

Example Script

(this is written with VRChat Udon in mind, but can easily be translated to standalone)

using UdonSharp;

// NOTE: This script has to be in the "_LTCGI/Scripts" folder, *or* reference
// the "LTCGI_AssemblyUdon" to allow it to use the "LTCGI_UdonAdapter" type!

public class LTCGI_ExampleToggle : UdonSharpBehaviour
// set this to your controller object (specifically the adapter object):
public LTCGI_UdonAdapter Adapter;

// set this however you want:
public bool StartingState = true;
private bool state;

void Start()
state = StartingState;

// you can make this a UI event as well!
public override void Interact()
state = !state;

Put this script on an object with a collider (e.g. default sphere or cube) and click it in VRChat to toggle LTCGI.

Material Swapping

Another way of doing this is to simply material-swap all objects that have an LTCGI-enabled shader on them to a version that has LTCGI disabled. This will remove GPU overhead entirely, although the difference will be minor.

It is also possible to toggle LTCGI related keywords and shader properties at runtime, although this will require ensuring that all necessary variants are bundled with the world. This is only recommended for advanced users.