Recommend a calibration approach (homography / PnP markers / VIOSO / MPCDI) for a scenario.

Recommend a warp tool: FFD vs Vertex vs Polygonal vs Multi-Pos, with rationale.

Diagnose a projection-mapping symptom (e.g. 'visible seam', 'black output') -> cause + fix.

Produce an ordered, scenario-tailored Pixera setup plan (Screens -> Mapping -> Compositing).

Parse a Pixera .avp show-file (offline) and summarize the mapping/warp context.

Returns projectors (model + pose), FFD warp modifiers (grid dims + control points), marker calibration sets, and soft-edge presence read straight from the project file - warp data the Native API cannot expose. Heuristic for Pixera build 26-1.

Validate a soft-edge/blend setup and flag what is wrong for the workflow.

Validate marker-calibration parameters (count, coplanarity, EDID/lens prereqs, error).

Validate Canvas Resolution vs projector output (resolution + aspect).

Validate Feed Mode choice for a surface (e.g. 'None' only for 3D/non-continuous UV).

Read the projector pose live, cull the mesh to what it sees, and recommend marker placement.

lens: {throw_ratio | fov_h_deg, aspect, shift_h, shift_v, resolution:[w,h]}. mesh_path: OBJ/GLTF/... on disk. mesh_transform: optional {position, rotation, scale} to place the mesh in world coordinates. Requires a live Pixera connection.

Score how calibratable a mesh is from a projector (VQI + breakdown). Requires a live connection.

Push world-space markers via Pixera.Calibration.setMarkerPositions (positions = flat x,y,z).

Applies to the marker calibration open in Pixera; the API takes no screen handle.

Return the Pixera Native API revision (even=release, odd=beta).

Liveness check: API revision + noop round-trip.

Probe whether the connected Pixera supports an API function.

Play/Pause/Stop a timeline by index (action: 'play'|'pause'|'stop').

Play/Pause/Stop a timeline by name (action: 'play'|'pause'|'stop').

Fire a cue by index on a timeline by index (zero-based).

Fire a cue by its cue number on a timeline by index.

Blackout (or restore) a projector by name.

Launch a calibration tool for a screen (mode 'newCalib'|'autoRecalib', tool e.g. 'vioso').

Load a warp file (MPCDI by default) onto a screen.

Load a Pixera project (replaces the current project; clears the handle cache).

Save the current Pixera project.

Trigger a mapping refresh on a screen.

Look up Pixera API methods offline (rev 481 API JSON). No connection needed.

query: a full method name (returns signature + doc), a prefix such as 'Pixera.Timelines.Layer.' (lists methods), or a substring such as 'VideoStream'. Class methods take the object handle as params.handle. Use before pixera_call.

Call any Pixera API method, e.g. method='Pixera.Screens.Screen.setIsVisible', params={'handle': 123, 'isVisible': true}.

Checks first: method and params against the rev 481 index (validate=false skips), destructive calls (remove/delete, load/save project, import mappings, engine stop) need allow_destructive=true, protected timelines can never be removed or renamed, and getHasFunction must confirm the method. Returns {ok, result | errors, stage}.

All screens with handle, position (m), rotation (deg), scale, visible, blackout.

Resource folder tree with each resource's name, id and type.

folder_name_path (e.g. 'Media/Screens') starts at one folder. detailed adds file path and resolution. Use the id with pixera_setup_layer(resource_id=...).

Find one resource by folder name path and name; returns handle, id, type, file path.

Timelines with fps and transport mode; per layer: assigned resource, model resource, home screen, scale mode. Protected timelines (PIXERA_PROTECTED_PREFIXES, default LE_) are marked.

Return Layer.getLayerJsonDescrip for one layer (raw JSON string from Pixera).

Set screen position [x,y,z] (m), rotation [x,y,z] (deg) and/or scale; reads pose back.

Pixera is right-handed, Y-up, metres. convention='blender' converts a Blender Z-up position (x, y, z) to Pixera (x, z, -y); rotation is refused in that mode. Omitted vectors stay unchanged.

Import a file (or, with directory=true, every file in a folder) into a resource folder.

OBJ files become '3DModel' resources (confirmed live); assign them to a layer with pixera_setup_layer(model_resource_id=...).

Directory import never removes existing resources. Returns name, id and type of each new resource.

Create and name a new timeline. Refuses existing names and protected prefixes.

Find or create a layer, then set any of: media resource (id), 3D model resource (id of a '3DModel' resource, e.g. an imported OBJ), home screen, scale_mode ('fill' | 'fit' | 'stretch' | 'resource' | 'model_1to1'), render only on home screen. Refuses protected timelines.

Set the stream mode of an existing Live Input resource and (de)activate its streams.

Without mode_index, only lists the available modes.

Outputs of a live system (default: first) with idPath, resolution, assigned projectors and screens. idPath (e.g. '1/2') is used by pixera_import_mappings.

Export the live system's projector mappings (warp, soft edge, color correction) to a folder: service_/mapping_NNN.axp plus original_output_structure.json.

Import mappings exported by pixera_export_mappings. output_map retargets by output idPath, e.g. {"1/1": "1/2"} moves output 1/1's mappings to 1/2. Overwrites the target outputs' mappings, so allow_destructive=true is required. Cannot create Art-Net outputs or feeds.

List projector names in the current project.

Get a projector's live position (m) and rotation (deg).

List screen names in the current project.

List timelines (handles + count) in the current project.

Read a parameter value by instance path (e.g. 'Timeline 1.Layer 1.Opacity').

Get a timeline's current playhead time in seconds.

Fetch Pixera monitoring data (alerts/heartbeat).