<!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" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<title>glPtexViewer</title>
<link rel="icon" type="image/png" href="images/icon.png">
<link rel="stylesheet" href="css/rst.css" type="text/css" />
<link rel="stylesheet" href="css/default.css" type="text/css" />
<link rel="stylesheet" href="css/flavor.css" type="text/css" />
<link rel="stylesheet" href="css/renderman-university.css" type="text/css" />
<link rel="stylesheet" href="css/pygments.css" type="text/css" />
<style>
#mainContentContainer {
left: 15px;
margin-left: 255px;
}
ul.creatorFooterNav {
margin-left: 250px;
}
.navigation {
background-color: #333333;
margin-top: 10px;
margin-left: 10px;
}
ul.creatorMainNav li a {
font-size: 12px !important;
}
.copyrightFooter {
font-size: 11px;
margin-top: 25px;
text-align: center;
float: none;
}
</style>
</head>
<body>
<div class="navigation">
<br>
<div class="searchBar">
<form action="search.html">
<input type="text" name="q" id="searchInput" />
<input type="button" id="searchButton" onclick="this.form.submit();" value="Search" />
</form>
</div>
<div class="quickLinks">
<ul>
<li><a href="intro.html">Introduction</a></li>
<ul>
<li><a href="license.html">License</a></li>
<li><a href="getting_started.html">Getting Started</a></li>
<li><a href="contributing.html">Contributing</a></li>
<li><a href="cmake_build.html">Building OpenSubdiv</a></li>
<li><a href="code_examples.html">Code Examples</a></li>
<li><a href="references.html">References</a></li>
</ul>
<p></p>
<li><a href="subdivision_surfaces.html">Subdivision Surfaces</a>
<ul>
<li><a href="subdivision_surfaces.html#piecewise-parametric-surfaces">Piecewise Parametric Surfaces</a></li>
<li><a href="subdivision_surfaces.html#arbitrary-topology">Arbitrary Topology</a></li>
<li><a href="subdivision_surfaces.html#subdivision-versus-tessellation">Subdivision versus Tessellation</a></li>
<li><a href="subdivision_surfaces.html#mesh-data-and-topology">Mesh Data and Topology</a></li>
<li><a href="subdivision_surfaces.html#schemes-and-options">Schemes and Options</a></li>
<li><a href="mod_notes.html">Modeling Tips</a></li>
</ul>
</li>
<p></p>
<li><a href="api_overview.html">OpenSubdiv User Guide</a>
<ul>
<li><a href="api_overview.html">API Overview</a>
<ul>
<li><a href="sdc_overview.html">Sdc</a></li>
<li><a href="vtr_overview.html">Vtr</a></li>
<li><a href="far_overview.html">Far</a></li>
<ul>
<li><a href="far_overview.html#far-topologyrefiner">Topology Refiner</a></li>
<li><a href="far_overview.html#far-topologyrefinerfactory">Topology Refiner Factory</a></li>
<li><a href="far_overview.html#far-primvarrefiner">Primvar Refiner</a></li>
<li><a href="far_overview.html#far-patchtable">Patch Table</a></li>
<li><a href="far_overview.html#far-stenciltable">Stencil Table</a></li>
</ul>
<li><a href="bfr_overview.html">Bfr</a></li>
<ul>
<li><a href="bfr_overview.html#bfr-navlink-evaluation">Evaluation</a></li>
<li><a href="bfr_overview.html#bfr-navlink-parameterization">Parameterization</a></li>
<li><a href="bfr_overview.html#bfr-navlink-tessellation">Tessellation</a></li>
<li><a href="bfr_overview.html#bfr-navlink-surfacefactory">More on Surface Factory</a></li>
<li><a href="bfr_overview.html#bfr-navlink-customizing">Custom Surface Factory</a></li>
</ul>
<li><a href="osd_overview.html">Osd</a></li>
<ul>
<li><a href="osd_shader_interface.html">Shader Interface</a></li>
</ul>
</ul>
</li>
<li><a href="tutorials.html">Tutorials</a>
<li><a href="hbr_overview.html">Historical But Relevant</a></li>
<ul>
<li><a href="hbr_overview.html">Hbr</a></li>
<ul>
<li><a href="using_osd_hbr.html">Using Hbr</a></li>
</ul>
<li><a href="hedits.html">Hierarchical Edits</a></li>
</ul>
</ul>
</li>
<p></p>
<li><a href="additional_resources.html">Additional Resources</a>
<ul>
<li><a href="http://graphics.pixar.com/opensubdiv/forum.html">Forum</a>
<li><a href="additional_resources.html#links">Links</a>
<li><a href="additional_resources.html#videos">Videos</a>
</ul>
<p></p>
<li><a href="release_notes.html">Releases</a>
<ul>
<li><a href="release_35.html">Release 3.5</a></li>
<li><a href="release_34.html">Release 3.4</a></li>
<li><a href="release_33.html">Release 3.3</a></li>
<li><a href="release_32.html">Release 3.2</a></li>
<li><a href="release_31.html">Release 3.1</a></li>
<li><a href="release_30.html">Release 3.0</a></li>
<ul>
<li><a href="release_30.html">Overview</a></li>
<li><a href="porting.html">Porting Guide: 2.0 to 3.0</a></li>
<li><a href="compatibility.html">Subdivision Compatibility</a></li>
</ul>
<li><a href="release_notes.html">Release Notes</a></li>
</ul>
<p></p>
<li><a href="doxy_html/index.html" target="_blank">Doxygen</a></li>
</ul>
</div>
<br>
</div>
<div class="document" id="glptexviewer">
<h1 class="title">glPtexViewer</h1>
<div id="mainContentContainer">
<div class="fullWidth headerColor">
<div class="center">
<div id="mainSiteNavigation">
<div class="homeRenderManLink">
<a href="http://graphics.pixar.com/opensubdiv/index.html"><img alt="OpenSubdiv Logo" src="images/opensubdiv_logo_header.png"></a>
</div>
<!-- TOP NAVIGATION MENU -->
<ul class="creatorMainNav floatLeft" id="menu">
<li class="creatorMainNav">
<a href="release_notes.html">3.5.1</a>
</li>
</ul>
<ul class="creatorMainNav floatNav" id="menu">
<li class="mainSubNavigation marginR12 marginL12" id="navbarId-23704">
<a href="intro.html">User Docs</a>
</li>
<li class="mainSubNavigation marginR12 marginL12" id="navbarId-23887">
<a href="doxy_html/index.html">API Docs</a>
</li>
<li class="mainSubNavigation marginR12 marginL12" id="navbarId-23944">
<a href="release_notes.html">Release Notes</a>
</li>
<li class="mainSubNavigation marginR15 marginL12" id="navbarId-23703">
<a href="http://graphics.pixar.com/opensubdiv/forum.html">Forum</a>
</li>
<a class="blueButton marginR0 marginL0" style="width:70px" href="https://github.com/PixarAnimationStudios/OpenSubdiv">Github</a>
</ul>
</div><!-- close mainSiteNavigation -->
</div><!-- close center -->
</div><!-- close fullWidth -->
<div class="clearBoth"></div>
<h1 class="articleContentTitle">glPtexViewer</h1>
<div class="clearBoth"></div>
<hr>
<div class="clearBoth"></div>
<div class="coursewareBackground">
<!-- <div class="topicLeftData-IntroPara"></div> -->
<div class="topicLeftData-MainData">
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#synopsis" id="toc-entry-1">SYNOPSIS</a></li>
<li><a class="reference internal" href="#description" id="toc-entry-2">DESCRIPTION</a></li>
<li><a class="reference internal" href="#options" id="toc-entry-3">OPTIONS</a></li>
<li><a class="reference internal" href="#keyboard-controls" id="toc-entry-4">KEYBOARD CONTROLS</a></li>
<li><a class="reference internal" href="#see-also" id="toc-entry-5">SEE ALSO</a></li>
</ul>
</div>
<div class="section" id="synopsis">
<h3>SYNOPSIS</h3>
<pre class="codefhead literal-block">
<strong>glPtexViewer</strong> [<strong>-f</strong>] [<strong>-yup</strong>] [<strong>-u</strong>] [<strong>-a</strong>] [<strong>-l</strong> <em>isolation level</em>] [<strong>-c</strong> <em>animation loops</em>]
[<strong>-e</strong> <em>environment map</em>] [<strong>-d</strong> <em>HDR diffuse map</em>] [<strong>-s</strong> <em>HDR specular map</em>]
[<strong>--disp</strong> <em>displacement scale</em>] [<strong>--bump</strong> <em>bump scale</em>]
<em>ptex color file</em>
<em>ptex displacement file</em>
<em>ptex occlusion file</em>
<em>ptex specular file</em>
<em>objfile(s)</em>
</pre>
</div>
<div class="section" id="description">
<h3>DESCRIPTION</h3>
<p><tt class="docutils literal">glPtexViewer</tt> is a stand-alone application that showcases advanced HDR shading
with color, displacement, occlusion and specular ptex maps. Multiple controls
are available to experiment with the algorithms.</p>
<a class="reference external image-reference" href="images/barb_1.jpg"><img alt="images/barb_1.jpg" class="align-center" src="images/barb_1.jpg" style="width: 400px;" /></a>
</div>
<div class="section" id="options">
<h3>OPTIONS</h3>
<p>See the description of the
<a class="reference external" href="code_examples.html#common-command-line-options">common comand line options</a>
for the subset of common options supported here.</p>
<dl class="docutils">
<dt><strong>-e</strong> <em>environment map</em></dt>
<dd>A low dynamic range spherical environment map used as a background. Ideally,
a color-normalized version of the HDR light probe.</dd>
<dt><strong>-d</strong> <em>HDR diffuse map</em></dt>
<dd>An HDR file containing a diffuse environment map (typically they are low
resolution blurry hemispherical convolutions of the environment light probe).</dd>
<dt><strong>-s</strong> <em>environment map</em></dt>
<dd>An HDR file containing a specular environment map.</dd>
<dt><strong>--disp</strong> <em>displacement scale</em></dt>
<dd>A scalar multiplier for the shader displacement values.</dd>
<dt><strong>--bump</strong> <em>displacement scale</em></dt>
<dd>A scalar multiplier for the shader bump values.</dd>
<dt><em>ptex color file</em></dt>
<dd>A ptex file containing RGB channels read as material albedo color.</dd>
<dt><em>ptex displacement file</em></dt>
<dd>A single-channel ptex file (preferably float precision) containing the
displacement values.</dd>
<dt><em>ptex occlusion file</em></dt>
<dd>A single-channel ptex file (preferably 8 bits precision) containing a
pre-computed ambient occlusion signal.</dd>
<dt><em>ptex specular file</em></dt>
<dd>A single-channel ptex file (preferably 8 bits precision) applied to modulate
the specular reflectance of the material</dd>
</dl>
</div>
<div class="section" id="keyboard-controls">
<h3>KEYBOARD CONTROLS</h3>
<blockquote>
<pre class="code c++ literal-block">
<span class="name label">q</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">quit</span><span class="whitespace">
</span><span class="name label">esc</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">hide</span><span class="whitespace"> </span><span class="name">GUI</span><span class="whitespace">
</span><span class="name label">x</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">save</span><span class="whitespace"> </span><span class="name">screenshot</span><span class="whitespace">
</span><span class="name label">f</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">fit</span><span class="whitespace"> </span><span class="name">frame</span><span class="whitespace">
</span><span class="operator">+/-</span><span class="whitespace"> </span><span class="operator">:</span><span class="whitespace"> </span><span class="name">increase</span><span class="whitespace"> </span><span class="operator">/</span><span class="whitespace"> </span><span class="name">decrease</span><span class="whitespace"> </span><span class="name">tessellation</span><span class="whitespace"> </span><span class="name">rate</span><span class="whitespace">
</span><span class="name label">r</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">reload</span><span class="whitespace"> </span><span class="name">and</span><span class="whitespace"> </span><span class="name">re</span><span class="operator">-</span><span class="name">compile</span><span class="whitespace"> </span><span class="name">the</span><span class="whitespace"> </span><span class="name">shader</span><span class="whitespace"> </span><span class="name">files</span><span class="whitespace">
</span><span class="name label">e</span><span class="whitespace"> </span><span class="punctuation">:</span><span class="whitespace"> </span><span class="name">draw</span><span class="whitespace"> </span><span class="name">normals</span>
</pre>
</blockquote>
</div>
<div class="section" id="see-also">
<h3>SEE ALSO</h3>
<p>Other <a class="reference external" href="code_examples.html">examples</a> :
<a class="reference external" href="glviewer.html">glViewer</a>, <a class="reference external" href="glfvarviewer.html">glFVarViewer</a>, <a class="reference external" href="glevallimit.html">glEvalLimit</a>, <a class="reference external" href="glstencilviewer.html">glStencilViewer</a>, <a class="reference external" href="glptexviewer.html">glPtexViewer</a>, <a class="reference external" href="glpainttest.html">glPaintTest</a>, <a class="reference external" href="glsharetopology.html">glShareTopology</a>, <a class="reference external" href="dxviewer.html">dxViewer</a>, <a class="reference external" href="dxptexviewer.html">dxPtexViewer</a>, </p>
</div>
</div>
<div class="footer">
<hr class="footer" />
Generated on: 2023-09-06 15:35 UTC.
</div>
</body>
</html>
</div><!-- close topicLeftData-MainData -->
</div><!-- close coursewareBackground -->
</div> <!-- close mainContentContainer -->
</div> <!-- close center -->
<!-- BOTTOM NAVIGATION MENU -->
<ul class="creatorFooterNav">
<li class="" id="navbarId-23704">
<a href="intro.html">User Docs</a>
</li>
<li class="" id="navbarId-23887">
<a href="doxy_html/index.html">API Docs</a>
</li>
<li class="" id="navbarId-23944">
<a href="release_notes.html">Release Notes</a>
</li>
<li class="" id="navbarId-23703">
<a href="http://graphics.pixar.com/opensubdiv/forum.html">Forum</a>
</li>
</ul><!-- end bottom navigation menu -->
<div class="clearBoth"></div>
<div class="center">
<div class="copyrightFooter">
TM & © 1986 - 2017 PIXAR. ALL RIGHTS RESERVED. <a class="copyrightFooter" target="_blank" href="https://www.pixar.com/terms-of-use#terms-of-use-1">Terms of Use</a>
</div>
</div>
<div class="clearBoth"></div>
