Wiki Page Content

Differences between revisions 1 and 2
Revision 1 as of 2011-02-24 22:07:35
Size: 2160
Editor: SheenaSmith
Comment: create page - 2/4 changeset 5189 (2/23 5391)
Revision 2 as of 2011-03-03 16:52:23
Size: 1246
Editor: SheenaSmith
Comment: update content
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
||'''name'''||^the hint to set; see [[#Remarks|Remarks]] for details^||
||'''value'''||^the value of the hint variable; see [[#Remarks|Remarks]] for details^||
||'''priority'''||^the priority level for the hint; see [[#Remarks|Remarks]] for details^||
||'''name'''||the hint to set; see the list of Hints on [[|CategoryHints]] for details||
||'''value'''||the value of the hint variable; see the individual Hint for details||
||'''priority'''||the [[SDL_HintPriority]] level for the hint||
Line 33: Line 33:
'''name''' and '''value''' may be one of the following pairs:
||<( |4>SDL_HINT_FRAMEBUFFER_ACCELERATION||0||disable 3D acceleration||
||1||enable 3D acceleration, using the default renderer||
||X||enable 3D acceleration, using X where X is one of the valid rendering drivers. (e.g. "direct3d", "opengl", etc.)||
||||(default is best guess for platform)||
||<( |6>SDL_HINT_RENDER_DRIVER||direct3d||||
||||(defaults by platform to first supported in list)||
||<( |2>SDL_HINT_RENDER_OPENGL_SHADERS||0||disable shaders||
||1||enable shaders (default if supported by OpenGL)||
||<( |2>SDL_HINT_RENDER_VSYNC||0||disable vsync (default)||
||1||enable vsync||

'''priority''' may be one of the following:

Line 57: Line 34:
 .[[SDL_SetHint]] ???  .[[SDL_SetHint]]



Use this function to set a hint with a specific priority.


SDL_bool SDL_SetHintWithPriority(const char*      name,
                                 const char*      value,
                                 SDL_HintPriority priority)

Function Parameters


the hint to set; see the list of Hints on CategoryHints for details


the value of the hint variable; see the individual Hint for details


the SDL_HintPriority level for the hint

Return Value

Returns SDL_TRUE if the hint was set, SDL_FALSE otherwise.

Code Examples

You can add your code example here


The priority controls the behavior when setting a hint that already has a value. Hints will replace existing hints of their priority and lower. Environment variables are considered to have override priority.

CategoryAPI, CategoryHints

None: SDL_SetHintWithPriority (last edited 2014-03-10 23:14:11 by PhilippWiesemann)

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