blob: 6f4103ccb6cf57daa6814dcce9034a26c26ee4c8 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>FindDCMTK &mdash; CMake 3.8.2 Documentation</title>
<link rel="stylesheet" href="../_static/cmake.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '3.8.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/cmake-favicon.ico"/>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="FindDevIL" href="FindDevIL.html" />
<link rel="prev" title="FindDart" href="FindDart.html" />
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="FindDevIL.html" title="FindDevIL"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="FindDart.html" title="FindDart"
accesskey="P">previous</a> |</li>
<li>
<img src="../_static/cmake-logo-16.png" alt=""
style="vertical-align: middle; margin-top: -2px" />
</li>
<li>
<a href="https://cmake.org/">CMake</a> &#187;
</li>
<li>
<a href="../index.html">3.8.2 Documentation</a> &#187;
</li>
<li class="nav-item nav-item-1"><a href="../manual/cmake-modules.7.html" accesskey="U">cmake-modules(7)</a> &#187;</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="finddcmtk">
<span id="module:FindDCMTK"></span><h1>FindDCMTK<a class="headerlink" href="#finddcmtk" title="Permalink to this headline"></a></h1>
<p>Find DCMTK libraries and applications</p>
<p>The module defines the following variables:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">DCMTK_INCLUDE_DIRS</span> <span class="o">-</span> <span class="n">Directories</span> <span class="n">to</span> <span class="n">include</span> <span class="n">to</span> <span class="n">use</span> <span class="n">DCMTK</span>
<span class="n">DCMTK_LIBRARIES</span> <span class="o">-</span> <span class="n">Files</span> <span class="n">to</span> <span class="n">link</span> <span class="n">against</span> <span class="n">to</span> <span class="n">use</span> <span class="n">DCMTK</span>
<span class="n">DCMTK_FOUND</span> <span class="o">-</span> <span class="n">If</span> <span class="n">false</span><span class="p">,</span> <span class="n">don</span><span class="s1">&#39;t try to use DCMTK</span>
<span class="n">DCMTK_DIR</span> <span class="o">-</span> <span class="p">(</span><span class="n">optional</span><span class="p">)</span> <span class="n">Source</span> <span class="n">directory</span> <span class="k">for</span> <span class="n">DCMTK</span>
</pre></div>
</div>
<div class="section" id="compatibility">
<h2>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline"></a></h2>
<p>This module is able to find a version of DCMTK that does or does not export
a <em>DCMTKConfig.cmake</em> file. It applies a two step process:</p>
<ul class="simple">
<li>Step 1: Attempt to find DCMTK version providing a <em>DCMTKConfig.cmake</em> file.</li>
<li>Step 2: If step 1 failed, rely on <em>FindDCMTK.cmake</em> to set <cite>DCMTK_*</cite> variables details below.</li>
</ul>
<p><a class="reference external" href="http://git.dcmtk.org/web?p=dcmtk.git;a=commit;h=662ae187c493c6b9a73dd5e3875372cebd0c11fe">Recent DCMTK</a>
provides a <em>DCMTKConfig.cmake</em> <span class="target" id="index-0-manual:cmake-packages(7)"></span><a class="reference internal" href="../manual/cmake-packages.7.html#manual:cmake-packages(7)" title="cmake-packages(7)"><code class="xref cmake cmake-manual docutils literal"><span class="pre">package</span> <span class="pre">configuration</span> <span class="pre">file</span></code></a>. To exclusively use the package configuration file
(recommended when possible), pass the <cite>NO_MODULE</cite> option to
<span class="target" id="index-0-command:find_package"></span><a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal"><span class="pre">find_package()</span></code></a>. For example, <cite>find_package(DCMTK NO_MODULE)</cite>.
This requires official DCMTK snapshot <em>3.6.1_20140617</em> or newer.</p>
<p>Until all clients update to the more recent DCMTK, build systems will need
to support different versions of DCMTK.</p>
<p>On any given system, the following combinations of DCMTK versions could be
considered:</p>
<table border="1" class="docutils">
<colgroup>
<col width="11%" />
<col width="30%" />
<col width="32%" />
<col width="27%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td>&nbsp;</td>
<td>SYSTEM DCMTK</td>
<td>LOCAL DCMTK</td>
<td>Supported ?</td>
</tr>
<tr class="row-even"><td>Case A</td>
<td>NA</td>
<td>[ ] DCMTKConfig</td>
<td>YES</td>
</tr>
<tr class="row-odd"><td>Case B</td>
<td>NA</td>
<td>[X] DCMTKConfig</td>
<td>YES</td>
</tr>
<tr class="row-even"><td>Case C</td>
<td>[ ] DCMTKConfig</td>
<td>NA</td>
<td>YES</td>
</tr>
<tr class="row-odd"><td>Case D</td>
<td>[X] DCMTKConfig</td>
<td>NA</td>
<td>YES</td>
</tr>
<tr class="row-even"><td>Case E</td>
<td>[ ] DCMTKConfig</td>
<td>[ ] DCMTKConfig</td>
<td>YES (*)</td>
</tr>
<tr class="row-odd"><td>Case F</td>
<td>[X] DCMTKConfig</td>
<td>[ ] DCMTKConfig</td>
<td>NO</td>
</tr>
<tr class="row-even"><td>Case G</td>
<td>[ ] DCMTKConfig</td>
<td>[X] DCMTKConfig</td>
<td>YES</td>
</tr>
<tr class="row-odd"><td>Case H</td>
<td>[X] DCMTKConfig</td>
<td>[X] DCMTKConfig</td>
<td>YES</td>
</tr>
</tbody>
</table>
<blockquote>
<div>(*) See Troubleshooting section.</div></blockquote>
<p>Legend:</p>
<blockquote>
<div><p>NA ...............: Means that no System or Local DCMTK is available</p>
<p>[ ] DCMTKConfig ..: Means that the version of DCMTK does NOT export a DCMTKConfig.cmake file.</p>
<p>[X] DCMTKConfig ..: Means that the version of DCMTK exports a DCMTKConfig.cmake file.</p>
</div></blockquote>
</div>
<div class="section" id="troubleshooting">
<h2>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline"></a></h2>
<p>What to do if my project finds a different version of DCMTK?</p>
<p>Remove DCMTK entry from the CMake cache per <span class="target" id="index-1-command:find_package"></span><a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal"><span class="pre">find_package()</span></code></a>
documentation.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">FindDCMTK</a><ul>
<li><a class="reference internal" href="#compatibility">Compatibility</a></li>
<li><a class="reference internal" href="#troubleshooting">Troubleshooting</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="FindDart.html"
title="previous chapter">FindDart</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="FindDevIL.html"
title="next chapter">FindDevIL</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/module/FindDCMTK.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="FindDevIL.html" title="FindDevIL"
>next</a> |</li>
<li class="right" >
<a href="FindDart.html" title="FindDart"
>previous</a> |</li>
<li>
<img src="../_static/cmake-logo-16.png" alt=""
style="vertical-align: middle; margin-top: -2px" />
</li>
<li>
<a href="https://cmake.org/">CMake</a> &#187;
</li>
<li>
<a href="../index.html">3.8.2 Documentation</a> &#187;
</li>
<li class="nav-item nav-item-1"><a href="../manual/cmake-modules.7.html" >cmake-modules(7)</a> &#187;</li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2000-2017 Kitware, Inc. and Contributors.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.2.
</div>
</body>
</html>