Getting Started with BerryToon

BerryToon is a versatile, feature-rich toon shader designed for Unity that offers extensive customization options for creating stylized characters, environments, and objects. This guide will help you understand BerryToon's capabilities and get you started with using it in your Unity projects.

Installation

1. Import the BerryToon package into your Unity project
2. The shader files will be located in the Assets/BerryToon folder

Basic Usage

Applying the Shader

1. Select a material in your project or create a new one
2. In the Inspector window, click the Shader dropdown menu and select BerryToon/BerryToon
3. The custom BerryToon GUI will appear, providing access to all shader features

Core Features

BerryToon offers a wide range of features to help you achieve your desired stylized look:

• Advanced Toon Shading: Create crisp, cell-shaded visuals with customizable light-to-shadow transitions
• Outlines: Add cartoon-style outlines with adjustable width, color, and texture support
• Rim Lighting: Create edge highlighting effects with customizable color, width, and masking
• Emission: Add glowing elements with scrolling textures and various blend modes
• Normal Map Support: Add surface detail while maintaining a stylized look
• Special Effects: Glitter, matcap, pattern overlays, and specular highlights
• Transparency Options: Multiple render modes including opaque, cutout, and transparent
• Color Adjustments: HSL (Hue, Saturation, Lightness) controls for fine-tuning colors

Interface Overview

The BerryToon GUI is organized into collapsible sections to make navigation easier:

• Base Settings: Main texture, color, overlay texture options
• Lighting Settings: Light falloff, ambient light, shadow parameters
• Rim Light Settings: Edge lighting effects and gradient options
• Rim Shade Settings: Create darker rim effects for added depth
• Emission Settings: Glowing elements with various blending options
• Outline Settings: Cartoon-style edge outlines
• Glitter Settings: Add sparkling effects
• Advanced Toon Settings: Fine-tune the toon shading effect
• HSL Adjustment: Color correction tools
• Normal Map Settings: Surface detail controls
• Matcap Settings: Spherical environment reflection
• Pattern Settings: Add repeating patterns with scrolling options
• Specular Settings: Add controllable highlights
• Transparency Settings: Control how transparency is handled

Getting Started with Common Effects

Basic Toon Shading

1. In the Base Settings section, set your main texture and base color
2. In the Lighting Settings, adjust:
   • Light Falloff Start/End to control shadow edge
   • Shadow Color to set the shadow tone
   • Ambient Multiplier to adjust overall brightness

Adding Outlines

1. In the Outline Settings section, enable "Use Outline"
2. Adjust the Outline Width and Color
3. For more control:
   • Add an Outline Mask texture to control outline visibility
   • Enable "Fixed Size" for consistent outline width
   • Use "Outline Width Mask" to vary width across the model

Creating Glowing Effects

1. In the Emission Settings section, enable "Use Emission"
2. Set Emission Color and add an Emission Map
3. Adjust Emission Blend Mode for different effects:
   • Normal: Standard additive glow
   • Add: Brightens the underlying color
   • Screen: Softer brightening effect
   • Multiply: Tints the base color
4. Enable "Emission UV Scroll" and set speeds for animated emission

Rim Lighting

1. In the Rim Light Settings section, enable "Use Rim Light"
2. Adjust:
   • Rim Light Power to control falloff
   • Rim Width to set how far the effect extends
   • Rim Color to set the glow color
3. For gradient rim lighting, enable "Use Rim Light Gradient" and set top/bottom colors

Render Modes

BerryToon supports different rendering modes that can be selected in the Transparency Settings section:

• Opaque: Standard rendering for solid objects (default)
• Cutout: Binary transparency using an alpha threshold
• Transparent: Support for semi-transparent materials

When using Cutout or Transparent mode, you'll need to configure:

• Alpha Mask texture to control transparency
• Alpha Cutoff value (for Cutout mode)

Advanced Techniques

HSL Adjustment

For color correction without changing textures:

1. Enable "Use HSL Adjustment" in the HSL Settings section
2. Adjust:
   • Hue Shift to change colors (-180 to 180 degrees)
   • Saturation to control color intensity
   • Lightness to brighten or darken

Overlay Textures

For adding extra detail or effects:

1. In the Base Settings, enable "Use Overlay Texture"
2. Set an Overlay Texture and color
3. Choose a blend mode:
   • Normal Blend: Standard blending
   • Screen Blend: Brightening effect
   • Multiply Blend: Darkening effect
   • Additive Blend: Adding colors