List all patterns stored on the PixelBlaze device.

Returns a list of dicts with 'id' and 'name' keys.

Get the currently active (running) pattern on the PixelBlaze.

Returns a dict with 'id' and 'name' of the active pattern.

Switch the PixelBlaze to run a specific pattern by its ID.

Args: pattern_id: The pattern ID to activate (from pixelblaze_list_patterns).

Returns a confirmation message.

Get the JavaScript source code of a pattern.

Args: pattern_id: The pattern ID to retrieve code for.

Returns the JavaScript source code string.

Create a new pattern on the PixelBlaze with the given JavaScript code, then activate it.

Args: name: Display name for the new pattern. code: PixelBlaze JavaScript source code (must define a render(index) function).

Returns a dict with the new pattern's 'id' and 'name'.

Replace the JavaScript source code of an existing pattern.

Args: pattern_id: The ID of the pattern to update. code: New PixelBlaze JavaScript source code.

Returns a confirmation message.

Delete a pattern from the PixelBlaze device.

Args: pattern_id: The ID of the pattern to delete.

Returns a confirmation message.

Get the UI controls for the currently active pattern.

Returns a list of control dicts, each with 'name', 'value', and 'type' keys. The controls correspond to exported slider/toggle/picker variables in the pattern code.

Set the value of a UI control (slider, toggle, etc.) on the active pattern.

Args: name: The control variable name (as it appears in pixelblaze_get_controls). value: Numeric value (sliders: 0.0–1.0; toggles: 0 or 1).

Returns a confirmation message.

Get hardware and runtime information about the PixelBlaze device.

Returns a dict with keys: host, pixel_count, fps, uptime_s, version_major, version_minor.

Set the global brightness of the PixelBlaze.

Args: value: Brightness level from 0.0 (off) to 1.0 (full brightness).

Returns a confirmation message.

Get the full PixelBlaze language reference (electromage.com/docs/language-reference).

This covers all built-in functions available when writing pattern code: render(index), beforeRender(delta), color functions (hsv, rgb), math/waveform functions (time, wave, triangle, sin, cos, etc.), array functions, 2D/3D rendering, UI controls (sliders, pickers), language features and limitations, variables, constants, and more.

Always call this before writing or editing any PixelBlaze pattern code.

Get the PixelBlaze 2D/3D pixel mapping reference documentation.

This covers how to define spatial coordinates for pixels using the mapper, coordinate systems, and the render2D/render3D pattern functions.

Call this when working with multi-dimensional LED layouts or spatial effects.

Fetch the text content of a PixelBlaze documentation page from the web.

Use this to look up specific pages on electromage.com/docs/ that aren't covered by the cached API reference, such as hardware-specific guides, GPIO, networking, or advanced topics.

Args: url: Full URL of the documentation page (e.g. https://electromage.com/docs/GPIO/).

Returns the page text content, or an error message if unreachable.