<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.imagick.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'imagick.setimageartifact.php',
    1 => 'Imagick::setImageArtifact',
    2 => 'Set image artifact',
  ),
  'up' => 
  array (
    0 => 'class.imagick.php',
    1 => 'Imagick',
  ),
  'prev' => 
  array (
    0 => 'imagick.setimagealphachannel.php',
    1 => 'Imagick::setImageAlphaChannel',
  ),
  'next' => 
  array (
    0 => 'imagick.setimageattribute.php',
    1 => 'Imagick::setImageAttribute',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/imagick/imagick/setimageartifact.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="imagick.setimageartifact" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Imagick::setImageArtifact</h1>
  <p class="verinfo">(PECL imagick 3)</p><p class="refpurpose"><span class="refname">Imagick::setImageArtifact</span> &mdash; <span class="dc-title">Set image artifact</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-imagick.setimageartifact-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Imagick::setImageArtifact</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$artifact</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$value</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   Associates an artifact with the image. The difference between image properties and 
   image artifacts is that properties are public and artifacts are private.
   This method is available if Imagick has been compiled against ImageMagick version 6.5.7 or newer.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-imagick.setimageartifact-parameters">
  <h3 class="title">Parameters</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">artifact</code></dt>
     <dd>
      <p class="para">
       The name of the artifact
      </p>
     </dd>
    
    
     <dt><code class="parameter">value</code></dt>
     <dd>
      <p class="para">
       The value of the artifact
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-imagick.setimageartifact-returnvalues">
  <h3 class="title">Return Values</h3>
  <p class="para">
   Returns <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> on success.
  </p>
 </div>


 <div class="refsect1 errors" id="refsect1-imagick.setimageartifact-errors">
  <h3 class="title">Errors/Exceptions</h3>
  <p class="para">
   Throws ImagickException on error.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-imagick.setimageartifact-examples">
  <h3 class="title">Examples</h3>
  <p class="para">
    <div class="example" id="example-1">
      <p><strong>Example #1  <span class="function"><strong>Imagick::setImageArtifact()</strong></span></strong></p>
      <div class="example-contents">
      <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">setImageArtifact</span><span style="color: #007700">() {<br /><br />    </span><span style="color: #0000BB">$src1 </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Imagick</span><span style="color: #007700">(</span><span style="color: #0000BB">realpath</span><span style="color: #007700">(</span><span style="color: #DD0000">"./images/artifact/source1.png"</span><span style="color: #007700">));<br />    </span><span style="color: #0000BB">$src2 </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Imagick</span><span style="color: #007700">(</span><span style="color: #0000BB">realpath</span><span style="color: #007700">(</span><span style="color: #DD0000">"./images/artifact/source2.png"</span><span style="color: #007700">));<br /><br />    </span><span style="color: #0000BB">$src2</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">setImageVirtualPixelMethod</span><span style="color: #007700">(</span><span style="color: #0000BB">\Imagick</span><span style="color: #007700">::</span><span style="color: #0000BB">VIRTUALPIXELMETHOD_TRANSPARENT</span><span style="color: #007700">);<br />    </span><span style="color: #0000BB">$src2</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">setImageArtifact</span><span style="color: #007700">(</span><span style="color: #DD0000">'compose:args'</span><span style="color: #007700">, </span><span style="color: #DD0000">"1,0,-0.5,0.5"</span><span style="color: #007700">);<br />    </span><span style="color: #0000BB">$src1</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">compositeImage</span><span style="color: #007700">(</span><span style="color: #0000BB">$src2</span><span style="color: #007700">, </span><span style="color: #0000BB">Imagick</span><span style="color: #007700">::</span><span style="color: #0000BB">COMPOSITE_MATHEMATICS</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">);<br />    <br />    </span><span style="color: #0000BB">$src1</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">setImageFormat</span><span style="color: #007700">(</span><span style="color: #DD0000">'png'</span><span style="color: #007700">);<br />    </span><span style="color: #0000BB">header</span><span style="color: #007700">(</span><span style="color: #DD0000">"Content-Type: image/png"</span><span style="color: #007700">);<br />    echo </span><span style="color: #0000BB">$src1</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getImagesBlob</span><span style="color: #007700">();<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

    </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-imagick.setimageartifact-seealso">
  <h3 class="title">See Also</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="imagick.getimageartifact.php" class="function" rel="rdfs-seeAlso">Imagick::getImageArtifact()</a> - Get image artifact</span></li>
    <li><span class="function"><a href="imagick.deleteimageartifact.php" class="function" rel="rdfs-seeAlso">Imagick::deleteImageArtifact()</a> - Delete image artifact</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>