src/events/SDL_touch_c.h
author Alex Szpakowski <slime73@gmail.com>
Sat, 10 Nov 2018 16:15:48 -0400
changeset 12404 eb60e952b13f
parent 11811 5d94cb6b24d3
child 12503 806492103856
permissions -rw-r--r--
Add SDL_TouchDeviceType enum and SDL_GetTouchDeviceType(SDL_TouchID id).

Touch device types include SDL_TOUCH_DEVICE_DIRECT (a touch screen with window-relative coordinates for touches), SDL_TOUCH_DEVICE_INDIRECT_ABSOLUTE (a trackpad-style device with absolute device coordinates), and SDL_TOUCH_DEVICE_INDIRECT_RELATIVE (a trackpad-style device with screen cursor-relative coordinates).

Phone screens are an example of a direct device type. Mac trackpads are the indirect-absolute touch device type. The Apple TV remote is an indirect-relative touch device type.
jim@4640
     1
/*
slouken@5535
     2
  Simple DirectMedia Layer
slouken@11811
     3
  Copyright (C) 1997-2018 Sam Lantinga <slouken@libsdl.org>
jim@4640
     4
slouken@5535
     5
  This software is provided 'as-is', without any express or implied
slouken@5535
     6
  warranty.  In no event will the authors be held liable for any damages
slouken@5535
     7
  arising from the use of this software.
jim@4640
     8
slouken@5535
     9
  Permission is granted to anyone to use this software for any purpose,
slouken@5535
    10
  including commercial applications, and to alter it and redistribute it
slouken@5535
    11
  freely, subject to the following restrictions:
jim@4640
    12
slouken@5535
    13
  1. The origin of this software must not be misrepresented; you must not
slouken@5535
    14
     claim that you wrote the original software. If you use this software
slouken@5535
    15
     in a product, an acknowledgment in the product documentation would be
slouken@5535
    16
     appreciated but is not required.
slouken@5535
    17
  2. Altered source versions must be plainly marked as such, and must not be
slouken@5535
    18
     misrepresented as being the original software.
slouken@5535
    19
  3. This notice may not be removed or altered from any source distribution.
jim@4640
    20
*/
icculus@8093
    21
#include "../SDL_internal.h"
jim@4646
    22
#include "../../include/SDL_touch.h"
jim@4640
    23
slouken@10638
    24
#ifndef SDL_touch_c_h_
slouken@10638
    25
#define SDL_touch_c_h_
jim@4640
    26
slouken@6951
    27
typedef struct SDL_Touch
slouken@6951
    28
{
slouken@6951
    29
    SDL_TouchID id;
slime73@12404
    30
    SDL_TouchDeviceType type;
slouken@6951
    31
    int num_fingers;
slouken@6951
    32
    int max_fingers;
slouken@6951
    33
    SDL_Finger** fingers;
slouken@6951
    34
} SDL_Touch;
jim@4640
    35
jim@4640
    36
jim@4640
    37
/* Initialize the touch subsystem */
jim@4640
    38
extern int SDL_TouchInit(void);
jim@4640
    39
slouken@6951
    40
/* Add a touch, returning the index of the touch, or -1 if there was an error. */
slime73@12404
    41
extern int SDL_AddTouch(SDL_TouchID id, SDL_TouchDeviceType type, const char *name);
slouken@7191
    42
slouken@6951
    43
/* Get the touch with a given id */
jimtla@4678
    44
extern SDL_Touch *SDL_GetTouch(SDL_TouchID id);
jim@4642
    45
slouken@6951
    46
/* Send a touch down/up event for a touch */
slouken@7191
    47
extern int SDL_SendTouch(SDL_TouchID id, SDL_FingerID fingerid,
slouken@7191
    48
                         SDL_bool down, float x, float y, float pressure);
jim@4640
    49
jim@4640
    50
/* Send a touch motion event for a touch */
jimtla@4678
    51
extern int SDL_SendTouchMotion(SDL_TouchID id, SDL_FingerID fingerid,
slouken@7191
    52
                               float x, float y, float pressure);
jim@4640
    53
slouken@6951
    54
/* Remove a touch */
slouken@6951
    55
extern void SDL_DelTouch(SDL_TouchID id);
jim@4640
    56
jim@4640
    57
/* Shutdown the touch subsystem */
jim@4640
    58
extern void SDL_TouchQuit(void);
jim@4640
    59
slouken@10638
    60
#endif /* SDL_touch_c_h_ */
jim@4640
    61
jim@4640
    62
/* vi: set ts=4 sw=4 expandtab: */