<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head>
<script type="text/javascript" language="JavaScript">
function reDo() {
if (innerWidth != origWidth || innerHeight != origHeight)
location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
origWidth = innerWidth;
origHeight = innerHeight;
onresize = reDo;
}
onerror = null;
</script>
<style type="text/css">
< !-- div.WebHelpPopupMenu {
position: absolute;
left: 0px;
top: 0px;
z-index: 4;
visibility: hidden;
}
p.WebHelpNavBar {
text-align: right;
}
-->
</style>
<script type="text/javascript">
gRootRelPath = "../../../..";
gCommonRootRelPath = "../../../..";
gTopicId = "9.2.5.11.0_5";
<script type="text/javascript" src="../../../../template/scripts/rh.min.js"></script>
<script type="text/javascript" src="../../../../template/scripts/common.min.js"></script>
<script type="text/javascript" src="../../../../template/scripts/topic.min.js"></script>
<script type="text/javascript" src="../../../../template/scripts/topicwidgets.min.js"></script>
<script type="text/javascript" src="../../../../whxdata/projectsettings.js"></script>
<link rel="stylesheet" type="text/css" href="../../../../template/styles/topic.min.css"/>
<link rel="stylesheet" type="text/css" href="../../../../template/Charcoal_Grey/topicheader.css"/>
<meta name="topic-status" content="Draft"/>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>texture_get_uvs</title>
<meta name="generator" content="Adobe RoboHelp 2019"/>
<link rel="stylesheet" href="../../../../assets/css/default.css" type="text/css"/>
<meta name="rh-authors" content="Mark Alexander"/>
<meta name="topic-comment" content="Reference page for texture_get_uvs"/>
<meta name="rh-index-keywords" content="texture_get_uvs"/>
<meta name="search-keywords" content="texture_get_uvs"/>
</head>
<body>
<div class="topic-header rh-hide" id="rh-topic-header" onclick="rh._.goToFullLayout()">
<div class="logo">
</div>
<div class="nav">
<div class="title" title="texture_get_uvs">
<span>texture_get_uvs</span>
</div>
<div class="gotohome" title="Click here to see this page in full context">
<span>Click here to see this page in full context</span>
</div>
</div>
</div>
<div class="topic-header-shadow rh-hide" id="rh-topic-header-shadow"></div>
<h1>texture_get_uvs</h1>
<p>This function returns a 1D <a href="../../../GML_Overview/Arrays.htm">array</a> with 4 elements representing the UV coordinates for the image on the texture page, filling in the array with the following values:</p>
<ul class="colour">
<li>[0] = left</li>
<li>[1] = top</li>
<li>[2] = right</li>
<li>[3] = bottom</li>
<li>[4] = amount of pixels the asset compiler has trimmed from the sprites left side (sprite assets only)</li>
<li>[5] = amount of pixels the asset compiler has trimmed from the sprites top side (sprite assets only)</li>
<li>[6] = normalised percentage of pixel data from the original sprites width that has been saved to the texture page (sprite assets only)</li>
<li>[7] = normalised percentage of pixel data from the original sprites height that has been saved to the texture page (sprite assets only)</li>
</ul>
<p>This value can then be used in other draw functions, particularly in general 3D and some of the 2D primitive functions, as well as the Shader functions. If you need the UVS for a sprite then you can use the <tt><a href="../../Asset_Management/Sprites/Sprite_Information/sprite_get_uvs.htm">sprite_get_uvs()</a></tt> and
for a font, <a href="../../Asset_Management/Fonts/font_get_uvs.htm"><tt>font_get_uvs()</tt></a>.</p>
<p> </p>
<h4>Syntax:</h4>
<p class="code">texture_get_uvs(texid)</p>
<table>
<tbody>
<tr>
<th>Argument</th>
<th>Description</th>
</tr>
<tr>
<td>texid</td>
<td>The image asset to get the texture from</td>
</tr>
</tbody>
</table>
<p> </p>
<h4>Returns:</h4>
<p class="code">1D Array (4 - 8 elements)</p>
<p> </p>
<h4>Example:</h4>
<p class="code">var tex = texture_get_uvs(surf_back);<br/> tex_left = tex[0];<br/> tex_top = tex[1];<br/> tex_right = tex[2];<br/> tex_left = tex[3];</p>
<p>The above code will store the UV coordinates for the given surface texture in a local array and then assign the values to instance variables.</p>
<p> </p>
<p> </p>
<p> </p>
<div class="footer">
<div class="buttons">
<div class="clear">
<div style="float:left">Back: <a href="Textures.htm">Textures</a></div>
<div style="float:right">Next: <a href="texture_set_stage.htm">texture_set_stage</a></div>
</div>
</div>
<h5>© Copyright YoYo Games Ltd. 2020 All Rights Reserved</h5>
</div>
</body></html>