Outlines
The Outlines feature creates outlines using a simplified pass with the mesh offset by a small amount. This is also known as an "Inverted Hull" outline.
For smooth meshes, the inverted hull technique works well, but for hard-edged models, it can have noticeable seams. To correct this, you can bake a version of the mesh with smoothed normals baked into the vertex color, using the Poi Vertex Color Baker. This will overwrite other vertex color data, and will create a unique version of the mesh.
All Outlines features have been reintroduced to the main shader, .poiyomi/Poiyomi Toon
as of version 9.0 and newer. There is no need to select a separate version in order to use Outlines.
Example of the inverted hull Outline technique on two Material Spheres.
Mode
Type
: Dropdown, Options:Basic
/Rim Light
/Directional
/Drop Shadow
- Default:
Basic
- Default:
Changes the mode of the outline.
Basic
Default mode. The width of the outline is constant around the model.
Rim Light
Rim Light actually uses the direction of the light to determine the width of the outline. Outlines will be thicker in the direction of the light. The color of the outline will be tinted with a value between the direct light color and the base color, according to the Rim Light Blend.
Rim Light Blend
Type
: Float, Range:0.0 - 1.0
How much to blend between the base color and the direct light color as the tint of the outline. At 0, the outline will be tinted with the base color. At 1, the outline will be tinted with the direct light color.
Only available when mode is set to Rim Light
.
Directional
Directional is similar to Rim Light in that it biases the outline to a specific direction, but the Directional Offset directly specifies what direction to use.
Directional Offset X Y
Type
: Vector4 (OnlyX
/Y
used)
Direction to use for the outline. Calculated from only the X (horizontal) and Y (vertical) values.
Drop Shadow
Drop Shadow is similar to Directional in that it biases the outline to a specific direction, but drop shadow moves the outline in X, Y, and Z, instead of specifying a direction to bias the thickness.
In Drop Shadow mode, the Width is not used.
Drop Direction X Y
Type
: Vector4 (OnlyX
/Y
/Z
used)
How much to offset the outline in the X, Y, and Z directions, in unity base units.
Space
Type
: Dropdown, Options:Local
/World
- Default:
Local
- Default:
Determines where the size of the Outlines should assume the initial scale units from. Influences the Outline Size.
Local
renders the Size based on the Scale Units of your Avatar.World
renders the Size based on World Units.
If you choose the Space to be World
, the Outline Size will remain the same regardless of your Avatar Scale. Keep this in mind when choosing this option.
Outline Size
Type
: Float
Thickness of the Outline, in Unity base units (scaled down by 100).
Outline Size Mask
Type
: Data Texture (sRGB: OFF
)
Mask Texture in Grayscale that determines the thickness of the Outline in various places on the model. Areas in darker Grayscale will reduce the thickness based on the initial Outline Size value set.
Examples:
- If your Outline Size is
0.5
and a section of your Texture is 50% Gray, it will reduce the thickness in that area to about0.25
thickness, which is half of your Outline Size. - If a section of your Texture is Black, it will reduce the thickness all the way down to
0
thickness.- If Clip 0 Width is enabled in this scenario, the Outline will be clipped entirely.
This determines the Outline Width per-vertex, not per-pixel.
Outline Texture
Type
: Data Texture (sRGB: ON
)
Texture to use for the Outline. Will be tinted based on the Color Adjust settings.
Color
Type
: Color
Base Color of the Outline. Can be mixed in various ways depending on the Mode settings.
Outline Emission
Type
: Float, Range:0.0 - 20.0
How much Emission the Outline should have. Creates a glowing effect, especially in Worlds with Post Processing Bloom.
MainTex Blend
Type
: Float, Range:0.0 - 1.0
How much the Outline Color should be blended with your Texture.
UTS2 style Blend
Type
: Checkbox
Determines if you want the Outlines to blend in a way that is similar to Unity-Chan Toon Shader 2 (UTS2).
Color Adjust
Type
: Checkbox
Enables the ability to modify the Outline Color in a similar fashion to Color Adjust. This is applied directly after the main Outline Color, and will not affect other sections that modify the base Outline Color.
This means each of these Color Adjust properties cannot be animated independently of each other! You must choose only one to animate at a time.
Hue
H
, Range:0.0 - 1.0
How much to shift the Outline Color around the Hue Circle.
Saturation
S
, Range:-1.0 - 1.0
Adjusts the saturation of the Outline Color.
- A value of
0
will make the Oultine Color fully de-saturate (Grayscale). - A value of
1
will not alter the color at all. - A value greater than
1
will increase the Saturation of the outline Color.
Value
V
, Range:-1.0 - 1.0
Adjusts the influence of the HSV Color Model.
Gamma
G
, Range:-1.0 - 1.0
Adjusts the Brightness of the Color.
Shift Speed
Type
: Float
How much to constantly shift the hue with time.
For reference, a value of 1
will result in a full Hue Shift cycle every 20 seconds.
Distance Alpha
Type
: Checkbox
When enabled, Distance Alpha can modify the Alpha value of the Outlines based on the distance from the Camera to the Object or Pixel.
Distance Alpha requires Transparency in order for it to work.
Pos To Use
Type
: Dropdown, Options:Object Position
/Pixel Position
Which position to use to calculate distance.
Object Position
will calculate distance relative to the origin of the Outline, resulting in the whole Outline having a uniform alpha change. This is useful for making an entire Outline change alpha based on the distance from the Outline itself.Pixel Position
will calculate distance relative to the position of each pixel on the Outline. This means different parts of an Outline can have different levels of alpha. This is useful for making parts of an Outline appear or disappear based on distance without the whole Outline being affected.
Min Distance Alpha
Type
: Float, Range:0.0 - 1.0
The alpha multiplier that will be applied at the Min Distance.
Max Distance Alpha
Type
: Float, Range:0.0 - 1.0
The alpha multiplier that will be applied at the Max Distance.
Min Distance
Type
: Float
The distance (in meters) at which the Min Distance Alpha multiplier will be applied.
Max Distance
Type
: Float
The distance (in meters) at which the Max Distance Alpha multiplier will be applied.
Fixed Size Over Distance
Type
: Checkbox- Default:
true
- Default:
Enables a fixed screen-space size for outlines. This can allow control of the outlines to not get smaller when moving away from the model.
Fixed Width
Type
: Float, Range:0.0 - 1.0
- Default:
0.5
- Default:
The width of the fixed outline size.
Fixed Size Max Distance
Type
: Float- Default:
1
- Default:
How far away from the model to use the fixed size outlines in Unity Base Units. Beyond this distance, the outlines will properly scale accordingly.
Keep your Max Distance value at a small number in order to ensure they scale correctly without blocking your Avatar's visibility when viewed at a far distance!
Lighting
Type
: Checkbox- Default:
true
- Default:
Enables lighting for the Outline. This darkens the outline color in shadowed areas.
Shadow Strength
Type
: Float, Range:0.0 - 1.0
Shadow intensity of the Outlines.
Vertex Colors
Vertex Color Normals
Type
: Checkbox
Use the vertex colors of the model, if they've been specially prepared. The (smoothed) vertex colors are used as the normal data.
Vertex Color Mask
Type
: Dropdown, Options:Off
/R
/G
/B
/A
Choose which Color channel to use in your Mask for the Vertex Colors.
Rendering Options
Clip 0 Width
Type
: Checkbox
Enables clipping of the outline if a vertex has 0
outline thickness.
If using an Outline Size Mask, all areas that are marked in Black
will be clipped when this option is enabled. This can be useful for certain areas of your Avatar that have inverted normals, such as the Eyes.
Override Base Alpha
Type
: Checkbox
Sets the base fragment Alpha to the Outline's Alpha value.
Cam Z Offset
Type
: Float- Default:
0
- Default:
How much to offset the Camera Z Position when Rendering the Outlines. This is useful for giving control over the clipping of the Outlines.
Cull
Type
: Dropdown, Options:Off
/Front
/Back
- Default:
Front
- Default:
Which faces to cull. For the inverted hull technique, this should be set to Front
.
ZWrite
Type
: Dropdown, Options:Off
/On
- Default:
On
- Default:
Determines whether the Outlines should write to the depth buffer. This should typically be ON by default.
ZTest
Type
: Dropdown, Options:Disabled
/Never
/Less
/Equal
/LessEqual
/Greater
/NotEqual
/GreaterEqual
/Always
- Default:
LessEqual
- Default:
Sets how the Outline Stencil should test the depth buffer. By default, the depth buffer is tested, and if the depth value is not less than or equal to the current value, the Outline is discarded.
AudioLink
The settings in this section will only be visible when AudioLink is activated on the Material.
Size Band
Type
: Dropdown, Options:Bass
/Low Mid
/High Mid
/Treble
/Volume
Which Band to use for the Outline Size adjustment.
Size Mod
Type
: Vector2
How much to add to or subtract from the Outline Size with Audio.
Modifier | Function |
---|---|
Min | Amount changed to Outline Size with No Audio in Size Band |
Max | Amount changed to Outline Size with Max Audio in Size Band |
Emission Band
Type
: Dropdown, Options:Bass
/Low Mid
/High Mid
/Treble
/Volume
Which Band to use for Outline Emission adjustment.
Emission Mod
Type
: Vector2
How much to add to or subtract from the Outline Emission Intensity with Audio.
Modifier | Function |
---|---|
Min | Amount changed to Outline Emission with No Audio in Emission Band |
Max | Amount changed to Outline Emission with Max Audio in Emission Band |
Color
Type
: Checkbox
Enables the ability to change the Outline Color with Audio.
Color Options
Band
Type
: Dropdown, Options:Bass
/Low Mid
/High Mid
/Treble
/Volume
Which Band to use to change the Outline Color with Audio.
Replace
Type
: Vector2
How much to replace the Outline Color with Audio.
Modifier | Function |
---|---|
Min | Amount of Outline Color replaced with No Audio in Color Band |
Max | Amount of Outline Color replaced with Max Audio in Color Band |
Color
Type
: Color
Which color to replace the current Outline Color with Audio.