%PDF- %PDF-
| Direktori : /usr/share/doc/imath-devel/html/ |
| Current File : //usr/share/doc/imath-devel/html/install.html |
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Install Options — Imath Documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/bizstyle.css" type="text/css" />
<script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script src="_static/bizstyle.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="The half Class" href="classes/half.html" />
<link rel="prev" title="Overview" href="intro.html" />
<meta name="viewport" content="width=device-width,initial-scale=1.0" />
<!--[if lt IE 9]>
<script src="_static/css3-mediaqueries.js"></script>
<![endif]-->
</head><body>
<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="classes/half.html" title="The half Class"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="intro.html" title="Overview"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Imath</a> »</li>
<li class="nav-item nav-item-this"><a href="">Install Options</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="install-options">
<h1>Install Options<a class="headerlink" href="#install-options" title="Permalink to this headline">¶</a></h1>
<p>When installing Imath from source, take note of the following CMake options:</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_CXX_STANDARD</span></code></dt><dd><p>C++ standard to compile against. Default is <code class="docutils literal notranslate"><span class="pre">14</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_HALF_USE_LOOKUP_TABLE</span></code></dt><dd><p>Use the half-to-float conversion lookup table. Default is <code class="docutils literal notranslate"><span class="pre">ON</span></code> for
backwards compatibility. With the value of <code class="docutils literal notranslate"><span class="pre">OFF</span></code>, use a bit-shift
conversion algorithm. Note that this setting is overriden when
compiler flags enable the F16C SSE instruction set.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_USE_DEFAULT_VISIBILITY</span></code></dt><dd><p>Use default visibility, which makes all symbols visible in compiled
objects. Default is <code class="docutils literal notranslate"><span class="pre">OFF</span></code>, in which case only designated
necessary symbols are marked for export.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_USE_NOEXCEPT</span></code></dt><dd><p>Use the <code class="docutils literal notranslate"><span class="pre">noexcept</span></code> specifier of appropriate methods. Default is
<code class="docutils literal notranslate"><span class="pre">ON</span></code>. With the value of <code class="docutils literal notranslate"><span class="pre">OFF</span></code>, the <code class="docutils literal notranslate"><span class="pre">noexcept</span></code> specifier is
omitted, for situations in which it is not desireable.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_ENABLE_LARGE_STACK</span></code></dt><dd><p>Enables the <code class="docutils literal notranslate"><span class="pre">halfFunction</span></code> object to place the lookup tables on
the stack rather than allocating heap memory. Default is <code class="docutils literal notranslate"><span class="pre">OFF</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_VERSION_RELEASE_TYPE</span></code></dt><dd><p>A string to append to the version
number in the internal package name macro
IMATH_PACKAGE_STRING. Default is the empty string, but can be set
to, for example, “-dev” during development (e.g. “3.1.0-dev”).</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_INSTALL_SYM_LINK</span></code></dt><dd><p>Install an unversioned symbolic link (i.e. libImath.so) to the
versioned library.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_INSTALL_PKG_CONFIG</span></code></dt><dd><p>Install Imath.pc file. Default is <code class="docutils literal notranslate"><span class="pre">ON</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_NAMESPACE</span></code></dt><dd><p>Public namespace alias for Imath. Default is <code class="docutils literal notranslate"><span class="pre">Imath</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_INTERNAL_NAMESPACE</span></code></dt><dd><p>Real namespace for Imath that will end up in compiled
symbols. Default is <code class="docutils literal notranslate"><span class="pre">Imath_<major>_<minor></span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_NAMESPACE_CUSTOM</span></code></dt><dd><p>Whether the namespace has been customized (so external users
know). Default is <code class="docutils literal notranslate"><span class="pre">NO</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_LIB_SUFFIX</span></code></dt><dd><p>String added to the end of all the versioned libraries. Default is
<code class="docutils literal notranslate"><span class="pre">-<major>_<minor></span></code></p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">IMATH_OUTPUT_SUBDIR</span></code></dt><dd><p>Destination sub-folder of the include path for install. Default is <code class="docutils literal notranslate"><span class="pre">Imath</span></code>.</p>
</dd>
</dl>
<p>To enable half-to-float conversion using the F16C SSE instruction set
for g++ and clang when installing Imath, add the <code class="docutils literal notranslate"><span class="pre">-mf16c</span></code> compiler
option:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">%</span> <span class="n">cmake</span> <span class="o"><</span><span class="n">Imath</span> <span class="n">source</span> <span class="n">directory</span><span class="o">></span> <span class="o">-</span><span class="n">DCMAKE_CXX_FLAGS</span><span class="o">=</span><span class="s2">"-mf16c"</span>
</pre></div>
</div>
<p>See <a class="reference internal" href="half_conversion.html#half-float-conversion-configuration-options"><span class="std std-ref">half-float Conversion Configuration Options</span></a> for more
information about the half-float conversion process.</p>
</div>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<img class="logo" src="_static/imath-logo-blue.png" alt="Logo"/>
</a></p>
<h4>Previous topic</h4>
<p class="topless"><a href="intro.html"
title="previous chapter">Overview</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="classes/half.html"
title="next chapter">The half Class</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/install.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#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="classes/half.html" title="The half Class"
>next</a> |</li>
<li class="right" >
<a href="intro.html" title="Overview"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Imath</a> »</li>
<li class="nav-item nav-item-this"><a href="">Install Options</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2021, Contributors to the OpenEXR Project.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.4.3.
</div>
</body>
</html>