doc/salome/gui/GEOM/input/get_non_blocks.doc

   1 /*!
   2
   3 \page get_non_blocks_page Get Non Blocks
   4
   5
   6 This operation retrieves all non-block solids and non-quadrangular faces from the selected shape.
   7
   8 A block solid is a solid that has 6 quadrangular faces.
   9
  10 A quadrangular face is a face that has 1 wire with 4 edges. If there are
  11 more than 4 edges in a single wire and C1 continuity mode is switched on,
  12 a face is quadrangular if it has 4 bounds of C1 continuity.
  13
  14 All solids and faces from a shape that do not satisfy these conditions are
  15 returned by this operation.
  16
  17 \image html measures2.png
  18
  19 It is possible to select an \b Object to be explored, to check or uncheck
  20 <b>Use C1 criterion</b> option and to set the <b>Angular Tolerance</b>
  21 to check C1 continuity between neighbor edges in a wire.
  22
  23 \b Preview option shows non-block solids and non-quadrangular faces in the viewer.
  24
  25 Press \b Apply or <b>Apply and Close</b> button to publish non-block solids
  26 and non-quadrangular faces in the Object Browser under the processed object.
  27 Solids and faces are published separately in two groups.
  28
  29 If no bad sub-shapes have been found, the corresponding warning is shown.
  30
  31 \image html measures2a.png
  32
  33 \n <b>TUI Command:</b>
  34 <em>geompy.GetNonBlocks(theShape, theIsUseC1 = False, theAngTolerance = 1.e-12).</em> \n
  35 where \n
  36 \em theShape is the shape to explore, \n
  37 \em theIsUseC1 is the flag to check if there are 4 bounds on a face
  38     taking into account C1 continuity, \n
  39 \em theAngTolerance the angular tolerance to check if two neighbor edges are
  40     codirectional in the common vertex with this tolerance. This parameter is
  41     used only if \em theIsUseC1 is set to True.
  42
  43 This command returns a tuple of two GEOM_Objects.
  44
  45 The first object is a group of all non-block solids; the second object is a group
  46 of all non-quadrangular faces.
  47
  48 See also a \ref tui_get_non_blocks_page "TUI example".
  49
  50 */