Library: Fixtures & Surfaces

The Library is both your landing workspace and your collection of reusable parts. At the top, it gives you Project Settings and Recent Projects. Below that, it has two reusable-library sections: Fixtures (what kind of LED pixel you're using) and Surfaces (saved Resolume output configurations).

Projects

Before you even start drawing, the Library page helps you manage projects:

• Project Settings lets you rename the active project and change its canvas width and height
• Recent Projects lets you open, duplicate, or delete saved projects
• New Project opens the project-creation dialog right from the landing page

[GRAPHIC: Screenshot of the Library landing state with Project Settings and Recent Projects above the Surface/Fixture browser. Shows that Library doubles as the main project hub]

Fixtures

A fixture in Filament describes a single LED pixel or pixel cluster — the fundamental unit that maps to DMX channels. Before placing any LEDs on your canvas, you need at least one fixture definition in your library.

[GRAPHIC: Screenshot of the fixture library showing several WS2812 presets alongside a custom matrix fixture, with the detail view showing dimensions and color format. Conveys that setup is quick with presets]

What a fixture definition contains

• Name — a human-readable label ("WS2812B Single LED", "16×16 Matrix Panel")
• Width × Height — the pixel grid dimensions. A single LED strip pixel is 1×1. A matrix panel might be 16×16 or 8×32
• Color format — the order in which DMX channels map to red, green, and blue

Color format matters — especially for WS2812

WS2812-based LEDs (the most common addressable LED type, used in most LED strips) are GRB, not RGB. If your colors look wrong on your actual hardware (red shows as green, etc.), the color format is the first thing to check.

Supported formats: RGB, GRB, BGR, RBG, GBR, BRG

• WS2812B, SK6812 → use GRB
• Most APA102, SK9822 → use RGB
• APA107, some generic strips → check your datasheet

Gamma correction

The gamma slider (1.0–3.0) applies a power curve to the color output. LEDs are physically linear devices, but humans perceive brightness logarithmically, so gamma lets you tune how mid-range brightness feels on the real fixture.

If you do not have a strong reason to change it, leave gamma near the default and adjust only when the fixture looks visibly off.

Getting fixtures into your library

Option 1: Load built-in presets (easiest)

Click Load Presets in the fixture library header. This imports a set of ready-to-use WS2812 presets plus a generic matrix preset — enough to get started immediately.

Option 2: Import from your Resolume installation

Click Import from Resolume. Filament finds your Resolume fixture library directory (configured in Settings) and imports all fixture definitions from it. If you've been using Resolume with your LEDs already, this brings your existing setup in.

Option 3: Create a custom fixture

Click + New Fixture and fill in the form. You'll need:

• Name
• Width and height in pixels
• Color format
• Gamma

The total channel count is shown live as you type, based on the fixture's pixel dimensions.

Editing and exporting fixtures

Select any fixture in the list to see its specs. With a fixture selected:

• Edit — modify name, dimensions, color format, or gamma
• Export — write this fixture definition directly to your Resolume fixture library directory so it's available in Resolume
• Delete — remove from library (with confirmation)

[GRAPHIC: Screenshot of the fixture edit dialog with the color format dropdown open, highlighting the GRB option. Helps users find the answer to the "why are my colors wrong?" question]

Detail view vs. compact view

The fixture library supports two view modes:

• Detail view — shows a thumbnail preview, name, and specs (good for browsing)
• Compact view — name-only list (good when you have many fixtures and know what you're looking for)

Toggle between them with the view button in the library header.

---

Surfaces

A Surface is a complete DMX output configuration — essentially a saved snapshot of one controller's worth of slices (LED positions, channel assignments, fixture mappings) as originally defined in Resolume's Advanced Output.

The Surface library lets you import existing Resolume setups, reuse them across projects, and build up a collection of saved configurations.

[GRAPHIC: Screenshot of the Surface library in detail view, showing thumbnail previews of each Surface with colored slice polygons. Conveys that you can visually identify configurations at a glance]

Importing Surfaces from a Resolume XML

If you've already set up Advanced Output in Resolume, you can import that configuration directly into Filament. This is the fastest way to bring an existing rig into Filament.

Click Import XML in the Surface library header, then follow the import wizard:

Step 1: Choose file Select your Resolume Advanced Output XML file. These are typically saved from Resolume's Advanced Output panel (File → Save As).

Step 2: Preview The wizard parses the file and shows you every Surface it found, along with:

• Slice count
• DMX channel range
• Fixture usage (which fixtures each Surface uses, and whether those fixtures are in your library)

If a Surface uses fixtures you do not already have in your library, the preview marks them clearly. Filament embeds those fixture definitions from the XML import and brings them into your library as part of the import flow, so you do not need to stop and do separate manual cleanup first.

Use Select All / Select None to batch-select, or pick individual Surfaces to import. When you're ready, click Import.

Step 3: Done Imported Surfaces appear in your library and can be added to any project.

[GRAPHIC: Screenshot of the import wizard step 2 (preview), showing the Surface list with slice counts, channel ranges, and fixture badges. Shows how much information you get before committing]

Adding a Surface to your project

From the library, each Surface card has an Add button that adds it to the currently open project. You can also drag a Surface card directly into the project sidebar — look for the drop zone that appears at the top of the sidebar when you're dragging.

Browsing and managing Surfaces

Use the search box to filter Surfaces by name. The current Library UI also gives you:

• Detail view and compact view toggles
• Refresh to reload saved Surfaces from storage
• Inline rename and delete actions on saved library entries
• Add buttons and drag-and-drop into the project sidebar

Saving project Surfaces back to the library

If you've been working on a Surface in a project and want to save it to the library for reuse, right-click the Surface name in the project sidebar and choose Save to Library. This stores the current state as a reusable library entry.

Thumbnails

Each Surface generates a thumbnail from its slice geometry, using a color scheme that shows the arrangement of output rectangles. These thumbnails are cached and load quickly when you're browsing.

---

Library navigation tips

• Use Library as your home base when creating, reopening, or resizing projects
• Drag from library to sidebar to add Surfaces to your project without leaving the library view
• Switch between detail and compact views depending on whether you want thumbnails or density
• Rename inline and refresh often when you are iterating on saved Surface variants