gpu_set_alphatestenable


Description

This function will enable or disable alpha testing for your game (by default this is disabled). By switching alpha testing on you can then use the companion function gpu_set_alphatestref to set the "cut-off" value at which all alpha values will be set to 0. The image below shows the difference that can be seen when alpha testing is switched on or off:

NOTE: This function may negatively affect performance on iOS, Android and Windows Phone devices.


Syntax:

gpu_set_alphatestenable(enable);


Arguments:

Argument Description
enable Enable or disable alpha testing (true / false)


Returns:

N/A


Example:

if !gpu_get_alphatestenable()
   {
   gpu_set_alphatestenable(true);
   gpu_set_alphatestref(128);
   }

The above code will check to see if alpha testing is enabled and if not it will switch on alpha testing and set the test threshold to 128 (only pixels with an alpha over 0.5 will be drawn).


Back: GPU Functions
Next: gpu_set_alphatestref
© Copyright YoYo Games Ltd. 2018 All Rights Reserved