NAME

SYNOPSIS

To speed things along, look at the wiki on arcan-fe.com and work through the exercises corresponding to the ability level that you want to achieve.

Entry Points

xxx()

Invoked as soon as audio/video/event/database subsystems are active.

xxx_clock_pulse()

Invoked every logical clock-pulse on a default monotonic clock at 25Hz unless clock_pulse_batch is set, then it takes precedence. The CLOCK global provides the current global clock value.

xxx_clock_pulse_batch(nticks, count)

Alternate form to _clock_pulse that handles congestion (> 1 ticks) by providing them in one single go.

xxx_input(evtbl)

Invoked every time an input device emits a valid output sample, this varies with user activity and filter configuration. Evtbl contains a number of fields: kind : touch devid, subid, pressure, size, x, y

kind : analog source, devid, subid, active, relative, samples

kind : digital, translated = true number, keysym, modifiers, devid, subid, utf8, active, device, subdevice

kind : digital, translated = false source, devid, subid, active

kind : eyes blink_left, blink_right, gaze_x1, gaze_y1, gaze_x2, gaze_y2, present, head_x, head_y, head_z, head_rx, head_ry, head_rz

xxx_input_end()

Signifies that the current input buffer is empty. This can be used as an input optimization trigger to accumulate input events before processing them forward.

xxx_input_raw()

This behaves like an advanced complement to xxx_input. By implementing it the application signals that it can handle out of loop input events. This can be used to reduce input latency in cases where events arrive while GPUs are locked for scanout. The contract is that if this function is present, you cannot call any part of the API that would modify GPU related state. The safe option is to restrict handling to patching and forwarding input to an external client. If the input was consumed, return true. Otherwise the input will be re-injected when the GPUs have been unlocked.

xxx_adopt(vid, kind, title, parent, last)

Invoked as part of system_collapse, script crash recovery fallback or on --pipe-stdin. Implies that there already exists a frameserver connection that can be adopted. Last indicates whethere there are more to come, and parent if there's a subsegment-parent relation. Return true if the connection can be imported into the current script, otherwise it will be destroyed automatically.

xxx_preframe_pulse() xxx_postframe_pulse()

Invoked right before and after synchronized transfer of a video frame, this may occur at rather spurious intervals depending on engine configuration and active synchronization strategy. Any computation in this entrypoint should be considered costly and it is mainly provided for monitoring purpsoes.

xxx_adopt(vid, segid, title, parent, last)

Invoked when an application is set to collapse with transfers or when recovering from a scripting error. It is used to allow the new script to retrieve externally bound vids. Return true if the VID was adopted otherwise it will be automatically deleted.

xxx_display_state(action, id, state)

Invoked when there has been a change in the output display configuration state, typically in response to hotplug events.

xxx_fatal(msg)

Invoked on a scripting error that is fatal, as a final means of saving state and conveying a message. The returned string will be attached to crash dump output.

xxx_shutdown()

This entrypoint will be triggered as a final state before the arcan process will exit. The most reasonable use for this entrypoint is terminating network connections with protocols that work better when clients are cooperating, but also for saving configuration through the database (e.g. store_key).

resource

targetcontrol

database

audio

image

3d

system

iodev

vidsys

network

SEE-ALSO

AUTHOR