xf86Crtc.h 25.4 KB
Newer Older
1 2
/*
 * Copyright © 2006 Keith Packard
3
 * Copyright © 2011 Aaron Plattner
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
 *
 * 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.
 */
#ifndef _XF86CRTC_H_
#define _XF86CRTC_H_

#include <edid.h>
#include "randrstr.h"
#include "xf86Modes.h"
29
#include "xf86Cursor.h"
30
#include "xf86i2c.h"
31
#include "damage.h"
32
#include "picturestr.h"
33 34 35 36 37 38 39 40

/* Compat definitions for older X Servers. */
#ifndef M_T_PREFERRED
#define M_T_PREFERRED	0x08
#endif
#ifndef M_T_DRIVER
#define M_T_DRIVER	0x40
#endif
41 42 43
#ifndef M_T_USERPREF
#define M_T_USERPREF	0x80
#endif
44 45 46
#ifndef HARDWARE_CURSOR_ARGB
#define HARDWARE_CURSOR_ARGB				0x00004000
#endif
47 48 49 50

typedef struct _xf86Crtc xf86CrtcRec, *xf86CrtcPtr;
typedef struct _xf86Output xf86OutputRec, *xf86OutputPtr;

51 52
/* define a standard for connector types */
typedef enum _xf86ConnectorType {
53 54 55 56 57 58 59 60 61 62 63 64
    XF86ConnectorNone,
    XF86ConnectorVGA,
    XF86ConnectorDVI_I,
    XF86ConnectorDVI_D,
    XF86ConnectorDVI_A,
    XF86ConnectorComposite,
    XF86ConnectorSvideo,
    XF86ConnectorComponent,
    XF86ConnectorLFP,
    XF86ConnectorProprietary,
    XF86ConnectorHDMI,
    XF86ConnectorDisplayPort,
65 66
} xf86ConnectorType;

67
typedef enum _xf86OutputStatus {
68 69 70
    XF86OutputStatusConnected,
    XF86OutputStatusDisconnected,
    XF86OutputStatusUnknown
71 72 73 74 75 76 77 78 79 80
} xf86OutputStatus;

