Sophie

Sophie

distrib > Mageia > 6 > armv5tl > media > core-updates > by-pkgid > 768f7d9f703884aa2562bf0a651086df > files > 4203

qtbase5-doc-5.9.4-1.1.mga6.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- imagecomposition.qdoc -->
  <title>Image Composition Example | Qt Widgets 5.9</title>
  <link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
  <script type="text/javascript">
    document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
    // loading style sheet breaks anchors that were jumped to before
    // so force jumping to anchor again
    setTimeout(function() {
        var anchor = location.hash;
        // need to jump to different anchor first (e.g. none)
        location.hash = "#";
        setTimeout(function() {
            location.hash = anchor;
        }, 0);
    }, 0);
  </script>
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="main">
    <div class="main-rounded">
      <div class="navigationbar">
        <table><tr>
<td >Qt 5.9</td><td ><a href="qtwidgets-index.html">Qt Widgets</a></td><td >Image Composition Example</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td>
        </tr></table>
      </div>
    </div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#setting-up-the-resource-file">Setting Up The Resource File</a></li>
<li class="level1"><a href="#imagecomposer-class-definition">ImageComposer Class Definition</a></li>
<li class="level1"><a href="#imagecomposer-class-implementation">ImageComposer Class Implementation</a></li>
<li class="level1"><a href="#the-main-function">The <code>main()</code> Function</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Image Composition Example</h1>
<span class="subtitle"></span>
<!-- $$$painting/imagecomposition-description -->
<div class="descr"> <a name="details"></a>
<p class="centerAlign"><img src="images/imagecomposition-example.png" alt="" /></p><a name="setting-up-the-resource-file"></a>
<h2 id="setting-up-the-resource-file">Setting Up The Resource File</h2>
<p>The Image Composition example requires two source images, <i>butterfly.png</i> and <i>checker.png</i> that are embedded within <i>imagecomposition.qrc</i>. The file contains the following code:</p>
<pre class="cpp">

  &lt;!DOCTYPE RCC&gt;&lt;RCC version=&quot;1.0&quot;&gt;
  &lt;qresource&gt;
      &lt;file&gt;images/butterfly.png&lt;/file&gt;
      &lt;file&gt;images/checker.png&lt;/file&gt;
  &lt;/qresource&gt;
  &lt;/RCC&gt;

