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	useful	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
       window  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
       reference 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 segment_request and viewport	events.

       The non-external	types will have	src  and parent	   verified  as	 valid
       frameservers and	the VID	s substitued for the respective	cookie identi-
       fier  (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			  April	2025		  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+14.3.quarterly>

home | help