1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>drm_crtc_helper_set_mode</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="ch02s05.html#idp1125415036" title="Modeset Helper Functions Reference"><link rel="prev" href="API-drm-helper-disable-unused-functions.html" title="drm_helper_disable_unused_functions"><link rel="next" href="API-drm-crtc-helper-set-config.html" title="drm_crtc_helper_set_config"></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">drm_crtc_helper_set_mode</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-drm-helper-disable-unused-functions.html">Prev</a>&#160;</td><th width="60%" align="center">Modeset Helper Functions Reference</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-drm-crtc-helper-set-config.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-drm-crtc-helper-set-mode"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>drm_crtc_helper_set_mode &#8212; 
2     internal helper to set a mode
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">bool <b class="fsfunc">drm_crtc_helper_set_mode </b>(</code></td><td>struct drm_crtc * <var class="pdparam">crtc</var>, </td></tr><tr><td>&#160;</td><td>struct drm_display_mode * <var class="pdparam">mode</var>, </td></tr><tr><td>&#160;</td><td>int <var class="pdparam">x</var>, </td></tr><tr><td>&#160;</td><td>int <var class="pdparam">y</var>, </td></tr><tr><td>&#160;</td><td>struct drm_framebuffer * <var class="pdparam">old_fb</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1125501180"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>crtc</code></em></span></dt><dd><p>
4     CRTC to program
5    </p></dd><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
6     mode to use
7    </p></dd><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
8     horizontal offset into the surface
9    </p></dd><dt><span class="term"><em class="parameter"><code>y</code></em></span></dt><dd><p>
10     vertical offset into the surface
11    </p></dd><dt><span class="term"><em class="parameter"><code>old_fb</code></em></span></dt><dd><p>
12     old framebuffer, for cleanup
13    </p></dd></dl></div></div><div class="refsect1"><a name="idp1125506876"></a><h2>Description</h2><p>
14   Try to set <em class="parameter"><code>mode</code></em> on <em class="parameter"><code>crtc</code></em>.  Give <em class="parameter"><code>crtc</code></em> and its associated connectors a chance
15   to fixup or reject the mode prior to trying to set it. This is an internal
16   helper that drivers could e.g. use to update properties that require the
17   entire output pipe to be disabled and re-enabled in a new configuration. For
18   example for changing whether audio is enabled on a hdmi link or for changing
19   panel fitter or dither attributes. It is also called by the
20   <code class="function">drm_crtc_helper_set_config</code> helper function to drive the mode setting
21   sequence.
22</p></div><div class="refsect1"><a name="idp1125509412"></a><h2>Returns</h2><p>
23   True if the mode was set successfully, false otherwise.
24</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-helper-disable-unused-functions.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="ch02s05.html#idp1125415036">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-drm-crtc-helper-set-config.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">drm_helper_disable_unused_functions</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">drm_crtc_helper_set_config</span></td></tr></table></div></body></html>
25