</pre>
<p>For more information on resource files, see <a href="../qtcore/resources.html">The Qt Resource System</a>.</p>
<a name="imagecomposer-class-definition"></a>
<h2 id="imagecomposer-class-definition">ImageComposer Class Definition</h2>
<p>The <code>ImageComposer</code> class is a subclass of <a href="qwidget.html">QWidget</a> that implements three private slots, <code>chooseSource()</code>, <code>chooseDestination()</code>, and <code>recalculateResult()</code>.</p>
<pre class="cpp">

  <span class="keyword">class</span> ImageComposer : <span class="keyword">public</span> <span class="type"><a href="qwidget.html">QWidget</a></span>
  {
      Q_OBJECT

  <span class="keyword">public</span>:
      ImageComposer();

  <span class="keyword">private</span> <span class="keyword">slots</span>:
      <span class="type">void</span> chooseSource();
      <span class="type">void</span> chooseDestination();
      <span class="type">void</span> recalculateResult();

</pre>
<p>In addition, <code>ImageComposer</code> consists of five private functions, <code>addOp()</code>, <code>chooseImage()</code>, <code>loadImage()</code>, <code>currentMode()</code>, and <code>imagePos()</code>, as well as private instances of <a href="qtoolbutton.html">QToolButton</a>, <a href="qcombobox.html">QComboBox</a>, <a href="qlabel.html">QLabel</a>, and <a href="../qtgui/qimage.html">QImage</a>.</p>
<pre class="cpp">

  <span class="keyword">private</span>:
      <span class="type">void</span> addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode mode<span class="operator">,</span> <span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>name);
      <span class="type">void</span> chooseImage(<span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>title<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">*</span>image<span class="operator">,</span> <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>button);
      <span class="type">void</span> loadImage(<span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>fileName<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">*</span>image<span class="operator">,</span> <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>button);
      <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode currentMode() <span class="keyword">const</span>;
      <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> imagePos(<span class="keyword">const</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">&amp;</span>image) <span class="keyword">const</span>;

      <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>sourceButton;
      <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>destinationButton;
      <span class="type"><a href="qcombobox.html">QComboBox</a></span> <span class="operator">*</span>operatorComboBox;
      <span class="type"><a href="qlabel.html">QLabel</a></span> <span class="operator">*</span>equalLabel;
      <span class="type"><a href="qlabel.html">QLabel</a></span> <span class="operator">*</span>resultLabel;

      <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> sourceImage;
      <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> destinationImage;
      <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> resultImage;
  };

</pre>
<a name="imagecomposer-class-implementation"></a>
<h2 id="imagecomposer-class-implementation">ImageComposer Class Implementation</h2>
<p>We declare a <a href="../qtcore/qsize.html">QSize</a> object, <code>resultSize</code>, as a static constant with width and height equal to 200.</p>
<pre class="cpp">

  <span class="keyword">static</span> <span class="keyword">const</span> <span class="type"><a href="../qtcore/qsize.html">QSize</a></span> resultSize(<span class="number">200</span><span class="operator">,</span> <span class="number">200</span>);

</pre>
<p>Within the constructor, we instantiate a <a href="qtoolbutton.html">QToolButton</a> object, <code>sourceButton</code> and set its <a href="qabstractbutton.html#iconSize-prop">iconSize</a> property to <code>resultSize</code>. The <code>operatorComboBox</code> is instantiated and then populated using the <code>addOp()</code> function. This function accepts a <a href="../qtgui/qpainter.html#CompositionMode-enum">QPainter::CompositionMode</a>, <i>mode</i>, and a <a href="../qtcore/qstring.html">QString</a>, <i>name</i>, representing the name of the composition mode.</p>
<pre class="cpp">

  ImageComposer<span class="operator">::</span>ImageComposer()
  {
      sourceButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qtoolbutton.html">QToolButton</a></span>;
      sourceButton<span class="operator">-</span><span class="operator">&gt;</span>setIconSize(resultSize);

      operatorComboBox <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcombobox.html">QComboBox</a></span>;
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceOver<span class="operator">,</span> tr(<span class="string">&quot;SourceOver&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_DestinationOver<span class="operator">,</span> tr(<span class="string">&quot;DestinationOver&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Clear<span class="operator">,</span> tr(<span class="string">&quot;Clear&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Source<span class="operator">,</span> tr(<span class="string">&quot;Source&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Destination<span class="operator">,</span> tr(<span class="string">&quot;Destination&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceIn<span class="operator">,</span> tr(<span class="string">&quot;SourceIn&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_DestinationIn<span class="operator">,</span> tr(<span class="string">&quot;DestinationIn&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceOut<span class="operator">,</span> tr(<span class="string">&quot;SourceOut&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_DestinationOut<span class="operator">,</span> tr(<span class="string">&quot;DestinationOut&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceAtop<span class="operator">,</span> tr(<span class="string">&quot;SourceAtop&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_DestinationAtop<span class="operator">,</span> tr(<span class="string">&quot;DestinationAtop&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Xor<span class="operator">,</span> tr(<span class="string">&quot;Xor&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Plus<span class="operator">,</span> tr(<span class="string">&quot;Plus&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Multiply<span class="operator">,</span> tr(<span class="string">&quot;Multiply&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Screen<span class="operator">,</span> tr(<span class="string">&quot;Screen&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Overlay<span class="operator">,</span> tr(<span class="string">&quot;Overlay&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Darken<span class="operator">,</span> tr(<span class="string">&quot;Darken&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Lighten<span class="operator">,</span> tr(<span class="string">&quot;Lighten&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_ColorDodge<span class="operator">,</span> tr(<span class="string">&quot;ColorDodge&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_ColorBurn<span class="operator">,</span> tr(<span class="string">&quot;ColorBurn&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_HardLight<span class="operator">,</span> tr(<span class="string">&quot;HardLight&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SoftLight<span class="operator">,</span> tr(<span class="string">&quot;SoftLight&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Difference<span class="operator">,</span> tr(<span class="string">&quot;Difference&quot;</span>));
      addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Exclusion<span class="operator">,</span> tr(<span class="string">&quot;Exclusion&quot;</span>));

</pre>
<p>The <code>destinationButton</code> is instantiated and its <a href="qabstractbutton.html#iconSize-prop">iconSize</a> property is set to <code>resultSize</code> as well. The <a href="qlabel.html">QLabel</a>s <code>equalLabel</code> and <code>resultLabel</code> are created and <code>resultLabel</code>'s <a href="qwidget.html#minimumWidth-prop">minimumWidth</a> is set.</p>
<pre class="cpp">

      destinationButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qtoolbutton.html">QToolButton</a></span>;
      destinationButton<span class="operator">-</span><span class="operator">&gt;</span>setIconSize(resultSize);

      equalLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;=&quot;</span>));

      resultLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qlabel.html">QLabel</a></span>;
      resultLabel<span class="operator">-</span><span class="operator">&gt;</span>setMinimumWidth(resultSize<span class="operator">.</span>width());

</pre>
<p>We connect the following signals to their corresponding slots:</p>
<ul>
<li><code>sourceButton</code>'s <a href="qabstractbutton.html#clicked">clicked()</a> signal is connected to <code>chooseSource()</code>,</li>
<li><code>operatorComboBox</code>'s <a href="qcombobox.html#activated">activated()</a> signal is connected to <code>recalculateResult()</code>, and</li>
<li><code>destinationButton</code>'s <a href="qabstractbutton.html#clicked">clicked()</a> signal is connected to <code>chooseDestination()</code>.</li>
</ul>
<pre class="cpp">

      connect(sourceButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(chooseSource()));
      connect(operatorComboBox<span class="operator">,</span> SIGNAL(activated(<span class="type">int</span>))<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(recalculateResult()));
      connect(destinationButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(chooseDestination()));

</pre>
<p>A <a href="qgridlayout.html">QGridLayout</a>, <code>mainLayout</code>, is used to place all the widgets. Note that <code>mainLayout</code>'s <a href="qlayout.html#sizeConstraint-prop">sizeConstraint</a> property is set to <a href="qlayout.html#SizeConstraint-enum">QLayout::SetFixedSize</a>, which means that <code>ImageComposer</code>'s size cannot be resized at all.</p>
<pre class="cpp">

      <span class="type"><a href="qgridlayout.html">QGridLayout</a></span> <span class="operator">*</span>mainLayout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qgridlayout.html">QGridLayout</a></span>;
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(sourceButton<span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">3</span><span class="operator">,</span> <span class="number">1</span>);
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(operatorComboBox<span class="operator">,</span> <span class="number">1</span><span class="operator">,</span> <span class="number">1</span>);
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(destinationButton<span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">2</span><span class="operator">,</span> <span class="number">3</span><span class="operator">,</span> <span class="number">1</span>);
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(equalLabel<span class="operator">,</span> <span class="number">1</span><span class="operator">,</span> <span class="number">3</span>);
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(resultLabel<span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">4</span><span class="operator">,</span> <span class="number">3</span><span class="operator">,</span> <span class="number">1</span>);
      mainLayout<span class="operator">-</span><span class="operator">&gt;</span>setSizeConstraint(<span class="type"><a href="qlayout.html">QLayout</a></span><span class="operator">::</span>SetFixedSize);
      setLayout(mainLayout);

</pre>
<p>We create a <a href="../qtgui/qimage.html">QImage</a>, <code>resultImage</code>, and we invoke <code>loadImage()</code> twice to load both the image files in our <i>imagecomposition.qrc</i> file. Then, we set the <a href="qwidget.html#windowTitle-prop">windowTitle</a> property to &quot;Image Composition&quot;.</p>
<pre class="cpp">

      resultImage <span class="operator">=</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span>(resultSize<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span><span class="operator">::</span>Format_ARGB32_Premultiplied);

      loadImage(<span class="string">&quot;:/images/butterfly.png&quot;</span><span class="operator">,</span> <span class="operator">&amp;</span>sourceImage<span class="operator">,</span> sourceButton);
      loadImage(<span class="string">&quot;:/images/checker.png&quot;</span><span class="operator">,</span> <span class="operator">&amp;</span>destinationImage<span class="operator">,</span> destinationButton);

      setWindowTitle(tr(<span class="string">&quot;Image Composition&quot;</span>));
  }

</pre>
<p>The <code>chooseSource()</code> and <code>chooseDestination()</code> functions are convenience functions that invoke <code>chooseImage()</code> with specific parameters.</p>
<pre class="cpp">

  <span class="type">void</span> ImageComposer<span class="operator">::</span>chooseSource()
  {
      chooseImage(tr(<span class="string">&quot;Choose Source Image&quot;</span>)<span class="operator">,</span> <span class="operator">&amp;</span>sourceImage<span class="operator">,</span> sourceButton);
  }

  <span class="type">void</span> ImageComposer<span class="operator">::</span>chooseDestination()
  {
      chooseImage(tr(<span class="string">&quot;Choose Destination Image&quot;</span>)<span class="operator">,</span> <span class="operator">&amp;</span>destinationImage<span class="operator">,</span> destinationButton);
  }

</pre>
<p>The <code>chooseImage()</code> function loads an image of the user's choice, depending on the <i>title</i>, <i>image</i>, and <i>button</i>.</p>
<pre class="cpp">

  <span class="type">void</span> ImageComposer<span class="operator">::</span>chooseImage(<span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>title<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">*</span>image<span class="operator">,</span>
                                  <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>button)
  {
      <span class="type"><a href="../qtcore/qstring.html">QString</a></span> fileName <span class="operator">=</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">::</span>getOpenFileName(<span class="keyword">this</span><span class="operator">,</span> title);
      <span class="keyword">if</span> (<span class="operator">!</span>fileName<span class="operator">.</span>isEmpty())
          loadImage(fileName<span class="operator">,</span> image<span class="operator">,</span> button);
  }

</pre>
<p>The <code>recalculateResult()</code> function is used to calculate amd display the result of combining the two images together with the user's choice of composition mode.</p>
<pre class="cpp">

  <span class="type">void</span> ImageComposer<span class="operator">::</span>recalculateResult()
  {
      <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode mode <span class="operator">=</span> currentMode();

      <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span> painter(<span class="operator">&amp;</span>resultImage);
      painter<span class="operator">.</span>setCompositionMode(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Source);
      painter<span class="operator">.</span>fillRect(resultImage<span class="operator">.</span>rect()<span class="operator">,</span> <span class="type"><a href="../qtcore/qt.html">Qt</a></span><span class="operator">::</span>transparent);
      painter<span class="operator">.</span>setCompositionMode(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceOver);
      painter<span class="operator">.</span>drawImage(<span class="number">0</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> destinationImage);
      painter<span class="operator">.</span>setCompositionMode(mode);
      painter<span class="operator">.</span>drawImage(<span class="number">0</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> sourceImage);
      painter<span class="operator">.</span>setCompositionMode(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_DestinationOver);
      painter<span class="operator">.</span>fillRect(resultImage<span class="operator">.</span>rect()<span class="operator">,</span> <span class="type"><a href="../qtcore/qt.html">Qt</a></span><span class="operator">::</span>white);
      painter<span class="operator">.</span>end();

      resultLabel<span class="operator">-</span><span class="operator">&gt;</span>setPixmap(<span class="type"><a href="../qtgui/qpixmap.html">QPixmap</a></span><span class="operator">::</span>fromImage(resultImage));
  }

</pre>
<p>The <code>addOp()</code> function adds an item to the <code>operatorComboBox</code> using <a href="qcombobox.html">QComboBox</a>'s <a href="qcombobox.html#addItem">addItem</a> function. This function accepts a <a href="../qtgui/qpainter.html#CompositionMode-enum">QPainter::CompositionMode</a>, <i>mode</i>, and a <a href="../qtcore/qstring.html">QString</a>, <i>name</i>. The rectangle is filled with Qt::Transparent and both the <code>sourceImage</code> and <code>destinationImage</code> are painted, before displaying it on <code>resultLabel</code>.</p>
<pre class="cpp">

  <span class="type">void</span> ImageComposer<span class="operator">::</span>addOp(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode mode<span class="operator">,</span> <span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>name)
  {
      operatorComboBox<span class="operator">-</span><span class="operator">&gt;</span>addItem(name<span class="operator">,</span> mode);
  }

</pre>
<p>The <code>loadImage()</code> function paints a transparent background using <a href="../qtgui/qpainter.html#fillRect-10">fillRect()</a> and draws <code>image</code> in a centralized position using <a href="../qtgui/qpainter.html#drawImage-7">drawImage()</a>. This <code>image</code> is then set as the <code>button</code>'s icon.</p>
<pre class="cpp">

  <span class="type">void</span> ImageComposer<span class="operator">::</span>loadImage(<span class="keyword">const</span> <span class="type"><a href="../qtcore/qstring.html">QString</a></span> <span class="operator">&amp;</span>fileName<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">*</span>image<span class="operator">,</span>
                                <span class="type"><a href="qtoolbutton.html">QToolButton</a></span> <span class="operator">*</span>button)
  {
      image<span class="operator">-</span><span class="operator">&gt;</span>load(fileName);

      <span class="comment">// Scale the image to given size</span>
      <span class="operator">*</span>image <span class="operator">=</span> image<span class="operator">-</span><span class="operator">&gt;</span>scaled(resultSize<span class="operator">,</span> <span class="type"><a href="../qtcore/qt.html">Qt</a></span><span class="operator">::</span>KeepAspectRatio);

      <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> fixedImage(resultSize<span class="operator">,</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span><span class="operator">::</span>Format_ARGB32_Premultiplied);
      <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span> painter(<span class="operator">&amp;</span>fixedImage);
      painter<span class="operator">.</span>setCompositionMode(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_Source);
      painter<span class="operator">.</span>fillRect(fixedImage<span class="operator">.</span>rect()<span class="operator">,</span> <span class="type"><a href="../qtcore/qt.html">Qt</a></span><span class="operator">::</span>transparent);
      painter<span class="operator">.</span>setCompositionMode(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode_SourceOver);
      painter<span class="operator">.</span>drawImage(imagePos(<span class="operator">*</span>image)<span class="operator">,</span> <span class="operator">*</span>image);
      painter<span class="operator">.</span>end();
      button<span class="operator">-</span><span class="operator">&gt;</span>setIcon(<span class="type"><a href="../qtgui/qpixmap.html">QPixmap</a></span><span class="operator">::</span>fromImage(fixedImage));

      <span class="operator">*</span>image <span class="operator">=</span> fixedImage;

      recalculateResult();
  }

</pre>
<p>The <code>currentMode()</code> function returns the composition mode currently selected in <code>operatorComboBox</code>.</p>
<pre class="cpp">

  <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode ImageComposer<span class="operator">::</span>currentMode() <span class="keyword">const</span>
  {
      <span class="keyword">return</span> (<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span><span class="operator">::</span>CompositionMode)
             operatorComboBox<span class="operator">-</span><span class="operator">&gt;</span>itemData(operatorComboBox<span class="operator">-</span><span class="operator">&gt;</span>currentIndex())<span class="operator">.</span>toInt();
  }

</pre>
<p>We use the <code>imagePos()</code> function to ensure that images loaded onto the <a href="qtoolbutton.html">QToolButton</a> objects, <code>sourceButton</code> and <code>destinationButton</code>, are centralized.</p>
<pre class="cpp">

  <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> ImageComposer<span class="operator">::</span>imagePos(<span class="keyword">const</span> <span class="type"><a href="../qtgui/qimage.html">QImage</a></span> <span class="operator">&amp;</span>image) <span class="keyword">const</span>
  {
      <span class="keyword">return</span> <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span>((resultSize<span class="operator">.</span>width() <span class="operator">-</span> image<span class="operator">.</span>width()) <span class="operator">/</span> <span class="number">2</span><span class="operator">,</span>
                    (resultSize<span class="operator">.</span>height() <span class="operator">-</span> image<span class="operator">.</span>height()) <span class="operator">/</span> <span class="number">2</span>);
  }

</pre>
<a name="the-main-function"></a>
<h2 id="the-main-function">The <code>main()</code> Function</h2>
<p>The <code>main()</code> function instantiates <a href="qapplication.html">QApplication</a> and <code>ImageComposer</code> and invokes its <a href="qwidget.html#show">show()</a> function.</p>
<pre class="cpp">

  <span class="type">int</span> main(<span class="type">int</span> argc<span class="operator">,</span> <span class="type">char</span> <span class="operator">*</span>argv<span class="operator">[</span><span class="operator">]</span>)
  {
      Q_INIT_RESOURCE(imagecomposition);

      <span class="type"><a href="qapplication.html">QApplication</a></span> app(argc<span class="operator">,</span> argv);
      ImageComposer composer;
      composer<span class="operator">.</span>show();
      <span class="keyword">return</span> app<span class="operator">.</span>exec();
  }

</pre>
<p>Files:</p>
<ul>
<li><a href="qtwidgets-painting-imagecomposition-imagecomposer-cpp.html">painting/imagecomposition/imagecomposer.cpp</a></li>
<li><a href="qtwidgets-painting-imagecomposition-imagecomposer-h.html">painting/imagecomposition/imagecomposer.h</a></li>
<li><a href="qtwidgets-painting-imagecomposition-main-cpp.html">painting/imagecomposition/main.cpp</a></li>
<li><a href="qtwidgets-painting-imagecomposition-imagecomposition-pro.html">painting/imagecomposition/imagecomposition.pro</a></li>
<li><a href="qtwidgets-painting-imagecomposition-imagecomposition-qrc.html">painting/imagecomposition/imagecomposition.qrc</a></li>
</ul>
<p>Images:</p>
<ul>
<li><a href="images/used-in-examples/painting/imagecomposition/images/background.png">painting/imagecomposition/images/background.png</a></li>
<li><a href="images/used-in-examples/painting/imagecomposition/images/blackrectangle.png">painting/imagecomposition/images/blackrectangle.png</a></li>
<li><a href="images/used-in-examples/painting/imagecomposition/images/butterfly.png">painting/imagecomposition/images/butterfly.png</a></li>
<li><a href="images/used-in-examples/painting/imagecomposition/images/checker.png">painting/imagecomposition/images/checker.png</a></li>
</ul>
</div>
<!-- @@@painting/imagecomposition -->
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2017 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>