Page cover

User Guide

Documentation for Spray Manager Pro

System Requirements

  • Unity 2022.3 LTS or higher

  • Universal Render Pipeline (URP) or High Definition Render Pipeline (HDRP)

  • Decal rendering enabled in pipeline settings


⚙️ Installation

  1. Import the Spray Manager package into your Unity project (2022.3+)

  2. Make sure your project is using URP or HDRP with the Decal feature enabled

  3. Open the main window via: Tools > Latin Tools > Spray Manager or press Ctrl+Alt+S

  4. The system will automatically create the necessary configuration files in your project


🪟 Spray Manager Window

Access the main interface through Tools > Latin Tools > Spray Manager. The window contains three main tabs:

📋 Info Tab

  • Welcome information and documentation links

  • Support contact information

  • Version details and update checking

  • Startup preferences configuration

🗂️ Atlas Manager Tab

  • Create Atlas Groups: Organize your textures into themed collections

  • Assign Materials: Automatic material creation or manual assignment

  • Preview Sprites: Real-time preview of all sprites in your atlases

  • Search and Filter: Quickly find specific textures or groups

🎨 Scene Sprays Tab

  • Enable Spray Tools: Activate scene placement tools

  • Tool Selection: Choose between Place, Paint, or Line tools

  • Atlas Selection: Pick your active atlas group and sprite

  • Scene Management: View and manage all sprays currently in the scene


🛠️ Placement Tools

Spray Manager provides three specialized tools for different placement workflows:

🎯 Place Tool (Hotkey: 1)

Perfect for precise single decal placement

  • Real-time preview with surface alignment

  • Visual gizmo showing placement area and orientation

  • Controls:

    • Click to place spray at cursor position

    • Shift + Mouse Wheel to adjust scale

    • Automatic surface normal detection

🖌️ Paint Tool (Hotkey: 2)

Ideal for painting multiple decals across surfaces

  • Circular brush with adjustable radius

  • Density control for spray distribution

  • Random rotation and scale variation

  • Controls:

    • Click and drag to paint multiple sprays

    • Shift + Mouse Wheel to adjust brush radius

    • Ctrl + Mouse Wheel to adjust random rotation

📏 Line Tool (Hotkey: 3)

Great for creating evenly distributed decal lines

  • Two-click line creation with preview

  • Configurable spray count and spacing

  • Random offset options for natural variation

  • Controls:

    • First click sets start point

    • Second click completes line and places sprays

    • Mouse Wheel to adjust spray count

    • Ctrl + Mouse Wheel to adjust random offset


✨ Custom Shaders

Spray Manager includes 5 specialized decal shaders for different visual effects:

Shader
Description
Best For

Standard

Clean, optimized decal with alpha support

Static decals, logos, dirt

UV Scroll

Animated movement via UV manipulation

Flowing textures, water, energy

Distortion

Refractive and heat-like distortion effects

Heat waves, magical effects

Flipbook

Frame-based animated decals

Animated effects, fire, smoke

Pulse

Rhythmic scaling or blending animation

Glowing effects, breathing textures

All shaders support:

  • Emission effects with color and intensity control

  • Dissolve effects for edge fade-out

  • Normal mapping for surface detail

  • Edge fade for smooth surface transitions


🧩 Spray Component Inspector

When you select a placed spray in the scene, a custom inspector appears with three organized tabs:

🔧 Spray Setup Tab

  • Atlas Selection: Choose from your configured atlas groups

  • Sprite Selection: Pick specific sprites with visual preview

  • Real-time Updates: See changes immediately in the scene

⚙️ Advanced Settings Tab

  • Material Configuration: Switch between atlas materials and custom materials

  • Shader Selection: Choose from the 5 available shader types

  • Effect Controls: Configure emission, dissolve, and normal mapping

  • Decal Settings: Adjust draw distance and projection parameters

🎚️ Editing Tools Tab

  • Size Controls: Quick scale adjustments and presets

  • Rotation Tools: 90° rotations, random rotation, flip controls

  • Alignment Tools: Align to surface, face camera, snap to grid

  • Surface Anchoring: Smart positioning tools for edges and centers


🗂️ Atlas Management

Creating Your First Atlas Group

  1. Go to the Atlas Manager tab

  2. Click "Add New Group"

  3. Give your group a descriptive name (e.g., "Environment Decals")

  4. Choose a background color for easy identification

  5. Add texture atlases by clicking "Add Atlas"

Best Practices

  • Organize by Theme: Group related textures together (dirt, graffiti, damage, etc.)

  • Consistent Naming: Use clear, descriptive names for easy searching

  • Material Assignment: Let the system auto-create materials or assign your custom ones

  • Sprite Preparation: Ensure your textures are properly set up as sprite atlases


📋 Scene Management

The Scene Sprays section provides powerful tools for managing all decals in your scene:

Bulk Operations

  • Select All: Select all spray components in the scene

  • Enable/Disable All: Toggle visibility for all sprays

  • Search and Filter: Find specific sprays by name or properties

Individual Spray Controls

  • Toggle Visibility: Enable/disable individual sprays

  • Quick Selection: Select and focus on specific sprays

  • Direct Deletion: Remove unwanted sprays with confirmation


⌨️ Keyboard Shortcuts

Global Shortcuts

Shortcut
Action

Ctrl+Alt+S

Open Spray Manager Window

Escape

Exit spray tools / Cancel operations

Tool Selection

Shortcut
Tool

1

Place Tool

2

Paint Tool

3

Line Tool

Tool Controls

Tool
Shortcut
Action

Place

Shift + Mouse Wheel

Adjust scale

Paint

Shift + Mouse Wheel

Adjust brush radius

Paint

Ctrl + Mouse Wheel

Adjust random rotation

Line

Mouse Wheel

Adjust spray count

Line

Ctrl + Mouse Wheel

Adjust random offset

Inspector Shortcuts

Shortcut
Action

Ctrl+D

Duplicate selected spray

Ctrl+R

Reset rotation

Arrow Keys

Adjust scale


❓ Troubleshooting

Common Issues

Sprays not appearing in scene

  • Ensure Decal rendering is enabled in your render pipeline settings

  • Check that the material is properly assigned and uses a compatible shader

  • Verify the DecalProjector component is active

Materials not showing in Atlas Manager

  • Confirm textures are imported as sprite atlases

  • Check that atlas groups are properly configured

  • Ensure materials exist and use the Latin Shaders

Performance issues with many sprays

  • Use texture atlases to reduce draw calls

  • Consider using fewer high-resolution decals

  • Group related sprays for better organization

Shaders not found

  • Verify all shader files are properly imported

  • Check that ShaderGraph package is installed and updated

  • Reimport shader assets if necessary


📞 Support

For feedback, bug reports, or feature requests:

📧 soportelatintechnology@gmail.com


Version: 1.0.0 Last Updated: October 2025

Last updated