/usr/share/doc/python-visual/html/cylinder.html is in python-visual 1:5.12-1.3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 | <!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"><!-- InstanceBegin template="/visual/Templates/template.dwt" codeOutsideHTMLIsLocked="false" -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- InstanceBeginEditable name="doctitle" -->
<title>cylinder</title>
<!-- InstanceEndEditable -->
<!-- InstanceBeginEditable name="head" -->
<link href="VisualRef.css" rel="stylesheet" type="text/css" />
<style type="text/css">
<!--
.style1 {font-size: x-large}
.style2 {font-size: xx-large}
-->
</style>
<!-- InstanceEndEditable -->
<script type="text/javascript">
<!--
function MM_jumpMenu(targ,selObj,restore){ //v3.0
eval(targ+".location='"+selObj.options[selObj.selectedIndex].value+"'");
if (restore) selObj.selectedIndex=0;
}
//-->
</script>
<link href="VisualRef.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table width="800" border="0" cellpadding="0" cellspacing="0">
<!--DWLayoutDefaultTable-->
<tr>
<td width="10" valign="top" bgcolor="#FFFFFF"><!--DWLayoutEmptyCell--> </td>
<td width="10" height="272" valign="top" bgcolor="#DDDDDD"><p> </p> </td>
<td width="173" valign="top" bgcolor="#DDDDDD"><p class="Normal"><a href="index.html">Home</a></p>
<p class="Normal">If you're new to Python <br />
and VPython: <a href="VisualIntro.html">Introduction</a></p>
<p class="Normal">A VPython <a href="VPython_Intro.pdf" target="_blank">tutorial</a></p>
<p class="Normal"><a href="primitives.html">Pictures</a> of 3D objects</p>
<p class="Normal">Choose a 3D object:</p>
<select name="jumpMenu4" id="jumpMenu4" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose an object</option>
<option value="cylinder.html">Overview</option>
<option value="arrow.html">arrow</option>
<option value="box.html">box</option>
<option value="cone.html">cone</option>
<option value="convex.html">convex</option>
<option value="curve.html">curve</option>
<option value="cylinder.html">cylinder</option>
<option value="ellipsoid.html">ellipsoid</option>
<option value="faces.html">faces</option>
<option value="frame.html">frame</option>
<option value="helix.html">helix</option>
<option value="label.html">label</option>
<option value="lights.html">lights</option>
<option value="points.html">points</option>
<option value="pyramid.html">pyramid</option>
<option value="ring.html">ring</option>
<option value="sphere.html">sphere</option>
</select>
<p class="Normal">Work with 3D objects:</p>
<select name="jumpMenu4" id="jumpMenu5" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose an option</option>
<option value="color.html">Color & Opacity</option>
<option value="lights.html">Lighting</option>
<option value="materials.html">Materials & Textures</option>
<option value="defaults.html">Defaults</option>
<option value="rate.html">Animation Speed</option>
<option value="rotation.html">Rotations</option>
<option value="options.html">Additional Options</option>
<option value="delete.html">Delete an Object</option>
<option value="float.html">3/4 = 0?</option>
</select>
<p class="Normal">Windows, Events, & Files:</p>
<select name="jumpMenu4" id="jumpMenu6" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose a topic</option>
<option value="display.html">Windows</option>
<option value="lights.html">Lighting</option>
<option value="mouse.html">Mouse Events</option>
<option value="mouse_click.html"> Mouse Click</option>
<option value="mouse_drag.html"> Mouse Drag</option>
<option value="keyboard.html">Keyboard Events</option>
<option value="controls.html">Buttons and Sliders</option>
<option value="files.html">Reading/Writing Files</option>
</select>
<p class="Normal"><a href="vector.html">Vector operations </a></p>
<p class="Normal"><a href="graph.html">Graphs</a></p>
<p class="Normal"><a href="factorial.html">factorial/combin</a></p>
<p class="Normal">What's new in <a href="new_features.html">Visual 5</a></p>
<p class="Normal"><a href="http://vpython.org" target="_blank">VPython web site</a><br />
<a href="license.txt" target="_blank">Visual license</a><br />
<a href="http://www.python.org" target="_blank">Python web site</a> <br />
<a href="http://www.python.org/doc/2.5.2/lib/module-math.html" target="_blank">Math module</a> (sqrt etc.)<br />
<a href="http://www.scipy.org/Documentation" target="_blank">Numpy module</a> (arrays) </p></td>
<td width="21" valign="top" bgcolor="#FFFFFF"><!--DWLayoutEmptyCell--> </td>
<td width="586" rowspan="2" valign="top"><!-- InstanceBeginEditable name="content" -->
<table width="100%" border="1">
<tr>
<td width="77%"><div align="center"><span class="style1 style2"><font color="#0000A0">cylinder</font></span></div></td>
<td width="23%"><div align="center"><img src="images/cylinder.jpg" alt="cylinder" width="131" height="127" /><a href="arrow.html"></a></div></td>
</tr>
</table>
<p class="Normal"><strong>Studying this description of the cylinder object
provides an overview of important aspects common to all of the
Visual 3D objects, box, sphere, pyramid, etc. </strong></p>
<p class="Normal"> <img src="VisualRef-1.gif" alt="cylinder" align="right" /> Here is an example
of how to make a cylinder, naming it "rod" for future reference:</p>
<p class="program"> rod = cylinder(pos=(0,2,1), axis=(5,0,0), radius=1)</p>
<p class="Normal"> The center of one end of this cylinder is at x=0, y=2,
and z=1. Its axis lies along the x axis, with length 5, so that the other
end of the cylinder is at (5,2,1), as shown in the accompanying diagram.</p>
<p class="Normal"> You can modify the position of the cylinder after it has
been created, which has the effect of moving it immediately to the new position:</p>
<p class="program"> rod.pos = (15,11,9) # change (x,y,z)<br />
rod.x = 15 # only change pos.x</p>
<p class="Normal"> If you create an object such as a cylinder but without
giving it a name such as <span class="attribute">rod</span>, you can't refer
to it later. This doesn't matter if you never intend to modify the object.</p>
<p class="Normal"> Since we didn't specify a color, the cylinder will be the
current "foreground" color (see <a href="display.html">Controlling
One or More Visual Display Windows</a>). The default foreground color is
white. After creating the cylinder, you can change its color:</p>
<p class="program"> rod.color = (0,0,1) # make rod be blue</p>
<p class="Normal"> This will make the cylinder suddenly turn blue, using the
so-called RGB system for specifying colors in terms of fractions of red,
green, and blue. (For details on choosing colors, see <a href="color.html">Specifying
Colors</a>.) You can set individual amounts of red, green, and blue like
this:</p>
<p class="program"> rod.red = 0.4<br />
rod.green = 0.7<br />
rod.blue = 0.8</p>
<p class="Normal"> The cylinder object can be created with other, optional
attributes, which can be listed in any order. Here is a full list of attributes,
most of which also apply to other objects:</p>
<p class="attributes"> <font color="#FF0000" class="attribute">pos</font> Position: the center of one end of the cylinder; default = (0,0,0)<br />
A triple, in parentheses, such as (3,2,5)</p>
<p class="attributes"> <font color="#FF0000">axis</font> The axis points from
pos to the other end of the cylinder, default = (1,0,0)</p>
<p class="attributes"> <span class="attribute">x</span>, <span class="attribute">y</span>, <span class="attribute">z</span> Essentially the same as pos.x, pos.y, pos.z,
defaults are all 0</p>
<p class="attributes"> <span class="attribute">radius</span> The radius of
the cylinder, default = 1</p>
<p class="attributes"> <span class="attribute">length</span> Length of axis;
if not specified, axis determines the length, default = 1<br />
If length is specified, it overrides the length given by axis</p>
<p class="attributes"> <span class="attribute">color</span> Color of object,
as a red-green-blue (RGB) triple: (1,0,0) is pure red, default = (1,1,1),
which is color.white</p>
<p class="attributes"> <span class="attribute">red</span>, <span class="attribute">green</span>, <span class="attribute">blue</span> (can set these color attributes individually),
defaults are all 1</p>
<p class="attributes"> <span class="attribute">opacity</span> Opacity
of object, default = 1; 0 is completely transparent</p>
<p class="attributes"><span class="attribute">material</span> Material
of object; see <a href="materials.html">Materials</a> for currently available options</p>
<p class="attributes"><span class="attribute">up</span> Which side
of the cylinder is "up"; this has only a subtle effect
on the 3D appearance of the cylinder unless a non-smooth material
is specified; default (0,1,0)</p>
<p class="Normal"> Note that the <span class="attribute">pos</span> attribute
for cylinder, arrow, cone, and pyramid corresponds to one end of the object,
whereas for a box, sphere, or ring it corresponds to the center of the object. </p>
<p class="Normal">See description of <a href="options.html">Additional
Attributes</a> available
for all 3D display objects.</p>
<p class="Normal"> When you start a VPython program, for convenience Visual
creates a display window and names it <span class="attribute">scene</span>.
By default, objects that you create go into that display window. See <a href="display.html">Controlling
One or More Visual Display Windows</a> later in this reference for how you
can create additional display windows and place objects in them.</p>
<p class="Normal"><br />
</p>
<!-- InstanceEndEditable --></td>
</tr>
<tr>
<td height="16" colspan="4"></td>
</tr>
</table>
</body>
<!-- InstanceEnd --></html>
|