GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
stepframe_target(3) Arcan Lua API stepframe_target(3)

stepframe_target - Request that the target generate / consume a video frame.

bool
stepframe_target( vid:target )
stepframe_target( )
stepframe_target( vid:target, int:n_frames )
stepframe_target( )
stepframe_target( vid:target, int:n_frames, int:clock_id )
stepframe_target( )
stepframe_target( vid:target, int:n_frames, bool:synch )
stepframe_target( )
stepframe_target( vid:target, int:n_frames, bool:synch, int:x, int:y, int:w, int:h )

The main purpose of this function is to have whatever target points to consume or generate a frame. The specifics of this varies a bit with what type the target has. There are two important distinctions, normal frameservers/clients and ones that are tied to offscreen render processes. If it is a normal client, only the first three forms are useful. The short version only sends an event to the client requesting that it produce a frame ( STEPFRAME ). The second form allows you to further quantify (default is 1) the amount of frames it should advance, which is mostly useful for control over streaming video sources and similar clients where there is a continous seekable stream of logical time slices (frames). If the client has been forced into having synchronous size management through target_flags , 'framestepping' also means acknowledging a pending resize lock. If a 'clock_id' is provided (default 0), it can also reference a custom client requested clock ( CLOCKREQ event) for custom fireable timers. Normally the engine takes care of these automatically, and the feature is mainly for specialised clients. If the client is tied to another processing step through define_rendertarget or define_calctarget , this will issue a readback that is either synchronous if synch is set to true, or asynchronous, if synch is set to false. If possible storage- coordinate region (x+w,y+h) is defined, the processing stage is hinted that only a certain region of the target should actually be considered. The function will return false if a step is requested while a readback is already pending. This can happen if the receiving step, which in the case of a recordtarget is an external process, is slow to process.

define_calctarget(3) define_recordtarget(3)

June 2022 targetcontrol

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.