NAME

SYNOPSIS

DESCRIPTION

The special max_w and max_h argument interpretation is only for the TARGET_FORCESIZE and TARGET_LIMITSIZE flags.

The possible flags are: TARGET_VSTORE_SYNCH , TARGET_SYNCHRONOUS , TARGET_NOALPHA , TARGET_AUTOCLOCK , TARGET_VERBOSE , TARGET_NOBUFFERPASS , TARGET_ALLOWCM , TARGET_ALLOWLODEF , TARGET_ALLOWHDR , TARGET_ALLOWVECTOR , TARGET_ALLOWINPUT , TARGET_FORCESIZE , TARGET_ALLOWGPU , TARGET_LIMITSIZE , TARGET_SYNCHSIZE , TARGET_BLOCKADOPT , TARGET_DRAINQUEUE

NOTES

1

flag, TARGET_VSTORE_SYNCH makes sure that there is a local copy of the buffer that is also uploaded to the GPU . This saves a readback in cases where direct access to pixel values are needed.

2

flag, TARGET_SYNCHRONOUS blocks CPU <-> GPU transfers until the transfer has been marked as completed. This will stall the rendering pipeline and possibly incur a heavy performance impact.

3

flag, TARGET_NOALPHA manually sets the alpha field for new frames to 0xff. A faster way of disabling (that would require less memory operations) alpha blending for untrusted sources would be to associate the respective VID s with a shader that doesn't use or lookup alpha value.

4

flag: TARGET_AUTOCLOCK is on by default and provides a standardd implementation for some of the autoclock requests that are then filtered and not forwarded to the eventhandler.

5

flag: TARGET_VERBOSE is off by default. Turning it on will emit additional data about delivered or dropped frames.

6

flag: TARGET_NOBUFFERPASS applies to plaforms where accelerated buffer passing is supported. This can be disabled statically/globally through a platform specific environment variable, and dynamically by setting this flag. The default behavior is to allow buffer passing, but if the graphics (agp) layer gets an invalid buffer, this flag is automatically set to true.

7

flag: TARGET_ALLOWCM allows a client to send/receive color lookup tables for one or several displays. You still need to explicitly specify when- and which tables- are to be sent or retrieved via the

video_displaygamma call. The event handler will indicate when gamma tables have been updated.

8

flag: TARGET_ALLOWLODEF allows a client to treat its video buffers in half-depth mode. Similar to TARGET_ALLOWHDR , this means that more advanced features than compositing (accessing / manipulating store, direct-feed share and so on) should be avoided.

9

flag: TARGET_ALLOWHDR allows a client to treat its video buffers in f16-mode. This is an advanced graphics format for working with sources that has a dynamic range. Most graphics applications becomes more costly, compositing multiple sources on a fixed-range display.

10

flag: TARGET_ALLOWVECTOR allows a client to treat its video buffers in vector mode. This converts the contents of its buffers to work as textures, and metadata for specifying content in a GPU friendly triangle- soup format. Like with allow-lodef/hdr, this will not work well with feedtargets or directly accessing storage.

11

flag: TARGET_ALLOWINPUT remaps any _IO events received unto the main event queue rather than being delivered in the normal frameserver bound callback. This allows for semi-transparent controlled IO injection with all the implications that might have. It is only intended for the cases where overhead needs to be minimized over having a forward from the normal event handler to the appl_input(iotbl) one.

12

flag: TARGET_ALLOWGPU allows a client to authenticate a platform specific token that can provide higher levels of GPU access than the implementation defined default. This is a security tradeoff as it may provide the client with access to read or modify private GPU state.

13

flag: TARGET_LIMITSIZE sets an upper limit to the dimensions that the client can negotiate. This is primarily to prevent accidental absurd behavior, such as 8192x8192 sized mouse cursors.

14

flag: TARGET_SYNCHSIZE changes the semantics for the 'resized' event to block the client, pending a stepframe_target call to release. It is not stable to toggle this flag on as the off state can be activated with a synch pending. On stepframe, the next update will contain the new buffer contents.

15

flag: TARGET_BLOCKADOPT prevents the engine from preserving the target on calls to system_collapse or on script-error recovery.

16

flag: TARGET_DRAINQUEUE allows events coming from the frameserver to be queued directly into the script event handler without being multiplexed on the master queue. This is a complex operation mainly intended for more trusted clients that act as protocol bridges or external input drivers where a higher event dispatch rate and lower event dispatch latency might be beneficial.

EXAMPLE

function target_flags0()
      a = launch_avfeed("", "avfeed", function(source, status)
            for k,v in pairs(status) do
                  print(k, v);
            end
      end);
      target_flag(a, TARGET_VERBOSE);
      target_flag(a, TARGET_SYNCHRONOUS);
      target_flag(a, TARGET_NOALPHA);
      target_flag(a, TARGET_AUTOCLOCK);
      target_flag(a, TARGET_NOBUFFERPASS);
end

MISUSE

function target_flags0()
      a = null_surface(64, 64);
      target_flag(a, FLAG_SYNCHRONOUS);
end

MISUSE

function target_flags1()
      a = launch_avfeed("", "avfeed", function() end);
      target_flag(a, 10000);
end

SEE ALSO: