The LED asset is a flexible and powerful Unity tool designed to create realistic LED displays using a grid of cubes. This tool allows users to display images, apply animated scrolling effects, and experiment with a range of color modes, including from-image, static color, gradient, and random color. Each cube acts as an individual LED, providing detailed control over brightness, color transitions, fade effects, and animation speed.

Key Features

• Dynamic Image Display: Easily display any image across the LED grid.
• Multiple Color Modes: Choose between from-image (sample colors directly from the image), static color (color range between two custom colors), random color (blend random colors with image colors), and gradient (blend colors based on cube position).
• Adjustable Brightness and Fade Effects: Global brightness control and optional fade effects with customizable fade duration.
• Animation Options: Set scrolling animations to cycle images across the grid in any direction, with adjustable speed and seamless looping.
• Customizable Grid Layout: Configure the grid dimensions (width and height), LED spacing, and assign any prefab as the LED cube.
• Custom Editor: The custom editor tool allows for real-time configuration and preview, displaying only relevant fields based on user settings. Easily tweak settings, adjust color modes, change grid sizes, and see updates instantly.

Example Use Cases

1. Digital Display Boards: Perfect for creating eye-catching digital displays that scroll images or text across the grid.
2. Lighting Effects for Virtual Spaces: Use in virtual events or concerts to simulate LED light panels with customized patterns.
3. Visual Effects for Games: Apply the grid as background lighting effects or animated billboards for game levels.
4. Educational and Presentation Tools: Create dynamic presentations or demonstrations of LED-based concepts for tutorials, trade shows, or interactive displays.

Usage Examples

Scrolling an Image with a Gradient Overlay

To display a scrolling image with a gradient blend:

1. Set LED Mode to Animated.
2. Choose Color Mode as Gradient.
3. Define Gradient Colors as desired for blending.
4. Set Animation Direction to Right and Animation Speed to 1.0 for a smooth scrolling effect.

Static Color Mapping with Custom Intensity

To create a static color map based on image intensity:

1. Set LED Mode to Static.
2. Select Color Mode as Static Color.
3. Set White Color and Black Color to define the color range for image intensity.
4. Adjust Global Brightness to fine-tune overall display intensity.

Setup Guide

1. Create an LED Board: Attach the LEDController script to an empty GameObject.
2. Assign LED Prefab: Create or select a cube prefab and assign it to the LED Cube Prefab field.
3. Apply Image Texture: Create a material with your desired texture, set Wrap Mode to Repeat, and assign it to Cube Material.
4. Adjust Settings: Use the custom editor to configure grid dimensions, color modes, animation settings, and brightness.

Tips for Best Results

• Ensure your texture’s aspect ratio matches the grid’s Width and Height for clear, proportional displays.
• Set the texture’s Wrap Mode to Repeat to enable seamless scrolling.
• Experiment with Animation Speed and Direction to create unique visual effects.

Troubleshooting

• Image Not Scrolling: Ensure LED Mode is set to Animated and that Animation Speed is above zero.
• Inconsistent Colors: Verify Color Mode and related settings. If using Static Color, make sure White Color and Black Color are configured correctly.
• Performance Issues: Reduce LED Width and LED Height if performance is impacted.

With the LED asset, you can create stunning, customizable LED-style displays that bring any virtual environment to life with dynamic visual effects.

documentation is ran through grok to improve english and readability and is then checked by our developers and fine tuned