sprite_get_uvs

This function returns an array with the UV coordinates and other data for the texture of the sprite sub-image on the texture page. The function returns an array with the following 8 elements:

• [0] = left
• [1] = top
• [2] = right
• [3] = bottom
• [4] = amount of pixels the asset compiler has trimmed from the sprite's left side
• [5] = amount of pixels the asset compiler has trimmed from the sprite's top side
• [6] = normalised percentage of pixel data from the original sprite's width that has been saved to the texture page
• [7] = normalised percentage of pixel data from the original sprite's height that has been saved to the texture page

This array can then be used in other draw functions, particularly when working in 3D or using the Primitive functions, as well as when working with the Shader functions.

NOTE This function will not work with vector sprites or skeleton animation sprites.

Syntax:

sprite_get_uvs(sprite, subimage);

Returns

Array (1D, 8 elements)

Example:

var _tex = sprite_get_uvs(sprite, 0);
tex_left = _tex[0];
tex_top = _tex[1];
tex_right = _tex[2];
tex_bottom = _tex[3];

The above code will store the UV coordinates for the given sprite in a local array and then assign the values to instance variables.