geom/doc/salome/gui/GEOM/working_with_groups.htm

<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">

<html>

<head>
<title>Working with groups</title>
<meta http-equiv="content-type" content="text/html; charset=windows-1252">
<meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">
<link rel="stylesheet" href="default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
<!--
if (navigator.appName !="Netscape")
{   document.write("<link rel='stylesheet' href='default.css'>");}
//-->
</script>
<style type="text/css">
<!--
p.whs1 { margin-left:40px; }
img_whs2 { border:none; width:24px; height:22px; border-style:none; }
p.whs3 { font-size:12pt; }
p.whs4 { font-size:12pt; margin-left:40px; font-weight:bold; }
img_whs5 { border:none; border-style:none; width:312px; height:379px; float:none; }
p.whs6 { font-size:12pt; font-weight:bold; }
p.whs7 { font-size:12pt; margin-left:40px; }
img_whs8 { border:none; width:250px; height:307px; border-style:none; }
img_whs9 { border:none; width:22px; height:22px; border-style:none; }
ul.whs10 { list-style:disc; }
-->
</style><script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
<!--
function reDo() {
  if (innerWidth != origWidth || innerHeight != origHeight)
     location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
}
onerror = null;
//-->
</script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
-->
</style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
<script type="text/javascript" language="javascript" src="whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
</head>
<body><script type="text/javascript" language="javascript1.2">
<!--
if (window.gbWhTopic)
{
	if (window.addTocInfo)
	{
	addTocInfo("GEOM module\nCreating geometrical objects\nWorking with groups");
addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");

	}
	if (window.writeBtnStyle)
		writeBtnStyle();

	if (window.writeIntopicBar)
		writeIntopicBar(1);

	if (window.setRelStartPage)
	{
	setRelStartPage("geom.htm");

		autoSync(1);
		sendSyncInfo();
		sendAveInfoOut();
	}
}
else
	if (window.gbIE4)
		document.location.reload();
//-->
</script>
<h1>Working with groups</h1>

<p>The <span style="font-style: italic;"><I>Salome</I></span> platform offers
 such a useful functionality as creation and editing groups of subshapes
 of a geometrical object which makes handling subshapes much easier. However
 the functionality is available in the OCC viewer only. If other viewer
 is used in your project by default, you can toggle the OCC viewer via
 Preferences / Viewer background / OCC viewer. &nbsp;</p>

<p>&nbsp;</p>

<p class=TODO>To perform operations with groups:</p>

<p class=TODO>&nbsp;</p>

<p class="whs1">In the main menu select <span style="font-weight: bold;"><B>New
 entity &gt; Group</B></span>.</p>

<p>&nbsp;</p>

<p><img src="image56.gif" width="24px" height="22px" border="0" class="img_whs2"> <span style="font-weight: bold; font-size: 14pt;"><font size=4 style="font-size:14pt;"><B>Create
 a group</B></font></span></p>

<p>&nbsp;</p>

<p class="whs3"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;">Description:</b>
 Creates a group of subshapes of a geometrical object.</font></span></p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Result:</b> GEOM_Object.</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">TUI Command:</b><i>
 </i><span style="font-style: italic;"><I>geompy.CreateGroup(MainShape, ShapeType)</I></span>,
 where MainShape is a shape for which the group is created, ShapeType is
 a type of shapes in the created group.</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Arguments:</b>
 1 Shape + Type of subshape.</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Dialog Box:</b></p>

<p class="whs3">&nbsp;</p>

<p class="whs4"><b style="font-weight: bold;"><img src="pics/creategroup.png" x-maintain-ratio="TRUE" width="312px" height="379px" border="0" class="img_whs5"></b></p>

<p class="whs3">&nbsp;</p>

<p class="whs6">Example:</p>

<p class="whs6">&nbsp;</p>

<p class="whs7"><img src="image193.jpg" width="250px" height="307px" border="0" class="img_whs8"></p>

<p class="whs3">&nbsp;</p>

<p class="whs3">&nbsp;</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><img src="image57.gif" width="22px" height="22px" border="0" class="img_whs9"> <span style="font-weight: bold; font-size: 14pt;"><font size=4 style="font-size:14pt;"><B>Edit
 a group</B></font></span></p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;">Description:</b>
 Allows to edit the existing group.</font></span></p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Result:</b> GEOM_Object.</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">TUI Command:</b><i>
 </i></p>

<ul type="disc" class="whs10">

	<li class=kadov-p><p class="whs3"><i><span style="font-style: italic;"><I>g</i>eompy.AddObject(Group,
 SubShapeID)</I></span>, where Group is a group to which a sub shape has to
 be added, SubShapeID is an ID of the sub shape to be added to the group</p></li>

	<li class=kadov-p><p class="whs3"><span style="font-style: italic;"><I>geompy.RemoveObject(Group,
 SubShapeID)</I></span>, where Group is a group from which a sub shape has
 to be removed, SubShapeID is an ID of the sub shape to be removed from
 the group</p></li>

	<li class=kadov-p><p class="whs3"><span style="font-style: italic;"><I>geompy.GetObjectIDs(Group)</I></span>,
 where Group is a group for which its object ID<49>s are returned. </p></li>
</ul>

<p class="whs7"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">Returns:
 List of IDs.</font></span></p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Arguments:</b>
 1 Shape + its subshapes.</p>

<p class="whs3">&nbsp;</p>

<p class="whs3"><b style="font-weight: bold;">Dialog Box:</b></p>

<p class="whs3">&nbsp;</p>

<p class="whs4"><b><img src="pics/editgroup.png" x-maintain-ratio="TRUE" width="312px" height="379px" border="0" class="img_whs5"></b></p>

<p class="whs4">&nbsp;</p>

<p class="whs3">Our <span style="font-weight: bold;"><B>TUI Scripts</B></span>
 provide you with useful examples of <a href="working_with_groups.htm">Working
 with Groups</a>. </p>

<p>&nbsp;</p>

<script type="text/javascript" language="javascript1.2">
<!--
if (window.writeIntopicBar)
	writeIntopicBar(0);
//-->
</script>
</body>
</html>