Layer Management

Less than 1 minute

Layer Management

Create layers, switch layers, set layer properties, and filter entities by layer.

Online Examples

Example	Description	Link
Create Layer	Usage of `Engine.createLayer`	Online Demo{target="_blank"}
Switch Current Layer	Usage of `Engine.setCurrentLayer`	Online Demo{target="_blank"}
Layer Visibility	Use `layerOn` to control on/off state	Online Demo{target="_blank"}
Get Layer List	Usage of `Engine.getLayers`	Online Demo{target="_blank"}
Get Entities by Layer	Filter entities by layer name	Online Demo{target="_blank"}
Freeze Layer	Use `isFrozen` to control frozen state	Online Demo{target="_blank"}
Lock Layer	Use `isLocked` to control locked state	Online Demo{target="_blank"}
Compare Layer States	Compare `layerOn`, `isFrozen`, and `isLocked`	Online Demo{target="_blank"}

Core API

Create Layers

// Create new layer
const layer = Engine.createLayer("NewLayer", {
    color: 1,                  // Layer color
    lineType: "CONTINUOUS",    // Linetype
    lineWeight: 0.25           // Lineweight
});

Switch Current Layer

// Set current layer
Engine.setCurrentLayer("LayerName");

// Get current layer
const currentLayer = Engine.getCurrentLayer();

Layer Properties

// Get layer
const layer = Engine.getLayer("LayerName");

// Turn layer on/off
layer.layerOn = false;  // Turn off
layer.layerOn = true;   // Turn on

// Freeze layer (hidden and not selectable)
layer.isFrozen = true;

// Lock layer (visible but not editable)
layer.isLocked = true;

Get Entities by Layer

// Get all entities on a specific layer
const entities = Engine.getEntities().filter(e => e.layer === "LayerName");

// Or use getEntitiesByLayer
const entities = Engine.getEntitiesByLayer("LayerName");

Layer State Comparison

State	Visible	Selectable	Editable
`layerOn = true`	✓	✓	✓
`layerOn = false`	✗	✗	✗
`isFrozen = true`	✗	✗	✗
`isLocked = true`	✓	✓	✗