chickadee » sdl2 » set-hint!

set-hint! name value #!optional priorityprocedure

Sets the value of the hint. See SDL_SetHintWithPriority and SDL_hints.h

name must be a hint symbol or string (same as the environment variable name). This procedure signals an exception if name is an unrecognized symbol, but accepts any string, even if it is not recognized.

value specifies the new value of the hint. It must be a string.

priority specifies the priorily level for setting the hint. If it is omitted, the priority will be 'normal. It must be one of these symbols:

  • 'default
  • 'normal
  • 'override

Returns #t if the hint's value was set, or #f if it was not set (e.g. because the hint was already set with a higher priority).

Requires sdl2 egg 0.2.0 or higher.