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

FreeBSD Manual Pages

  
 
  

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

NAME
       image_inherit_order - Changes the specific object order value to	be ex-
       pressed as relative to its parent.

SYNOPSIS
       nil
       image_inherit_order( vid, bool_state )

DESCRIPTION
       Normally,  order	 is expressed as an independent	property. For some ap-
       plications e.g. user-interfaces,	it might be more useful	and  intuitive
       to  express it relative to a linked object to cut down on the amount of
       tracking	and reordering calles needed to	reorder	an anchor  point  used
       for something like a window. By default,	order inheritance is disabled,
       but can be explicitly enabled by	calling	this function.

NOTES
       1      For  long	 hierarchies,  this  can  be an	expensive operation as
	      changes to order implies a detach/attach operation and is	imple-
	      mented recursively.

EXAMPLE
       function	image_inherit_order0()
	     a = fill_surface(32, 32, 255, 0, 0);
	     b = fill_surface(16, 16, 0, 255, 0);
	     order_image(a, 2);
	     order_image(b, 1);
	     image_inherit_order(b, true);
	     link_image(b, a);
	     show_image({a, b});
       end

MISUSE
       function	image_inherit_order0()
	     a = fill_surface(32, 32, 255, 0, 0);
	     order_image(BADID);
       end

MISUSE
       function	image_inherit_order1()
	     a = fill_surface(32, 32, 255, 0, 0);
	     order_image(a, "not a number");
       end

image				  April	2025		image_inherit_order(3)

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

home | help