typedef struct _xf86CrtcFuncs {
   /**
    * Turns the crtc on/off, or sets intermediate power levels if available.
    *
    * Unsupported intermediate modes drop to the lower power setting.  If the
    * mode is DPMSModeOff, the crtc must be disabled sufficiently for it to
    * be safe to call mode_set.
    */
81 82
    void
     (*dpms) (xf86CrtcPtr crtc, int mode);
83 84 85 86

   /**
    * Saves the crtc's state for restoration on VT switch.
    */
87 88
    void
     (*save) (xf86CrtcPtr crtc);
89 90 91 92

   /**
    * Restore's the crtc's state at VT switch.
    */
93 94
    void
     (*restore) (xf86CrtcPtr crtc);
95 96 97 98 99 100

    /**
     * Lock CRTC prior to mode setting, mostly for DRI.
     * Returns whether unlock is needed
     */
    Bool
101 102
     (*lock) (xf86CrtcPtr crtc);

103 104 105 106
    /**
     * Unlock CRTC after mode setting, mostly for DRI
     */
    void
107 108
     (*unlock) (xf86CrtcPtr crtc);

109 110 111 112 113 114 115 116
    /**
     * Callback to adjust the mode to be set in the CRTC.
     *
     * This allows a CRTC to adjust the clock or even the entire set of
     * timings, which is used for panels with fixed timings or for
     * buses with clock limitations.
     */
    Bool
117 118
     (*mode_fixup) (xf86CrtcPtr crtc,
                    DisplayModePtr mode, DisplayModePtr adjusted_mode);
119

Dave Airlie's avatar
Dave Airlie committed
120 121 122 123
    /**
     * Prepare CRTC for an upcoming mode set.
     */
    void
124
     (*prepare) (xf86CrtcPtr crtc);
Dave Airlie's avatar
Dave Airlie committed
125

126 127 128 129
    /**
     * Callback for setting up a video mode after fixups have been made.
     */
    void
130 131 132
     (*mode_set) (xf86CrtcPtr crtc,
                  DisplayModePtr mode,
                  DisplayModePtr adjusted_mode, int x, int y);
133

Dave Airlie's avatar
Dave Airlie committed
134 135 136 137
    /**
     * Commit mode changes to a CRTC
     */
    void
138
     (*commit) (xf86CrtcPtr crtc);
Dave Airlie's avatar
Dave Airlie committed
139

140 141
    /* Set the color ramps for the CRTC to the given values. */
    void
142 143
     (*gamma_set) (xf86CrtcPtr crtc, CARD16 *red, CARD16 *green, CARD16 *blue,
                   int size);
144

145 146 147
    /**
     * Allocate the shadow area, delay the pixmap creation until needed
     */
148 149
    void *(*shadow_allocate) (xf86CrtcPtr crtc, int width, int height);

150 151 152 153
    /**
     * Create shadow pixmap for rotation support
     */
    PixmapPtr
154 155
     (*shadow_create) (xf86CrtcPtr crtc, void *data, int width, int height);

156 157 158 159
    /**
     * Destroy shadow pixmap
     */
    void
160
     (*shadow_destroy) (xf86CrtcPtr crtc, PixmapPtr pPixmap, void *data);
161

162 163 164 165
    /**
     * Set cursor colors
     */
    void
166
     (*set_cursor_colors) (xf86CrtcPtr crtc, int bg, int fg);
167 168 169 170 171

    /**
     * Set cursor position
     */
    void
172
     (*set_cursor_position) (xf86CrtcPtr crtc, int x, int y);
173 174 175 176 177

    /**
     * Show cursor
     */
    void
178
     (*show_cursor) (xf86CrtcPtr crtc);
179 180 181 182 183

    /**
     * Hide cursor
     */
    void
184
     (*hide_cursor) (xf86CrtcPtr crtc);
185 186 187 188

    /**
     * Load monochrome image
     */
189
    Bool
190
     (*load_cursor_image) (xf86CrtcPtr crtc, CARD8 *image);
191 192 193 194

    /**
     * Load ARGB image
     */
195
    Bool
196
     (*load_cursor_argb) (xf86CrtcPtr crtc, CARD32 *image);
197

198 199 200 201
    /**
     * Clean up driver-specific bits of the crtc
     */
    void
202
     (*destroy) (xf86CrtcPtr crtc);
203 204 205 206 207

    /**
     * Less fine-grained mode setting entry point for kernel modesetting
     */
    Bool
208 209
     (*set_mode_major) (xf86CrtcPtr crtc, DisplayModePtr mode,
                        Rotation rotation, int x, int y);
210 211 212

    /**
     * Callback for panning. Doesn't change the mode.
213
     * Added in ABI version 2
214 215
     */
    void
216
     (*set_origin) (xf86CrtcPtr crtc, int x, int y);
217

218 219 220 221 222
    /**
     */
    Bool
    (*set_scanout_pixmap)(xf86CrtcPtr crtc, PixmapPtr pixmap);

223 224
} xf86CrtcFuncsRec, *xf86CrtcFuncsPtr;

225
#define XF86_CRTC_VERSION 5
226

227
struct _xf86Crtc {
228 229 230 231 232
    /**
     * ABI versioning
     */
    int version;

233 234 235
    /**
     * Associated ScrnInfo
     */
236 237
    ScrnInfoPtr scrn;

238
    /**
239
     * Desired state of this CRTC
240
     *
241
     * Set when this CRTC should be driving one or more outputs 
242
     */
243 244
    Bool enabled;

245 246 247 248 249 250 251
    /**
     * Active mode
     *
     * This reflects the mode as set in the CRTC currently
     * It will be cleared when the VT is not active or
     * during server startup
     */
252 253 254 255 256
    DisplayModeRec mode;
    Rotation rotation;
    PixmapPtr rotatedPixmap;
    void *rotatedData;

257 258 259 260 261
    /**
     * Position on screen
     *
     * Locates this CRTC within the frame buffer
     */
262 263
    int x, y;

264 265 266 267 268 269 270 271
    /**
     * Desired mode
     *
     * This is set to the requested mode, independent of
     * whether the VT is active. In particular, it receives
     * the startup configured mode and saves the active mode
     * on VT switch.
     */
272 273 274 275
    DisplayModeRec desiredMode;
    Rotation desiredRotation;
    int desiredX, desiredY;

276 277 278 279 280 281 282 283
    /** crtc-specific functions */
    const xf86CrtcFuncsRec *funcs;

