<!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-style:none; border:none; width:24px; height:22px; }
p.whs3 { font-size:12pt; }
p.whs4 { font-size:12pt; margin-left:40px; }
img_whs5 { border-style:none; border:none; width:200px; height:224px; }
p.whs6 { font-size:12pt; font-weight:bold; }
img_whs7 { border-style:none; border:none; width:250px; height:307px; }
img_whs8 { border-style:none; border:none; width:22px; height:22px; }
ul.whs9 { list-style:disc; }
img_whs10 { border-style:none; border:none; width:200px; height:226px; }
-->
</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="image192.jpg" width="200px" height="224px" border="0" class="img_whs5"></b></p>

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

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

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

<p class="whs4"><img src="image193.jpg" width="250px" height="307px" border="0" class="img_whs7"></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_whs8"> <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="whs9">
	
	<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�s are returned. </p></li>
</ul>

<p class="whs4"><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 style="font-weight: bold;"><img src="image194.jpg" width="200px" height="226px" border="0" class="img_whs10"></b></p>

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