Wiki Page Content

Revision 5 as of 2010-08-29 21:53:06

Clear message

SDL_SetTextureAlphaMod

Use this function to set an additional alpha value multiplied into render copy operations.

Syntax

int SDL_SetTextureAlphaMod(SDL_Texture* texture,
                           Uint8        alpha)

Function Parameters

texture

the texture to update

alpha

the source alpha value multiplied into copy operations

Return Value

Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Code Examples

You can add your code example here

Remarks

When a texture is copied, during the copy operation the source alpha value is modulated by this alpha value according to the following formula:

  • srcA = srcA * alpha

Alpha modulation is not always supported by the driver; it will return -1 if alpha modulation is unsupported.

You can call SDL_GetRendererInfo to get information about the current renderer. The current renderer has a mask of supported channel modulations which will have SDL_TEXTUREMODULATE_ALPHA set if alpha modulation is supported.


CategoryAPI, CategoryVideo

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit