1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
|
<!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/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>FreeMat: vtkTexture</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">FreeMat
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('vtkrendering_vtktexture.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">vtkTexture </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Section: <a class="el" href="sec_vtkrendering.html">Visualization Toolkit Rendering Classes</a> </p>
<h1><a class="anchor" id="Usage"></a>
Usage</h1>
<p>vtkTexture is an object that handles loading and binding of texture maps. It obtains its data from an input image data dataset type. Thus you can create visualization pipelines to read, process, and construct textures. Note that textures will only work if texture coordinates are also defined, and if the rendering system supports texture.</p>
<p>Instances of vtkTexture are associated with actors via the actor's SetTexture() method. Actors can share texture maps (this is encouraged to save memory resources.)</p>
<p>To create an instance of class vtkTexture, simply invoke its constructor as follows </p>
<pre class="fragment"> obj = vtkTexture
</pre> <h1><a class="anchor" id="Methods"></a>
Methods</h1>
<p>The class vtkTexture has several methods that can be used. They are listed below. Note that the documentation is translated automatically from the VTK sources, and may not be completely intelligible. When in doubt, consult the VTK website. In the methods listed below, <code>obj</code> is an instance of the vtkTexture class. </p>
<ul>
<li>
<code>string = obj.GetClassName ()</code> </li>
<li>
<code>int = obj.IsA (string name)</code> </li>
<li>
<code>vtkTexture = obj.NewInstance ()</code> </li>
<li>
<code>vtkTexture = obj.SafeDownCast (vtkObject o)</code> </li>
<li>
<code>obj.Render (vtkRenderer ren)</code> - Renders a texture map. It first checks the object's modified time to make sure the texture maps Input is valid, then it invokes the Load() method. </li>
<li>
<code>obj.PostRender (vtkRenderer )</code> - Cleans up after the texture rendering to restore the state of the graphics context. </li>
<li>
<code>obj.ReleaseGraphicsResources (vtkWindow )</code> - Release any graphics resources that are being consumed by this texture. The parameter window could be used to determine which graphic resources to release. </li>
<li>
<code>obj.Load (vtkRenderer )</code> - Abstract interface to renderer. Each concrete subclass of vtkTexture will load its data into graphics system in response to this method invocation. </li>
<li>
<code>int = obj.GetRepeat ()</code> - Turn on/off the repetition of the texture map when the texture coords extend beyond the [0,1] range. </li>
<li>
<code>obj.SetRepeat (int )</code> - Turn on/off the repetition of the texture map when the texture coords extend beyond the [0,1] range. </li>
<li>
<code>obj.RepeatOn ()</code> - Turn on/off the repetition of the texture map when the texture coords extend beyond the [0,1] range. </li>
<li>
<code>obj.RepeatOff ()</code> - Turn on/off the repetition of the texture map when the texture coords extend beyond the [0,1] range. </li>
<li>
<code>int = obj.GetEdgeClamp ()</code> - Turn on/off the clamping of the texture map when the texture coords extend beyond the [0,1] range. Only used when Repeat is off, and edge clamping is supported by the graphics card. </li>
<li>
<code>obj.SetEdgeClamp (int )</code> - Turn on/off the clamping of the texture map when the texture coords extend beyond the [0,1] range. Only used when Repeat is off, and edge clamping is supported by the graphics card. </li>
<li>
<code>obj.EdgeClampOn ()</code> - Turn on/off the clamping of the texture map when the texture coords extend beyond the [0,1] range. Only used when Repeat is off, and edge clamping is supported by the graphics card. </li>
<li>
<code>obj.EdgeClampOff ()</code> - Turn on/off the clamping of the texture map when the texture coords extend beyond the [0,1] range. Only used when Repeat is off, and edge clamping is supported by the graphics card. </li>
<li>
<code>int = obj.GetInterpolate ()</code> - Turn on/off linear interpolation of the texture map when rendering. </li>
<li>
<code>obj.SetInterpolate (int )</code> - Turn on/off linear interpolation of the texture map when rendering. </li>
<li>
<code>obj.InterpolateOn ()</code> - Turn on/off linear interpolation of the texture map when rendering. </li>
<li>
<code>obj.InterpolateOff ()</code> - Turn on/off linear interpolation of the texture map when rendering. </li>
<li>
<code>obj.SetQuality (int )</code> - Force texture quality to 16-bit or 32-bit. This might not be supported on all machines. </li>
<li>
<code>int = obj.GetQuality ()</code> - Force texture quality to 16-bit or 32-bit. This might not be supported on all machines. </li>
<li>
<code>obj.SetQualityToDefault ()</code> - Force texture quality to 16-bit or 32-bit. This might not be supported on all machines. </li>
<li>
<code>obj.SetQualityTo16Bit ()</code> - Force texture quality to 16-bit or 32-bit. This might not be supported on all machines. </li>
<li>
<code>obj.SetQualityTo32Bit ()</code> - Force texture quality to 16-bit or 32-bit. This might not be supported on all machines. </li>
<li>
<code>int = obj.GetMapColorScalarsThroughLookupTable ()</code> - Turn on/off the mapping of color scalars through the lookup table. The default is Off. If Off, unsigned char scalars will be used directly as texture. If On, scalars will be mapped through the lookup table to generate 4-component unsigned char scalars. This ivar does not affect other scalars like unsigned short, float, etc. These scalars are always mapped through lookup tables. </li>
<li>
<code>obj.SetMapColorScalarsThroughLookupTable (int )</code> - Turn on/off the mapping of color scalars through the lookup table. The default is Off. If Off, unsigned char scalars will be used directly as texture. If On, scalars will be mapped through the lookup table to generate 4-component unsigned char scalars. This ivar does not affect other scalars like unsigned short, float, etc. These scalars are always mapped through lookup tables. </li>
<li>
<code>obj.MapColorScalarsThroughLookupTableOn ()</code> - Turn on/off the mapping of color scalars through the lookup table. The default is Off. If Off, unsigned char scalars will be used directly as texture. If On, scalars will be mapped through the lookup table to generate 4-component unsigned char scalars. This ivar does not affect other scalars like unsigned short, float, etc. These scalars are always mapped through lookup tables. </li>
<li>
<code>obj.MapColorScalarsThroughLookupTableOff ()</code> - Turn on/off the mapping of color scalars through the lookup table. The default is Off. If Off, unsigned char scalars will be used directly as texture. If On, scalars will be mapped through the lookup table to generate 4-component unsigned char scalars. This ivar does not affect other scalars like unsigned short, float, etc. These scalars are always mapped through lookup tables. </li>
<li>
<code>obj.SetLookupTable (vtkScalarsToColors )</code> - Specify the lookup table to convert scalars if necessary </li>
<li>
<code>vtkScalarsToColors = obj.GetLookupTable ()</code> - Specify the lookup table to convert scalars if necessary </li>
<li>
<code>vtkUnsignedCharArray = obj.GetMappedScalars ()</code> - Get Mapped Scalars </li>
<li>
<code>obj.SetTransform (vtkTransform transform)</code> - Set a transform on the texture which allows one to scale, rotate and translate the texture. </li>
<li>
<code>vtkTransform = obj.GetTransform ()</code> - Set a transform on the texture which allows one to scale, rotate and translate the texture. </li>
<li>
<code>int = obj.GetBlendingMode ()</code> - Used to specify how the texture will blend its RGB and Alpha values with other textures and the fragment the texture is rendered upon. </li>
<li>
<code>obj.SetBlendingMode (int )</code> - Used to specify how the texture will blend its RGB and Alpha values with other textures and the fragment the texture is rendered upon. </li>
<li>
<code>bool = obj.GetPremultipliedAlpha ()</code> - Whether the texture colors are premultiplied by alpha. Initial value is false. </li>
<li>
<code>obj.SetPremultipliedAlpha (bool )</code> - Whether the texture colors are premultiplied by alpha. Initial value is false. </li>
<li>
<code>obj.PremultipliedAlphaOn ()</code> - Whether the texture colors are premultiplied by alpha. Initial value is false. </li>
<li>
<code>obj.PremultipliedAlphaOff ()</code> - Whether the texture colors are premultiplied by alpha. Initial value is false. </li>
<li>
<code>int = obj.GetRestrictPowerOf2ImageSmaller ()</code> - When the texture is forced to be a power of 2, the default behavior is for the "new" image's dimensions to be greater than or equal to with respects to the original. Setting RestrictPowerOf2ImageSmaller to be 1 (or ON) with force the new image's dimensions to be less than or equal to with respects to the original. </li>
<li>
<code>obj.SetRestrictPowerOf2ImageSmaller (int )</code> - When the texture is forced to be a power of 2, the default behavior is for the "new" image's dimensions to be greater than or equal to with respects to the original. Setting RestrictPowerOf2ImageSmaller to be 1 (or ON) with force the new image's dimensions to be less than or equal to with respects to the original. </li>
<li>
<code>obj.RestrictPowerOf2ImageSmallerOn ()</code> - When the texture is forced to be a power of 2, the default behavior is for the "new" image's dimensions to be greater than or equal to with respects to the original. Setting RestrictPowerOf2ImageSmaller to be 1 (or ON) with force the new image's dimensions to be less than or equal to with respects to the original. </li>
<li>
<code>obj.RestrictPowerOf2ImageSmallerOff ()</code> - When the texture is forced to be a power of 2, the default behavior is for the "new" image's dimensions to be greater than or equal to with respects to the original. Setting RestrictPowerOf2ImageSmaller to be 1 (or ON) with force the new image's dimensions to be less than or equal to with respects to the original. </li>
</ul>
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="index.html">FreeMat Documentation</a></li><li class="navelem"><a class="el" href="sec_vtkrendering.html">Visualization Toolkit Rendering Classes</a></li>
<li class="footer">Generated on Thu Jul 25 2013 17:18:35 for FreeMat by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>
</ul>
</div>
</body>
</html>
|