    /**
     * Driver private
     *
     * Holds driver-private information
     */
284
    void *driver_private;
285 286 287 288 289 290 291 292

#ifdef RANDR_12_INTERFACE
    /**
     * RandR crtc
     *
     * When RandR 1.2 is available, this
     * points at the associated crtc object
     */
293
    RRCrtcPtr randr_crtc;
294
#else
295
    void *randr_crtc;
296
#endif
297 298 299 300

    /**
     * Current cursor is ARGB
     */
301
    Bool cursor_argb;
302 303 304
    /**
     * Track whether cursor is within CRTC range 
     */
305
    Bool cursor_in_range;
306 307 308
    /**
     * Track state of cursor associated with this CRTC
     */
309
    Bool cursor_shown;
Keith Packard's avatar
Keith Packard committed
310 311 312 313

    /**
     * Current transformation matrix
     */
314
    PictTransform crtc_to_framebuffer;
315
    /* framebuffer_to_crtc was removed in ABI 2 */
316 317 318 319 320 321 322 323 324 325 326 327
    struct pict_f_transform f_crtc_to_framebuffer;      /* ABI 2 */
    struct pict_f_transform f_framebuffer_to_crtc;      /* ABI 2 */
    PictFilterPtr filter;       /* ABI 2 */
    xFixed *params;             /* ABI 2 */
    int nparams;                /* ABI 2 */
    int filter_width;           /* ABI 2 */
    int filter_height;          /* ABI 2 */
    Bool transform_in_use;
    RRTransformRec transform;   /* ABI 2 */
    Bool transformPresent;      /* ABI 2 */
    RRTransformRec desiredTransform;    /* ABI 2 */
    Bool desiredTransformPresent;       /* ABI 2 */
Keith Packard's avatar
Keith Packard committed
328 329 330
    /**
     * Bounding box in screen space
     */
331
    BoxRec bounds;
332 333 334 335 336
    /**
     * Panning:
     * TotalArea: total panning area, larger than CRTC's size
     * TrackingArea: Area of the pointer for which the CRTC is panned
     * border: Borders of the displayed CRTC area which induces panning if the pointer reaches them
337
     * Added in ABI version 2
338
     */
339 340 341
    BoxRec panningTotalArea;
    BoxRec panningTrackingArea;
    INT16 panningBorder[4];
342 343 344

    /**
     * Current gamma, especially useful after initial config.
345
     * Added in ABI version 3
346 347 348 349 350
     */
    CARD16 *gamma_red;
    CARD16 *gamma_green;
    CARD16 *gamma_blue;
    int gamma_size;
351 352 353 354 355 356 357

    /**
     * Actual state of this CRTC
     *
     * Set to TRUE after modesetting, set to FALSE if no outputs are connected
     * Added in ABI version 3
     */
358
    Bool active;
359 360 361
    /**
     * Clear the shadow
     */
362
    Bool shadowClear;
363 364 365 366 367 368 369 370 371 372 373 374

    /**
     * Indicates that the driver is handling the transform, so the shadow
     * surface should be disabled.  The driver writes this field before calling
     * xf86CrtcRotate to indicate that it is handling the transform (including
     * rotation and reflection).
     *
     * Setting this flag also causes the server to stop adjusting the cursor
     * image and position.
     *
     * Added in ABI version 4
     */
375
    Bool driverIsPerformingTransform;
376 377 378 379

    /* Added in ABI version 5
     */
    PixmapPtr current_scanout;
380 381 382 383 384 385 386 387
};

