DxGetMaterialSize: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 13: Line 13:
===Returns===
===Returns===
Returns two ''ints'' representing the width and height in pixels of the material, or false if an invalid parameter was passed to the function.  
Returns two ''ints'' representing the width and height in pixels of the material, or false if an invalid parameter was passed to the function.  
{{New feature/item|4.0130|1.3|4021|
If the material is a volume texture, this function will return three ''ints'' representing the width, height and depth.
If the material is a volume texture, this function will return three ''ints'' representing the width, height and depth.
}}


==Example==  
==Example==  

Revision as of 07:05, 15 July 2013

This gets the dimensions of the supplied material element.

Syntax

int, int [, int] dxGetMaterialSize ( element material )

Required Arguments

  • material : The material element whose size is to be gotten

Returns

Returns two ints representing the width and height in pixels of the material, or false if an invalid parameter was passed to the function. If the material is a volume texture, this function will return three ints representing the width, height and depth.

Example

myTexture = dxCreateTexture( "man.png" )
local width, height = dxGetMaterialSize( myTexture )
outputChatBox( "man.png is " .. tostring(width) .. " pixels wide and " .. tostring(height) .. " pixels high" )

Changelog

Version Description
1.3.0-9.04021 Added third return value for volume textures

See Also