GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
link_image(3) Arcan Lua API link_image(3)

link_image - Reassign the property-space to be relative another object

nil
link_image( vid:id, vid:newparent )
link_image( vid:id, vid:newparent, int:panchor )
link_image( vid:id, vid:newparent, int:panchor, int:anchor_opt )

By default, all objects defines their properties relative to an invisible WORLDID object. By the use of this function, this object can be switched to another dynamically, allowing you to build complex hierarchies.

The default properties that are relative to another object in this way are opacity, position, orientation and lifetime, though this set can be changed with the use of image_mask_set , image_mask_clear , image_mask_clearall , image_mask_toggle

The vid argument refers to the object that shall be reassigned, and the newparent arguments specified the object that it should be made relative to.

If the panchor argument is specified, it defines the positional anchoring space based on one of the following values:

ANCHOR_UL : upper-left, ANCHOR_CR : upper-center, ANCHOR_UR : upper-right, ANCHOR_CL : center-left, ANCHOR_C : center, ANCHOR_CR : center-right, ANCHOR_LL : lower-left, ANCHOR_LC : lower-center, ANCHOR_LR : lower-right.

If the anchor_opt argument is specified, further anchor behavior can be controlled. The valid values for anchor_opt now are: ANCHOR_SCALE_NONE (default), ANCHOR_SCALE_W , ANCHOR_SCALE_H , ANCHOR_SCALE_WH - the object size is now defined relative to that of the width and/or height of the parent. The relative delta is calculated based on the current scale versus the initial (storage without a texture backing) or the current storage size.

1
Changing link ownership resets all scheduled transformations except for blending.
2
Rotation transforms do not take the positional anchor point into account, only its mask.
3
Link to self is equivalent to linking back to WORLDID .
4
linked scale means that 1px will be subtracted from id in each desired dimension when calculating final size as no object can go below 1x1 px size, making it otherwise impossible to describe the case where parent and child should have identical size for the shared dimension. hare dimensions

function link_image0()
      a = fill_surface(64, 64, 255, 0, 0);
      b = fill_surface(32, 32, 0, 255, 0);
      link_image(b, a);
      show_image(b);
      blend_image(a, 1.0, 50);
      move_image(a, VRESW, VRESH, 100);
      rotate_image(a, 100, 100);
      expire_image(a, 100);
end
June 2022 image

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.