Guía de Usuario

Requisitos del sistema

• Unity 2022.3 LTS o superior.
• Universal Render Pipeline (URP) o High Definition Render Pipeline (HDRP).
• Renderizado de Decals habilitado en la configuración del pipeline.

Compatibilidad

Para obtener resultados estables, confirma que tu proyecto, render pipeline y configuración de decals estén alineados antes de comenzar a colocar sprays.

---

Instalación

1. Importa el paquete Spray Manager en tu proyecto de Unity (2022.3+).
2. Verifica que tu proyecto esté en URP o HDRP y con Decal habilitado.
3. Abre la ventana principal desde: Tools > Latin Tools > Spray Manager o usando Ctrl+Alt+S.
4. El sistema creará automáticamente los archivos de configuración necesarios.

---

Ventana Spray Manager

Accede a la interfaz principal desde Tools > Latin Tools > Spray Manager.

La ventana contiene tres pestañas principales:

Info Tab

• Información de bienvenida y enlaces de documentación.
• Datos de contacto para soporte.
• Detalles de versión y comprobación de actualizaciones.
• Configuración de preferencias al iniciar.

Atlas Manager Tab

• Create Atlas Groups: organiza texturas en colecciones temáticas.
• Assign Materials: creación automática de materiales o asignación manual.
• Preview Sprites: vista previa en tiempo real de sprites en tus atlas.
• Search and Filter: búsqueda rápida por nombre o grupo.

Scene Sprays Tab

• Enable Spray Tools: activa herramientas de colocación en escena.
• Tool Selection: elige entre Place, Paint o Line.
• Atlas Selection: selecciona atlas group y sprite activo.
• Scene Management: revisa y gestiona sprays colocados en la escena.

---

Herramientas de colocación

Spray Manager ofrece tres herramientas especializadas según tu flujo de trabajo.

Place Tool (Atajo: 1)

Ideal para colocación precisa de decals individuales.

• Vista previa en tiempo real con alineación a superficie.
• Gizmo visual con orientación y área de colocación.

Controles:

• Click para colocar el spray en la posición del cursor.
• Shift + Mouse Wheel para ajustar escala.
• Detección automática de normales de superficie.

Paint Tool (Atajo: 2)

Ideal para pintar múltiples decals sobre superficies.

• Brocha circular con radio ajustable.
• Control de densidad para distribución de sprays.
• Variación aleatoria de rotación y escala.

Controles:

• Click + arrastrar para pintar múltiples sprays.
• Shift + Mouse Wheel para ajustar radio de brocha.
• Ctrl + Mouse Wheel para ajustar rotación aleatoria.

Line Tool (Atajo: 3)

Perfecto para crear líneas de decals con distribución uniforme.

• Creación por dos clicks con previsualización.
• Control de cantidad de sprays y espaciado.
• Offset aleatorio para variaciones más naturales.

Controles:

• Primer click: define punto inicial.
• Segundo click: completa la línea y coloca los sprays.
• Mouse Wheel: ajusta cantidad de sprays.
• Ctrl + Mouse Wheel: ajusta offset aleatorio.

---

Shaders personalizados

Spray Manager incluye 5 shaders especializados para decals:

Shader	Descripción	Ideal para
Standard	Decal limpio y optimizado con soporte alpha	Decals estáticos, logos, suciedad
UV Scroll	Movimiento animado mediante manipulación UV	Flujos, agua, energía
Distortion	Efectos refractivos y de distorsión térmica	Olas de calor, efectos mágicos
Flipbook	Decals animados por frames	Fuego, humo, efectos animados
Pulse	Animación rítmica de escala o blending	Brillos, texturas pulsantes

Todos los shaders soportan:

• Emission con control de color e intensidad.
• Dissolve para desvanecimiento en bordes.
• Normal mapping para detalle de superficie.
• Edge fade para transición suave en superficies.

---

Inspector del componente Spray

Al seleccionar un spray en escena, aparece un inspector personalizado con tres pestañas:

Spray Setup Tab

