xfree86/doc/README.modes

9 underlying hardware CRTC and output concepts to the xf86 DDX layer so that
30 the 'CRTC' (xf86CrtcRec) and the 'Output' (xf86OutputRec). A CRTC refers to
57 other outputs which can be simutaneously connected to a CRTC.
59 2.1.2 CRTC overview
66 Each crtc has an associated cursor, along with the current configuration.
92 This function allocates and initializes structures needed to track CRTC and
106 Create one CRTC object. See the discussion below for a description of the
109 each CRTC present in the hardware.
167 This function completes the screen initialization process for the crtc and
232     xf86CrtcSetMode (xf86CrtcPtr crtc, DisplayModePtr mode, Rotation rotation,
235 Applies a mode to a CRTC. All of the outputs which are currently using the
236 specified CRTC are included in the mode setting process. 'x' and 'y' are the
237 offset within the frame buffer that the crtc is placed at. No checking is
255 operations. The current 'desired' mode for the CRTC associated with the
273 any leftover Output and CRTC objects by disabling them, saving power. It is
277 4. CRTC operations
279 4.1 CRTC functions
281 These functions provide an abstract interface for the CRTC object; most
282 manipulation of the CRTC object is done through these functions.
285     crtc->funcs->dpms (xf86CrtcPtr crtc, int mode)
288 DPMSModeOn. This requests that the crtc go to the specified power state.
290 crtc dpms functions.
293     crtc->funcs->save (xf86CrtcPtr crtc)
296     crtc->funcs->restore (xf86CrtcPtr crtc)
298 Preserve/restore any register contents related to the CRTC. These are
304     crtc->funcs->lock (xf86CrtcPtr crtc)
307     crtc->funcs->unlock (xf86CrtcPtr crtc)
315     crtc->funcs->mode_fixup (xf86CrtcPtr crtc,
319 This call gives the CRTC a chance to see what mode will be set and to
321 shall not modify the state of the crtc hardware at all. If the CRTC cannot
325     crtc->funcs->prepare (xf86CrtcPtr crtc)
328 the operation. A usual function to perform here is to disable the crtc so
332     crtc->funcs->mode_set (xf86CrtcPtr crtc,
336 This function applies the specified mode (possibly adjusted by the CRTC
340     crtc->funcs->commit (xf86CrtcPtr crtc)
342 Once the mode has been applied to the CRTC and Outputs, this function is
346     crtc->funcs->gamma_set (xf86CrtcPtr crtc, CARD16 *red,
349 This function adjusts the gamma ramps for the specified crtc.
352     crtc->funcs->shadow_allocate (xf86CrtcPtr crtc, int width, int height)
355 allocated, the crtc must scan from the shadow instead of the main frame
360     crtc->funcs->shadow_create (xf86CrtcPtr crtc, void *data,
368     crtc->funcs->shadow_destroy (xf86CrtcPtr crtc, PixmapPtr pPixmap,
376     crtc->funcs->destroy (xf86CrtcPtr crtc)
378 When a CRTC is destroyed (which only happens in error cases), this function
381 4.2 CRTC fields
383 The CRTC object is not opaque; there are several fields of interest to the
393 	 * Active state of this CRTC
395 	 * Set when this CRTC is driving one or more outputs
399 	/** Track whether cursor is within CRTC range  */
402 	/** Track state of cursor associated with this CRTC */
408 	 * This reflects the mode as set in the CRTC currently
420 	 * Locates this CRTC within the frame buffer
436 	/** crtc-specific functions */
447 	 * RandR crtc
450 	 * points at the associated crtc object