include/SDL_hints.h
changeset 12381 dc9108cd4340
parent 12317 d147224c0f28
parent 12211 0d8f33ad5fbb
child 12467 2d7891d05d8d
equal deleted inserted replaced
12379:5dc13016cf34 12381:dc9108cd4340
  1042  *  https://developer.apple.com/library/content/documentation/Audio/Conceptual/AudioSessionProgrammingGuide/AudioSessionCategoriesandModes/AudioSessionCategoriesandModes.html
  1042  *  https://developer.apple.com/library/content/documentation/Audio/Conceptual/AudioSessionProgrammingGuide/AudioSessionCategoriesandModes/AudioSessionCategoriesandModes.html
  1043  */
  1043  */
  1044 #define SDL_HINT_AUDIO_CATEGORY   "SDL_AUDIO_CATEGORY"
  1044 #define SDL_HINT_AUDIO_CATEGORY   "SDL_AUDIO_CATEGORY"
  1045 
  1045 
  1046 /**
  1046 /**
       
  1047  *  \brief  A variable controlling whether the 2D render API is compatible or efficient.
       
  1048  *
       
  1049  *  This variable can be set to the following values:
       
  1050  *
       
  1051  *    "0"     - Don't use batching to make rendering more efficient.
       
  1052  *    "1"     - Use batching, but might cause problems if app makes its own direct OpenGL calls.
       
  1053  *
       
  1054  *  Up to SDL 2.0.9, the render API would draw immediately when requested. Now
       
  1055  *  it batches up draw requests and sends them all to the GPU only when forced
       
  1056  *  to (during SDL_RenderPresent, when changing render targets, by updating a
       
  1057  *  texture that the batch needs, etc). This is significantly more efficient,
       
  1058  *  but it can cause problems for apps that expect to render on top of the
       
  1059  *  render API's output. As such, SDL will disable batching if a specific
       
  1060  *  render backend is requested (since this might indicate that the app is
       
  1061  *  planning to use the underlying graphics API directly). This hint can
       
  1062  *  be used to explicitly request batching in this instance. It is a contract
       
  1063  *  that you will either never use the underlying graphics API directly, or
       
  1064  *  if you do, you will call SDL_RenderFlush() before you do so any current
       
  1065  *  batch goes to the GPU before your work begins. Not following this contract
       
  1066  *  will result in undefined behavior.
       
  1067  */
       
  1068 #define SDL_HINT_RENDER_BATCHING  "SDL_RENDER_BATCHING"
       
  1069 
       
  1070 
       
  1071 /**
  1047  *  \brief  An enumeration of hint priorities
  1072  *  \brief  An enumeration of hint priorities
  1048  */
  1073  */
  1049 typedef enum
  1074 typedef enum
  1050 {
  1075 {
  1051     SDL_HINT_DEFAULT,
  1076     SDL_HINT_DEFAULT,