/*! \page create_groups_page Generation of Groups This option is available in some dialogs. To activate it please check Generate Groups check box. When it is checked, it is possible to define the prefix for generated groups names using Group Names Prefix input field. \image html gen_group_dlg.png "Generate groups option in a dialog" The groups are created along with the result of the operation when \b Apply or Apply and Close button is clicked. Each generated group represents a set of sub-shapes of the result that satisfies certain conditions. The groups of the following types can be generated: - \b Down - sub-shapes starting the result, e.g. bottom lid for the pipe creation operation. - \b Up - sub-shapes ending the result, e.g. top lid for the pipe creation operation. - \b Side1, \b Side2 - sub-shapes corresponding to each side of the result. - \b Other - faces generated from the bounding edges of \b Down group. The groups are named according to the following naming rule: If Group Names Prefix is set _, otherwise the name is \b . The following figure shows group names created with the prefix \b Group: \image html gen_group_tree.png "Group_Down, Group_Up, Group_Side1 and Group_Side2 are generated" The general behavior of this functionality is the following: \b Down and \b Up groups contain: - Edges if the profile is edge or wire; - Faces if the profile is face or shell. \b Side1 and \b Side2 groups contain edges generated from the first and last vertices of the profile edge or wire correspondingly. The first and last vertices are determined taking into account edge/wire orientation. \b Other group represents faces generated from the bounding edges of profile. The behavior in TUI is the following: - Each Python function that supports groups generation has a flag \b IsGenerateGroups which is equal to \b False by default. - If \b IsGenerateGroups is not set the groups are not created; the returned value is GEOM_Object that represents a result of the operation. - If \b IsGenerateGroups is set the operation returns a list of GEOM_Object. Its first element is a result, the remaining ones are the groups in the order: \b Down, \b Up, \b Side1, \b Side2 for opened profile or \b Down, \b Up, \b Other for closed profile. - If \b IsGenerateGroups is set and the path is closed an error occurs. */