Pixotope QueryServer - API

Description

QueryServer is, similar to Store and AssethubServer, a per-network service, so it can be accessed statically using the name "QueryServer". It contains a bunch of DH2 Queries which serve to make using DH2 easier, it also provides "Relays" which are GET/UPDATE-able endpoints that combine data from several places or transforms it in some other way. As both the Queries and Relays are parsed at startup, they can be expanded by anyone, even in a deployed installation. It is also open source and found here:

https://bitbucket.org/futureuniverse/open-python-services/src/master/

Name

QueryServer

State

QueryServer maintains no state



Relays (GET Endpoints)

QueryServer exposes several non-state fields that can be queried at runtime. These are automatically updated and provide information about the system.

ActivatedBackupMachines

Manages automatic failover by activating backup machines when main machines become unhealthy.

Return Type: List[Dict[str, Any]]


ActiveBackupServer

Returns active server, whether it is main or backup.

Return Type: Dict[str, Any]


AllSelectedGroupMachines

Returns all selected machines from grouped render machines.

Return Type: List[str]


AsyncComputeInfo

Returns default async compute info structure with inactive status.

Return Type: Dict[str, Any]


AutomaticFailover

Returns the automatic failover setting from the store.

Return Type: bool


AvailableServerBackups

Filters and aggregates available server backup machines.

Return Type: Dict[str, Any]


AvailableSRTPorts

Calculates available SRT ports for each machine based on used ports in Routing.


AvailableTools

Aggregates available tools from all connected DRM servers.


AvailableUDPPorts

Calculates available UDP ports for each machine based on used ports in LocalChains.

Return Type: Dict[str, Dict[str, Any]]


BackupMachineLoaders

Returns the loaders per machine.

Return Type: Dict[str, Dict[str, bool]]


BackupNetworkStatus

Returns the network status of the server backup.

Return Type: Dict[str, Any]


CaptureCameraImagesProgress

Tracks progress and blurriness metrics for camera image capture operation.


CameraSystems

Calls GetCameraSystems query with machines, cameras, and tracking statuses to aggregate camera system data.

Return Type: Dict[str, Any]


CameraTrackingProtocols

Retrieves supported camera tracking protocols from connected CTS.


CloudAsyncJobInfo

Aggregates cloud async compute job information including progress, queue, ETA, and upload status.

Return Type: Dict[str, Any]


ColorMatchingInProgress

Checks if any color matching operation is currently in progress.

Return Type: Dict[str, bool]


ColorMatchingProfiles

Retrieves available color matching profiles from AR/XR pipelines.

Return Type: Dict[str, Any]


ColorMatchingProgress

Tracks the progress percentage of ongoing color matching operations.

Return Type: Dict[str, int]


ColorMatchingStatuses

Aggregates color matching calibration status, progress, and state for all pipelines.

Return Type: Dict[str, Dict[str, Any]]


CombinedEngineWorlds

Aggregates current world information from all ready engines.

Return Type: Dict[str, Any]


CombinedMatroxAdapters

Aggregates Matrox adapter information from all connected Matrox services.

Return Type: Dict[str, Any]


CombinedNMOSConfig

Aggregates NMOS persistent state configuration from all connected Matrox services.

Return Type: Dict[str, Any]


CombinedNMOSConnStatus

Aggregates NMOS connection status from all connected Matrox services.

Return Type: Dict[str, Any]


ComputeAsyncJobsUsage

Calculates total cloud async compute jobs used in the current month.

Return Type: Dict[str, int]


ConnectedBackupHandler

Returns connected BackupHandler service.

Return Type: str


ConnectedClientMachines

Returns list of connected client machines (non-server machines).

Return Type: List[str]


ConnectedCTS

Returns list of connected CTS (Camera Tracking System) services filtered by running daemons.

Return Type: List[str]


ConnectedDaemons

Returns list of connected Daemon services.

Return Type: List[str]


ConnectedDiagnostics

Returns list of connected Diagnostics services filtered by running daemons.

Return Type: List[str]


ConnectedEngines

Returns list of connected Engine services filtered by running daemons.

Return Type: List[str]


ConnectedGateways

Returns list of connected Gateway services filtered by running daemons.

Return Type: List[str]


ConnectedLicenseDRMs

Returns list of connected License DRM services filtered by running daemons.

Return Type: List[str]


ConnectedMachines

Returns list of machine names extracted from connected daemons.

Return Type: List[str]


ConnectedPipelines

Returns list of connected Pipeline services filtered by running daemons.

Return Type: List[str]


ConnectedZones

Returns list of connected ZoneServer services filtered by running daemons.

Return Type: List[str]


CurrentDaemon

Returns the daemon service of the current machine.

Return Type: str


CurrentGateway

Returns the gateway service of the current machine.

Return Type: str


CurrentLicenseDRM

