/*
    PsychToolbox3/Source/Linux/Screen/PsychWindowGlue.h

    PLATFORMS:

        This is the Linux/X11 version only.

    AUTHORS:

        Mario Kleiner       mk      mario.kleiner.de@gmail.com

    HISTORY:

        2/20/06             mk      Created - Derived from Windows version.

    DESCRIPTION:

        Functions in this file comprise an abstraction layer for probing and controlling window state, except for window content.

        Each C function which implements a particular Screen subcommand should be platform neutral.  For example, the source to SCREENPixelSizes()
        should be platform-neutral, despite that the calls in OS X and Linux to detect available pixel sizes are different.  The platform
        specificity is abstracted out in C files which end it "Glue", for example PsychScreenGlue, PsychWindowGlue, PsychWindowTextClue.

*/

//include once
#ifndef PSYCH_IS_INCLUDED_PsychWindowGlue
#define PSYCH_IS_INCLUDED_PsychWindowGlue

#include "Screen.h"

psych_bool  PsychRealtimePriority(psych_bool enable_realtime);
psych_bool  PsychOSOpenOnscreenWindow(PsychScreenSettingsType *screenSettings, PsychWindowRecordType *windowRecord, int numBuffers, int stereomode, int conserveVRAM);
void        PsychOSCloseOnscreenWindow(PsychWindowRecordType *windowRecord);
void        PsychOSCloseWindow(PsychWindowRecordType *windowRecord);
void        PsychOSFlipWindowBuffers(PsychWindowRecordType *windowRecord);
void        PsychOSSetVBLSyncLevel(PsychWindowRecordType *windowRecord, int swapInterval);
void        PsychOSSetGLContext(PsychWindowRecordType *windowRecord);
void        PsychOSUnsetGLContext(PsychWindowRecordType *windowRecord);
void        PsychOSSetUserGLContext(PsychWindowRecordType *windowRecord, psych_bool copyfromPTBContext);
double      PsychOSGetVBLTimeAndCount(PsychWindowRecordType *windowRecord, psych_uint64* vblCount);
psych_bool  PsychOSSetupFrameLock(PsychWindowRecordType *masterWindow, PsychWindowRecordType *slaveWindow);
psych_int64 PsychOSScheduleFlipWindowBuffers(PsychWindowRecordType *windowRecord, double tWhen, psych_int64 targetMSC, psych_int64 divisor, psych_int64 remainder, unsigned int specialFlags);
psych_int64 PsychOSGetSwapCompletionTimestamp(PsychWindowRecordType *windowRecord, psych_int64 targetSBC, double* tSwap);
psych_bool  PsychOSEnablePresentEventReception(PsychWindowRecordType *windowRecord, int forCompositor, psych_bool enable);
void        PsychOSProcessEvents(PsychWindowRecordType *windowRecord, int flags);
double      PsychOSAdjustForCompositorDelay(PsychWindowRecordType *windowRecord, double targetTime, psych_bool onlyForCalibration);
psych_bool  PsychVRRActive(PsychWindowRecordType *windowRecord);
psych_bool  PsychOSConstrainPointer(PsychWindowRecordType *windowRecord, psych_bool constrain, PsychRectType rect);

// Special query function, only defined on Linux/X11:
int         PsychGetXScreenIdForScreen(int screenNumber);

// Special OpenML init and test, only defined on Linux/X11:
void        PsychOSInitializeOpenML(PsychWindowRecordType *windowRecord);

// Special logging function, Linux/X11 only:
psych_bool PsychOSSwapCompletionLogging(PsychWindowRecordType *windowRecord, int cmd, int aux1);
psych_bool PsychOSEnableX11ClientCompositorSync(PsychWindowRecordType *windowRecord);
psych_bool PsychOSX11ClientCompositorSyncEnabled(PsychWindowRecordType *windowRecord);

// Linux/X11 only: Ensure that video outputs are properly configured to reproduce at least min_bpc framebuffer output precision:
psych_bool PsychOSEnsureMinimumOutputPrecision(int screenNumber, int min_bpc);

//end include once
#endif
