mirror of
https://github.com/gnif/LookingGlass.git
synced 2024-09-20 09:21:33 +00:00
c15d0dc672
X11 needs to calibrate to get the best possible latency, as such it needs the scene to render so that the render time of the scene can be accounted for in the delay calculation.
260 lines
7.4 KiB
C
260 lines
7.4 KiB
C
/**
|
|
* Looking Glass
|
|
* Copyright (C) 2017-2021 The Looking Glass Authors
|
|
* https://looking-glass.io
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the Free
|
|
* Software Foundation; either version 2 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
* more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc., 59
|
|
* Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
#ifndef _H_I_DISPLAYSERVER_
|
|
#define _H_I_DISPLAYSERVER_
|
|
|
|
#include <stdbool.h>
|
|
#include <EGL/egl.h>
|
|
#include "common/types.h"
|
|
|
|
typedef enum LG_ClipboardData
|
|
{
|
|
LG_CLIPBOARD_DATA_TEXT = 0,
|
|
LG_CLIPBOARD_DATA_PNG,
|
|
LG_CLIPBOARD_DATA_BMP,
|
|
LG_CLIPBOARD_DATA_TIFF,
|
|
LG_CLIPBOARD_DATA_JPEG,
|
|
|
|
LG_CLIPBOARD_DATA_NONE // enum max, not a data type
|
|
}
|
|
LG_ClipboardData;
|
|
|
|
typedef enum LG_DSProperty
|
|
{
|
|
/**
|
|
* returns the maximum number of samples supported
|
|
* if not implemented LG assumes no multisample support
|
|
* return data type: int
|
|
*/
|
|
LG_DS_MAX_MULTISAMPLE,
|
|
|
|
/**
|
|
* returns if the platform is warp capable
|
|
* if not implemented LG assumes that the platform is warp capable
|
|
* return data type: bool
|
|
*/
|
|
LG_DS_WARP_SUPPORT,
|
|
}
|
|
LG_DSProperty;
|
|
|
|
enum LG_DSWarpSupport
|
|
{
|
|
LG_DS_WARP_NONE,
|
|
LG_DS_WARP_SURFACE,
|
|
LG_DS_WARP_SCREEN,
|
|
};
|
|
|
|
typedef enum LG_DSPointer
|
|
{
|
|
LG_POINTER_NONE = 0,
|
|
LG_POINTER_SQUARE,
|
|
LG_POINTER_ARROW,
|
|
LG_POINTER_INPUT,
|
|
LG_POINTER_MOVE,
|
|
LG_POINTER_RESIZE_NS,
|
|
LG_POINTER_RESIZE_EW,
|
|
LG_POINTER_RESIZE_NESW,
|
|
LG_POINTER_RESIZE_NWSE,
|
|
LG_POINTER_HAND,
|
|
LG_POINTER_NOT_ALLOWED,
|
|
}
|
|
LG_DSPointer;
|
|
|
|
#define LG_POINTER_COUNT (LG_POINTER_NOT_ALLOWED + 1)
|
|
|
|
typedef struct LG_DSInitParams
|
|
{
|
|
const char * title;
|
|
int x, y, w, h;
|
|
bool center;
|
|
bool fullscreen;
|
|
bool resizable;
|
|
bool borderless;
|
|
bool maximize;
|
|
|
|
// if true the renderer requires an OpenGL context
|
|
bool opengl;
|
|
|
|
// x11 needs to know if this is in use so we can decide to setup for
|
|
// presentation times
|
|
bool jitRender;
|
|
}
|
|
LG_DSInitParams;
|
|
|
|
typedef void (* LG_ClipboardReplyFn)(void * opaque, const LG_ClipboardData type,
|
|
uint8_t * data, uint32_t size);
|
|
|
|
typedef struct LG_DSGLContext
|
|
* LG_DSGLContext;
|
|
|
|
typedef struct LGEvent LGEvent;
|
|
|
|
struct LG_DisplayServerOps
|
|
{
|
|
/* called before options are parsed, useful for registering options */
|
|
void (*setup)(void);
|
|
|
|
/* return true if the selected ds is valid for the current platform */
|
|
bool (*probe)(void);
|
|
|
|
/* called before anything has been initialized */
|
|
bool (*earlyInit)(void);
|
|
|
|
/* called when it's time to create and show the application window */
|
|
bool (*init)(const LG_DSInitParams params);
|
|
|
|
/* called at startup after window creation, renderer and SPICE is ready */
|
|
void (*startup)();
|
|
|
|
/* called just before final window destruction, before final free */
|
|
void (*shutdown)();
|
|
|
|
/* final free */
|
|
void (*free)();
|
|
|
|
/*
|
|
* return a system specific property, returns false if unsupported or failure
|
|
* if the platform does not support/implement the requested property the value
|
|
* of `ret` must not be altered.
|
|
*/
|
|
bool (*getProp)(LG_DSProperty prop, void * ret);
|
|
|
|
#ifdef ENABLE_EGL
|
|
/* EGL support */
|
|
EGLDisplay (*getEGLDisplay)(void);
|
|
EGLNativeWindowType (*getEGLNativeWindow)(void);
|
|
void (*eglSwapBuffers)(EGLDisplay display, EGLSurface surface, const struct Rect * damage, int count);
|
|
#endif
|
|
|
|
#ifdef ENABLE_OPENGL
|
|
/* opengl platform specific methods */
|
|
LG_DSGLContext (*glCreateContext)(void);
|
|
void (*glDeleteContext)(LG_DSGLContext context);
|
|
void (*glMakeCurrent)(LG_DSGLContext context);
|
|
void (*glSetSwapInterval)(int interval);
|
|
void (*glSwapBuffers)(void);
|
|
#endif
|
|
|
|
/* Waits for a good time to render the next frame in time for the next vblank.
|
|
* This is optional and a display server may choose to not implement it.
|
|
*
|
|
* return true to force the frame to be rendered, this is used by X11 for
|
|
* calibration */
|
|
bool (*waitFrame)(void);
|
|
|
|
/* This must be called when waitFrame returns, but no frame is actually rendered. */
|
|
void (*skipFrame)(void);
|
|
|
|
/* This is used to interrupt waitFrame. */
|
|
void (*stopWaitFrame)(void);
|
|
|
|
/* dm specific cursor implementations */
|
|
void (*guestPointerUpdated)(double x, double y, double localX, double localY);
|
|
void (*setPointer)(LG_DSPointer pointer);
|
|
void (*grabKeyboard)();
|
|
void (*ungrabKeyboard)();
|
|
/* (un)grabPointer is used to toggle cursor tracking/confine in normal mode */
|
|
void (*grabPointer)();
|
|
void (*ungrabPointer)();
|
|
/* (un)capturePointer is used do toggle special cursor tracking in capture mode */
|
|
void (*capturePointer)();
|
|
void (*uncapturePointer)();
|
|
|
|
/* exiting = true if the warp is to leave the window */
|
|
void (*warpPointer)(int x, int y, bool exiting);
|
|
|
|
/* called when the client needs to realign the pointer. This should simply
|
|
* call the appropriate app_handleMouse* method for the platform with zero
|
|
* deltas */
|
|
void (*realignPointer)();
|
|
|
|
/* returns true if the position specified is actually valid */
|
|
bool (*isValidPointerPos)(int x, int y);
|
|
|
|
/* called to disable/enable the screensaver */
|
|
void (*inhibitIdle)();
|
|
void (*uninhibitIdle)();
|
|
|
|
/* wait for the specified time without blocking UI processing/event loops */
|
|
void (*wait)(unsigned int time);
|
|
|
|
/* get/set the window dimensions & state */
|
|
void (*setWindowSize)(int x, int y);
|
|
bool (*getFullscreen)(void);
|
|
void (*setFullscreen)(bool fs);
|
|
void (*minimize)(void);
|
|
|
|
/* clipboard support, optional, if not supported set to NULL */
|
|
bool (*cbInit)(void);
|
|
void (*cbNotice)(LG_ClipboardData type);
|
|
void (*cbRelease)(void);
|
|
void (*cbRequest)(LG_ClipboardData type);
|
|
};
|
|
|
|
#ifdef ENABLE_EGL
|
|
#define ASSERT_EGL_FN(x) assert(x);
|
|
#else
|
|
#define ASSERT_EGL_FN(x)
|
|
#endif
|
|
|
|
#ifdef ENABLE_OPENGL
|
|
#define ASSERT_OPENGL_FN(x) assert(x)
|
|
#else
|
|
#define ASSERT_OPENGL_FN(x)
|
|
#endif
|
|
|
|
#define ASSERT_LG_DS_VALID(x) \
|
|
assert((x)->setup ); \
|
|
assert((x)->probe ); \
|
|
assert((x)->earlyInit ); \
|
|
assert((x)->init ); \
|
|
assert((x)->startup ); \
|
|
assert((x)->shutdown ); \
|
|
assert((x)->free ); \
|
|
assert((x)->getProp ); \
|
|
ASSERT_EGL_FN((x)->getEGLDisplay ); \
|
|
ASSERT_EGL_FN((x)->getEGLNativeWindow ); \
|
|
ASSERT_EGL_FN((x)->eglSwapBuffers ); \
|
|
ASSERT_OPENGL_FN((x)->glCreateContext ); \
|
|
ASSERT_OPENGL_FN((x)->glDeleteContext ); \
|
|
ASSERT_OPENGL_FN((x)->glMakeCurrent ); \
|
|
ASSERT_OPENGL_FN((x)->glSetSwapInterval); \
|
|
ASSERT_OPENGL_FN((x)->glSwapBuffers ); \
|
|
assert(!(x)->waitFrame == !(x)->stopWaitFrame); \
|
|
assert((x)->guestPointerUpdated); \
|
|
assert((x)->setPointer ); \
|
|
assert((x)->grabPointer ); \
|
|
assert((x)->ungrabPointer ); \
|
|
assert((x)->capturePointer ); \
|
|
assert((x)->uncapturePointer ); \
|
|
assert((x)->warpPointer ); \
|
|
assert((x)->realignPointer ); \
|
|
assert((x)->isValidPointerPos ); \
|
|
assert((x)->inhibitIdle ); \
|
|
assert((x)->uninhibitIdle ); \
|
|
assert((x)->wait ); \
|
|
assert((x)->setWindowSize ); \
|
|
assert((x)->setFullscreen ); \
|
|
assert((x)->getFullscreen ); \
|
|
assert((x)->minimize );
|
|
|
|
#endif
|