1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>struct drm_crtc_state</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux DRM Developer's Guide"><link rel="up" href="drm-kms-init.html#idp1124538092" 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>&#160;</td><th width="60%" align="center">KMS Data Structures</th><td width="20%" align="right">&#160;<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 &#8212; 
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  u32 plane_mask;
12  u32 last_vblank_count;
13  struct drm_display_mode adjusted_mode;
14  struct drm_display_mode mode;
15  struct drm_pending_vblank_event * event;
16  struct drm_atomic_state * state;
17};  </pre></div><div class="refsect1"><a name="idp1124542708"></a><h2>Members</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">crtc</span></dt><dd><p>
18backpointer to the CRTC
19      </p></dd><dt><span class="term">enable</span></dt><dd><p>
20whether the CRTC should be enabled, gates all other state
21      </p></dd><dt><span class="term">active</span></dt><dd><p>
22whether the CRTC is actively displaying (used for DPMS)
23      </p></dd><dt><span class="term">planes_changed</span></dt><dd><p>
24for use by helpers and drivers when computing state updates
25      </p></dd><dt><span class="term">mode_changed</span></dt><dd><p>
26for use by helpers and drivers when computing state updates
27      </p></dd><dt><span class="term">active_changed</span></dt><dd><p>
28for use by helpers and drivers when computing state updates
29      </p></dd><dt><span class="term">plane_mask</span></dt><dd><p>
30bitmask of (1 &lt;&lt; drm_plane_index(plane)) of attached planes
31      </p></dd><dt><span class="term">last_vblank_count</span></dt><dd><p>
32for helpers and drivers to capture the vblank of the
33update to ensure framebuffer cleanup isn't done too early
34      </p></dd><dt><span class="term">adjusted_mode</span></dt><dd><p>
35for use by helpers and drivers to compute adjusted mode timings
36      </p></dd><dt><span class="term">mode</span></dt><dd><p>
37current mode timings
38      </p></dd><dt><span class="term">event</span></dt><dd><p>
39optional pointer to a DRM event to signal upon completion of the
40state update
41      </p></dd><dt><span class="term">state</span></dt><dd><p>
42backpointer to global drm_atomic_state
43      </p></dd></dl></div></div><div class="refsect1"><a name="idp1124552188"></a><h2>Description</h2><p>
44   Note that the distinction between <em class="parameter"><code>enable</code></em> and <em class="parameter"><code>active</code></em> is rather subtile:
45   Flipping <em class="parameter"><code>active</code></em> while <em class="parameter"><code>enable</code></em> is set without changing anything else may
46   never return in a failure from the -&gt;atomic_check callback. Userspace assumes
47   that a DPMS On will always succeed. In other words: <em class="parameter"><code>enable</code></em> controls resource
48   assignment, <em class="parameter"><code>active</code></em> controls the actual hardware state.
49</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>&#160;</td><td width="20%" align="center"><a accesskey="u" href="drm-kms-init.html#idp1124538092">Up</a></td><td width="40%" align="right">&#160;<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>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">struct drm_crtc_funcs</span></td></tr></table></div></body></html>
50