geom/doc/salome/gui/GEOM/input/shapesonshape.doc

/*!

\page shapesonshape_page Get Shapes on Shape

This operation is a special case of <b>Explode</b> operation. It
produces a group of sub-shapes of the exploded shape, which are
located in a definite way relatively another reference shape. The
reference shape should be a solid.

To use this operation, select in the Main Menu <b>Operations -> Get Shapes on Shape.</b> The following dialog box will appear. 

\image html shapesonshape.png

<ul>
<li> <b>Name</b> is the name of the resulting group of shapes; </li>
<li> <b>Shape for exploding</b> is the shape that will be exploded; </li>
<li> <b>Solid for checking</b> is the reference shape, which should be
a solid; </li>
<li> <b>Reconstruction Limit</b> is the type of created sub-shapes:
		       solid, shell, face, wire, edge, vertex; </li>
<li> <b>State</b> is the position of the created sub-shapes relatively the reference shapes:
        <ul>
	<li> IN - the created sub-shapes are located inside the reference shape; </li>
	<li> OUT - the created sub-shapes are located outside the reference shape; </li>
	<li> ON - the created sub-shapes lie on the reference shape; </li>
	<li> ONIN - the created sub-shapes lie on the reference shape or are located inside it; </li>
	<li> ONOUT - the created sub-shapes lie on the reference shape or are located outside it; </li>
        </ul> </li>
</ul>

Example: 

In the images below the box is the exploded shape and the cylinder is the reference shape. In the first image the edge IN the reference cylinder is highlighted in red, in the second the edges OUT of the reference cylinder are highlighted.

\image html shonshex1.png
\image html shonshex2.png

 
*/