Salome HOME
Merge branch 'V8_5_asterstudy'
[modules/smesh.git] / doc / salome / gui / SMESH / input / point_marker.rst
1 .. _point_marker_page:
2
3 ************
4 Point Marker
5 ************
6
7 You can change the representation of points in
8 the 3D viewer either by selecting one of the predefined
9 shapes or by loading a custom texture from an external file.
10
11 Standard point markers
12 ----------------------
13
14 The Mesh module provides a set of predefined point marker shapes
15 which can be used to display points in the 3D viewer.
16 Each standard point marker has two attributes: type (defines shape
17 form) and scale factor (defines shape size).
18
19 .. image:: ../images/point_marker_widget1.png
20         :align: center
21
22
23 .. image:: ../images/std_point_marker.png
24         :align: center
25
26 .. centered::
27         Mesh presentation with standard point markers
28
29 Custom point markers
30 --------------------
31
32 It is also possible to load a point marker shape from an external file.
33 This file should provide a description of the point texture as a set
34 of lines; each line is represented as a sequence of "0" and "1" symbols,
35 where "1" symbol means an opaque pixel and "0" symbol means a
36 transparent pixel. The width of the texture corresponds to the length
37 of the longest line in the file, expanded to the nearest byte-aligned
38 value. The height of the texture is equal to the number of non-empty
39 lines in the file. Note that missing symbols are replaced by "0".
40
41 Here is a texture file sample:
42 ::
43
44         11111111
45         10000001
46         10011001
47         10111101
48         10111101
49         10011001
50         10000001
51         11111111
52
53
54 .. image:: ../images/point_marker_widget2.png
55         :align: center
56
57
58 .. image:: ../images/custom_point_marker.png 
59         :align: center
60
61 .. centered::
62         Mesh presentation with custom point markers