<     > 

Groups

If you want to visually indicate that a group of parameters are related you can use the Group control. Grouped parameters always appear within an outlined box and you can either specify a name to appear as a label (in double quotation marks) or just the outline (by using the ShowFrame keyword).

If the group of parameters appears inside a Rows with another group of parameters, you can also specify the width of each group relative to the entire width of the row.

Layout "Default"
{
   ...
   Group {["<group_name>"] | [, ShowFrame]} [, width%]
   {
       <parameter_nameM>;
       <parameter_nameN>;
       ...
   }
   ...
}

Example: Grouping Parameters with a Label

You can also display the group in a frame with a caption:

Group "Measurements"
{
   TaskSize;
}

Example: Grouping Parameters with an Outline Only

You can use the ShowFrame attribute to put the group in a frame. For example, the following group will be displayed without a caption, but with a frame:

Group, ShowFrame
{
   TaskSize;
}

Example: Grouping Parameters on a Single Row

You can use Row to place to groups side by side. For example:

Row 
{
   Group "Objects"
   {
       objcurves;
       objnurbssrf;
       objpolymesh;
       objimpgeometry;
       objnulls;
       objlights;
       objcameras;
   }
   Group "Control Objects"
   {
       objctrlchnroots;
       objctrlchnjnts;
       objctrlchneff;
       objctrllattices;
       objctrlwaves;
       objctrltextsupp;
       objctrlother;
   }
}

Group "Invisible Objects"
{
   showattrnogeom;
}

width

The width value allows you to control the horizontal spacing of groups on a page by specifying the percentage that each should take. For example, we could modify the above example to reduce the size of the left group using this syntax:

Row 
{
   Group "Objects", 30%
   {
       objcurves;
       objnurbssrf;
       objpolymesh;
       objimpgeometry;
       objnulls;
       objlights;
       objcameras;
   }
   Group "Control Objects", 70%
   {
       objctrlchnroots;
       objctrlchnjnts;
       objctrlchneff;
       objctrllattices;
       objctrlwaves;
       objctrltextsupp;
       objctrlother;
   }
}

Group "Invisible Objects"
{
   showattrnogeom;
}

SOFTIMAGE|XSI v6.01     <     >