Returns the license DRM service of the current machine.

Return Type: str


CurrentMachineTools

Returns available tools from the current machine.

Return Type: List[Any]


CustomDirectors

Aggregates custom director information (name, color, title) for all daemons.

Return Type: Dict[str, Dict[str, Any]]


DaemonEvents

Aggregates EngineIsStarting events from all connected daemons.


DaemonInfos

Aggregates daemon information including machine info, meta info, custom directors, and network details.

Return Type: Dict[str, Dict[str, Any]]


DaemonIsBusy

Aggregates daemon is busy information from all daemons.

Return Type: Dict[str, Any]


DirectorInfos

Aggregates director startup information from all daemons.

Return Type: Dict[str, Any]


DynamicCameras

Provides dynamic query data for cameras including name, type, tracking protocol, and camera set.

Return Type: Dict[str, Any]


DynamicIOBotEntities

Provides dynamic query data for Pixotope Space IOBot entities.

Return Type: Dict[str, Any]


DynamicIOBotPresets

Provides dynamic query data for Pixotope Space IOBot presets grouped by entity.

Return Type: Dict[str, Any]


DynamicLevels

Provides dynamic query data for available levels across all projects.

Return Type: Dict[str, Any]


DynamicMachines

Provides dynamic query data for machines including hostname, name, IP, color, render group, and server status.

Return Type: Dict[str, Any]


DynamicNDISources

Provides dynamic query data for available NDI sources from all pipelines.

Return Type: Dict[str, Any]


DynamicProjects

Provides dynamic query data for available projects across all machines.

Return Type: Dict[str, Any]


DynamicVideoInputs

Provides dynamic query data for video input routing items.

Return Type: Dict[str, Any]


DynamicVideoOutputs

Provides dynamic query data for video output routing items.

Return Type: Dict[str, Any]


DynamicWebcamSources

Provides dynamic query data for available webcam sources from all pipelines.

Return Type: Dict[str, Any]


EnabledBackupClient

Returns the enabled backup client info.

Return Type: Dict[str, Dict[str, Any]]


Endpoints

Exposes information about all available endpoints and calls. This can be called at runtime and is automatically updated.

Return Type: Object containing:

  • State: boolean

  • PersistentState: boolean

  • Calls: Object mapping call names to their parameters

  • Fields: Object mapping relay names to their descriptions


EngineCameraPreviews

Aggregates engine camera preview data from all ready engines.

Return Type: Dict[str, Any]


EngineOptions

Aggregates DLSS availability status for all ready engines.

Return Type: Dict[str, Dict[str, bool]]


EngineStates

Aggregates engine state including pixel streaming enabled, engine starting, and engine running status for all machines.

Return Type: Dict[str, Dict[str, Any]]


FailoverController

Controls failover process by activating backup machines and updating machine groups and XR mappings.

Return Type: bool


GroupedRenderMachines

Groups render machines by machine groups with selected and available machines for main and backup.

Return Type: Dict[str, Dict[str, Any]]


HealthThresholds

Returns configured health thresholds and default threshold values.

Return Type: Dict[str, Dict[str, Any]]


HealthyEngines

Returns list of machines that have healthy engine metrics.

Return Type: List[str]


HealthyMachines

Returns list of unique machine names from connected pipelines.

Return Type: List[str]


HealthySystemInfo

Evaluates machines health to determine if they have critical issues.

Return Type: Dict[str, Dict[str, bool]]


IOEffects

Aggregates IO effects (sharpen, visualizer, depth/normal generation, BPE) for all machine media.

Return Type: List[Dict[str, Any]]


InputSources

Aggregates formatted input sources (NDI, AJA cards, webcams) from all connected pipelines.

Return Type: Dict[str, Dict[str, List[Any]]]


InstallerInfos

Aggregates installer type information from all connected daemons.

Return Type: Dict[str, Dict[str, Any]]


LicenseInfos

Aggregates license information including user email and activated license names from DRM servers.

Return Type: Dict[str, Dict[str, Any]]


LOWPRIO_CombinedSystemInfo

Aggregates system information from all connected clients with low priority updates.

Return Type: Dict[str, Any]


MachineFeatures

Returns machine features supported by each machine tool.

Return Type: Dict[str, Dict[str, bool]]


MachineGroups

Maps connected machines to their default, custom, and feature group memberships.

Return Type: Dict[str, Dict[str, Any]]


MachineOutputtingKey

Determines which machines are outputting keyed video based on chromakey settings.

Return Type: Dict[str, Dict[str, bool]]


MachinesHealth

Processes and aggregates machine health metrics from diagnostics, pipeline, and engine services.

Return Type: Dict[str, Dict[str, Any]]


MainServerInfo

Returns the main server idle info.

Return Type: Dict[str, Any]


ManageIOBotConnection

