How Do I Prepare an ILDA Animation for an SD-Card Laser?
To prepare an ILDA animation for SD-card playback, check your projector's supported format and point limit, then open the animation in BeamTracer's ILDA Viewer. EXPORT ILDA → SD Card selects indexed Format 0 with a 750-point limit, and the default Optimize & Truncate simplifies each path to fit. Reopen the downloaded .ild before copying it to your card.
A point limit can change the drawing when you export a laser file. This example follows one original animation through conversion, then reloads the finished file so you can see exactly what the export kept.
The converted animation in Cinema, shown as a software simulation. Camera motion and fog do not certify a projector or physical installation.
What should I check before choosing the SD Card preset?
Read the documentation for your exact projector or SD-card player. Confirm the ILDA formats it accepts, its point limit, and any instructions for card formatting, folders, filenames or a playback list. Use those requirements when preparing the file; the name SD Card is not a guarantee that every device accepts the same settings.
The built-in preset selects Format 0 (3D Indexed Color) and MAX POINTS PER FRAME → 750. If your device specifies something else, change the export settings accordingly. A filename ending in .ild alone does not tell you which format is inside.
The ILDA export guide explains the preset and format choices. For the difference between indexed and true-color files, see which ILDA format to export.
Software preparation only
This workflow was checked in BeamTracer with an original test animation. It does not establish playback on a particular projector, card or player. Follow the device's own instructions for the final transfer and playback test.
How do I convert an existing ILDA animation?
Open the original in ILDA Viewer, inspect FILE INFO and FILE HEALTH, then open EXPORT ILDA. Choose SD Card, leave Optimize & Truncate selected, and convert. Keep the original file so you can compare against it after downloading a converted version.
The original Orbit Weave has 36 frames and three colored curves. It uses true-color Format 5 and 1,095 points per frame.
- Open ILDA Viewer and load your original
.ildfile. - Check FILE INFO, play the animation, and read FILE HEALTH.
- Click EXPORT ILDA and choose SD Card under QUICK PRESETS.
- Check OUTPUT FORMAT and MAX POINTS PER FRAME against your device's requirements.
- Leave Optimize & Truncate selected under IF OVER LIMIT.
- Click Convert & Download, read the Warnings, then choose Download to save the converted
.ild.
The default Optimize & Truncate result: 36 frames converted to Format 0, with one Simplified line per frame in the warnings.
Can a point limit remove part of my drawing?
It can, but the default tries the gentler fix first. Optimize & Truncate removes points that already lie along a path, keeping corners and colors. In this sample, that alone fit every frame: all 36 frames keep all three curves at 606 to 625 points per frame. The warnings list one "Simplified 1095 → … points along the path" line per frame and report no removed shapes.
| Property | Original | Optimize & Truncate (default) | Shape-Aware Only |
|---|---|---|---|
| ILDA format | Format 5, true color | Format 0, indexed color | Format 0, indexed color |
| Animation frames | 36 | 36 | 36 |
| Points per frame | 1,095 | 606–625 | 734 |
| Curves retained | 3 | 3 | 2 |
The simplified curves stay within 0.03 percent of the projection width of the original paths, so their shapes do not change in the 2D view. Format 0 does change color: each color moves to the nearest entry in the indexed palette, so the orange curve plays back red.
If simplifying is not enough, Optimize & Truncate then removes whole shapes until the frame fits, and its warning ends with "(removed shapes)". Play the converted file and compare it with the original before accepting that result.
When should I choose Shape-Aware Only?
Choose Shape-Aware Only when you would rather keep the remaining shapes point for point than simplify them. It skips simplification and removes whole shapes until each frame fits. On this sample, it kept two of the three curves at 734 points per frame and dropped the purple curve from every frame; each warning reads "Kept 2 of 3 shapes".
Keep the original
If the converted animation loses an important shape, return to the source and simplify it deliberately. Do not accept missing artwork just because the output is under a point limit.
How do I check the exact file I am about to copy?
Load the downloaded .ild into ILDA Viewer as a new file. Check its reported format and frame count, play through the animation, and inspect the visible drawing. The reloaded sample below is the actual converted download: FILE HEALTH reports Format 0, 36 frames and 22,102 total points, and all three curves remain.
FILE HEALTH reports file and point-count information; it does not measure your physical scanners. The same applies to the 3D → Cinema view shown at the top of this article. Use the 2D picture for checking the retained paths and Cinema for a different view of the simulated beams.
Once you are satisfied with the file, copy that inspected download using your device's required card layout and naming instructions. Keep the original and the converted copy separately so a later edit does not replace your reference. Physical projection requires its own laser safety preparation. Need ready-made files for the card? How do I put laser show files on a projector's SD card? downloads library files as one SD-card ZIP, and Laser Show Files shows the ILDA files a plan with Laser includes.
Inspect and prepare your ILDA animation before transferring it.
Try ILDA Viewer