Wiki Page Content

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 this texture is rendered, during the copy operation the source alpha value is modulated by this alpha value according to the following formula:

  • srcA = srcA * (alpha / 255)

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


CategoryAPI, CategoryRender

None: SDL_SetTextureAlphaMod (last edited 2014-04-02 22:32:16 by mattbentley)

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