Manages IOBot connection/disconnection based on stored connection info.

Return Type: bool


ManageNetworkGroups

Manages Pixotope Network client groups by updating server group info.

Return Type: bool


NetworkAdapters

Aggregates network adapter information from all connected daemons.

Return Type: Dict[str, Any]


NetworkFeatures

Returns network features supported by the server machine.

Return Type: Dict[str, bool]


ParameterThresholds

Returns parameter thresholds for machine health monitoring from store.

Return Type: Dict[str, Any]


PathsInfo

Aggregates path information (machine paths and synced paths) from all daemons.

Return Type: Dict[str, Any]


PipelineTrackingStatuses

Aggregates tracking statuses for all connected pipelines.

Return Type: Dict[str, Any]


PixotopeSpaceConnectiomStatus

Returns IOBot connection status for the current daemon.

Return Type: Dict[str, Any]


PixotopeSpaceConnectionInfo

Returns stored Pixotope Space IOBot connection information (IP and port).

Return Type: Dict[str, Any]


PixotopeSpaceEntities

Returns IOBot entities from the current daemon.

Return Type: Dict[str, Any]


PixotopeSpacePresets

Returns IOBot presets grouped by entity from the current daemon.

Return Type: Dict[str, Any]


PixotopeVersions

Aggregates Pixotope version information from all connected daemons.

Return Type: Dict[str, str]


Presets

Returns all presets from the store.


ProjectsInfos

Aggregates project paths, projects, and favourite shows from all connected daemons.

Return Type: Dict[str, Dict[str, Any]]


ReadyEngines

Filters connected engines to return only those that are ready.

Return Type: List[str]


RenderClientsGroupInfo

Combines grouped render machines with detailed machine info for selected and available machines.

Return Type: Dict[str, Dict[str, Any]]


RenderClientsMachineInfo

Aggregates render client machine information including color and machine group memberships.

Return Type: Dict[str, Dict[str, Any]]


RenderClientsMappingInfo

Aggregates render client mapping information for main and backup machines in each group.

Return Type: Dict[str, Dict[str, Any]]


RenderGroupMachines

Aggregates render group machines including host, clients, grouped machines, and available machine names.

Return Type: Dict[str, Any]


RenderMachineGroups

Processes render machine groups by filtering routing lengths and checking for out-of-sync states.

Return Type: Dict[str, Dict[str, Any]]


RenderMappingUsedSources

Returns all used videohub sources and destinations from render machine groups.

Return Type: Dict[str, List[int]]


ResetMachinesGroupsMapping

Resets machine group routings based on video outputs and connected machines.

Return Type: bool


Roles

Aggregates role information from all connected daemons.

Return Type: Dict[str, Any]


RunningPipeline

Returns the currently running pipeline, either current or first connected.

Return Type: str


ServerBackupClients

Filters and aggregates server backup client information with daemon details.

Return Type: Dict[str, Any]


ServerBackupInProgress

Returns the loading status, backup handler loaders, and backup machine loaders.

Return Type: Dict[str, Dict[str, bool]]


ServerBackups

Aggregates server backup information for all client machines.

Return Type: Dict[str, Dict[str, Any]]


ServerBackupsInfo

Aggregates server backup information for all client machines.

Return Type: Dict[str, Any]


TimecodeReport

Generates timecode report from engine system information.


TotalDataSources

Returns count of total data sources in the data mapper.

Return Type: Dict[str, int]


TriggerGetCloudJobUsage

Generates a unique UUID to trigger cloud job usage refresh.

Return Type: Dict[str, str]


ValidInvalidMachines

Calculates valid and invalid machines based on health metrics and critical failover settings.

Return Type: Dict[str, Any]


ValidRenderMachineGroups

Filters and returns valid render machine groups based on connected machines.

Return Type: Dict[str, Any]


VideehubUpdates

Generates Videohub routing updates for failover scenarios and out-of-sync corrections.

Return Type: List[Dict[str, Any]]


VideoFilesInfo

Aggregates video file information (folder, loopback, running, stopped status) for all machine routings.

Return Type: Dict[str, Dict[str, Dict[str, Any]]]


VideoInputs

Aggregates all video routing items (both inputs and outputs) from all machines.

Return Type: List[Dict[str, Any]]


VideoIOInputs

Filters VideoInputs to return only input-type video routing items.

Return Type: List[Dict[str, Any]]


VideoIOOutputs

Filters VideoInputs to return only output-type video routing items.

Return Type: List[Dict[str, Any]]


VideoOptions

Retrieves video format options (colorspaces, formats, resolutions, framerates) from running pipeline.

Return Type: Dict[str, Any]


VideoOutputsPerMachine

Aggregates video outputs grouped by machine name.

Return Type: Dict[str, List[Dict[str, Any]]]


VideohubAutoConnect

