blob: 1edb1645a5837de240f8642dcafa1c14dda5ca64 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" xmlns:xlink="http://www.w3.org/1999/xlink" pref:renderer="mathplayer-dl">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<style xmlns="" type="text/css">
/* This style sets a margin around the entire page */
html, body {
margin: 10px;
}
p {
font: normal 16px verdana, sans-serif;
margin: 0;
padding-bottom:12px;
}
h1 {
font: bold 25px verdana, sans-serif;
margin-top: 0;
margin-bottom: 3px;
padding-top: 0;
padding-bottom: 0;
}
h2 {
font: bold 19px verdana, sans-serif;
margin-top: 28px;
margin-bottom: 3px;
padding-top: 0;
padding-bottom: 0;
}
h3 {
font: bold 19px verdana, sans-serif !important;
margin-top: 28px;
margin-bottom: 3px;
padding-top: 0;
padding-bottom: 0;
}
li {
font: normal 16px verdana, sans-serif;
margin-top: 0;
margin-bottom: 18px;
padding-top: 0;
padding-bottom: 0;
}
.pdparam {
font: italic 16px verdana, sans-serif;
}
.term {
font: italic 16px verdana, sans-serif;
font-weight: normal;
}
.type {
font: normal 16px verdana, sans-serif !important;
}
.parameter {
font-style: italic;
}
a:link, a:visited {
color: blue;
text-decoration: none;
font: normal 16px;
}
a:hover {
background-color: #FFFF99;
font: normal 16px;
}
div.funcsynopsis {
text-align: left;
background-color: #e6e6e6;
font: normal 16px verdana, sans-serif;
padding-top: 10px;
padding-bottom: 10px;
}
div.funcsynopsis table {
border-collapse: separate;
font: normal 16px verdana, sans-serif;
}
div.funcsynopsis td {
background-color: #e6e6e6;
border: 0 solid #000;
padding: 1px;
font: normal 16px verdana, sans-serif;
}
div.refsect1 {
font-family: verdana, sans-serif;
font-size: 16px;
}
code.constant {
font: normal 16px courier new, monospace !important;
}
span.errorname {
font: normal 16px verdana, sans-serif !important;
}
code.function {
font: bold 16px verdana, sans-serif !important;
}
b.fsfunc {
font: bold 16px verdana, sans-serif !important;
}
code.varname {
font: italic 16px verdana, sans-serif;
}
code.replaceable {
font: italic 16px courier new, monospace;
}
code.funcdef {
font: normal 16px verdana, sans-serif !important;
}
.citerefentry {
font: normal 16px verdana, sans-serif !important;
}
.parameter {
font-style: italic;
}
code.fsfunc {
font: normal 16px verdana, sans-serif !important;
}
/* PARAMETER: This style controls spacing between the terms in Parameter section */
dt {
margin-top: 15px;
}
/* TABLES: These styles apply to all tables OTHER than the Synopsis and Example tables */
div.refsect1 table {
width: 100%;
margin-top: 10px;
background-color: #FFF;
border-collapse: collapse;
border-color: #000;
border-width: 1px;
font: normal 16px verdana, sans-serif;
}
div.refsect1 th {
border-collapse: collapse;
border-color: #000;
border-width: 1px;
font: bold 16px verdana, sans-serif;
}
div.refsect1 td {
background-color: #FFF;
padding: 5px;
vertical-align: text-top;
border-collapse: collapse;
border-color: #000;
border-width: 1px;
font: normal 16px verdana, sans-serif;
}
div.refsect1 p{
font: normal 16px verdana, sans-serif;
margin-top: 8px;
margin-bottom: 8px;
padding-top: 0;
padding-bottom: 0;
}
/* EXAMPLE: These styles apply only to the Example section */
div.refsect2 {
font: normal 16px courier new, monospace !important;
}
div.refsect2 table {
margin-top: 0;
background-color: #e6e6e6;
width: 100%;
border: 0 solid #000;
padding: 2px;
font: normal 16px courier new, monospace !important;
}
div.refsect2 td {
background-color: #e6e6e6;
font: normal 16px courier new, monospace !important;
white-space:pre;
}
/* COPYRIGHT: This style formats the text of the copyright statement at the bottom of the page */
div.refsect3 {
font: normal 11px verdana, sans-serif;
margin-top: 50px;
margin-bottom: 20px;
padding-top: 0;
padding-bottom: 0;
}
</style>
<title>FP_CONTRACT, FP_FAST_FMAF, FP_FAST_FMA_HALF</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<meta name="keywords" content="FP_CONTRACT, FP_FAST_FMAF, FP_FAST_FMA_HALF" />
</head>
<body>
<div class="refentry">
<a id="id-1"></a>
<div class="titlepage"></div>
<div xmlns="" class="refnamediv">
<a xmlns="http://www.w3.org/1999/xhtml" id="FP_CONTRACT"></a>
<h1>FP_CONTRACT, FP_FAST_FMAF, FP_FAST_FMA_HALF</h1>
<p>
Control expression contraction; fast fma()
</p>
</div>
<div class="refsect2">
<a id="example1"></a>
<div class="informaltable">
<table class="informaltable" border="0">
<colgroup>
<col align="left" class="col1" />
</colgroup>
<tbody>
<tr>
<td align="left"><div class="literallayout"><p><br />
#pragma OPENCL FP_CONTRACT <code class="varname">on-off-switch</code><br />
<br />
<code class="varname">on-off-switch</code> is one of:<br />
     ON, OFF or DEFAULT.<br />
     The DEFAULT value is ON.<br />
