User Guide

System requirements

• Unity 2022.3 LTS or higher.
• Universal Render Pipeline (URP) or High Definition Render Pipeline (HDRP).
• Decal rendering enabled in your pipeline settings.

Compatibility

For stable results, ensure your Unity version, render pipeline, and decal settings are properly aligned before starting placement.

---

Installation

1. Import the Spray Manager package into your Unity project (2022.3+).
2. Make sure your project is using URP or HDRP with Decal enabled.
3. Open the main window from: Tools > Latin Tools > Spray Manager or press Ctrl+Alt+S.
4. The system will automatically create the required configuration files.

---

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 preference settings.

Atlas Manager Tab

• Create Atlas Groups: organize textures into themed collections.
• Assign Materials: automatic material creation or manual assignment.
• Preview Sprites: real-time preview of sprites in your atlases.
• Search and Filter: quickly find textures and groups.

Scene Sprays Tab

• Enable Spray Tools: activate placement tools in scene view.
• Tool Selection: choose between Place, Paint, and Line.
• Atlas Selection: choose active atlas group and sprite.
• Scene Management: review and manage sprays in the current scene.

---

Placement tools

Spray Manager provides three specialized tools for different workflows.

Place Tool (Hotkey: 1)

Perfect for precise single decal placement.

• Real-time preview with surface alignment.
• Visual gizmo showing orientation and placement area.

Controls:

• Click to place a 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 adjusts spray count.
• Ctrl + Mouse Wheel adjusts random offset.

---

Custom shaders

Spray Manager includes 5 specialized decal shaders:

Shader	Description	Best for
Standard	Clean, optimized decal with alpha support	Static decals, logos, dirt
UV Scroll	Animated movement through UV manipulation	Flowing textures, water, energy
Distortion	Refractive and heat-like distortion effects	Heat waves, magical effects
Flipbook	Frame-based animated decals	Fire, smoke, animated effects
Pulse	Rhythmic scaling or blending animation	Glows, breathing textures

All shaders support:

• Emission controls (color and intensity).
• Dissolve effects for edge fade-out.
• Normal mapping for surface detail.
• Edge fade for smooth surface transitions.

---

Spray component inspector

When selecting a spray in scene, a custom inspector appears with three organized tabs:

Spray Setup Tab

• Atlas Selection: choose from configured atlas groups.
• Sprite Selection: choose specific sprites with visual preview.
• Real-time Updates: changes are applied immediately in scene.

Advanced Settings Tab

• Material Configuration: switch between atlas 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-degree rotation, random rotation, and flip controls.
• Alignment Tools: align to surface, camera, or grid.
• Surface Anchoring: smart positioning for edges and centers.

---

Atlas management

Create your first Atlas Group

1. Go to the Atlas Manager tab.
2. Click Add New Group.
3. Give it a descriptive name (for example: Environment Decals).
4. Choose a background color for quick visual identification.
5. Add atlas textures with Add Atlas.

Best practices

• Organize by theme: dirt, graffiti, damage, signage, and so on.
• Consistent naming: improves search and long-term maintenance.
• Material assignment: use auto-creation or manual assignment based on your pipeline.
• Sprite preparation: ensure textures are correctly set up as atlases/sprites.

---

Scene management

The Scene Sprays section provides tools to manage all decals in your scene.

Bulk operations

• Select All: selects all sprays in the scene.
• Enable/Disable All: toggles global spray visibility.
• Search and Filter: filter by name or properties.

Individual controls

• Toggle Visibility: enable/disable specific sprays.
• Quick Selection: select and focus individual sprays quickly.
• Direct Deletion: remove unwanted sprays with confirmation.

---

Keyboard shortcuts

Global shortcuts

Shortcut	Action
Ctrl+Alt+S	Open Spray Manager window
Escape	Exit tools / Cancel operation

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

Sprays are not visible in scene

• Ensure Decal rendering is enabled in your render pipeline settings.
• Confirm the material is assigned correctly and uses a compatible shader.
• Verify the DecalProjector component is active.

Materials do not show in Atlas Manager

• Confirm textures are imported as sprite atlases.
• Check atlas groups are configured correctly.
• Ensure valid materials exist and use Latin Tools shaders.

Performance drops with many sprays

• Use texture atlases to reduce draw calls.
• Reduce unnecessary high-resolution decals.
• Group related sprays for easier management and optimization.

Shaders are missing

• Verify shader files were imported correctly.
• Check ShaderGraph package is installed/updated when applicable.
• Reimport shader assets if inconsistencies appear.

---

Support

For feedback, bug reports, or feature requests:

Support: soportelatintechnology@gmail.com

---

Version: 1.0.0
Last updated: April 11, 2026