view release on metacpan or  search on metacpan

lib/SDL2/hints.pm  view on Meta::CPAN

=item C<SDL_HINT_VIDEO_X11_FORCE_EGL>

A variable controlling whether X11 should use GLX or EGL by default

This variable can be set to the following values:

    0   Use GLX
    1   Use EGL

By default SDL will use GLX when both are present.

=item C<SDL_HINT_MOUSE_DOUBLE_CLICK_TIME>

A variable setting the double click time, in milliseconds.

=item C<SDL_HINT_MOUSE_DOUBLE_CLICK_RADIUS>

A variable setting the double click radius, in pixels.

=item C<SDL_HINT_MOUSE_NORMAL_SPEED_SCALE>

A variable setting the speed scale for mouse motion, in floating point, when
the mouse is not in relative mode.

=item C<SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE>

A variable setting the scale for mouse motion, in floating point, when the
mouse is in relative mode.

=item C<SDL_HINT_MOUSE_RELATIVE_SCALING>

A variable controlling whether relative mouse motion is affected by renderer
scaling

This variable can be set to the following values:

    0   Relative motion is unaffected by DPI or renderer's logical size
    1   Relative motion is scaled according to DPI scaling and logical size

By default relative mouse deltas are affected by DPI and renderer scaling.

=item C<SDL_HINT_TOUCH_MOUSE_EVENTS>

A variable controlling whether touch events should generate synthetic mouse
events

This variable can be set to the following values:

    0   Touch events will not generate mouse events
    1   Touch events will generate mouse events

By default SDL will generate mouse events for touch events.

=item C<SDL_HINT_MOUSE_TOUCH_EVENTS>

A variable controlling whether mouse events should generate synthetic touch
events

This variable can be set to the following values:

    0   Mouse events will not generate touch events (default for desktop platforms)
    1   Mouse events will generate touch events (default for mobile platforms, such as Android and iOS)

=item C<SDL_HINT_IOS_HIDE_HOME_INDICATOR>

A variable controlling whether the home indicator bar on iPhone X should be
hidden.

This variable can be set to the following values:

    0   The indicator bar is not hidden (default for windowed applications)
    1   The indicator bar is hidden and is shown when the screen is touched (useful for movie playback applications)
    2   The indicator bar is dim and the first swipe makes it visible and the second swipe performs the "home" action (default for fullscreen applications)

=item C<SDL_HINT_TV_REMOTE_AS_JOYSTICK>

A variable controlling whether the Android / tvOS remotes should be listed as
joystick devices, instead of sending keyboard events.

This variable can be set to the following values:

    0   Remotes send enter/escape/arrow key events
    1   Remotes are available as 2 axis, 2 button joysticks (the default).

=item C<SDL_HINT_GAMECONTROLLERTYPE>

A variable that overrides the automatic controller type detection

The variable should be comma separated entries, in the form: VID/PID=type

The VID and PID should be hexadecimal with exactly 4 digits, e.g. C<0x00fd>

The type should be one of:

=over

=item C<Xbox360>

=item C<XboxOne>

=item C<PS3>

=item C<PS4>

=item C<PS5>

=item C<SwitchPro>

This hint affects what driver is used, and must be set before calling
C<SDL_Init(SDL_INIT_GAMECONTROLLER)>.

=item C<SDL_HINT_GAMECONTROLLERCONFIG_FILE>

A variable that lets you provide a file with extra gamecontroller db entries.

The file should contain lines of gamecontroller config data, see
SDL_gamecontroller.h

This hint must be set before calling C<SDL_Init(SDL_INIT_GAMECONTROLLER)>

You can update mappings after the system is initialized with