include/drm/drm_modes.h

3  * Copyright © 2007-2008 Dave Airlie
4  * Copyright © 2007-2008 Intel Corporation
40  * DVI, etc.  And 'screen' refers to the whole of the visible display, which
46  * enum drm_mode_status - hardware support status of a mode
50  * @MODE_H_ILLEGAL: mode has illegal horizontal timings
51  * @MODE_V_ILLEGAL: mode has illegal vertical timings
129 	MODE_STALE = -3,
130 	MODE_BAD = -2,
131 	MODE_ERROR = -1
142  * DRM_SIMPLE_MODE - Simple display mode
145  * @hd_mm: Display width in millimeters
146  * @vd_mm: Display height in millimeters
159 #define CRTC_STEREO_DOUBLE	(1 << 1) /* adjust timings for stereo modes */
173  * struct drm_display_mode - DRM kernel-internal display mode structure
174  * @hdisplay: horizontal display size
179  * @vdisplay: vertical display size
184  * @crtc_hdisplay: hardware mode horizontal display size
191  * @crtc_vdisplay: hardware mode vertical display size
198  * The horizontal and vertical timings are defined per the following diagram.
205  *     <-----------------------><----------------><-------------><-------------->
210  *     <----- [hv]display ----->
211  *     <------------- [hv]sync_start ------------>
212  *     <--------------------- [hv]sync_end --------------------->
213  *     <-------------------------------- [hv]total ----------------------------->*
215  * This structure contains two copies of timings. First are the plain timings,
218  * there's the hardware timings, which are corrected for interlacing,
219  * double-clocking and similar things. They are provided as a convenience, and
246 	 *  - DRM_MODE_FLAG_PHSYNC: horizontal sync is active high.
247 	 *  - DRM_MODE_FLAG_NHSYNC: horizontal sync is active low.
248 	 *  - DRM_MODE_FLAG_PVSYNC: vertical sync is active high.
249 	 *  - DRM_MODE_FLAG_NVSYNC: vertical sync is active low.
250 	 *  - DRM_MODE_FLAG_INTERLACE: mode is interlaced.
251 	 *  - DRM_MODE_FLAG_DBLSCAN: mode uses doublescan.
252 	 *  - DRM_MODE_FLAG_CSYNC: mode uses composite sync.
253 	 *  - DRM_MODE_FLAG_PCSYNC: composite sync is active high.
254 	 *  - DRM_MODE_FLAG_NCSYNC: composite sync is active low.
255 	 *  - DRM_MODE_FLAG_HSKEW: hskew provided (not used?).
256 	 *  - DRM_MODE_FLAG_BCAST: <deprecated>
257 	 *  - DRM_MODE_FLAG_PIXMUX: <deprecated>
258 	 *  - DRM_MODE_FLAG_DBLCLK: double-clocked mode.
259 	 *  - DRM_MODE_FLAG_CLKDIV2: half-clocked mode.
263 	 *  - DRM_MODE_FLAG_3D_NONE: normal, non-3D mode.
264 	 *  - DRM_MODE_FLAG_3D_FRAME_PACKING: 2 full frames for left and right.
265 	 *  - DRM_MODE_FLAG_3D_FIELD_ALTERNATIVE: interleaved like fields.
266 	 *  - DRM_MODE_FLAG_3D_LINE_ALTERNATIVE: interleaved lines.
267 	 *  - DRM_MODE_FLAG_3D_SIDE_BY_SIDE_FULL: side-by-side full frames.
268 	 *  - DRM_MODE_FLAG_3D_L_DEPTH: ?
269 	 *  - DRM_MODE_FLAG_3D_L_DEPTH_GFX_GFX_DEPTH: ?
270 	 *  - DRM_MODE_FLAG_3D_TOP_AND_BOTTOM: frame split into top and bottom
272 	 *  - DRM_MODE_FLAG_3D_SIDE_BY_SIDE_HALF: frame split into left and
281 	 * logical @clock when e.g. using interlacing, double-clocking, stereo
282 	 * modes or other fancy stuff that changes the timings and signals
329 	 *  - DRM_MODE_TYPE_PREFERRED: Preferred mode, usually the native
332 	 *  - DRM_MODE_TYPE_DRIVER: Mode created by the driver, which is all of
335 	 *  - DRM_MODE_TYPE_USERDEF: Mode defined or selected via the kernel
342 	 *  - DRM_MODE_TYPE_BUILTIN: Meant for hard-coded modes, unused.
344 	 *  - DRM_MODE_TYPE_DEFAULT: Again a leftover, use
346 	 *  - DRM_MODE_TYPE_CLOCK_C and DRM_MODE_TYPE_CRTC_C: Define leftovers
357 	 * user-mode's list in drm_mode_getconnector ioctl. The purpose of
373 	 * Human-readable name of the mode, filled out with drm_mode_set_name().
395  * DRM_MODE_FMT - printf string for &struct drm_display_mode
400  * DRM_MODE_ARG - printf arguments for &struct drm_display_mode
401  * @m: display mode
404 	(m)->name, drm_mode_vrefresh(m), (m)->clock, \
405 	(m)->hdisplay, (m)->hsync_start, (m)->hsync_end, (m)->htotal, \
406 	(m)->vdisplay, (m)->vsync_start, (m)->vsync_end, (m)->vtotal, \
407 	(m)->type, (m)->flags
412  * drm_mode_is_stereo - check for stereo mode flags
416  * True if the mode is one of the stereo modes (like side-by-side), false if
421 	return mode->flags & DRM_MODE_FLAG_3D_MASK;  in drm_mode_is_stereo()
436 bool drm_mode_is_420_only(const struct drm_display_info *display,
438 bool drm_mode_is_420_also(const struct drm_display_info *display,
440 bool drm_mode_is_420(const struct drm_display_info *display,