1<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>struct drm_crtc_state</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux GPU Driver Developer's Guide"><link rel="up" href="drm-kms-init.html#id-1.3.4.8.10" title="KMS Data Structures"><link rel="prev" href="API-drm-mode-create-tile-group.html" title="drm_mode_create_tile_group"><link rel="next" href="API-struct-drm-crtc-funcs.html" title="struct drm_crtc_funcs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">struct drm_crtc_state</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-drm-mode-create-tile-group.html">Prev</a> </td><th width="60%" align="center">KMS Data Structures</th><td width="20%" align="right"> <a accesskey="n" href="API-struct-drm-crtc-funcs.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-struct-drm-crtc-state"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>struct drm_crtc_state — 
2  mutable CRTC state
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="programlisting">
4struct drm_crtc_state {
5  struct drm_crtc * crtc;
6  bool enable;
7  bool active;
8  bool planes_changed:1;
9  bool mode_changed:1;
10  bool active_changed:1;
11  bool connectors_changed:1;
12  u32 plane_mask;
13  u32 last_vblank_count;
14  struct drm_display_mode adjusted_mode;
15  struct drm_display_mode mode;
16  struct drm_pending_vblank_event * event;
17  struct drm_atomic_state * state;
18};  </pre></div><div class="refsect1"><a name="id-1.3.4.8.10.2.5"></a><h2>Members</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">crtc</span></dt><dd><p>
19backpointer to the CRTC
20      </p></dd><dt><span class="term">enable</span></dt><dd><p>
21whether the CRTC should be enabled, gates all other state
22      </p></dd><dt><span class="term">active</span></dt><dd><p>
23whether the CRTC is actively displaying (used for DPMS)
24      </p></dd><dt><span class="term">planes_changed</span></dt><dd><p>
25planes on this crtc are updated
26      </p></dd><dt><span class="term">mode_changed</span></dt><dd><p>
27crtc_state-&gt;mode or crtc_state-&gt;enable has been changed
28      </p></dd><dt><span class="term">active_changed</span></dt><dd><p>
29crtc_state-&gt;active has been toggled.
30      </p></dd><dt><span class="term">connectors_changed</span></dt><dd><p>
31connectors to this crtc have been updated
32      </p></dd><dt><span class="term">plane_mask</span></dt><dd><p>
33bitmask of (1 &lt;&lt; drm_plane_index(plane)) of attached planes
34      </p></dd><dt><span class="term">last_vblank_count</span></dt><dd><p>
35for helpers and drivers to capture the vblank of the
36update to ensure framebuffer cleanup isn't done too early
37      </p></dd><dt><span class="term">adjusted_mode</span></dt><dd><p>
38for use by helpers and drivers to compute adjusted mode timings
39      </p></dd><dt><span class="term">mode</span></dt><dd><p>
40current mode timings
41      </p></dd><dt><span class="term">event</span></dt><dd><p>
42optional pointer to a DRM event to signal upon completion of the
43state update
44      </p></dd><dt><span class="term">state</span></dt><dd><p>
45backpointer to global drm_atomic_state
46      </p></dd></dl></div></div><div class="refsect1"><a name="id-1.3.4.8.10.2.6"></a><h2>Description</h2><p>
47   Note that the distinction between <em class="parameter"><code>enable</code></em> and <em class="parameter"><code>active</code></em> is rather subtile:
48   Flipping <em class="parameter"><code>active</code></em> while <em class="parameter"><code>enable</code></em> is set without changing anything else may
49   never return in a failure from the -&gt;atomic_check callback. Userspace assumes
50   that a DPMS On will always succeed. In other words: <em class="parameter"><code>enable</code></em> controls resource
51   assignment, <em class="parameter"><code>active</code></em> controls the actual hardware state.
52</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-drm-mode-create-tile-group.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="drm-kms-init.html#id-1.3.4.8.10">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-struct-drm-crtc-funcs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">drm_mode_create_tile_group</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">struct drm_crtc_funcs</span></td></tr></table></div></body></html>
53