<br />
FP_FAST_FMAF<br />
FP_FAST_FMA<br />
FP_FAST_FMA_HALF        </p></div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsect1">
<a id="fpcontract"></a>
<h2>FP_CONTRACT</h2>
<p>
The <code class="function">FP_CONTRACT</code> pragma takes the form:
</p>
<p>
</p>
<div class="informaltable">
<table class="informaltable" border="0">
<colgroup>
<col align="left" class="col1" />
</colgroup>
<tbody>
<tr>
<td align="left">
#pragma OPENCL FP_CONTRACT on-off-switch
</td>
</tr>
</tbody>
</table>
</div>
<p>
</p>
<p>
<code class="function">FP_CONTRACT</code> can be used to allow (if the state is
<code class="constant">on</code>) or disallow (if the state is <code class="constant">off</code>)
the implementation to contract expressions. Each pragma can occur either outside
external declarations or preceding all explicit declarations and statements inside
a compound statement.
</p>
<p>
The parameter <code class="varname">on-off-switch</code> is one of ON, OFF or DEFAULT. The
DEFAULT value is ON.
</p>
<p>
When outside external declarations, the pragma takes effect from its occurrence until
another <code class="function">FP_CONTRACT</code> pragma is encountered, or until the end of
the translation unit. When inside a compound statement, the pragma takes effect from
its occurrence until another <code class="function">FP_CONTRACT</code> pragma is encountered
(including within a nested compound statement), or until the end of the compound
statement; at the end of a compound statement the state for the pragma is restored
to its condition just before the compound statement. If this pragma is used in any
other context, the behavior is undefined.
</p>
</div>
<div class="refsect1">
<a id="fpfastfma"></a>
<h2>FP_FAST_FMAF, FP_FAST_FMA, and FP_FAST_FMA_HALF</h2>
<p>
The <code class="constant">FP_FAST_FMAF</code> macro indicates whether the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a> function
is fast compared with direct code for single precision floating-point. If
defined, the <code class="constant">FP_FAST_FMAF</code> macro shall indicate that the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a>() function generally
executes about as fast as, or faster than, a multiply and an add of float operands.
</p>
<p>
The <code class="constant">FP_FAST_FMA</code> macro indicates whether the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a> family of functions
are fast compared with direct code for double precision floating-point. If
defined, the <code class="constant">FP_FAST_FMA</code> macro shall indicate that the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a>() function generally
executes about as fast as, or faster than, a multiply and an add of double operands.
</p>
<p>
The <code class="constant">FP_FAST_FMA_HALF</code> macro indicates whether the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a>() family of
functions are fast compared with direct code for half precision floating-point. If
defined, the <code class="constant">FP_FAST_FMA_HALF</code> macro shall indicate that the
<a class="citerefentry" href="fma.html"><span class="citerefentry"><span class="refentrytitle">fma</span></span></a>() function generally
executes about as fast as, or faster than, a multiply and an add of half operands
</p>
</div>
<div class="refsect1">
<a id="specification"></a>
<h2>Specification</h2>
<p>
<img src="pdficon_small1.gif" />
<a href="https://www.khronos.org/registry/cl/specs/opencl-2.0-openclc.pdf#namedest=FP_CONTRACT" target="OpenCL Spec">OpenCL Specification</a>
</p>
</div>
<div class="refsect1">
<a id="seealso"></a>
<h2>Also see</h2>
<p>
<a class="citerefentry" href="mathFunctions.html"><span class="citerefentry"><span class="refentrytitle">Math Functions</span></span></a>,
<a class="citerefentry" href="mathConstants.html"><span class="citerefentry"><span class="refentrytitle">Symbolic Math Constants</span></span></a>,
<a class="citerefentry" href="macroLimits.html"><span class="citerefentry"><span class="refentrytitle">Macros and Limits</span></span></a>
</p>
</div>
<div xmlns="" class="refsect3" lang="en" xml:lang="en"><a xmlns="http://www.w3.org/1999/xhtml" id="Copyright"></a><h4 xmlns="http://www.w3.org/1999/xhtml"></h4><img xmlns="http://www.w3.org/1999/xhtml" src="KhronosLogo.jpg" /><p xmlns="http://www.w3.org/1999/xhtml"></p>Copyright © 2007-2015 The Khronos Group Inc.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and/or associated documentation files (the
"Materials"), to deal in the Materials without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Materials, and to
permit persons to whom the Materials are furnished to do so, subject to
the condition that this copyright notice and permission notice shall be included
in all copies or substantial portions of the Materials.
</div>
</div>
</body>
</html>