typedef struct _xf86OutputFuncs {
    /**
     * Called to allow the output a chance to create properties after the
     * RandR objects have been created.
     */
    void
388
     (*create_resources) (xf86OutputPtr output);
389 390 391 392 393 394 395 396 397

    /**
     * Turns the output on/off, or sets intermediate power levels if available.
     *
     * Unsupported intermediate modes drop to the lower power setting.  If the
     * mode is DPMSModeOff, the output must be disabled, as the DPLL may be
     * disabled afterwards.
     */
    void
398
     (*dpms) (xf86OutputPtr output, int mode);
399 400 401 402 403

    /**
     * Saves the output's state for restoration on VT switch.
     */
    void
404
     (*save) (xf86OutputPtr output);
405 406 407 408 409

    /**
     * Restore's the output's state at VT switch.
     */
    void
410
     (*restore) (xf86OutputPtr output);
411 412 413 414 415 416 417 418 419 420

    /**
     * Callback for testing a video mode for a given output.
     *
     * This function should only check for cases where a mode can't be supported
     * on the output specifically, and not represent generic CRTC limitations.
     *
     * \return MODE_OK if the mode is valid, or another MODE_* otherwise.
     */
    int
421
     (*mode_valid) (xf86OutputPtr output, DisplayModePtr pMode);
422 423 424 425 426 427 428 429 430

    /**
     * Callback to adjust the mode to be set in the CRTC.
     *
     * This allows an output to adjust the clock or even the entire set of
     * timings, which is used for panels with fixed timings or for
     * buses with clock limitations.
     */
    Bool
431 432
     (*mode_fixup) (xf86OutputPtr output,
                    DisplayModePtr mode, DisplayModePtr adjusted_mode);
433

Dave Airlie's avatar
Dave Airlie committed
434 435 436 437
    /**
     * Callback for preparing mode changes on an output
     */
    void
438
     (*prepare) (xf86OutputPtr output);
Dave Airlie's avatar
Dave Airlie committed
439 440 441 442 443

    /**
     * Callback for committing mode changes on an output
     */
    void
444
     (*commit) (xf86OutputPtr output);
Dave Airlie's avatar
Dave Airlie committed
445

446 447 448 449 450 451 452 453
    /**
     * Callback for setting up a video mode after fixups have been made.
     *
     * This is only called while the output is disabled.  The dpms callback
     * must be all that's necessary for the output, to turn the output on
     * after this function is called.
     */
    void
454 455
     (*mode_set) (xf86OutputPtr output,
                  DisplayModePtr mode, DisplayModePtr adjusted_mode);
456 457 458 459

    /**
     * Probe for a connected output, and return detect_status.
     */
460
     xf86OutputStatus(*detect) (xf86OutputPtr output);
461 462 463 464 465 466 467 468

    /**
     * Query the device for the modes it provides.
     *
     * This function may also update MonInfo, mm_width, and mm_height.
     *
     * \return singly-linked list of modes or NULL if no modes found.
     */
469
     DisplayModePtr(*get_modes) (xf86OutputPtr output);
470 471 472 473 474 475

#ifdef RANDR_12_INTERFACE
    /**
     * Callback when an output's property has changed.
     */
    Bool
476 477
     (*set_property) (xf86OutputPtr output,
                      Atom property, RRPropertyValuePtr value);
478 479 480 481 482 483
#endif
#ifdef RANDR_13_INTERFACE
    /**
     * Callback to get an updated property value
     */
    Bool
484
     (*get_property) (xf86OutputPtr output, Atom property);
485 486 487 488 489
#endif
#ifdef RANDR_GET_CRTC_INTERFACE
    /**
     * Callback to get current CRTC for a given output
     */
490
     xf86CrtcPtr(*get_crtc) (xf86OutputPtr output);
491 492 493 494 495
#endif
    /**
     * Clean up driver-specific bits of the output
     */
    void
496
     (*destroy) (xf86OutputPtr output);
497 498
} xf86OutputFuncsRec, *xf86OutputFuncsPtr;

499
#define XF86_OUTPUT_VERSION 2
500

501
struct _xf86Output {
502 503 504 505 506
    /**
     * ABI versioning
     */
    int version;

507 508 509
    /**
     * Associated ScrnInfo
     */
510
    ScrnInfoPtr scrn;
511 512 513 514 515 516

    /**
     * Currently connected crtc (if any)
     *
     * If this output is not in use, this field will be NULL.
     */
517
    xf86CrtcPtr crtc;
518 519 520 521

    /**
     * Possible CRTCs for this output as a mask of crtc indices
     */
522
    CARD32 possible_crtcs;
523 524 525 526

    /**
     * Possible outputs to share the same CRTC as a mask of output indices
     */
527 528
    CARD32 possible_clones;

529 530 531
    /**
     * Whether this output can support interlaced modes
     */
532
    Bool interlaceAllowed;
533 534 535 536

    /**
     * Whether this output can support double scan modes
     */
537
    Bool doubleScanAllowed;
538 539 540 541 542 543 544

