doc/salome/gui/VISU/input/point_marker.doc

   1 /*!
   2
   3 \page point_marker_page Point Marker
   4
   5 \n You can change the representation of points in
   6 the 3D viewer either by selecting one of the predefined
   7 shapes or by loading a custom texture from an external file.
   8
   9 - Standard point markers
  10
  11 The Post-Pro module provides a set of predefined point marker shapes
  12 which can be used to display points in the 3D viewer.
  13 Each standard point marker has two attributes: type (defines shape
  14 form) and scale factor (defines shape size).
  15
  16 \image html point_marker_dlg1.png
  17
  18 <br>
  19
  20 \image html std_point_marker.png "Presentation with standard point markers"
  21
  22 <br>
  23
  24 There is also an additional type of point marker - Point Sprite marker,
  25 which allows to display points as OpenGL point sprites with predefined
  26 shape and alpha mask. This marker is added to the end of the list of
  27 standard markers.
  28
  29 \note The Point Sprite marker is insensitive to scale factor parameter,
  30 but it is possible to change its magnification by pressing "m" and "M"
  31 (Shift + "m") buttons in the view, just like for Gauss Points presentation.
  32
  33 \image html point_marker_dlg3.png
  34
  35 <br>
  36
  37 \image html point_sprite_marker.png "Presentation with Point Sprite marker"
  38
  39 - Custom point markers
  40
  41 It is also possible to load a point marker shape from an external file.
  42 This file should provide a description of the point texture as a set
  43 of lines; each line is represented as a sequence of "0" and "1" symbols,
  44 where "1" symbol means an opaque pixel and "0" symbol means a
  45 transparent pixel. The width of the texture corresponds to the length
  46 of the longest line in the file, expanded to the nearest byte-aligned
  47 value. The height of the texture is equal to the number of non-empty
  48 lines in the file. Note that missing symbols are replaced by "0".
  49
  50 Here is a texture file sample:
  51
  52 <pre>
  53 00111100
  54 00111100
  55 11111111
  56 11111111
  57 11111111
  58 11111111
  59 00111100
  60 00111100
  61 </pre>
  62
  63 \image html point_marker_dlg2.png
  64
  65 <br>
  66
  67 \image html custom_point_marker.png "Presentation with custom point markers"
  68
  69 <b>See Also</b> a sample script of using
  70 \ref tui_point_marker_page "Point Marker" functionality via TUI.
  71
  72 */
  73