include/SDL_hints.h
changeset 5200 01bced9a4cc1
parent 5192 ef5a61ea3202
child 5233 ce4f91138031
equal deleted inserted replaced
5199:164f20ba08eb 5200:01bced9a4cc1
   104     SDL_HINT_OVERRIDE
   104     SDL_HINT_OVERRIDE
   105 } SDL_HintPriority;
   105 } SDL_HintPriority;
   106 
   106 
   107 
   107 
   108 /**
   108 /**
   109  *  \brief Set a hint
   109  *  \brief Set a hint with a specific priority
   110  *
   110  *
   111  *  The priority controls the behavior when setting a hint that already
   111  *  The priority controls the behavior when setting a hint that already
   112  *  has a value.  Hints will replace existing hints of their priority and
   112  *  has a value.  Hints will replace existing hints of their priority and
   113  *  lower.  Environment variables are considered to have override priority.
   113  *  lower.  Environment variables are considered to have override priority.
   114  * 
   114  * 
   115  *  \return SDL_TRUE if the hint was set, SDL_FALSE otherwise
   115  *  \return SDL_TRUE if the hint was set, SDL_FALSE otherwise
   116  */
   116  */
       
   117 extern DECLSPEC SDL_bool SDLCALL SDL_SetHintWithPriority(const char *name,
       
   118                                                          const char *value,
       
   119                                                          SDL_HintPriority priority);
       
   120 
       
   121 /**
       
   122  *  \brief Set a hint with normal priority
       
   123  * 
       
   124  *  \return SDL_TRUE if the hint was set, SDL_FALSE otherwise
       
   125  */
   117 extern DECLSPEC SDL_bool SDLCALL SDL_SetHint(const char *name,
   126 extern DECLSPEC SDL_bool SDLCALL SDL_SetHint(const char *name,
   118                                              const char *value,
   127                                              const char *value);
   119                                              SDL_HintPriority priority);
   128 
   120 
   129 
   121 /**
   130 /**
   122  *  \brief Get a hint
   131  *  \brief Get a hint
   123  *  
   132  *  
   124  *  \return The string value of a hint variable.
   133  *  \return The string value of a hint variable.