    /**
     * List of available modes on this output.
     *
     * This should be the list from get_modes(), plus perhaps additional
     * compatible modes added later.
     */
545
    DisplayModePtr probed_modes;
546 547 548 549

    /**
     * Options parsed from the related monitor section
     */
550 551
    OptionInfoPtr options;

552 553 554
    /**
     * Configured monitor section
     */
555 556
    XF86ConfMonitorPtr conf_monitor;

557 558 559
    /**
     * Desired initial position
     */
560
    int initial_x, initial_y;
561

562 563 564
    /**
     * Desired initial rotation
     */
565
    Rotation initial_rotation;
566

567 568 569 570 571 572
    /**
     * Current connection status
     *
     * This indicates whether a monitor is known to be connected
     * to this output or not, or whether there is no way to tell
     */
573
    xf86OutputStatus status;
574 575

    /** EDID monitor information */
576
    xf86MonPtr MonInfo;
577 578

    /** subpixel order */
579
    int subpixel_order;
580 581

    /** Physical size of the currently attached output device. */
582
    int mm_width, mm_height;
583 584

    /** Output name */
585
    char *name;
586 587 588 589 590

    /** output-specific functions */
    const xf86OutputFuncsRec *funcs;

    /** driver private information */
591 592
    void *driver_private;

593
    /** Whether to use the old per-screen Monitor config section */
594
    Bool use_screen_monitor;
595

596 597 598 599 600 601 602
#ifdef RANDR_12_INTERFACE
    /**
     * RandR 1.2 output structure.
     *
     * When RandR 1.2 is available, this points at the associated
     * RandR output structure and is created when this output is created
     */
603
    RROutputPtr randr_output;
604
#else
605
    void *randr_output;
606
#endif
607 608 609 610
    /** 
     * Desired initial panning
     * Added in ABI version 2
     */
611 612 613
    BoxRec initialTotalArea;
    BoxRec initialTrackingArea;
    INT16 initialBorder[4];
614 615
};

616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638
typedef struct _xf86ProviderFuncs {
    /**
     * Called to allow the provider a chance to create properties after the
     * RandR objects have been created.
     */
    void
    (*create_resources) (ScrnInfoPtr scrn);

    /**
     * Callback when an provider's property has changed.
     */
    Bool
    (*set_property) (ScrnInfoPtr scrn,
                     Atom property, RRPropertyValuePtr value);

    /**
     * Callback to get an updated property value
     */
    Bool
    (*get_property) (ScrnInfoPtr provider, Atom property);

} xf86ProviderFuncsRec, *xf86ProviderFuncsPtr;

639 640 641 642 643 644 645 646 647 648 649 650 651 652
typedef struct _xf86CrtcConfigFuncs {
    /**
     * Requests that the driver resize the screen.
     *
     * The driver is responsible for updating scrn->virtualX and scrn->virtualY.
     * If the requested size cannot be set, the driver should leave those values
     * alone and return FALSE.
     *
     * A naive driver that cannot reallocate the screen may simply change
     * virtual[XY].  A more advanced driver will want to also change the
     * devPrivate.ptr and devKind of the screen pixmap, update any offscreen
     * pixmaps it may have moved, and change pScrn->displayWidth.
     */
    Bool
653
     (*resize) (ScrnInfoPtr scrn, int width, int height);
654 655
} xf86CrtcConfigFuncsRec, *xf86CrtcConfigFuncsPtr;

656 657
typedef void (*xf86_crtc_notify_proc_ptr) (ScreenPtr pScreen);