Manages Videohub auto-connect by connecting or disconnecting based on stored settings.

Return Type: bool


VideohubConnectionInfo

Returns Videohub connection information including auto-connect setting and IP address.

Return Type: Dict[str, Any]


VideohubConnectionStatus

Returns Videohub server connection status from the current daemon.

Return Type: Dict[str, Any]


VideohubController

Syncs Videohub routings when automatic failover is enabled and Videohub is connected.

Return Type: bool


VideohubSources

Returns Videohub input/output sources and their state including routing and lock status.

Return Type: Dict[str, Any]


VideohubState

Returns Videohub state including input/output labels, locks, and routing from current daemon.

Return Type: Dict[str, Any]


WebRTCNetworkConfig

Aggregates WebRTC network configuration from store machines.

Return Type: dict[str, dict[str, Any]]


ZoneCameraFormat

Monitors and relays image settings (FPS, resolution, etc.) for multiple cameras from Store routing data. Outputs data in format compatible with ApplicationModel::setImageSource.

Return Type: Dict[str, Dict[str, Any]]


ZoneMachineScenes

Retrieves all zone scenes per machine.

Return Type: Dict[str, List[Dict[str, Any]]]


ZoneMachines

Returns list of connected ZoneServer machine names.

Return Type: List[str]


ZoneScenes

Retrieves all zone scenes.

Return Type: Dict[str, Dict[str, Any]]


Calls

AddIOMedia

Adds IO media (Input/Output) to specified machines with auto-generated unique names.

Params

Name

Type

Description

CustomID

string

Custom identifier for the media

InputType

string

Input type for the media

Machines

array

List of machines

Type

string

Type of media


AddMachineGroup

Adds a new machine group.

No params.


AdjustmentPreset

Manages adjustment presets.

Params

Name

Type

Description

Engine

string

Engine identifier

GroupName

string

Name of the group

IsAdjustment

boolean

Whether this is an adjustment

LevelPath

string

Path to the level

Method

string

Method to use

Panel

string

Panel identifier

Payload

object

Payload data

Preset

string

Preset identifier

Type

string

Type of preset


AwaitCamerasCleared

Waits for all cameras to be cleared.

No params.


CalculateXRARLatency

Calculates XR/AR latency.

No params.


CancelCaptureImage

Cancels an ongoing camera image capture operation.

No params.


CancelColorMatching

Cancels the color matching process.

No params.


CancelComputeJobs

Cancels all running compute jobs.

No params.


CaptureCameraImages

Captures images from a specified camera.

Params

Name

Type

Description

Camera

string

Camera identifier

MachineName

string

Name of the machine

NumberOfImages

number

Number of images to capture


CleanRoutings

Cleans routings for a specific machine.

Params

Name

Type

Description

MachineName

string

Target machine name


CleanServerBackups

Cleans server backups by disabling all active servers and removing backup network configurations.

No params.

Return Type: bool


CleanupTestVideoConsistency

Params

Name

Type

Description

Format

string

Video format


ClearAllKeyerPresets

Clears all keyer presets of a specific type.

Params

Name

Type

Description

Type

string

Type of presets to clear


ClearDigitalTwin

Clears the digital twin data.

No params.


ClearKeyerPreset

Clears a specific keyer preset.

Params

Name

Type

Description

Preset

string

Preset to clear


ClearMachineGroupsMapping

Clears all machine group mappings.

No params.


ClearRoutings

Clears all routings.

No params.


CloudAsyncGeometry

Runs cloud async geometry computation.

Params

Name

Type

Description

Camera

string

Camera identifier

CustomFolder

string

Custom folder path

MachineName

string

Machine name

NumberOfImages

number

Number of images to process


ColorMatching

Initiates color matching process.

No params.


CompareAgainstBlackB64

Compares a base64 image against black.

Params

Name

Type

Description

Image

string

Base64 encoded image


ConnectToVideohub

Connects to a Videohub device.

Params

Name

Type

Description

IP

string

IP address of the Videohub

Reconnect

boolean

Whether this is a reconnection


CreateZoneScene

Creates a new zone scene for a specific camera.

Params

Name

Type

Description

CameraId

string

Camera identifier

MachineName

string

Name of the machine


DeleteMedia

Deletes media from a machine.

Params

Name

Type

Description

IsCamera

boolean

Whether this is camera media

MachineName

string

Target machine name

MediaId

string

Media identifier


DeleteZoneScene

Deletes a zone scene for a specific camera.

Params

Name

Type

Description

CameraId

string

Camera identifier

SceneId

string

Scene identifier

Return Type: dict


DetermineBlurrinessOfB64

Analyzes the blurriness of a base64 image.

Params

Name

Type

Description

Image

string

Base64 encoded image


DetermineBrightnessOfB64

Analyzes the brightness of a base64 image.

Params

Name

Type

Description

Image

string

Base64 encoded image


DiffB64Images

Calculates the difference between two base64 images.

Params

Name

Type

Description

Image1

string

First base64 encoded image

Image2

string

Second base64 encoded image


DisableVideohubAutoconnect

Disables automatic Videohub connection.

No params.


DisableServerBackup

Disables server backup for a machine and removes backup network configuration.

Params

Name

Type

Description

MachineName

string

Name of the machine

Return Type: bool


DisconnectFromVideohub

Disconnects from the Videohub.

No params.


DispatchMetaCall

Dispatches a given method to a given service on the target machines. This is a meta-call function that allows dynamic invocation of methods across multiple machines in the system.

Params

Name

Default

Required

Description

Endpoint


✅ Required

The method/endpoint name that will be called on the target service. This is passed in the Topic of the forwarded calls.

Service


✅ Required

The name of the service to target (e.g., "CTS", "Engine", "Director", "Daemon").

TargetMachines


✅ Required

List of machine names to target. Supports:

  • Explicit machine names (e.g., ["Machine1", "Machine2"])• Wildcard ["*"] to target all connected machines

  • Machine groups using "Groups." prefix (e.g., ["Groups.Default.AR"])

Params

{}

Optional

Dictionary/object containing parameters to pass to the target endpoint. If the endpoint doesn't require parameters, this can be omitted or set to an empty object.

IsAsync

false

Optional

Controls call behavior:

  • false (default): Calls are dispatched sequentially, and results are awaited and returned

  • true: Calls are dispatched in parallel without waiting for results. Response will contain null for both Result and Error fields.

Target Machines Special Syntax

The TargetMachines parameter supports several patterns:

  1. Explicit names: ["Machine1", "Machine2"] - Targets specific machines

  2. Wildcard: ["*"] - Targets all machines with connected Daemon services

  3. Machine groups: ["Groups.Default.AR","Groups.Custom.MyCustomGroup"] - Targets all machines in the "Engines" group as defined in State.MachineGroupings

  4. Mixed: ["Machine1", "Groups.Default.AR", "Machine2"] - Combines explicit names and groups

Response Structure

The query returns an array of result objects, one for each target machine:

JSON
[
    {
        "Machine": "string",  // Name of the target machine
        "Error": "string | null",  // Error message if the call failed, null on success
        "Result": "any | null"  // The actual result from the service, null on error or async calls
    }
]

Examples

Example 1: Success
Example 1: Success
Request
JSON
{
    "Type": "Call",
    "Target": "QueryServer",
    "RespondTo": "Explorer",
    "Method": "DispatchMetaCall",
    "ID": "1"
}
JSON
{
    "Params": {
        "Service": "CTS",
        "Endpoint": "LensRequest",
        "Params": {},
        "TargetMachines": ["Machine1"],
    }
}
Response
JSON
{
    "Result": [
        {
            "Machine": "Machine1",
            "Error": null,
            "Result": [
                "Canon CR-N500 & -N700.cts",
                "HJ14ex4.3B_IASE.cts",
                "Panasonic AW-UE100.cts",
                "Panasonic AW-UE150.cts",
                "Sony AM7.cts",
                "Sony BRC-X1000 & -H800.cts",
                "Sony SELP 28-135 compensated breathing.cts",
                "Template Linear.cts",
                "Template Static.cts"
            ]
        }
    ]
}


Example 2: Failure
Example 2: Failure
Request
JSON
{
    "Type": "Call",
    "Target": "QueryServer",
    "RespondTo": "Explorer",
    "Method": "DispatchMetaCall",
    "ID": "2"
}
JSON
{
    "Params": {
        "Service": "CTS",
        "Endpoint": "RandomEndpoint",
        "Params": {},
        "TargetMachines": ["Machine1"],
        "IsAsync": false
    }
}
Response
JSON
{
    "Result": [
        {
            "Machine": "Machine1",
            "Error": "Service Machine1-CTS on machine Machine1 returned a failure: Unrecognized method name",
            "Result": null
        }
    ]
}


Example 3: Async Call
Example 3: Async Call
Request
JSON
{
    "Type": "Call",
    "Target": "QueryServer",
    "RespondTo": "Explorer",
    "Method": "DispatchMetaCall",
    "ID": "3"
}
JSON
{
    "Params": {
        "Service": "CTS",
        "Endpoint": "LensRequest",
        "Params": {},
        "TargetMachines": ["Machine1"],
        "IsAsync": true
    }
}
Response
JSON
{
    "Result": [
        {
            "Machine": "Machine1",
            "Error": null,
            "Result": null
        }
    ]
}

Note: When IsAsync is true, the call returns immediately with null values. The actual service call is executed in the background.

