Wiki Page Content

Differences between revisions 9 and 10
Revision 9 as of 2010-08-29 21:59:54
Size: 1379
Editor: SheenaSmith
Comment: update content (w/ Sam)
Revision 10 as of 2010-08-29 22:00:16
Size: 1383
Editor: SheenaSmith
Comment: minor change
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 `mod_modes` mask if alpha modulation is supported. 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 a 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

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

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.


CategoryAPI, CategoryVideo

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