randr/randrstr.h

   1 /*
   2  * Copyright © 2000 Compaq Computer Corporation
   3  * Copyright © 2002 Hewlett-Packard Company
   4  * Copyright © 2006 Intel Corporation
   5  * Copyright © 2008 Red Hat, Inc.
   6  *
   7  * Permission to use, copy, modify, distribute, and sell this software and its
   8  * documentation for any purpose is hereby granted without fee, provided that
   9  * the above copyright notice appear in all copies and that both that copyright
  10  * notice and this permission notice appear in supporting documentation, and
  11  * that the name of the copyright holders not be used in advertising or
  12  * publicity pertaining to distribution of the software without specific,
  13  * written prior permission.  The copyright holders make no representations
  14  * about the suitability of this software for any purpose.  It is provided "as
  15  * is" without express or implied warranty.
  16  *
  17  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  18  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  19  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  20  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  21  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  22  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  23  * OF THIS SOFTWARE.
  24  *
  25  * Author:  Jim Gettys, Hewlett-Packard Company, Inc.
  26  *          Keith Packard, Intel Corporation
  27  */
  28
  29 #ifdef HAVE_DIX_CONFIG_H
  30 #include <dix-config.h>
  31 #endif
  32
  33 #ifndef _RANDRSTR_H_
  34 #define _RANDRSTR_H_
  35
  36 #include <X11/X.h>
  37 #include <X11/Xproto.h>
  38 #include "misc.h"
  39 #include "os.h"
  40 #include "dixstruct.h"
  41 #include "resource.h"
  42 #include "scrnintstr.h"
  43 #include "windowstr.h"
  44 #include "pixmapstr.h"
  45 #include "extnsionst.h"
  46 #include "servermd.h"
  47 #include "rrtransform.h"
  48 #include <X11/extensions/randr.h>
  49 #include <X11/extensions/randrproto.h>
  50 #include <X11/extensions/render.h>      /* we share subpixel order information */
  51 #include "picturestr.h"
  52 #include <X11/Xfuncproto.h>
  53
  54 /* required for ABI compatibility for now */
  55 #define RANDR_10_INTERFACE 1
  56 #define RANDR_12_INTERFACE 1
  57 #define RANDR_13_INTERFACE 1    /* requires RANDR_12_INTERFACE */
  58 #define RANDR_GET_CRTC_INTERFACE 1
  59
  60 #define RANDR_INTERFACE_VERSION 0x0103
  61
  62 typedef XID RRMode;
  63 typedef XID RROutput;
  64 typedef XID RRCrtc;
  65
  66 extern _X_EXPORT int RREventBase, RRErrorBase;
  67
  68 extern _X_EXPORT int (*ProcRandrVector[RRNumberRequests]) (ClientPtr);
  69 extern _X_EXPORT int (*SProcRandrVector[RRNumberRequests]) (ClientPtr);
  70
  71 /*
  72  * Modeline for a monitor. Name follows directly after this struct
  73  */
  74
  75 #define RRModeName(pMode) ((char *) (pMode + 1))
  76 typedef struct _rrMode RRModeRec, *RRModePtr;
  77 typedef struct _rrPropertyValue RRPropertyValueRec, *RRPropertyValuePtr;
  78 typedef struct _rrProperty RRPropertyRec, *RRPropertyPtr;
  79 typedef struct _rrCrtc RRCrtcRec, *RRCrtcPtr;
  80 typedef struct _rrOutput RROutputRec, *RROutputPtr;
  81
  82 struct _rrMode {
  83     int refcnt;
  84     xRRModeInfo mode;
  85     char *name;
  86     ScreenPtr userScreen;
  87 };
  88
  89 struct _rrPropertyValue {
  90     Atom type;                  /* ignored by server */
  91     short format;               /* format of data for swapping - 8,16,32 */
  92     long size;                  /* size of data in (format/8) bytes */
  93     pointer data;               /* private to client */
  94 };
  95
  96 struct _rrProperty {
  97     RRPropertyPtr next;
  98     ATOM propertyName;
  99     Bool is_pending;
 100     Bool range;
 101     Bool immutable;
 102     int num_valid;
 103     INT32 *valid_values;
 104     RRPropertyValueRec current, pending;
 105 };
 106
 107 struct _rrCrtc {
 108     RRCrtc id;
 109     ScreenPtr pScreen;
 110     RRModePtr mode;
 111     int x, y;
 112     Rotation rotation;
 113     Rotation rotations;
 114     Bool changed;
 115     int numOutputs;
 116     RROutputPtr *outputs;
 117     int gammaSize;
 118     CARD16 *gammaRed;
 119     CARD16 *gammaBlue;
 120     CARD16 *gammaGreen;
 121     void *devPrivate;
 122     Bool transforms;
 123     RRTransformRec client_pending_transform;
 124     RRTransformRec client_current_transform;
 125     PictTransform transform;
 126     struct pict_f_transform f_transform;
 127     struct pict_f_transform f_inverse;
 128 };
 129
 130 struct _rrOutput {
 131     RROutput id;
 132     ScreenPtr pScreen;
 133     char *name;
 134     int nameLength;
 135     CARD8 connection;
 136     CARD8 subpixelOrder;
 137     int mmWidth;
 138     int mmHeight;
 139     RRCrtcPtr crtc;
 140     int numCrtcs;
 141     RRCrtcPtr *crtcs;
 142     int numClones;
 143     RROutputPtr *clones;
 144     int numModes;
 145     int numPreferred;
 146     RRModePtr *modes;
 147     int numUserModes;
 148     RRModePtr *userModes;
 149     Bool changed;
 150     RRPropertyPtr properties;
 151     Bool pendingProperties;
 152     void *devPrivate;
 153 };
 154
 155 #if RANDR_12_INTERFACE
 156 typedef Bool (*RRScreenSetSizeProcPtr) (ScreenPtr pScreen,
 157                                         CARD16 width,
 158                                         CARD16 height,
 159                                         CARD32 mmWidth, CARD32 mmHeight);
 160
 161 typedef Bool (*RRCrtcSetProcPtr) (ScreenPtr pScreen,
 162                                   RRCrtcPtr crtc,
 163                                   RRModePtr mode,
 164                                   int x,
 165                                   int y,
 166                                   Rotation rotation,
 167                                   int numOutputs, RROutputPtr * outputs);
 168
 169 typedef Bool (*RRCrtcSetGammaProcPtr) (ScreenPtr pScreen, RRCrtcPtr crtc);
 170
 171 typedef Bool (*RRCrtcGetGammaProcPtr) (ScreenPtr pScreen, RRCrtcPtr crtc);
 172
 173 typedef Bool (*RROutputSetPropertyProcPtr) (ScreenPtr pScreen,
 174                                             RROutputPtr output,
 175                                             Atom property,
 176                                             RRPropertyValuePtr value);
 177
 178 typedef Bool (*RROutputValidateModeProcPtr) (ScreenPtr pScreen,
 179                                              RROutputPtr output,
 180                                              RRModePtr mode);
 181
 182 typedef void (*RRModeDestroyProcPtr) (ScreenPtr pScreen, RRModePtr mode);
 183
 184 #endif
 185
 186 #if RANDR_13_INTERFACE
 187 typedef Bool (*RROutputGetPropertyProcPtr) (ScreenPtr pScreen,
 188                                             RROutputPtr output, Atom property);
 189 typedef Bool (*RRGetPanningProcPtr) (ScreenPtr pScrn,
 190                                      RRCrtcPtr crtc,
 191                                      BoxPtr totalArea,
 192                                      BoxPtr trackingArea, INT16 *border);
 193 typedef Bool (*RRSetPanningProcPtr) (ScreenPtr pScrn,
 194                                      RRCrtcPtr crtc,
 195                                      BoxPtr totalArea,
 196                                      BoxPtr trackingArea, INT16 *border);
 197
 198 #endif                          /* RANDR_13_INTERFACE */
 199
 200 typedef Bool (*RRGetInfoProcPtr) (ScreenPtr pScreen, Rotation * rotations);
 201 typedef Bool (*RRCloseScreenProcPtr) (int i, ScreenPtr pscreen);
 202
 203 /* These are for 1.0 compatibility */
 204
 205 typedef struct _rrRefresh {
 206     CARD16 rate;
 207     RRModePtr mode;
 208 } RRScreenRate, *RRScreenRatePtr;
 209
 210 typedef struct _rrScreenSize {
 211     int id;
 212     short width, height;
 213     short mmWidth, mmHeight;
 214     int nRates;
 215     RRScreenRatePtr pRates;
 216 } RRScreenSize, *RRScreenSizePtr;
 217
 218 #ifdef RANDR_10_INTERFACE
 219
 220 typedef Bool (*RRSetConfigProcPtr) (ScreenPtr pScreen,
 221                                     Rotation rotation,
 222                                     int rate, RRScreenSizePtr pSize);
 223
 224 #endif
 225
 226 typedef struct _rrScrPriv {
 227     /*
 228      * 'public' part of the structure; DDXen fill this in
 229      * as they initialize
 230      */
 231 #if RANDR_10_INTERFACE
 232     RRSetConfigProcPtr rrSetConfig;
 233 #endif
 234     RRGetInfoProcPtr rrGetInfo;
 235 #if RANDR_12_INTERFACE
 236     RRScreenSetSizeProcPtr rrScreenSetSize;
 237     RRCrtcSetProcPtr rrCrtcSet;
 238     RRCrtcSetGammaProcPtr rrCrtcSetGamma;
 239     RRCrtcGetGammaProcPtr rrCrtcGetGamma;
 240     RROutputSetPropertyProcPtr rrOutputSetProperty;
 241     RROutputValidateModeProcPtr rrOutputValidateMode;
 242     RRModeDestroyProcPtr rrModeDestroy;
 243 #endif
 244 #if RANDR_13_INTERFACE
 245     RROutputGetPropertyProcPtr rrOutputGetProperty;
 246     RRGetPanningProcPtr rrGetPanning;
 247     RRSetPanningProcPtr rrSetPanning;
 248 #endif
 249
 250     /*
 251      * Private part of the structure; not considered part of the ABI
 252      */
 253     TimeStamp lastSetTime;      /* last changed by client */
 254     TimeStamp lastConfigTime;   /* possible configs changed */
 255     RRCloseScreenProcPtr CloseScreen;
 256
 257     Bool changed;               /* some config changed */
 258     Bool configChanged;         /* configuration changed */
 259     Bool layoutChanged;         /* screen layout changed */
 260
 261     CARD16 minWidth, minHeight;
 262     CARD16 maxWidth, maxHeight;
 263     CARD16 width, height;       /* last known screen size */
 264     CARD16 mmWidth, mmHeight;   /* last known screen size */
 265
 266     int numOutputs;
 267     RROutputPtr *outputs;
 268     RROutputPtr primaryOutput;
 269
 270     int numCrtcs;
 271     RRCrtcPtr *crtcs;
 272
 273     /* Last known pointer position */
 274     RRCrtcPtr pointerCrtc;
 275
 276 #ifdef RANDR_10_INTERFACE
 277     /*
 278      * Configuration information
 279      */
 280     Rotation rotations;
 281     CARD16 reqWidth, reqHeight;
 282
 283     int nSizes;
 284     RRScreenSizePtr pSizes;
 285
 286     Rotation rotation;
 287     int rate;
 288     int size;
 289 #endif
 290     Bool discontiguous;
 291 } rrScrPrivRec, *rrScrPrivPtr;
 292
 293 extern _X_EXPORT DevPrivateKeyRec rrPrivKeyRec;
 294
 295 #define rrPrivKey (&rrPrivKeyRec)
 296
 297 #define rrGetScrPriv(pScr)  ((rrScrPrivPtr)dixLookupPrivate(&(pScr)->devPrivates, rrPrivKey))
 298 #define rrScrPriv(pScr) rrScrPrivPtr    pScrPriv = rrGetScrPriv(pScr)
 299 #define SetRRScreen(s,p) dixSetPrivate(&(s)->devPrivates, rrPrivKey, p)
 300
 301 /*
 302  * each window has a list of clients requesting
 303  * RRNotify events.  Each client has a resource
 304  * for each window it selects RRNotify input for,
 305  * this resource is used to delete the RRNotifyRec
 306  * entry from the per-window queue.
 307  */
 308
 309 typedef struct _RREvent *RREventPtr;
 310
 311 typedef struct _RREvent {
 312     RREventPtr next;
 313     ClientPtr client;
 314     WindowPtr window;
 315     XID clientResource;
 316     int mask;
 317 } RREventRec;
 318
 319 typedef struct _RRTimes {
 320     TimeStamp setTime;
 321     TimeStamp configTime;
 322 } RRTimesRec, *RRTimesPtr;
 323
 324 typedef struct _RRClient {
 325     int major_version;
 326     int minor_version;
 327 /*  RRTimesRec  times[0]; */
 328 } RRClientRec, *RRClientPtr;
 329
 330 extern _X_EXPORT RESTYPE RRClientType, RREventType;     /* resource types for event masks */
 331 extern _X_EXPORT DevPrivateKeyRec RRClientPrivateKeyRec;
 332
 333 #define RRClientPrivateKey (&RRClientPrivateKeyRec)
 334 extern _X_EXPORT RESTYPE RRCrtcType, RRModeType, RROutputType;
 335
 336 #define VERIFY_RR_OUTPUT(id, ptr, a)\
 337     {\
 338         int rc = dixLookupResourceByType((pointer *)&(ptr), id,\
 339                                          RROutputType, client, a);\
 340         if (rc != Success) {\
 341             client->errorValue = id;\
 342             return rc;\
 343         }\
 344     }
 345
 346 #define VERIFY_RR_CRTC(id, ptr, a)\
 347     {\
 348         int rc = dixLookupResourceByType((pointer *)&(ptr), id,\
 349                                          RRCrtcType, client, a);\
 350         if (rc != Success) {\
 351             client->errorValue = id;\
 352             return rc;\
 353         }\
 354     }
 355
 356 #define VERIFY_RR_MODE(id, ptr, a)\
 357     {\
 358         int rc = dixLookupResourceByType((pointer *)&(ptr), id,\
 359                                          RRModeType, client, a);\
 360         if (rc != Success) {\
 361             client->errorValue = id;\
 362             return rc;\
 363         }\
 364     }
 365
 366 #define GetRRClient(pClient)    ((RRClientPtr)dixLookupPrivate(&(pClient)->devPrivates, RRClientPrivateKey))
 367 #define rrClientPriv(pClient)   RRClientPtr pRRClient = GetRRClient(pClient)
 368
 369 /* Initialize the extension */
 370 extern _X_EXPORT void
 371  RRExtensionInit(void);
 372
 373 #ifdef RANDR_12_INTERFACE
 374 /*
 375  * Set the range of sizes for the screen
 376  */
 377 extern _X_EXPORT void
 378
 379 RRScreenSetSizeRange(ScreenPtr pScreen,
 380                      CARD16 minWidth,
 381                      CARD16 minHeight, CARD16 maxWidth, CARD16 maxHeight);
 382 #endif
 383
 384 /* rrscreen.c */
 385 /*
 386  * Notify the extension that the screen size has been changed.
 387  * The driver is responsible for calling this whenever it has changed
 388  * the size of the screen
 389  */
 390 extern _X_EXPORT void
 391  RRScreenSizeNotify(ScreenPtr pScreen);
 392
 393 /*
 394  * Request that the screen be resized
 395  */
 396 extern _X_EXPORT Bool
 397
 398 RRScreenSizeSet(ScreenPtr pScreen,
 399                 CARD16 width, CARD16 height, CARD32 mmWidth, CARD32 mmHeight);
 400
 401 /*
 402  * Send ConfigureNotify event to root window when 'something' happens
 403  */
 404 extern _X_EXPORT void
 405  RRSendConfigNotify(ScreenPtr pScreen);
 406
 407 /*
 408  * screen dispatch
 409  */
 410 extern _X_EXPORT int
 411  ProcRRGetScreenSizeRange(ClientPtr client);
 412
 413 extern _X_EXPORT int
 414  ProcRRSetScreenSize(ClientPtr client);
 415
 416 extern _X_EXPORT int
 417  ProcRRGetScreenResources(ClientPtr client);
 418
 419 extern _X_EXPORT int
 420  ProcRRGetScreenResourcesCurrent(ClientPtr client);
 421
 422 extern _X_EXPORT int
 423  ProcRRSetScreenConfig(ClientPtr client);
 424
 425 extern _X_EXPORT int
 426  ProcRRGetScreenInfo(ClientPtr client);
 427
 428 /*
 429  * Deliver a ScreenNotify event
 430  */
 431 extern _X_EXPORT void
 432  RRDeliverScreenEvent(ClientPtr client, WindowPtr pWin, ScreenPtr pScreen);
 433
 434 /* randr.c */
 435 /*
 436  * Send all pending events
 437  */
 438 extern _X_EXPORT void
 439  RRTellChanged(ScreenPtr pScreen);
 440
 441 /*
 442  * Poll the driver for changed information
 443  */
 444 extern _X_EXPORT Bool
 445  RRGetInfo(ScreenPtr pScreen, Bool force_query);
 446
 447 extern _X_EXPORT Bool RRInit(void);
 448
 449 extern _X_EXPORT Bool RRScreenInit(ScreenPtr pScreen);
 450
 451 extern _X_EXPORT RROutputPtr RRFirstOutput(ScreenPtr pScreen);
 452
 453 extern _X_EXPORT CARD16
 454  RRVerticalRefresh(xRRModeInfo * mode);
 455
 456 #ifdef RANDR_10_INTERFACE
 457 /*
 458  * This is the old interface, deprecated but left
 459  * around for compatibility
 460  */
 461
 462 /*
 463  * Then, register the specific size with the screen
 464  */
 465
 466 extern _X_EXPORT RRScreenSizePtr
 467 RRRegisterSize(ScreenPtr pScreen,
 468                short width, short height, short mmWidth, short mmHeight);
 469
 470 extern _X_EXPORT Bool
 471  RRRegisterRate(ScreenPtr pScreen, RRScreenSizePtr pSize, int rate);
 472
 473 /*
 474  * Finally, set the current configuration of the screen
 475  */
 476
 477 extern _X_EXPORT void
 478
 479 RRSetCurrentConfig(ScreenPtr pScreen,
 480                    Rotation rotation, int rate, RRScreenSizePtr pSize);
 481
 482 extern _X_EXPORT Rotation RRGetRotation(ScreenPtr pScreen);
 483
 484 #endif
 485
 486 /* rrcrtc.c */
 487
 488 /*
 489  * Notify the CRTC of some change; layoutChanged indicates that
 490  * some position or size element changed
 491  */
 492 extern _X_EXPORT void
 493  RRCrtcChanged(RRCrtcPtr crtc, Bool layoutChanged);
 494
 495 /*
 496  * Create a CRTC
 497  */
 498 extern _X_EXPORT RRCrtcPtr RRCrtcCreate(ScreenPtr pScreen, void *devPrivate);
 499
 500 /*
 501  * Set the allowed rotations on a CRTC
 502  */
 503 extern _X_EXPORT void
 504  RRCrtcSetRotations(RRCrtcPtr crtc, Rotation rotations);
 505
 506 /*
 507  * Set whether transforms are allowed on a CRTC
 508  */
 509 extern _X_EXPORT void
 510  RRCrtcSetTransformSupport(RRCrtcPtr crtc, Bool transforms);
 511
 512 /*
 513  * Notify the extension that the Crtc has been reconfigured,
 514  * the driver calls this whenever it has updated the mode
 515  */
 516 extern _X_EXPORT Bool
 517
 518 RRCrtcNotify(RRCrtcPtr crtc,
 519              RRModePtr mode,
 520              int x,
 521              int y,
 522              Rotation rotation,
 523              RRTransformPtr transform, int numOutputs, RROutputPtr * outputs);
 524
 525 extern _X_EXPORT void
 526  RRDeliverCrtcEvent(ClientPtr client, WindowPtr pWin, RRCrtcPtr crtc);
 527
 528 /*
 529  * Request that the Crtc be reconfigured
 530  */
 531 extern _X_EXPORT Bool
 532
 533 RRCrtcSet(RRCrtcPtr crtc,
 534           RRModePtr mode,
 535           int x,
 536           int y, Rotation rotation, int numOutput, RROutputPtr * outputs);
 537
 538 /*
 539  * Request that the Crtc gamma be changed
 540  */
 541
 542 extern _X_EXPORT Bool
 543  RRCrtcGammaSet(RRCrtcPtr crtc, CARD16 *red, CARD16 *green, CARD16 *blue);
 544
 545 /*
 546  * Request current gamma back from the DDX (if possible).
 547  * This includes gamma size.
 548  */
 549
 550 extern _X_EXPORT Bool
 551  RRCrtcGammaGet(RRCrtcPtr crtc);
 552
 553 /*
 554  * Notify the extension that the Crtc gamma has been changed
 555  * The driver calls this whenever it has changed the gamma values
 556  * in the RRCrtcRec
 557  */
 558
 559 extern _X_EXPORT Bool
 560  RRCrtcGammaNotify(RRCrtcPtr crtc);
 561
 562 /*
 563  * Set the size of the gamma table at server startup time
 564  */
 565
 566 extern _X_EXPORT Bool
 567  RRCrtcGammaSetSize(RRCrtcPtr crtc, int size);
 568
 569 /*
 570  * Return the area of the frame buffer scanned out by the crtc,
 571  * taking into account the current mode and rotation
 572  */
 573
 574 extern _X_EXPORT void
 575  RRCrtcGetScanoutSize(RRCrtcPtr crtc, int *width, int *height);
 576
 577 /*
 578  * Compute the complete transformation matrix including
 579  * client-specified transform, rotation/reflection values and the crtc
 580  * offset.
 581  *
 582  * Return TRUE if the resulting transform is not a simple translation.
 583  */
 584 extern _X_EXPORT Bool
 585
 586 RRTransformCompute(int x,
 587                    int y,
 588                    int width,
 589                    int height,
 590                    Rotation rotation,
 591                    RRTransformPtr rr_transform,
 592                    PictTransformPtr transform,
 593                    struct pict_f_transform *f_transform,
 594                    struct pict_f_transform *f_inverse);
 595
 596 /*
 597  * Return crtc transform
 598  */
 599 extern _X_EXPORT RRTransformPtr RRCrtcGetTransform(RRCrtcPtr crtc);
 600
 601 /*
 602  * Check whether the pending and current transforms are the same
 603  */
 604 extern _X_EXPORT Bool
 605  RRCrtcPendingTransform(RRCrtcPtr crtc);
 606
 607 /*
 608  * Destroy a Crtc at shutdown
 609  */
 610 extern _X_EXPORT void
 611  RRCrtcDestroy(RRCrtcPtr crtc);
 612
 613 /*
 614  * Set the pending CRTC transformation
 615  */
 616
 617 extern _X_EXPORT int
 618
 619 RRCrtcTransformSet(RRCrtcPtr crtc,
 620                    PictTransformPtr transform,
 621                    struct pict_f_transform *f_transform,
 622                    struct pict_f_transform *f_inverse,
 623                    char *filter, int filter_len, xFixed * params, int nparams);
 624
 625 /*
 626  * Initialize crtc type
 627  */
 628 extern _X_EXPORT Bool
 629  RRCrtcInit(void);
 630
 631 /*
 632  * Initialize crtc type error value
 633  */
 634 extern _X_EXPORT void
 635  RRCrtcInitErrorValue(void);
 636
 637 /*
 638  * Crtc dispatch
 639  */
 640
 641 extern _X_EXPORT int
 642  ProcRRGetCrtcInfo(ClientPtr client);
 643
 644 extern _X_EXPORT int
 645  ProcRRSetCrtcConfig(ClientPtr client);
 646
 647 extern _X_EXPORT int
 648  ProcRRGetCrtcGammaSize(ClientPtr client);
 649
 650 extern _X_EXPORT int
 651  ProcRRGetCrtcGamma(ClientPtr client);
 652
 653 extern _X_EXPORT int
 654  ProcRRSetCrtcGamma(ClientPtr client);
 655
 656 extern _X_EXPORT int
 657  ProcRRSetCrtcTransform(ClientPtr client);
 658
 659 extern _X_EXPORT int
 660  ProcRRGetCrtcTransform(ClientPtr client);
 661
 662 int
 663  ProcRRGetPanning(ClientPtr client);
 664
 665 int
 666  ProcRRSetPanning(ClientPtr client);
 667
 668 void
 669  RRConstrainCursorHarder(DeviceIntPtr, ScreenPtr, int, int *, int *);
 670
 671 /* rrdispatch.c */
 672 extern _X_EXPORT Bool
 673  RRClientKnowsRates(ClientPtr pClient);
 674
 675 /* rrmode.c */
 676 /*
 677  * Find, and if necessary, create a mode
 678  */
 679
 680 extern _X_EXPORT RRModePtr RRModeGet(xRRModeInfo * modeInfo, const char *name);
 681
 682 /*
 683  * Destroy a mode.
 684  */
 685
 686 extern _X_EXPORT void
 687  RRModeDestroy(RRModePtr mode);
 688
 689 /*
 690  * Return a list of modes that are valid for some output in pScreen
 691  */
 692 extern _X_EXPORT RRModePtr *RRModesForScreen(ScreenPtr pScreen, int *num_ret);
 693
 694 /*
 695  * Initialize mode type
 696  */
 697 extern _X_EXPORT Bool
 698  RRModeInit(void);
 699
 700 /*
 701  * Initialize mode type error value
 702  */
 703 extern _X_EXPORT void
 704  RRModeInitErrorValue(void);
 705
 706 extern _X_EXPORT int
 707  ProcRRCreateMode(ClientPtr client);
 708
 709 extern _X_EXPORT int
 710  ProcRRDestroyMode(ClientPtr client);
 711
 712 extern _X_EXPORT int
 713  ProcRRAddOutputMode(ClientPtr client);
 714
 715 extern _X_EXPORT int
 716  ProcRRDeleteOutputMode(ClientPtr client);
 717
 718 /* rroutput.c */
 719
 720 /*
 721  * Notify the output of some change. configChanged indicates whether
 722  * any external configuration (mode list, clones, connected status)
 723  * has changed, or whether the change was strictly internal
 724  * (which crtc is in use)
 725  */
 726 extern _X_EXPORT void
 727  RROutputChanged(RROutputPtr output, Bool configChanged);
 728
 729 /*
 730  * Create an output
 731  */
 732
 733 extern _X_EXPORT RROutputPtr
 734 RROutputCreate(ScreenPtr pScreen,
 735                const char *name, int nameLength, void *devPrivate);
 736
 737 /*
 738  * Notify extension that output parameters have been changed
 739  */
 740 extern _X_EXPORT Bool
 741  RROutputSetClones(RROutputPtr output, RROutputPtr * clones, int numClones);
 742
 743 extern _X_EXPORT Bool
 744
 745 RROutputSetModes(RROutputPtr output,
 746                  RRModePtr * modes, int numModes, int numPreferred);
 747
 748 extern _X_EXPORT int
 749  RROutputAddUserMode(RROutputPtr output, RRModePtr mode);
 750
 751 extern _X_EXPORT int
 752  RROutputDeleteUserMode(RROutputPtr output, RRModePtr mode);
 753
 754 extern _X_EXPORT Bool
 755  RROutputSetCrtcs(RROutputPtr output, RRCrtcPtr * crtcs, int numCrtcs);
 756
 757 extern _X_EXPORT Bool
 758  RROutputSetConnection(RROutputPtr output, CARD8 connection);
 759
 760 extern _X_EXPORT Bool
 761  RROutputSetSubpixelOrder(RROutputPtr output, int subpixelOrder);
 762
 763 extern _X_EXPORT Bool
 764  RROutputSetPhysicalSize(RROutputPtr output, int mmWidth, int mmHeight);
 765
 766 extern _X_EXPORT void
 767  RRDeliverOutputEvent(ClientPtr client, WindowPtr pWin, RROutputPtr output);
 768
 769 extern _X_EXPORT void
 770  RROutputDestroy(RROutputPtr output);
 771
 772 extern _X_EXPORT int
 773  ProcRRGetOutputInfo(ClientPtr client);
 774
 775 extern _X_EXPORT int
 776  ProcRRSetOutputPrimary(ClientPtr client);
 777
 778 extern _X_EXPORT int
 779  ProcRRGetOutputPrimary(ClientPtr client);
 780
 781 /*
 782  * Initialize output type
 783  */
 784 extern _X_EXPORT Bool
 785  RROutputInit(void);
 786
 787 /*
 788  * Initialize output type error value
 789  */
 790 extern _X_EXPORT void
 791  RROutputInitErrorValue(void);
 792
 793 /* rrpointer.c */
 794 extern _X_EXPORT void
 795  RRPointerMoved(ScreenPtr pScreen, int x, int y);
 796
 797 extern _X_EXPORT void
 798  RRPointerScreenConfigured(ScreenPtr pScreen);
 799
 800 /* rrproperty.c */
 801
 802 extern _X_EXPORT void
 803  RRDeleteAllOutputProperties(RROutputPtr output);
 804
 805 extern _X_EXPORT RRPropertyValuePtr
 806 RRGetOutputProperty(RROutputPtr output, Atom property, Bool pending);
 807
 808 extern _X_EXPORT RRPropertyPtr
 809 RRQueryOutputProperty(RROutputPtr output, Atom property);
 810
 811 extern _X_EXPORT void
 812  RRDeleteOutputProperty(RROutputPtr output, Atom property);
 813
 814 extern _X_EXPORT Bool
 815  RRPostPendingProperties(RROutputPtr output);
 816
 817 extern _X_EXPORT int
 818
 819 RRChangeOutputProperty(RROutputPtr output, Atom property, Atom type,
 820                        int format, int mode, unsigned long len,
 821                        pointer value, Bool sendevent, Bool pending);
 822
 823 extern _X_EXPORT int
 824
 825 RRConfigureOutputProperty(RROutputPtr output, Atom property,
 826                           Bool pending, Bool range, Bool immutable,
 827                           int num_values, INT32 *values);
 828 extern _X_EXPORT int
 829  ProcRRChangeOutputProperty(ClientPtr client);
 830
 831 extern _X_EXPORT int
 832  ProcRRGetOutputProperty(ClientPtr client);
 833
 834 extern _X_EXPORT int
 835  ProcRRListOutputProperties(ClientPtr client);
 836
 837 extern _X_EXPORT int
 838  ProcRRQueryOutputProperty(ClientPtr client);
 839
 840 extern _X_EXPORT int
 841  ProcRRConfigureOutputProperty(ClientPtr client);
 842
 843 extern _X_EXPORT int
 844  ProcRRDeleteOutputProperty(ClientPtr client);
 845
 846 /* rrxinerama.c */
 847 #ifdef XINERAMA
 848 extern _X_EXPORT void
 849  RRXineramaExtensionInit(void);
 850 #endif
 851
 852 #endif                          /* _RANDRSTR_H_ */
 853
 854 /*
 855
 856 randr extension implementation structure
 857
 858 Query state:
 859     ProcRRGetScreenInfo/ProcRRGetScreenResources
 860         RRGetInfo
 861
 862             • Request configuration from driver, either 1.0 or 1.2 style
 863             • These functions only record state changes, all
 864               other actions are pended until RRTellChanged is called
 865
 866             ->rrGetInfo
 867             1.0:
 868                 RRRegisterSize
 869                 RRRegisterRate
 870                 RRSetCurrentConfig
 871             1.2:
 872                 RRScreenSetSizeRange
 873                 RROutputSetCrtcs
 874                 RRModeGet
 875                 RROutputSetModes
 876                 RROutputSetConnection
 877                 RROutputSetSubpixelOrder
 878                 RROutputSetClones
 879                 RRCrtcNotify
 880
 881         • Must delay scanning configuration until after ->rrGetInfo returns
 882           because some drivers will call SetCurrentConfig in the middle
 883           of the ->rrGetInfo operation.
 884
 885         1.0:
 886
 887             • Scan old configuration, mirror to new structures
 888
 889             RRScanOldConfig
 890                 RRCrtcCreate
 891                 RROutputCreate
 892                 RROutputSetCrtcs
 893                 RROutputSetConnection
 894                 RROutputSetSubpixelOrder
 895                 RROldModeAdd    • This adds modes one-at-a-time
 896                     RRModeGet
 897                 RRCrtcNotify
 898
 899         • send events, reset pointer if necessary
 900
 901         RRTellChanged
 902             WalkTree (sending events)
 903
 904             • when layout has changed:
 905                 RRPointerScreenConfigured
 906                 RRSendConfigNotify
 907
 908 Asynchronous state setting (1.2 only)
 909     When setting state asynchronously, the driver invokes the
 910     ->rrGetInfo function and then calls RRTellChanged to flush
 911     the changes to the clients and reset pointer if necessary
 912
 913 Set state
 914
 915     ProcRRSetScreenConfig
 916         RRCrtcSet
 917             1.2:
 918                 ->rrCrtcSet
 919                     RRCrtcNotify
 920             1.0:
 921                 ->rrSetConfig
 922                 RRCrtcNotify
 923             RRTellChanged
 924  */