When you pull up your home photo in the xLights layout panel, you are ready to start drawing your display. Across the top toolbar, you will notice an array of default geometric icons: a single line for roof outlines, an arc for lawn rings, a grid box for a matrix, and a classic ring for wreaths.
These are Native xLights Shapes. They are mathematical vectors built into the software engine that let you generate a custom layout on the fly.
But as you start adding complex high-density props—like a GEUSA custom snowflake or a spinning star—you have to switch gears and use the Vendor Download tool. If you try to force a manufacturer's specialized prop into a basic native shape tool, your channels will misalign, and your effects will look completely scrambled on the lawn. Let’s break down when to use standard shapes versus when to deploy native vendor models to ensure a flawless setup.
When to Use Native xLights Shapes (The Vectors)
Native shapes are designed for elements where you dictate the physical dimensions, spacing, and wire paths on your house. The software automatically calculates the data channel layout based on the numbers you type into the properties bar.
1. Lines (Roof Contours & Icicles)
When outlining your gutters or dropping vertical icicle strings, you use the standard Line Tool. You tell the software, "This line has 300 pixels, and it drops into 5-4-3 node icicle drops." xLights handles the underlying math natively, mapping the patterns perfectly along your roof's custom coordinates.
2. Matrices & Window Frames (The Grids)
For custom garage door screens or rectangular window outlines made out of plastic tracks, you use the native Matrix or Poly Line tools. You enter your exact row and column count, and the software effortlessly creates a digital canvas for scrolling text and video clips.
3. Basic Arches
If you are building standard jumping arches over your driveway using flexible PEX tubing or standard pixel tracks, the native Arc Tool is all you need. You specify how many nodes sit in the arc, and it calculates the left-to-right chasing math automatically.
When You MUST Use Vendor Model Downloads (The Blueprints)
The moment you move away from simple lines, grids, and plain circles and introduce a pre-cut coroplast shape from Gilbert Engineering, standard mathematical shapes will completely fail you.
For instance, if you purchase a GEUSA high-density snowflake or spinner wreath, it isn't a basic circle. It features intricate, staggered pixel groupings, sub-models, and overlapping nodes designed to maximize visual depth.
-
The Trap: If you try to map a 300-pixel GEUSA Spinner by using the native xLights "Circle" tool and typing in 300 nodes, the software will assume the lights sit in one massive, single-line circle. When you turn on the show, an effect designed to spin outward from the center will instead chase chaotically around the edges of your prop.
-
The Solution: For any manufactured prop, you must bypass the standard layout icons. Click the Create New Download icon (the small blue arrow pointing down), drag a box on your screen, select Gilbert Engineering, and pick your exact prop name.
The Layout Rule of Thumb
To keep your configuration fast, organized, and bug-free, use this simple blueprint strategy:
┌───> USE NATIVE SHAPE TOOLS (Line, Matrix, Arc)
│ • Roof outlines, gutter icicles, window tracks, garage screens
[ YOUR HOUSE MAP ]│
└───> USE VENDOR MODEL DOWNLOADS (Gilbert Engineering Dropdown)
• Snowflakes, Singing Faces, Spinner Wreaths, Special High-Density Grids
By using Native Shapes for your home’s architectural frame and pairing them with GEUSA Vendor Downloads for your high-density yard features, you protect your display from configuration bugs.
Your layout maps itself perfectly on the first try, ensuring complete compatibility with elite sequence clubs like xTreme Sequences and keeping your show running flawlessly all season long.