Salome HOME
Join modifications from branch OCC_debug_for_3_2_0b1
[modules/visu.git] / doc / salome / gui / VISU / primitive_types.htm
1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">\r
2 \r
3 <html>\r
4 \r
5 <head>\r
6 <title>Primitive Types</title>\r
7 <meta http-equiv="content-type" content="text/html; charset=windows-1252">\r
8 <meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">\r
9 <link rel="stylesheet" href="default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">\r
10 <!--\r
11 if (navigator.appName !="Netscape")\r
12 {   document.write("<link rel='stylesheet' href='default.css'>");}\r
13 //-->\r
14 </script>\r
15 <style type="text/css">\r
16 <!--\r
17 img_whs1 { border:none; float:none; width:30px; height:30px; border-style:none; }\r
18 p.whs2 { font-weight:bold; }\r
19 p.whs3 { font-weight:bold; margin-left:40px; }\r
20 img_whs4 { border:none; width:511px; height:244px; border-style:none; }\r
21 p.whs5 { margin-left:36px; }\r
22 img_whs6 { border:none; width:485px; height:141px; border-style:none; }\r
23 img_whs7 { border:none; width:484px; height:139px; border-style:none; }\r
24 p.whs8 { font-weight:bold; margin-left:0px; }\r
25 img_whs9 { border:none; width:186px; height:175px; float:none; border-style:none; }\r
26 img_whs10 { border:none; width:191px; height:175px; float:none; border-style:none; }\r
27 p.whs11 { margin-left:40px; text-indent:-28px; font-weight:bold; }\r
28 p.whs12 { margin-left:0px; font-style:normal; }\r
29 p.whs13 { margin-left:80px; font-style:italic; }\r
30 p.whs14 { margin-left:80px; font-style:italic; text-align:center; }\r
31 img_whs15 { border:none; width:418px; height:154px; float:none; border-style:none; }\r
32 -->\r
33 </style><script type="text/javascript" language="JavaScript">\r
34 <!--\r
35 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
36 {\r
37   var strNSS = "<style type='text/css'>";\r
38   strNSS += "p.whs8 {margin-left:1pt; }";\r
39   strNSS += "p.whs11 {text-indent:1pt; }";\r
40   strNSS += "p.whs12 {margin-left:1pt; }";\r
41   strNSS +="</style>";\r
42   document.write(strNSS);\r
43 }\r
44 //-->\r
45 </script>\r
46 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
47 <!--\r
48 function reDo() {\r
49   if (innerWidth != origWidth || innerHeight != origHeight)\r
50      location.reload();\r
51 }\r
52 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
53         origWidth = innerWidth;\r
54         origHeight = innerHeight;\r
55         onresize = reDo;\r
56 }\r
57 onerror = null; \r
58 //-->\r
59 </script>\r
60 <style type="text/css">\r
61 <!--\r
62 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
63 -->\r
64 </style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>\r
65 <script type="text/javascript" language="javascript" src="whver.js"></script>\r
66 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>\r
67 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>\r
68 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>\r
69 </head>\r
70 <body><script type="text/javascript" language="javascript1.2">\r
71 <!--\r
72 if (window.gbWhTopic)\r
73 {\r
74         if (window.addTocInfo)\r
75         {\r
76         addTocInfo("Post-Pro module\n3D presentations\nField presentations\nGauss Points Presentations\nPrimitive Types");\r
77 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");\r
78 \r
79         }\r
80         if (window.writeBtnStyle)\r
81                 writeBtnStyle();\r
82 \r
83         if (window.writeIntopicBar)\r
84                 writeIntopicBar(1);\r
85 \r
86         if (window.setRelStartPage)\r
87         {\r
88         setRelStartPage("visu.htm");\r
89 \r
90                 autoSync(1);\r
91                 sendSyncInfo();\r
92                 sendAveInfoOut();\r
93         }\r
94 }\r
95 else\r
96         if (window.gbIE4)\r
97                 document.location.reload();\r
98 //-->\r
99 </script>\r
100 <h1>Primitive Types</h1>\r
101 \r
102 <p><span style="font-weight: bold;"><B><img src="i_blue.jpg" x-maintain-ratio="TRUE" width="30px" height="30px" border="0" class="img_whs1"></B></span>Gauss Point presentations \r
103  use primitives to visualize the value of the results obtained during calculations \r
104  so that the color and relative size of the points depend on each component \r
105  of a vector, tensor or matrix (e.g. scalar and module for vectors). Of \r
106  course, the size of primitives in the Viewer also depends on their location \r
107  within the 3D scene. At a given computed size, a primitive will be bigger \r
108  when it is close to the camera and smaller at a distance. &nbsp;</p>\r
109 \r
110 <p>There are three Basic primitive types which can be used in Gauss Points \r
111  presentations: <span style="font-weight: bold;"><B>Point Sprites, Open GL \r
112  Points</B></span> and <span style="font-weight: bold;"><B>Geometrical Spheres.</B></span></p>\r
113 \r
114 <p>&nbsp;</p>\r
115 \r
116 <p class="whs2">Point Sprites</p>\r
117 \r
118 <p class="whs2">&nbsp;</p>\r
119 \r
120 <p class="whs3"><img src="image33.jpg" width="511px" height="244px" border="0" class="img_whs4"></p>\r
121 \r
122 <p class="whs2">&nbsp;</p>\r
123 \r
124 <p>Each <span style="font-weight: bold;"><B>Point Sprite</B></span> is visualised \r
125  in 3D Viewer with two 16*16 textures: <span style="font-weight: bold;"><B>Main \r
126  texture</B></span> which defines the shape of the point sprite and <span style="font-weight: bold;"><B>Alpha \r
127  Channel Texture</B></span> which defines the transparency of the point sprite. \r
128  By default Salome suggests textures defined in the Preferences, however \r
129  you can browse for other .bmp, .png or .jpg files to be used as textures. \r
130  </p>\r
131 \r
132 <p><span style="font-weight: bold;"><B>Alpha Channel Threshold</B></span> defines \r
133  the level of transparency ranging from 0 to 1. </p>\r
134 \r
135 <p>The default sizes of point sprites are computed by the system, therefore, \r
136  these parameters cannot be defined in the preferences, however, the <span \r
137  style="font-weight: bold;"><B>Maximum Size</B></span> of the point sprite is \r
138  limited (Clamp) so that the whole scene would remain visible if the user \r
139  applies a high zoom factor. <span style="font-weight: bold;"><B>Maximum Size</B></span> \r
140  corresponds to the maximum size of a point sprite during rendering whatever \r
141  is the magnification of the point or the zoom of the view. Technically, \r
142  it corresponds to setting up a clamp in the vertex shader. The Size is \r
143  measured in pixels and belongs to the interval from 1 to 512. </p>\r
144 \r
145 <p>&nbsp;</p>\r
146 \r
147 <p class="whs2">OpenGL Points</p>\r
148 \r
149 <p class="whs2">&nbsp;</p>\r
150 \r
151 <p class="whs5">&nbsp;<img src="image30.gif" width="485px" height="141px" border="0" class="img_whs6"></p>\r
152 \r
153 <p>&nbsp;</p>\r
154 \r
155 <p><span style="font-weight: bold;"><B>OpenGL Points</B></span> don't use any \r
156  files as textures, displaying results as simple OpenGL points, so the \r
157  only parameter relevant to them is the <span style="font-weight: bold;"><B>Maximum \r
158  Size. </B></span></p>\r
159 \r
160 <p>&nbsp;</p>\r
161 \r
162 <p class="whs2">Geometrical Spheres</p>\r
163 \r
164 <p class="whs2">&nbsp;</p>\r
165 \r
166 <p class="whs3"><img src="image31.gif" width="484px" height="139px" border="0" class="img_whs7"></p>\r
167 \r
168 <p class="whs8">&nbsp;</p>\r
169 \r
170 <p class="whs8">Geometrical Spheres <span \r
171  style="font-weight: normal;">display results using a standard sphere with \r
172  a number of faces be defined thought a </span>Resolution<span style="font-weight: normal;"> \r
173  parameter. By default the </span>Resolution<span style="font-weight: normal;"> \r
174  is set to 8. This number corresponds to the Latitude and Longitude definitions \r
175  of a VTK sphere. The </span>Number of Faces<span style="font-weight: normal;"> \r
176  parameter is equal to the total number of points in the scene when no \r
177  segmentation cursor is used or number of points within the cursor when \r
178  a segmentation is in progress, multiplied by the number of faces of one \r
179  Sphere in the current resolution. This value computed by the system using \r
180  the formula: NbrFaces = 2*Resolution x &nbsp;[Resolution-2] \r
181  and displayed to the end-user for information purpose.</span></p>\r
182 \r
183 <p class="whs8"><span style="font-weight: normal;">in \r
184  the pictures you can see the spheres with </span>Resolution<span style="font-weight: normal;"> \r
185  of</span> <span style="font-size: 36pt;"><font size=7 style="font-size:36pt;">8</font></span> <span style="font-weight: normal;"><img src="pics/image87.gif" x-maintain-ratio="TRUE" width="186px" height="175px" border="0" class="img_whs9"> &nbsp;and \r
186  </span><span style="font-size: 36pt;"><font size=7 style="font-size:36pt;">6<img src="pics/image88.gif" x-maintain-ratio="TRUE" width="191px" height="175px" border="0" class="img_whs10"></font></span></p>\r
187 \r
188 <p class="whs11">&nbsp;</p>\r
189 \r
190 <p class="whs12"><span style="font-weight: bold;"><B>Notify \r
191  when number of faces exceeds </B></span>prompts the user by a dialog to continue \r
192  or to cancel the display operation if the number of faces is greater than \r
193  the number defined in the menu. </p>\r
194 \r
195 <p class="whs13">&nbsp;</p>\r
196 \r
197 <p align="center" class="whs14"><img src="pics/warning.png" x-maintain-ratio="TRUE" width="418px" height="154px" border="0" class="img_whs15"></p>\r
198 \r
199 <p class="whs2">&nbsp;</p>\r
200 \r
201 <p>&nbsp;</p>\r
202 \r
203 <p>&nbsp;</p>\r
204 \r
205 <p>&nbsp;</p>\r
206 \r
207 <p>&nbsp;</p>\r
208 \r
209 <script type="text/javascript" language="javascript1.2">\r
210 <!--\r
211 if (window.writeIntopicBar)\r
212         writeIntopicBar(0);\r
213 //-->\r
214 </script>\r
215 </body>\r
216 </html>\r