Filter Target 🎯

Thankfully, in the latest update of SafeSpace - it is now super* easy to change the filter!

*while it is easier with the ui, it is still a bit confusing of a concept, heh

How SafeSpace Filters Work

SafeSpace is made of three parts - a read, a write, and a container. To edit this, it can be helpful to understand what render queues are and how Unity works: Unity essentially has an order of how to draw things - skybox, geometry (worlds), cut out objects, translucent objects, and then UI (super simplified). SafeSpace works by reading the render process at a certain step, capturing it, then rewriting it at a later step - all contained inside the container.

How To Change the Filter

In the tab, you want to put the particle game object called Read (to find it, essentially just fully expand the SafeSpace prefab in the hierarchy, it's under the Particles game object) into the Read Game Object field. You will now see Current Queue and New Queue fields. Simply enter your new queue and hit save, and it will generate a new shader and swap the material to that for you. You can always hit the Reset to Default button to revert to the original shader (or simply change the shader on the material to the original one, which is luka/safespace/ss_read).

What Do I Change It To?

The default is 2501 - which is just right after most avatars and worlds (at around 2450). You can up it if you want to, for instance, be more leniant and include things like some particles, transparent effects like glass/water, or other avatars that may be configured at a higher queue, I would suggest setting it to 3001 - right after the transparent queue. Here's a little table to help you decide~

Common Render Queues and What They Do

Here are the most common queues you'll use, their number, and what they're typically used for.

Queue Name	Number	Use Case for SafeSpace
Background	1000	Captures the sky box.
Geometry	2000	Captures the solid world.
AlphaTest	2450	(Default at 2451) Captures most avatars and world.
Transparent	3000	(Alternative at 3001) All of the above, but slightly more leniant in case you are filtering out too much.
Overlay	4000	Rarely used for the Read step, as it would capture a lot of things that are typically overlayed.