• Atlas Selection: selección de atlas groups configurados.
• Sprite Selection: selección de sprite con preview visual.
• Real-time Updates: cambios aplicados inmediatamente en escena.

Advanced Settings Tab

• Material Configuration: cambia entre materiales de atlas y materiales custom.
• Shader Selection: elige entre los 5 tipos de shader disponibles.
• Effect Controls: ajusta emission, dissolve y normal mapping.
• Decal Settings: controla distancia de dibujo y parámetros de proyección.

Editing Tools Tab

• Size Controls: ajustes rápidos de escala y presets.
• Rotation Tools: rotación 90°, aleatoria y flip.
• Alignment Tools: alinear a superficie, cámara o grid.
• Surface Anchoring: posicionamiento inteligente en bordes y centros.

---

Gestión de Atlas

Crear tu primer Atlas Group

1. Ve a la pestaña Atlas Manager.
2. Haz click en Add New Group.
3. Asigna un nombre descriptivo (ejemplo: Environment Decals).
4. Elige un color de fondo para identificación rápida.
5. Agrega atlas con Add Atlas.

Buenas prácticas

• Organiza por temática: suciedad, grafitis, daño, señalética, etc.
• Nombres consistentes: facilita búsqueda y mantenimiento.
• Material assignment: usa auto-creación o asignación manual según tu pipeline.
• Preparación de sprites: confirma que las texturas estén configuradas correctamente como atlas/sprites.

---

Gestión de escena

La sección Scene Sprays incluye herramientas para administrar todos los decals de la escena.

Operaciones masivas

• Select All: selecciona todos los sprays de la escena.
• Enable/Disable All: activa o desactiva visibilidad global.
• Search and Filter: filtra sprays por nombre o propiedades.

Control individual

• Toggle Visibility: activa/desactiva sprays individuales.
• Quick Selection: selecciona y enfoca sprays concretos.
• Direct Deletion: elimina sprays no deseados con confirmación.

---

Atajos de teclado

Atajos globales

Atajo	Acción
Ctrl+Alt+S	Abrir ventana Spray Manager
Escape	Salir de herramientas / Cancelar operación

Selección de herramientas

Atajo	Herramienta
1	Place Tool
2	Paint Tool
3	Line Tool

Controles por herramienta

Herramienta	Atajo	Acción
Place	Shift + Mouse Wheel	Ajustar escala
Paint	Shift + Mouse Wheel	Ajustar radio de brocha
Paint	Ctrl + Mouse Wheel	Ajustar rotación aleatoria
Line	Mouse Wheel	Ajustar cantidad de sprays
Line	Ctrl + Mouse Wheel	Ajustar offset aleatorio

Atajos del inspector

Atajo	Acción
Ctrl+D	Duplicar spray seleccionado
Ctrl+R	Reset de rotación
Arrow Keys	Ajustar escala

---

Troubleshooting

Los sprays no aparecen en escena

• Verifica que Decal rendering esté habilitado en tu render pipeline.
• Confirma que el material esté correctamente asignado y use un shader compatible.
• Revisa que el componente DecalProjector esté activo.

Los materiales no aparecen en Atlas Manager

• Comprueba que las texturas estén importadas como sprite atlas.
• Revisa que los atlas groups estén configurados correctamente.
• Asegúrate de que existan materiales válidos con shaders de Latin Tools.

Problemas de rendimiento con muchos sprays

• Usa texture atlases para reducir draw calls.
• Reduce decals de alta resolución cuando no sean necesarios.
• Organiza sprays por grupos para facilitar administración y optimización.

No se encuentran los shaders

• Verifica que los archivos de shader se hayan importado correctamente.
• Revisa que el paquete ShaderGraph esté instalado/actualizado si aplica.
• Reimporta los assets de shader en caso de inconsistencias.

---

Soporte

Para feedback, reportes de bugs o solicitudes de features:

Soporte: soportelatintechnology@gmail.com

---

Versión: 1.0.0
Última actualización: Octubre 2025