658
typedef struct _xf86CrtcConfig {
659 660
    int num_output;
    xf86OutputPtr *output;
661 662 663 664 665 666
    /**
     * compat_output is used whenever we deal
     * with legacy code that only understands a single
     * output. pScrn->modes will be loaded from this output,
     * adjust frame will whack this output, etc.
     */
667 668 669 670
    int compat_output;

    int num_crtc;
    xf86CrtcPtr *crtc;
671

672 673
    int minWidth, minHeight;
    int maxWidth, maxHeight;
674 675

    /* For crtc-based rotation */
676 677
    DamagePtr rotation_damage;
    Bool rotation_damage_registered;
678 679

    /* DGA */
680 681 682 683 684 685
    unsigned int dga_flags;
    unsigned long dga_address;
    DGAModePtr dga_modes;
    int dga_nmode;
    int dga_width, dga_height, dga_stride;
    DisplayModePtr dga_save_mode;
686

687 688
    const xf86CrtcConfigFuncsRec *funcs;

689
    CreateScreenResourcesProcPtr CreateScreenResources;
690

691
    CloseScreenProcPtr CloseScreen;
692

693
    /* Cursor information */
694 695 696 697 698
    xf86CursorInfoPtr cursor_info;
    CursorPtr cursor;
    CARD8 *cursor_image;
    Bool cursor_on;
    CARD32 cursor_fg, cursor_bg;
699 700 701 702

    /**
     * Options parsed from the related device section
     */
703
    OptionInfoPtr options;
704

705
    Bool debug_modes;
706 707

    /* wrap screen BlockHandler for rotation */
708
    ScreenBlockHandlerProcPtr BlockHandler;
709

710
    /* callback when crtc configuration changes */
711
    xf86_crtc_notify_proc_ptr xf86_crtc_notify;
712

713 714 715 716 717 718 719
    char *name;
    const xf86ProviderFuncsRec *provider_funcs;
#ifdef RANDR_12_INTERFACE
    RRProviderPtr randr_provider;
#else
    void *randr_provider;
#endif
720 721
} xf86CrtcConfigRec, *xf86CrtcConfigPtr;

722
extern _X_EXPORT int xf86CrtcConfigPrivateIndex;
723 724 725

#define XF86_CRTC_CONFIG_PTR(p)	((xf86CrtcConfigPtr) ((p)->privates[xf86CrtcConfigPrivateIndex].ptr))

726 727 728 729
static _X_INLINE xf86OutputPtr
xf86CompatOutput(ScrnInfoPtr pScrn)
{
    xf86CrtcConfigPtr config = XF86_CRTC_CONFIG_PTR(pScrn);
730

731 732 733 734 735 736 737
    return config->output[config->compat_output];
}

static _X_INLINE xf86CrtcPtr
xf86CompatCrtc(ScrnInfoPtr pScrn)
{
    xf86OutputPtr compat_output = xf86CompatOutput(pScrn);
738

739
    if (!compat_output)
740
        return NULL;
741 742 743 744 745 746
    return compat_output->crtc;
}

static _X_INLINE RRCrtcPtr
xf86CompatRRCrtc(ScrnInfoPtr pScrn)
{
747 748
    xf86CrtcPtr compat_crtc = xf86CompatCrtc(pScrn);

749
    if (!compat_crtc)
750
        return NULL;
751 752 753
    return compat_crtc->randr_crtc;
}

754 755 756 757
/*
 * Initialize xf86CrtcConfig structure
 */

758
extern _X_EXPORT void
759
 xf86CrtcConfigInit(ScrnInfoPtr scrn, const xf86CrtcConfigFuncsRec * funcs);
760

761
extern _X_EXPORT void
762 763 764

xf86CrtcSetSizeRange(ScrnInfoPtr scrn,
                     int minWidth, int minHeight, int maxWidth, int maxHeight);
765 766 767 768

/*
 * Crtc functions
 */
769
extern _X_EXPORT xf86CrtcPtr
770
xf86CrtcCreate(ScrnInfoPtr scrn, const xf86CrtcFuncsRec * funcs);
771

772
extern _X_EXPORT void
773
 xf86CrtcDestroy(xf86CrtcPtr crtc);
774

775
/**
776
 * Sets the given video mode on the given crtc
777
 */
778

779
extern _X_EXPORT Bool
780 781 782 783

xf86CrtcSetModeTransform(xf86CrtcPtr crtc, DisplayModePtr mode,
                         Rotation rotation, RRTransformPtr transform, int x,
                         int y);
784 785

extern _X_EXPORT Bool
786 787 788

xf86CrtcSetMode(xf86CrtcPtr crtc, DisplayModePtr mode, Rotation rotation,
                int x, int y);
789

790
extern _X_EXPORT void
791
 xf86CrtcSetOrigin(xf86CrtcPtr crtc, int x, int y);
792

793 794 795
/*
 * Assign crtc rotation during mode set
 */
796
extern _X_EXPORT Bool
797
 xf86CrtcRotate(xf86CrtcPtr crtc);
798

799 800 801 802
/*
 * Clean up any rotation data, used when a crtc is turned off
 * as well as when rotation is disabled.
 */
803
extern _X_EXPORT void
804
 xf86RotateDestroy(xf86CrtcPtr crtc);
805

806 807 808
/*
 * free shadow memory allocated for all crtcs
 */
809
extern _X_EXPORT void
810
 xf86RotateFreeShadow(ScrnInfoPtr pScrn);
811

812 813 814
/*
 * Clean up rotation during CloseScreen
 */
815
extern _X_EXPORT void
816
 xf86RotateCloseScreen(ScreenPtr pScreen);
817

818 819 820
/**
 * Return whether any output is assigned to the crtc
 */
821
extern _X_EXPORT Bool
822
 xf86CrtcInUse(xf86CrtcPtr crtc);
823 824 825 826

/*
 * Output functions
 */
827
extern _X_EXPORT xf86OutputPtr
828 829
xf86OutputCreate(ScrnInfoPtr scrn,
                 const xf86OutputFuncsRec * funcs, const char *name);
830

831
extern _X_EXPORT void
832
 xf86OutputUseScreenMonitor(xf86OutputPtr output, Bool use_screen_monitor);
833

834
extern _X_EXPORT Bool
835
 xf86OutputRename(xf86OutputPtr output, const char *name);
836

837
extern _X_EXPORT void
838
 xf86OutputDestroy(xf86OutputPtr output);
839

840
extern _X_EXPORT void
841
 xf86ProbeOutputModes(ScrnInfoPtr pScrn, int maxX, int maxY);
842

843
extern _X_EXPORT void
844
 xf86SetScrnInfoModes(ScrnInfoPtr pScrn);
845

846
#ifdef RANDR_13_INTERFACE
847
#define ScreenInitRetType	int
848
#else
849
#define ScreenInitRetType	Bool
850
#endif
851

852
extern _X_EXPORT ScreenInitRetType xf86CrtcScreenInit(ScreenPtr pScreen);
853

854
extern _X_EXPORT Bool
855
 xf86InitialConfiguration(ScrnInfoPtr pScrn, Bool canGrow);
856

857
extern _X_EXPORT void
858 859
 xf86DPMSSet(ScrnInfoPtr pScrn, int PowerManagementMode, int flags);

860
extern _X_EXPORT Bool
861
 xf86SaveScreen(ScreenPtr pScreen, int mode);
862

863
extern _X_EXPORT void
864
 xf86DisableUnusedFunctions(ScrnInfoPtr pScrn);
865

866
extern _X_EXPORT DisplayModePtr
867 868
xf86OutputFindClosestMode(xf86OutputPtr output, DisplayModePtr desired);

869
extern _X_EXPORT Bool
870 871

xf86SetSingleMode(ScrnInfoPtr pScrn, DisplayModePtr desired, Rotation rotation);
872

873 874 875
/**
 * Set the EDID information for the specified output
 */
876
extern _X_EXPORT void
877
 xf86OutputSetEDID(xf86OutputPtr output, xf86MonPtr edid_mon);
878 879 880 881 882

/**
 * Return the list of modes supported by the EDID information
 * stored in 'output'
 */
883
extern _X_EXPORT DisplayModePtr xf86OutputGetEDIDModes(xf86OutputPtr output);
884

885
extern _X_EXPORT xf86MonPtr
886
xf86OutputGetEDID(xf86OutputPtr output, I2CBusPtr pDDCBus);
887 888 889 890 891

/**
 * Initialize dga for this screen
 */

892
#ifdef XFreeXDGA
893
extern _X_EXPORT Bool
894
 xf86DiDGAInit(ScreenPtr pScreen, unsigned long dga_address);
895

Keith Packard's avatar
Keith Packard committed
896 897
/* this is the real function, used only internally */
_X_INTERNAL Bool
898
 _xf86_di_dga_init_internal(ScreenPtr pScreen);
Keith Packard's avatar
Keith Packard committed
899

900 901 902 903
/**
 * Re-initialize dga for this screen (as when the set of modes changes)
 */

904
extern _X_EXPORT Bool
905
 xf86DiDGAReInit(ScreenPtr pScreen);
906
#endif
907

Keith Packard's avatar
Keith Packard committed
908 909
/* This is the real function, used only internally */
_X_INTERNAL Bool
910
 _xf86_di_dga_reinit_internal(ScreenPtr pScreen);
Keith Packard's avatar
Keith Packard committed
911

912 913 914 915 916
/*
 * Set the subpixel order reported for the screen using
 * the information from the outputs
 */

917
extern _X_EXPORT void
918
 xf86CrtcSetScreenSubpixelOrder(ScreenPtr pScreen);
919

920 921 922
/*
 * Get a standard string name for a connector type 
 */
923
extern _X_EXPORT const char *xf86ConnectorGetName(xf86ConnectorType connector);
924

925 926 927 928 929
/*
 * Using the desired mode information in each crtc, set
 * modes (used in EnterVT functions, or at server startup)
 */

930
extern _X_EXPORT Bool
931
 xf86SetDesiredModes(ScrnInfoPtr pScrn);
932

933 934 935 936 937 938
/**
 * Initialize the CRTC-based cursor code. CRTC function vectors must
 * contain relevant cursor setting functions.
 *
 * Driver should call this from ScreenInit function
 */
939
extern _X_EXPORT Bool
940
 xf86_cursors_init(ScreenPtr screen, int max_width, int max_height, int flags);
941 942 943 944 945 946 947 948

/**
 * Called when anything on the screen is reconfigured.
 *
 * Reloads cursor images as needed, then adjusts cursor positions.
 * 
 * Driver should call this from crtc commit function.
 */
949
extern _X_EXPORT void
950
 xf86_reload_cursors(ScreenPtr screen);
951 952 953 954

/**
 * Called from EnterVT to turn the cursors back on
 */
955
extern _X_EXPORT void
956
 xf86_show_cursors(ScrnInfoPtr scrn);
957 958 959 960

/**
 * Called by the driver to turn cursors off
 */
961
extern _X_EXPORT void
962
 xf86_hide_cursors(ScrnInfoPtr scrn);
963 964 965 966

/**
 * Clean up CRTC-based cursor code. Driver must call this at CloseScreen time.
 */
967
extern _X_EXPORT void
968
 xf86_cursors_fini(ScreenPtr screen);
969

970 971 972 973 974 975
/**
 * Transform the cursor's coordinates based on the crtc transform.  Normally
 * this is done by the server, but if crtc->driverIsPerformingTransform is TRUE,
 * then the server does not transform the cursor position automatically.
 */
extern _X_EXPORT void
976
 xf86CrtcTransformCursorPos(xf86CrtcPtr crtc, int *x, int *y);
977

978
#ifdef XV
979 980 981 982 983 984
/*
 * For overlay video, compute the relevant CRTC and
 * clip video to that.
 * wraps xf86XVClipVideoHelper()
 */

985
extern _X_EXPORT Bool
986

987
xf86_crtc_clip_video_helper(ScrnInfoPtr pScrn,
988 989 990 991 992 993 994 995
                            xf86CrtcPtr * crtc_ret,
                            xf86CrtcPtr desired_crtc,
                            BoxPtr dst,
                            INT32 *xa,
                            INT32 *xb,
                            INT32 *ya,
                            INT32 *yb,
                            RegionPtr reg, INT32 width, INT32 height);
996
#endif
997

998
extern _X_EXPORT xf86_crtc_notify_proc_ptr
999
xf86_wrap_crtc_notify(ScreenPtr pScreen, xf86_crtc_notify_proc_ptr new);
1000

1001
extern _X_EXPORT void
1002
 xf86_unwrap_crtc_notify(ScreenPtr pScreen, xf86_crtc_notify_proc_ptr old);
1003

1004
extern _X_EXPORT void
1005
 xf86_crtc_notify(ScreenPtr pScreen);
1006

1007 1008 1009 1010
/**
 * Gamma
 */

1011
extern _X_EXPORT Bool
1012
 xf86_crtc_supports_gamma(ScrnInfoPtr pScrn);
1013

1014 1015 1016 1017
extern _X_EXPORT void
xf86ProviderSetup(ScrnInfoPtr scrn,
                  const xf86ProviderFuncsRec * funcs, const char *name);

1018 1019 1020
extern _X_EXPORT void
xf86DetachAllCrtc(ScrnInfoPtr scrn);

1021
#endif                          /* _XF86CRTC_H_ */