.. _groupspage:

Groups Page 
============

Grouping allows you to make quick changes to pre-allocated groups for making quick and impactful changes to effects and parameters. 
Move multiple objects in real time for even more impressive effects and streamlined control. 
Objects can be part of multiple groups but you don't give up any control, they can still be modified independently of the groups they are a part of.

-----------------------------

**Members Tab**

.. image:: ../../../_images/Groups_Members.*
    :alt: Members Tab
    :width: 100%
    :align: center


Use the Members tab to organise Groups. They can be added or removed and Objects can be assigned within each group in the Members Tab.

    - :guilabel:`+` Create a new group
    - :guilabel:`Delete` Remove the selected group
    - :guilabel:`Colour` Opens a dialog to randomise all groups' colours or reset them to the default value
    - :guilabel:`Group ID` Double-click to change this group's colour
    - :guilabel:`Group Name` Double-click to change this group's name
    - :guilabel:`Object Table` Use this matrix to assign Objects to Groups

You can drag and drop the Group rows to re-order them.

-----------------------------

**Settings Tab**

.. image:: ../../../_images/Groups_Settings.*
    :alt: Settings Tab
    :width: 100%
    :align: center


Control settings for individual groups can be adjusted in the Settings Tab:
    - :guilabel:`+` Create a new group
    - :guilabel:`Delete` Remove the selected group
    - :guilabel:`Colour` Opens a dialog to randomise all groups' colours or reset them to the default value
    - :guilabel:`Group ID` Double-click to change this group's colour
    - :guilabel:`Group Name` Double-click to change this group's name
    - :guilabel:`OSC Filter` If active, this group's parameters can be controlled through OSC messages
    - :guilabel:`OSC ID` Set the OSC number that this Group receives from (e.g. /group/{OSC ID}/…)
    - :guilabel:`Hide` Hides all Objects that are a member of this group

    Buttons above a column can be clicked to toggle the state of the entire column, so you can quickly change all Groups at once if you need to.