/* * Copyright © 2000 Compaq Computer Corporation * Copyright © 2002 Hewlett-Packard Company * Copyright © 2006 Intel Corporation * * Permission to use, copy, modify, distribute, and sell this software and its * documentation for any purpose is hereby granted without fee, provided that * the above copyright notice appear in all copies and that both that copyright * notice and this permission notice appear in supporting documentation, and * that the name of the copyright holders not be used in advertising or * publicity pertaining to distribution of the software without specific, * written prior permission. The copyright holders make no representations * about the suitability of this software for any purpose. It is provided "as * is" without express or implied warranty. * * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE * OF THIS SOFTWARE. * * Author: Jim Gettys, Hewlett-Packard Company, Inc. * Keith Packard, Intel Corporation */ #ifdef HAVE_DIX_CONFIG_H #include #endif #ifndef _RANDRSTR_H_ #define _RANDRSTR_H_ #include #include #include "misc.h" #include "os.h" #include "dixstruct.h" #include "resource.h" #include "scrnintstr.h" #include "windowstr.h" #include "pixmapstr.h" #include "extnsionst.h" #include "servermd.h" #include #include #include /* we share subpixel order information */ #include "picturestr.h" #include /* required for ABI compatibility for now */ #define RANDR_10_INTERFACE 1 #define RANDR_12_INTERFACE 1 typedef XID RRMode; typedef XID RROutput; typedef XID RRCrtc; extern int RREventBase, RRErrorBase; extern int (*ProcRandrVector[RRNumberRequests]) (ClientPtr); extern int (*SProcRandrVector[RRNumberRequests]) (ClientPtr); /* * Modeline for a monitor. Name follows directly after this struct */ #define RRModeName(pMode) ((char *) (pMode + 1)) typedef struct _rrMode RRModeRec, *RRModePtr; typedef struct _rrPropertyValue RRPropertyValueRec, *RRPropertyValuePtr; typedef struct _rrProperty RRPropertyRec, *RRPropertyPtr; typedef struct _rrCrtc RRCrtcRec, *RRCrtcPtr; typedef struct _rrOutput RROutputRec, *RROutputPtr; struct _rrMode { int refcnt; xRRModeInfo mode; char *name; void *devPrivate; Bool userDefined; }; struct _rrPropertyValue { Atom type; /* ignored by server */ short format; /* format of data for swapping - 8,16,32 */ long size; /* size of data in (format/8) bytes */ pointer data; /* private to client */ }; struct _rrProperty { RRPropertyPtr next; ATOM propertyName; Bool is_pending; Bool range; Bool immutable; int num_valid; INT32 *valid_values; RRPropertyValueRec current, pending; }; struct _rrCrtc { RRCrtc id; ScreenPtr pScreen; RRModePtr mode; int x, y; Rotation rotation; Rotation rotations; Bool changed; int numOutputs; RROutputPtr *outputs; int gammaSize; CARD16 *gammaRed; CARD16 *gammaBlue; CARD16 *gammaGreen; void *devPrivate; }; struct _rrOutput { RROutput id; ScreenPtr pScreen; char *name; int nameLength; CARD8 connection; CARD8 subpixelOrder; int mmWidth; int mmHeight; RRCrtcPtr crtc; int numCrtcs; RRCrtcPtr *crtcs; int numClones; RROutputPtr *clones; int numModes; int numPreferred; RRModePtr *modes; Bool changed; RRPropertyPtr properties; void *devPrivate; }; #if RANDR_12_INTERFACE typedef Bool (*RRScreenSetSizeProcPtr) (ScreenPtr pScreen, CARD16 width, CARD16 height, CARD32 mmWidth, CARD32 mmHeight); typedef Bool (*RRCrtcSetProcPtr) (ScreenPtr pScreen, RRCrtcPtr crtc, RRModePtr mode, int x, int y, Rotation rotation, int numOutputs, RROutputPtr * outputs); typedef Bool (*RRCrtcSetGammaProcPtr) (ScreenPtr pScreen, RRCrtcPtr crtc); typedef Bool (*RROutputSetPropertyProcPtr) (ScreenPtr pScreen, RROutputPtr output, Atom property, RRPropertyValuePtr value); #endif typedef Bool (*RRGetInfoProcPtr) (ScreenPtr pScreen, Rotation * rotations); typedef Bool (*RRCloseScreenProcPtr) (int i, ScreenPtr pscreen); /* These are for 1.0 compatibility */ typedef struct _rrRefresh { CARD16 rate; RRModePtr mode; } RRScreenRate, *RRScreenRatePtr; typedef struct _rrScreenSize { int id; short width, height; short mmWidth, mmHeight; int nRates; RRScreenRatePtr pRates; } RRScreenSize, *RRScreenSizePtr; #ifdef RANDR_10_INTERFACE typedef Bool (*RRSetConfigProcPtr) (ScreenPtr pScreen, Rotation rotation, int rate, RRScreenSizePtr pSize); #endif typedef struct _rrScrPriv { /* * 'public' part of the structure; DDXen fill this in * as they initialize */ #if RANDR_10_INTERFACE RRSetConfigProcPtr rrSetConfig; #endif RRGetInfoProcPtr rrGetInfo; #if RANDR_12_INTERFACE RRScreenSetSizeProcPtr rrScreenSetSize; RRCrtcSetProcPtr rrCrtcSet; RRCrtcSetGammaProcPtr rrCrtcSetGamma; RROutputSetPropertyProcPtr rrOutputSetProperty; #endif /* * Private part of the structure; not considered part of the ABI */ TimeStamp lastSetTime; /* last changed by client */ TimeStamp lastConfigTime; /* possible configs changed */ RRCloseScreenProcPtr CloseScreen; Bool changed; /* some config changed */ Bool configChanged; /* configuration changed */ Bool layoutChanged; /* screen layout changed */ CARD16 minWidth, minHeight; CARD16 maxWidth, maxHeight; CARD16 width, height; /* last known screen size */ CARD16 mmWidth, mmHeight; /* last known screen size */ int numOutputs; RROutputPtr *outputs; int numCrtcs; RRCrtcPtr *crtcs; /* Last known pointer position */ RRCrtcPtr pointerCrtc; #ifdef RANDR_10_INTERFACE /* * Configuration information */ Rotation rotations; CARD16 reqWidth, reqHeight; int nSizes; RRScreenSizePtr pSizes; Rotation rotation; int rate; int size; #endif } rrScrPrivRec, *rrScrPrivPtr; extern int rrPrivIndex; #define rrGetScrPriv(pScr) ((rrScrPrivPtr) (pScr)->devPrivates[rrPrivIndex].ptr) #define rrScrPriv(pScr) rrScrPrivPtr pScrPriv = rrGetScrPriv(pScr) #define SetRRScreen(s,p) ((s)->devPrivates[rrPrivIndex].ptr = (pointer) (p)) /* * each window has a list of clients requesting * RRNotify events. Each client has a resource * for each window it selects RRNotify input for, * this resource is used to delete the RRNotifyRec * entry from the per-window queue. */ typedef struct _RREvent *RREventPtr; typedef struct _RREvent { RREventPtr next; ClientPtr client; WindowPtr window; XID clientResource; int mask; } RREventRec; typedef struct _RRTimes { TimeStamp setTime; TimeStamp configTime; } RRTimesRec, *RRTimesPtr; typedef struct _RRClient { int major_version; int minor_version; /* RRTimesRec times[0]; */ } RRClientRec, *RRClientPtr; extern RESTYPE RRClientType, RREventType; /* resource types for event masks */ extern int RRClientPrivateIndex; extern RESTYPE RRCrtcType, RRModeType, RROutputType; #define LookupOutput(client,id,a) ((RROutputPtr) \ (SecurityLookupIDByType (client, id, \ RROutputType, a))) #define LookupCrtc(client,id,a) ((RRCrtcPtr) \ (SecurityLookupIDByType (client, id, \ RRCrtcType, a))) #define LookupMode(client,id,a) ((RRModePtr) \ (SecurityLookupIDByType (client, id, \ RRModeType, a))) #define GetRRClient(pClient) ((RRClientPtr) (pClient)->devPrivates[RRClientPrivateIndex].ptr) #define rrClientPriv(pClient) RRClientPtr pRRClient = GetRRClient(pClient) /* Initialize the extension */ void RRExtensionInit(void); #ifdef RANDR_12_INTERFACE /* * Set the range of sizes for the screen */ void RRScreenSetSizeRange(ScreenPtr pScreen, CARD16 minWidth, CARD16 minHeight, CARD16 maxWidth, CARD16 maxHeight); #endif /* rrscreen.c */ /* * Notify the extension that the screen size has been changed. * The driver is responsible for calling this whenever it has changed * the size of the screen */ void RRScreenSizeNotify(ScreenPtr pScreen); /* * Request that the screen be resized */ Bool RRScreenSizeSet(ScreenPtr pScreen, CARD16 width, CARD16 height, CARD32 mmWidth, CARD32 mmHeight); /* * Send ConfigureNotify event to root window when 'something' happens */ void RRSendConfigNotify(ScreenPtr pScreen); /* * screen dispatch */ int ProcRRGetScreenSizeRange(ClientPtr client); int ProcRRSetScreenSize(ClientPtr client); int ProcRRGetScreenResources(ClientPtr client); int ProcRRSetScreenConfig(ClientPtr client); int ProcRRGetScreenInfo(ClientPtr client); /* * Deliver a ScreenNotify event */ void RRDeliverScreenEvent(ClientPtr client, WindowPtr pWin, ScreenPtr pScreen); /* mirandr.c */ Bool miRandRInit(ScreenPtr pScreen); Bool miRRGetInfo(ScreenPtr pScreen, Rotation * rotations); Bool miRRGetScreenInfo(ScreenPtr pScreen); Bool miRRCrtcSet(ScreenPtr pScreen, RRCrtcPtr crtc, RRModePtr mode, int x, int y, Rotation rotation, int numOutput, RROutputPtr * outputs); Bool miRROutputSetProperty(ScreenPtr pScreen, RROutputPtr output, Atom property, RRPropertyValuePtr value); /* randr.c */ /* * Send all pending events */ void RRTellChanged(ScreenPtr pScreen); /* * Poll the driver for changed information */ Bool RRGetInfo(ScreenPtr pScreen); Bool RRInit(void); Bool RRScreenInit(ScreenPtr pScreen); RROutputPtr RRFirstOutput(ScreenPtr pScreen); Rotation RRGetRotation(ScreenPtr pScreen); CARD16 RRVerticalRefresh(xRRModeInfo * mode); #ifdef RANDR_10_INTERFACE /* * This is the old interface, deprecated but left * around for compatibility */ /* * Then, register the specific size with the screen */ RRScreenSizePtr RRRegisterSize(ScreenPtr pScreen, short width, short height, short mmWidth, short mmHeight); Bool RRRegisterRate(ScreenPtr pScreen, RRScreenSizePtr pSize, int rate); /* * Finally, set the current configuration of the screen */ void RRSetCurrentConfig(ScreenPtr pScreen, Rotation rotation, int rate, RRScreenSizePtr pSize); Bool RRScreenInit(ScreenPtr pScreen); Rotation RRGetRotation(ScreenPtr pScreen); int RRSetScreenConfig(ScreenPtr pScreen, Rotation rotation, int rate, RRScreenSizePtr pSize); #endif /* rrcrtc.c */ /* * Notify the CRTC of some change; layoutChanged indicates that * some position or size element changed */ void RRCrtcChanged(RRCrtcPtr crtc, Bool layoutChanged); /* * Create a CRTC */ RRCrtcPtr RRCrtcCreate(void *devPrivate); /* * Set the allowed rotations on a CRTC */ void RRCrtcSetRotations(RRCrtcPtr crtc, Rotation rotations); /* * Attach a CRTC to a screen. Once done, this cannot be * undone without destroying the CRTC; it is separate from Create * only to allow an xf86-based driver to create objects in preinit */ Bool RRCrtcAttachScreen(RRCrtcPtr crtc, ScreenPtr pScreen); /* * Notify the extension that the Crtc has been reconfigured, * the driver calls this whenever it has updated the mode */ Bool RRCrtcNotify(RRCrtcPtr crtc, RRModePtr mode, int x, int y, Rotation rotation, int numOutputs, RROutputPtr * outputs); void RRDeliverCrtcEvent(ClientPtr client, WindowPtr pWin, RRCrtcPtr crtc); /* * Request that the Crtc be reconfigured */ Bool RRCrtcSet(RRCrtcPtr crtc, RRModePtr mode, int x, int y, Rotation rotation, int numOutput, RROutputPtr * outputs); /* * Request that the Crtc gamma be changed */ Bool RRCrtcGammaSet(RRCrtcPtr crtc, CARD16 *red, CARD16 *green, CARD16 *blue); /* * Notify the extension that the Crtc gamma has been changed * The driver calls this whenever it has changed the gamma values * in the RRCrtcRec */ Bool RRCrtcGammaNotify(RRCrtcPtr crtc); /* * Set the size of the gamma table at server startup time */ Bool RRCrtcGammaSetSize(RRCrtcPtr crtc, int size); void RRCrtcGetScanoutSize(RRCrtcPtr crtc, int *width, int *height); /* * Destroy a Crtc at shutdown */ void RRCrtcDestroy(RRCrtcPtr crtc); /* * Initialize crtc type */ Bool RRCrtcInit(void); /* * Crtc dispatch */ int ProcRRGetCrtcInfo(ClientPtr client); int ProcRRSetCrtcConfig(ClientPtr client); int ProcRRGetCrtcGammaSize(ClientPtr client); int ProcRRGetCrtcGamma(ClientPtr client); int ProcRRSetCrtcGamma(ClientPtr client); /* rrdispatch.c */ Bool RRClientKnowsRates(ClientPtr pClient); /* rrmode.c */ /* * Find, and if necessary, create a mode */ RRModePtr RRModeGet(xRRModeInfo * modeInfo, const char *name); void RRModePruneUnused(ScreenPtr pScreen); /* * Destroy a mode. */ void RRModeDestroy(RRModePtr mode); /* * Return a list of modes that are valid for some output in pScreen */ RRModePtr *RRModesForScreen(ScreenPtr pScreen, int *num_ret); /* * Initialize mode type */ Bool RRModeInit(void); int ProcRRCreateMode(ClientPtr client); int ProcRRDestroyMode(ClientPtr client); int ProcRRAddOutputMode(ClientPtr client); int ProcRRDeleteOutputMode(ClientPtr client); /* rroutput.c */ /* * Notify the output of some change. configChanged indicates whether * any external configuration (mode list, clones, connected status) * has changed, or whether the change was strictly internal * (which crtc is in use) */ void RROutputChanged(RROutputPtr output, Bool configChanged); /* * Create an output */ RROutputPtr RROutputCreate(const char *name, int nameLength, void *devPrivate); /* * Attach an output to a screen, again split from creation so * xf86 DDXen can create randr resources before the ScreenRec * exists */ Bool RROutputAttachScreen(RROutputPtr output, ScreenPtr pScreen); /* * Notify extension that output parameters have been changed */ Bool RROutputSetClones(RROutputPtr output, RROutputPtr * clones, int numClones); Bool RROutputSetModes(RROutputPtr output, RRModePtr * modes, int numModes, int numPreferred); Bool RROutputSetCrtcs(RROutputPtr output, RRCrtcPtr * crtcs, int numCrtcs); void RROutputSetCrtc(RROutputPtr output, RRCrtcPtr crtc); Bool RROutputSetConnection(RROutputPtr output, CARD8 connection); Bool RROutputSetSubpixelOrder(RROutputPtr output, int subpixelOrder); Bool RROutputSetPhysicalSize(RROutputPtr output, int mmWidth, int mmHeight); void RRDeliverOutputEvent(ClientPtr client, WindowPtr pWin, RROutputPtr output); void RROutputDestroy(RROutputPtr output); int ProcRRGetOutputInfo(ClientPtr client); /* * Initialize output type */ Bool RROutputInit(void); /* rrpointer.c */ void RRPointerMoved(ScreenPtr pScreen, int x, int y); void RRPointerScreenConfigured(ScreenPtr pScreen); /* rrproperty.c */ void RRDeleteAllOutputProperties(RROutputPtr output); RRPropertyValuePtr RRGetOutputProperty(RROutputPtr output, Atom property, Bool pending); RRPropertyPtr RRQueryOutputProperty(RROutputPtr output, Atom property); void RRDeleteOutputProperty(RROutputPtr output, Atom property); int RRChangeOutputProperty(RROutputPtr output, Atom property, Atom type, int format, int mode, unsigned long len, pointer value, Bool sendevent); int RRConfigureOutputProperty(RROutputPtr output, Atom property, Bool pending, Bool range, Bool immutable, int num_values, INT32 *values); int ProcRRChangeOutputProperty(ClientPtr client); int ProcRRGetOutputProperty(ClientPtr client); int ProcRRListOutputProperties(ClientPtr client); int ProcRRQueryOutputProperty(ClientPtr client); int ProcRRConfigureOutputProperty(ClientPtr client); int ProcRRDeleteOutputProperty(ClientPtr client); /* rrxinerama.c */ void RRXineramaExtensionInit(void); #endif /* _RANDRSTR_H_ */ /* randr extension implementation structure Query state: ProcRRGetScreenInfo/ProcRRGetScreenResources RRGetInfo • Request configuration from driver, either 1.0 or 1.2 style • These functions only record state changes, all other actions are pended until RRTellChanged is called ->rrGetInfo 1.0: RRRegisterSize RRRegisterRate RRSetCurrentConfig 1.2: RRScreenSetSizeRange RROutputSetCrtcs RROutputSetCrtc RRModeGet RROutputSetModes RROutputSetConnection RROutputSetSubpixelOrder RROutputSetClones RRCrtcNotify • Must delay scanning configuration until after ->rrGetInfo returns because some drivers will call SetCurrentConfig in the middle of the ->rrGetInfo operation. 1.0: • Scan old configuration, mirror to new structures RRScanOldConfig RRCrtcCreate RROutputCreate RROutputSetCrtcs RROutputSetCrtc RROutputSetConnection RROutputSetSubpixelOrder RROldModeAdd • This adds modes one-at-a-time RRModeGet RRCrtcNotify • send events, reset pointer if necessary RRTellChanged WalkTree (sending events) • when layout has changed: RRPointerScreenConfigured RRSendConfigNotify Asynchronous state setting (1.2 only) When setting state asynchronously, the driver invokes the ->rrGetInfo function and then calls RRTellChanged to flush the changes to the clients and reset pointer if necessary Set state ProcRRSetScreenConfig RRCrtcSet 1.2: ->rrCrtcSet RRCrtcNotify 1.0: ->rrSetConfig RRCrtcNotify RRTellChanged */