FreeBSD Manual Pages
target_displayhint(3) Arcan Lua API target_displayhint(3) NAME target_displayhint - Send visibility / drawing hint to target frameserver. SYNOPSIS int:cellw, int:cellh target_displayhint( vid:dst, int:width, int:height ) target_displayhint( vid:dst, int:width, int:height, int:flags ) target_displayhint( vid:dst, int:width, int:height, int:flags, vid:proxy ) target_displayhint( vid:dst, int:width, int:height, int:flags, int:WORLDID ) target_displayhint( vid:dst, int:width, int:height, int:flags, tbl:disptbl ) DESCRIPTION The target_displayhint sends a hint to the specified target that it should try and resize its shared memory connection to the desired dimensions. This can be used to notify about current drawing dimensions for the associated video object, or for special cases where one might want an explicitly over- or under-sized input buffer. The possible values for the optional flags field are (combine with bit.bor): TD_HINT_IGNORE - no change to the flag state from last time. TD_HINT_CON- TINUED - resize events are likely to be followed with more, TD_HINT_UNFO- CUSED - no input focus, input events can still arrive but no visibile in- dication (e.g. cursor) needs to be shown TD_HINT_INVISIBLE - not currently visible/used, no need to update/draw TD_HINT_MAXIMIZED - window is in a 'maximized' state, some UI toolkits will change their visible behavior if they know that they are in this state. TD_HINT_FULLSCREEN - window is in a 'fullscreen' state, similar to the maximized state, some UI toolkits may want this. TD_HINT_DETACHED - (with provided embedded proxy), the associ- ated window has been detached from the embedding and should not be consid- ered in local layouting. If the optional disptbl is set and is a table, the fields 'ppcm' and 'sub- pixel_layout' are expected to be present. If the * WORLDID * form is used, the current default output display proper- ties will be sent. The function returns the current estimated cell dimensions for clients that use the tpack- format for server-side text. This is affected by the last fonthint as well as the provided density, and is just an estimate. NOTES 1 width/height that exceeds the static compile-time limitations of MAX_TARGETW or MAX_TARGETH will be clamped to those values. In- valid hint- dimensions (0 <= n) is a terminal state transition. 2 changing the pixel density (width/height + disptbl with phy_width, phy_height) may incur font rendering changes in the dst referenced target. 3 The correlated event gets special treatment. When the dequeue func- tion in the shared memory interface discover a displayhint event, the remainder of the queue will be scanned for additional ones. Rel- evant fields will be merged and properties that are in conflict will favor the most recent. This prevents bubbles from a possible re- size- reaction for common scenarios such as drag-resizing a window. EXAMPLE function target_displayhint0() local a = target_alloc("example", function() end); show_image(a); resize_image(a, VRESW, VRESH); target_displayhint(a, VRESW, VRESH); end SEE ALSO: targetcontrol August 2026 target_displayhint(3)
NAME | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLE | SEE ALSO:
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=target_displayhint&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>