Wiki Page Content

Differences between revisions 14 and 15
Revision 14 as of 2011-02-15 19:25:28
Size: 1395
Editor: SheenaSmith
Comment: update content - 2/14 changeset 5295 (as of 5145); moved to render.h
Revision 15 as of 2014-04-02 22:32:16
Size: 1147
Editor: mattbentley
Comment:
Deletions are marked like this. Additions are marked like this.
Line 33: Line 33:
You can call [[SDL_GetRendererInfo]]() to fill in an [[SDL_RendererInfo]] structure with the information about the current renderer. This structure will have SDL_TEXTUREMODULATE_ALPHA set in the `mod_modes` mask if alpha modulation is supported.

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)

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