LogoLogo
  • User Manual
  • Chapters
    • Welcome
      • Acknowledgments
      • History
      • Sisyphean Effort
    • Quick Start Guide
      • Installation
      • Defining a Show Directory
      • Controllers
      • Layout and Background Image definition
      • Model Definition
      • Model Group Definition
      • Creating a New Sequence
        • Adding Models to a View
      • Adding Effects
      • Saving the Sequence
      • Backup and Exit
      • Testing
    • Installation
      • Upgrade
      • Windows
      • Macintosh
      • Linux
    • Controllers Tab
      • Controllers
      • Show Directory
      • Controllers Settings
        • USB Controller
        • Ethernet Controller
        • NULL Controller
        • Controller Visualizer
    • Layout Tab
      • Layout
      • Models
        • Model Settings
          • Setting Start Channels
        • Arches Model
        • Channel Block Model
        • Candy Cane Model
        • Circle Model
        • Cube Model
        • Custom Model
        • DMX Model
          • DMX Moving Head Advance
        • Image Model
        • Icicles Model
        • Matrix Model
        • PolyLine Model
        • Single Line Model
        • Sphere Model
        • Spinner Model
        • Star Model
        • Tree Model
        • Window Frame Model
        • Wreath Model
      • Download/Import Models
      • Model Groups
      • Objects
      • Layout Preview
      • Editing Layout Preview
      • Moving Model/Objects
      • SubModels
    • Sequencer Tab
      • Sequencer
      • Rendering
      • Timeline and Waveform
      • Adding An Effect
      • Changing An Effect
        • Changing Color Settings
      • Layers
        • Layer Blending
        • Layer Settings
      • Timing Tracks
      • Render All
      • Windows
      • Value Curves
      • Effect Presets
      • Views
      • Models
      • Singing Faces
        • Adding Word to User Dictionary
      • Pixel Editor
      • Shortcuts
    • Menus
      • File
        • New Sequence
        • Preferences
          • Backup
          • View
          • Effects Grid
          • Sequences
          • Output
          • Colors
          • Other
        • Sequence Settings
        • Backup and Recovery
      • Edit
      • Tools
        • Test
        • Convert
        • Generate Custom Model
        • FPP Connect
      • View
        • Windows
        • Perspectives
      • Audio
      • Import
      • Help
    • Advanced Features
  • Effects
    • Built-in Effects
      • Off
      • On
      • Adjust
      • Bars
      • Butterfly
      • Candle
      • Circles
      • Color Wash
      • Curtain
      • DMX
      • Duplicate
      • Faces
      • Fan
      • Fill
      • Fire
      • Fireworks
      • Galaxy
      • Garlands
      • Glediator
      • Guitar
      • Kaleidoscope
      • Life
      • Lightning
      • Lines
      • Liquid
      • Marquee
      • Meteors
      • Morph
      • Moving Head
      • Music
      • Piano
      • Pictures
      • Pinwheel
      • Plasma
      • Ripple
      • Servo
      • Shader
      • Shape
      • Shimmer
      • Shockwave
      • Single Strand
      • Snowflakes
      • Snow Storm
      • Spirals
      • Spirograph
      • State
      • Strobe
      • Tendrils
      • Text
      • Tree
      • Twinkle
      • Video
      • VU Meter
      • Warp
      • Wave
  • Appendicies
    • Glossary
    • Keyboard Shortcuts
  • Tutorials
    • Configure Matrix Panels
    • Coming from LOR
    • Editing xLights_rgb.xml
Powered by GitBook
On this page
  • Model Groups
  • Add Group
  • Modify Group
  • Delete Group
  • Rename Group
  • Clone Group
  • Delete Empty Groups
Export as PDF
  1. Chapters
  2. Layout Tab

Model Groups

PreviousDownload/Import ModelsNextObjects

Last updated 2 years ago

Model Groups

A Model Group defines a collection of models. It is an optional entity, but very useful, in that many effects can be sequenced against the Model Group and xLights will then generate effects on all the Models in the group.

A Model can belong to more than one Model Group. An an example a model ‘Arch1’ can belong to the ‘All Models Group’ Model group as well as the ‘Arches Group’

You can also have models that do not belong to a Model Group - for example a matrix that you wish to sequence effects on separately such that dropping an effect on the” All Models” group does not affect the matrix.

Add Group

To create a Model Group, from the layout tab right click within the Model list window. Click on Add Group, enter a Model Group name in the resultant window and click Ok.

In the layout windows, a Model Group can be added by highlight multiple models, right click, and select 'Create Group'.

In xLights, Model Groups are sequenced against an internal grid representation.

The Default Layout Mode and Max Grid Size provides options on how the ‘internal grid’ is to be calculated when effects run across a model group.

If ‘Grid as per preview’ is selected , then the buffer used will be exactly as to how the the house preview appears i.e will be quite large.

If ‘Minimal Grid’ is selected then the buffer area will be an area just surrounding the model group.

Select minimal grid wherever you can. Large grid sizes can significantly slow down rendering, particularly on some effects like fan and shockwave.

Modify Group

To modify the models that form part of a group, click on the group name.

The models that are currently in the group will be displayed in the ‘Models in Group’ right list and the other models will be displayed in the ‘Add to Group’ left list. Use the arrows to add or remove models as required and click on the Save when done.

The order of the models in the ‘Models in Group’ determines the render order of the Group Render Styles. 'Per Model' group render styles are rendered in model order top to bottom.

Delete Group

To remove a Model Group, select the Model Group from the model list, right click and select Delete Group. This will not change or remove any of the underlying models, however any effects that have been placed at that group level on the sequencer will be removed and the Model group will be removed from the Layout display if it has been added to that display.

Rename Group

To rename a Model Group, select the Model Group from the same list , right click and select Rename Group. Enter the new name for the Model Group. 'Clone Group' will create a copy of the current group with the same models. 'Delete Empty Groups' will delete Model Group with containing no models.

Selecting a Model Group from the list, sets it as a filter and only that Model Group is active on the layout; as such only models that are part of that group are displayed on the Preview screen. In order to revert back to all the models , Click on the ‘eye’ next to the Model Group name to deselect it.

Clone Group

Create a copy or clone of the currently selected group.

Delete Empty Groups

Delete any model group that is empty and contains no models or groups.

It is useful to have a Model Group (say “All Models”) and include all the models for your show and include that model group on the layout tab.