Example 4: Multiple Machines with Groups
Example 4: Multiple Machines with Groups
Request
JSON
{
    "Params": {
        "Service": "Engine",
        "Endpoint": "GetEngineStatus",
        "Params": {},
        "TargetMachines": ["Groups.Custom.Engines", "Machine1"],
    }
}

This will target all machines in the "Engines" group plus "Machine1" (if not already in the group).

Example 5: Wildcard - All Machines
Example 5: Wildcard - All Machines
Request
JSON
{
    "Params": {
        "Service": "Daemon",
        "Endpoint": "GetSystemInfo",
        "Params": {},
        "TargetMachines": ["*"],
    }
}

This will target all machines that have a connected Daemon service.

Notes

  1. Service Naming: The query automatically constructs the full service name using the pattern {MachineName}-{ServiceName} (e.g., "Machine1-CTS").

  2. Connection Validation: Before dispatching calls, the query verifies that the target service is connected. If not, it returns an error for that machine without attempting the call.

  3. Sequential vs Parallel: When IsAsync is false, calls are executed sequentially, which can take time if targeting many machines. Use IsAsync: true for fire-and-forget operations.

  4. Error Handling: Each machine's result is tracked independently. If one machine fails, others will still be processed. Check the Error field for each result to identify failures.

  5. Group Resolution: Machine groups are resolved from State.MachineGroupings in the Store. If a group doesn't exist or is not a list, it's silently skipped.


DuplicateCurrentShow

Duplicates the currently open show.

No params.


EncoderDetectStart

Initiates encoder limit detection on a camera.

Params

Name

Type

Description

ChainId

string

Camera chain identifier

Return Type: dict


EncoderDetectStop

Stops encoder limit detection on a camera.

Params

Name

Type

Description

ChainId

string

Camera chain identifier

Return Type: dict


FailoverMachineSwitch

Switches failover to a different machine.

Params

Name

Type

Description

GroupId

string

Group identifier

MainMachineName

string

Name of the main machine


FailoverMachineSwitched

Notification that failover machines have switched.

Params

Name

Type

Description

SwitchedMachines

array

List of switched machines


GetAliveIP

Gets the alive IP address.

No params.


GetCameraSystems

Gets information about camera systems.

Params

Name

Type

Description

Cameras

array

Camera filter/specification

Machines

array

Machine filter/specification

TrackingStatuses

array

Tracking status filter


GetColorDiagram

Gets color diagram

Params

Name

Type

Description

Machine

string

Machine name

Name

string

Name to query


GetDefaultVideoInput

Gets the default video input for a machine, returns SRT port if mobile, empty string otherwise.

Name

Type

Description

IsMobile

boolean

Whether the machine is mobile

Machine

string

Machine name

Return Type: str


GetFromRole

Gets information from a specific role.

Params

Name

Type

Description

Name

string

Name to query

Role

string

Role to query from


GetImageForRouting

Gets an image for a routing.

Params

Name

Type

Description

RoutingID

string

Routing identifier

Scale

number

Image scale


GetImportShowState

Gets the import state for a show.

Params

Name

Type

Description

ShowName

string

Name of the show


GetMachineNames

Retrieves the names of all machines in the system.

No params.


GetSystemDump

Gets a complete system dump for diagnostics.

No params.


GetVideoIONodes

Gets all video IO nodes in the system.

No params.


GetZoneTrackingTemplates

Gets the zone tracking templates.

No params.

Return Type: List[Dict[str, Any]]


GiveJakobNewName

Development/debug function.

No params.


ImportComputedMesh

Imports a computed mesh.

Params

Name

Type

Description

LevelLocation

string

Level location path

ProjectLocation

string

Project location path

TargetMachine

string

Target machine name

ZipLocation

string

Path to the mesh zip file


Increment

Increments a value.

Params

Name

Type

Description

Name

string

Name of the value

Number

number

Increment amount

Service

string

Service name


LaunchEngineLevel

Launches a specific Unreal Engine level.

Params

Name

Type

Description

Level

string

Level path

Project

string

Project path


LoadKeyerPreset

Loads a keyer preset.

Params

Name

Type

Description

Machine

string

Target machine

Preset

string

Preset to load

VideoIOName

string

Video IO name


LockRenderMachineRow

Locks a render machine row in the Videohub.

Params

Name

Type

Description

OutputIndex

number

Output index to lock

ShouldLock

boolean

Whether to lock or unlock


MeasureStoreLatency

Measures Store latency.

No params.


NestedStoreState

Tests nested store state.

No params.


NetworkHealthCheck

Performs a health check on a specified network target.

Params

Name

Type

Description

Target

string

The target machine or service to check


NetworkInstall

Installs from a specified network path. After the Pixotope_Installer.exe is synced, a Powershell command is executed Start-Process -FilePath "Synced Config/AutoInstaller/Pixotope_Installer.exe" -ArgumentList /SILENT -Wait

Params

