Rotate
Jump to navigation
Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Description
rotate(node_id, degrees) rotate(node_id, degrees, anchor_x, anchor_y, anchor_z) rotate(node_id, degrees, animation_type, animation_speed) (from AM/AP 4.0) rotate(node_id, degrees, animation_type, animation_speed, animation_direction) (from AM/AP 4.0) rotate(node_id, degrees, anchor_x, anchor_y, anchor_z, animation_type, animation_speed, animation_direction) (from AM/AP 4.0)
rotate is used to rotate an image, txt or canvas object. The object will be rotated around the center of the object, unless a custom anchor point is provided.
Return value
This function won't return a value.
Arguments
# | Argument | Type | Description |
---|---|---|---|
1 | node_id | ID | Node identifier. This number can be obtained by calling functions like img_add, txt_add or canvas_add. |
2 | degrees | Number | Number of degrees to rotate the object to. |
3 | anchor_x | Number | (Optional) Rotate around this X coordinate. |
4 | anchor_y | Number | (Optional) Rotate around this Y coordinate. |
5 | anchor_z | Number | (Optional) Rotate around this Z coordinate. |
6 | animation_type | String | (Optional) Can be 'OFF', 'LINEAR' or 'LOG'. |
7 | animation_speed | Float | (Optional) Animation speed. Between 1.0 (Fastest) and 0.0 (Slowest) |
8 | animation_direction | String | (Optional) Can be 'DIRECT', 'CW', 'CCW', 'FASTEST' or 'SLOWEST'. Default is 'DIRECT'. The 'DIRECT' mode will use the absolute rotation value (so it you go from 0 to 720 it will make two full rotations). All others will use the relative position (from 0 720 won't do anything since they are the same angle). |
Example (Simple)
-- Load and display text and images
myimage1 = img_add_fullscreen("myimage1.png")
-- Rotate myimage1 to 90 degrees
rotate(myimage1, 90)
-- This will also rotate the image to 90 degrees (450-360)
rotate(myimage1, 450)
Example (Animation)
-- Add an image
myimage1 = img_add_fullscreen("myimage1.png")
-- Enable animation
rotate(myimage1, 0, "LOG", 0.04)
-- Any rotation done at this point will be animated
rotate(myimage1, 90)