Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
target_anchorhint(3)		  Arcan Lua API 	    target_anchorhint(3)

NAME
     target_anchorhint	-  Inform  a  target about its coordinates relative to a
     reference

SYNOPSIS
     nil
     target_anchorhint( vid:tgt, int:type=ANCHORHINT_SEGMENT, int:parent, int:x,
     int:y, int:z )
     target_anchorhint(   vid:tgt,   int:type=ANCHORHINT_EXTERNAL,   int:parent,
     int:x, int:y, int:z )
     target_anchorhint( vid:tgt, int:type=ANCHORHINT_PROXY, vid:src, int:parent,
     int:x, int:y, int:z )
     target_anchorhint(  vid:tgt,  int:type=ANCHORHINT_PROXY_EXTERNAL,	int:src,
     int:parent, int:x, int:y, int:z )

DESCRIPTION
     While target_displayhint  can be used  to	provide  additional  information
     about  how  a client will be presented, it does not carry information about
     how it will be positioned within some reference frame. This is not as  use-
     ful  since clients can already hint in the other direction through viewport
     events.

     The major exceptions are when one client is  bridging  to	other  windowing
     systems  ( ANCHORHINT_PROXY , ANCHORHINT_PROXY_EXTERNAL ), acting as a win-
     dow manager for nested/embedded subsegments ( ANCHORHINT_SEGMENT ) or as an
     out-of-process external window manager ( ANCHORHINT_PROXY ).  *x*	and  *y*
     refers  to  the  resolved upper-left corner position of the target, and *z*
     the stacking or composition order.

     In such cases target_anchorhint can be used. The type indicates which  ref-
     erence  objects  that could be provided. If the type contains EXTERNAL  the
     src  and parent  arguments will be treated as an opaque externally provided
     identifier, as with target_displayhint    and  received  through  the  seg-
     ment_request and viewport events.

     The  non-external types will have src  and parent	verified as valid frame-
     servers and the VID s substitued for the respective cookie identifier  (see
     launch_target  ).	If no parenting relationship is required, use the global
     WORLDID  as reference. Pointing to an invalid VID	  is  a  terminal  state
     transition.

SEE ALSO:
     target_displayhint(3) launch_target(3)

targetcontrol			   August 2026		    target_anchorhint(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=target_anchorhint&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help