Name

Type

Description

Path

string

Network path to install from

Return

Returns true when installation is completed or false if it fails.


PauseDedicatedVideo

Pauses dedicated video.

Params

Name

Type

Description

MachineName

string

Target machine

RoutingID

string

Routing identifier


PauseVideo

Pauses video playback.

Params

Name

Type

Description

MachineName

string

Target machine

RoutingID

string

Routing identifier


PhaseOffsetDetection

No params.


PixotopeSpaceCuePreset

Cues a preset.

Params

Name

Type

Description

EntityId

string

Entity identifier

PresetId

string

Preset identifier


PixotopeSpaceGetPreset

Gets a specific preset.

Params

Name

Type

Description

EntityId

string

Entity identifier

PresetId

string

Preset identifier


PixotopeSpaceGetPresets

Gets all presets for an entity.

Params

Name

Type

Description

EntityId

string

Entity identifier


PixotopeSpacePlayLoopPreset

Plays a preset in loop mode.

Params

Name

Type

Description

EntityId

string

Entity identifier

PresetId

string

Preset identifier


PixotopeSpacePlayPreset

Plays a preset.

Params

Name

Type

Description

EntityId

string

Entity identifier

PresetId

string

Preset identifier


PixotopeSpaceStopPreset

Stops a playing preset.

Params

Name

Type

Description

EntityId

string

Entity identifier

PresetId

string

Preset identifier


PlayVideo

Plays video on a routing.

Params

Name

Type

Description

MachineName

string

Target machine

RoutingID

string

Routing identifier


RecordDedicatedVideo

Records dedicated video to a specific file.

Params

Name

Type

Description

FileFolder

string

Folder path for the recording

FileName

string

File name for the recording

MachineName

string

Target machine

RoutingID

string

Routing identifier


RecordVideo

Records video from a routing.

Params

Name

Type

Description

MachineName

string

Target machine

RoutingID

string

Routing identifier


RemoveMachineGroup

Removes a machine group.

Params

Name

Type

Description

MachineGroupId

string

ID of the group to remove


RenameCamera

Renames a camera.

Params

Name

Type

Description

CameraId

string

ID of the camera to rename

NewName

string

New name for the camera


RenameKeyerPreset

Renames a keyer preset.

Params

Name

Type

Description

NewName

string

New preset name

Preset

string

Current preset name


RenameMachineGroup

Renames a machine group.

Params

Name

Type

Description

MachineGroupId

string

ID of the group

NewName

string

New name for the group


RenameMedia

Renames video media.

Params

Name

Type

Description

MachineName

string

Target machine name

NewName

string

New media name

VideoId

string

Video identifier


RenameZoneScene

Renames a zone scene for a specific camera.

Params

Name

Type

Description

CameraId

string

Camera identifier

MachineName

string

Name of the machine

NewName

string

New name for the scene

SceneId

string

Scene identifier


ResetKeyerParameters

Resets keyer parameters to defaults.

Params

Name

Type

Description

Name

string

Name of the keyer


ResetRoutingToProtocolDefaults

Resets routing to protocol defaults.

Params

Name

Type

Description

CameraId

string

Camera identifier

Machines

array

List of machines

Protocol

string

Protocol name


ResetTimecode

Resets timecode.

Params

Name

Type

Description

IsPTP

boolean

Whether using PTP

MachineName

string

Target machine


ResetZoneTrackingTemplate

Resets the template for a specific scene.

Params

Name

Type

Description

CameraId

string

Camera identifier

MachineName

string

Name of the machine

SceneId

string

Scene identifier


RestartMachines

Restarts specified machines in the system.

Params

Name

Type

Description

Machines

array

List of machines to restart


RestartPipelines

Restarts all rendering pipelines.

No params.


RestartVideo

Restarts video playback.

Params

Name

Type

Description

MachineName

string

Target machine

Record

boolean

Whether to restart recording

RoutingID

string

Routing identifier


RouteCameraSystem

Routes a camera system.

Params

Name

Type

Description

CameraId

string

Camera identifier

IsMobile

boolean

Whether this is a mobile camera

Machines

array

List of machines

Name

string

Routing name


RouteLocalCamera

Routes a local camera.

Params

Name

Type

Description

CameraId

string

Camera identifier

Machines

array

List of machines


SaveKeyerPreset

Saves the current keyer settings as a preset.

Params

Name

Type

Description

Machine

string

Target machine

Preset

string

Preset name

VideoIOName

string

Video IO name


SaveZoneTrackingState

Saves the tracking state for a specific machine.

Params

Name

Type

Description

MachineName

string

Name of the machine

Name

string

Name for the saved state

Return Type: bool


SaveZoneTrackingTemplate

Saves the template for a specific scene.

Params

Name

Type

Description

CameraId

string

Camera identifier

KeyframeNodes

array

Keyframe node data

MachineName

string

Name of the machine

SceneId

string

Scene identifier

SelectedKeyframe

any

Currently selected keyframe

SportType

string

Sport type for the template

TemplateLength

number

Template length

TemplateType

string

Template type

TemplateWidth

number

Template width


SetCalibratedLag

Sets calibrated lag for a component.

Params

Name

Type

Description

Component

string

Component identifier

Lag

number

Lag value in milliseconds

Machine

string

Machine name


SetTimecode

Configures timecode settings.

Params

Name

Type

Description

AnyVideoIsST2110

boolean

Whether any video is ST2110

AutoReset

boolean

Whether to auto-reset

Enabled

boolean

Whether timecode is enabled

Machines

array

List of machines


SetTrackingProtocol

Sets the tracking protocol for a camera.

Params

Name

Type

Description

Camera

string

Camera identifier

Protocol

string

Tracking protocol to use


SetupTestIO

Sets up test IO configuration.

Params

Name

Type

Description

FilePath

string

Path to test file

IncludeOutput

boolean

Whether to include output


SetupTestVideoColorMatchingOutput

Sets up test video color matching output.

No params.


SetupTestVideoConsistency

Sets up test video routing with NDI or SRT input for consistency testing.

Params

Name

Type

Description

Delay

number

Delay value

Format

string

Video format

InputType

string

Input type


SetupVideoIOTestOCIO

Sets up Video IO OCIO test.

No params.


SetupVideoIOTestRouting

Sets up Video IO routing test.

No params.


SetZoneConfiguration

Sets the configuration for zone service of a specific machine.

Params

Name

Type

Description

CalibrationFilePath

string

Path to calibration file

MachineName

string

Name of the machine

RestartWebRTC

boolean

Whether to restart WebRTC

VideoFilePath

string

Path to video file

VideoParameter

any

Video parameter value

VideoType

string

Type of video

Return Type: bool


ShuffleColors

Development function to shuffle colors.

No params.


ShutdownPipelines

Shuts down all rendering pipelines.

No params.


StartingEngines

Validates that engines are starting correctly.

Params

Name

Type

Description

Machines

array

List of machines to validate

Return Type: bool


StopDedicatedVideo

Stops dedicated video.

Params

Name

Type

Description

MachineName

string

Target machine

RoutingID

string

Routing identifier


StopVideo

Stops video playback.

Params

Name

Type

Description

MachineName

string

Target machine

Record

boolean

Whether to stop recording

RoutingID

string

Routing identifier


StoreState

Tests store state functionality.

No params.


Swap

Swaps two values.

Params

Name

Type

Description

First

string

First value

Second

string

Second value

Service

string

Service name


SwitchCameraGroup

Switches to a different camera group.

Params

Name

Type

Description

Group

string

Name of the camera group to switch to


SwitchServerBackup

Switches server backup to a specified machine and configures backup network info.

Params

Name

Type

Description

IPAddress

string

IP address of the backup machine

MachineName

string

Name of the machine

Return Type: bool


SyncChanges

Synchronizes changes.

Params

Name

Type

Description

Action

string

Action to perform

ReadFrom

string

Source to read from


SyncRenderMapping

Synchronizes render mapping.

No params.


TestAwait

Tests await functionality.

No params.


TestExternalKey

Tests external keying.

No params.


TestIOBotConnection

Tests the IO Bot connection.

No params.


TestKeyer

Tests the keyer functionality.

No params.


TestSharpening

Tests image sharpening.

No params.


TestSpamSettingsChange

Tests rapid settings changes.

No params.


TestStorePerformance

Tests Store performance.

No params.


ToggleLockZoneScreen

Toggles the lock zone screen for a specific machine.

Params

Name

Type

Description

MachineName

string

Name of the machine

ShouldLock

boolean

Whether to lock the screen

Return Type: bool


UNFINISHED_TestVideoIOLatency

This test is unfinished.

No params.


UpdateMachineGroupMapping

Updates machine group mapping.

Params

Name

Type

Description

IOIndex

number

IO index

IOType

string

IO type

IOValue

string

IO value

MachineGroupId

string

Machine group ID

MachineName

string

Machine name

MachinesType

string

Type of machines


UpdateMachineGroupSelection

Updates machine selection for a group.

Params

Name

Type

Description

MachineGroupId

string

ID of the group

Machines

array

List of machines

MachinesType

string

Type of machines


VideohubTestConnection

Tests the Videohub connection.

No params.


WaitForEngineToLaunch

Waits for an engine instance to launch.

No params.


WaitForEnginesToBeReady

Waits for all Unreal Engine instances to be ready.

No params.


WaitForMainServicesToStart

Waits for main services to start.

No params.


WaitForPipelinesToFinishBuilding

Waits for all pipelines to finish building.

No params.