Overview

image-20240923-065121.png

The Parlament plug-in arranges child containers in a semicircular (hemicycle) seating layout — like seats in a legislative chamber or parliament. It is designed for election graphics, political visualizations, and any scene that needs to display items arranged in concentric arc rows.

The plug-in takes the parent container's geometry and material, hides the parent's own geometry, and clones it into N child containers distributed across configurable concentric rows.

Note: This plug-in is located in: Plugins -> Container plug-ins -> Tools

Note: This plug-in is compatible with the Classic Render Pipeline only.

This page contains the following topics and procedures:

Parameters

Parameter

Default

Range

Description

Number Of Elements

40

1 – 1,000

Total number of seats/objects to place in the hemicycle.

Number Of Rows

3

1 – 50

Number of concentric rows.

Rebuild Geometry

—

—

Deletes all child containers and rebuilds them from scratch.

Inner Radius

70.0

0 – 10,000

Radius of the innermost row.

Outer Radius

200.0

0 – 10,000

Radius of the outermost row.

Start Angle

−90°

−180° – 180°

The arc's starting angle. Default −90° starts at the left.

End Angle

90°

−180° – 180°

The arc's ending angle. Default 90° ends at the right, forming a semicircle.

X Scale

1.0

0.01 – 10

Per-element X scale.

Y Scale

1.0

0.01 – 10

Per-element Y scale.

Z Scale

1.0

0.01 – 10

Per-element Z scale.

Lock

On

—

Uniform scaling: when enabled, changing one axis applies to all three.

How It Works

Seat Distribution Algorithm

  1. The arc between Start Angle and End Angle is divided into concentric rings, spaced evenly between the inner and outer radius.

  2. Each row's arc length is computed. Seats are distributed proportionally: Outer rows (with longer arcs) receive more seats than inner rows.

  3. A greedy balancing algorithm picks the row with the lowest fill ratio for each seat, ensuring even distribution.

  4. Each child container is positioned on the arc and rotated to face the center of the hemicycle.

Live Update vs. Rebuild

The plug-in supports two update modes:

Mode

When

What happens

Live update

Radius, angles, or scale change

Existing child containers are repositioned and rescaled (no tree modification). Fast and non-destructive.

Rebuild

Rebuild Geometry button pressed, or element/row count changed

All child containers are deleted and recreated. Required when the number of elements or rows changes.

Important: The parent container must have a geometry assigned (for example, a Sphere, Cube, or custom object) before adding the Parlament plug-in. The plug-in clones this geometry into each child seat. The parent's own geometry is hidden automatically.

Setup Guide

Basic Parliament Visualization

  1. Create a container and assign a geometry (for example, a small Sphere) and a material.

  2. Add the Parlament plug-in to the container.

  3. Set Number Of Elements to the total seat count (for example, 598 for the German Bundestag).

  4. Set Number Of Rows to the desired row count (for example, 15).

  5. Adjust Inner Radius and Outer Radius to fit your scene layout.

  6. The plug-in creates child containers arranged in a semicircle.

Note: If the object you used for creating the seats contains many polygons, the total product of the parliament container can quickly be too heavy to render.

Coloring Seats by Party

After the plug-in creates the child containers, each seat is a separate container in the scene tree. You can:

  • Apply different materials to individual seats to represent party colors.

  • Use shared memory or ControlObject to drive seat colors from data.

  • Animate individual seats (for example, highlight a seat when a vote is cast).

Partial Arcs

To create layouts other than a semicircle:

  • Full circle: Set Start Angle to -180° and End Angle to 180°.

  • Quarter arc: Set Start Angle to -45° and End Angle to 45°.

  • Inverted (seats facing outward): Swap Start and End Angle values.

Usage Example: Election Night Graphic

  1. Create a Sphere geometry container with a small radius (for example, scale 0.5).

  2. Apply a neutral gray material.

  3. Add the Parlament plug-in with 598 elements across 15 rows.

  4. Set Inner Radius to 100, Outer Radius to 300.

  5. The plug-in generates 598 spheres arranged in the hemicycle pattern.

  6. Use a script or ControlObject to iterate through seats and assign party-colored materials based on election results data.

Technical Notes

  • The plug-in positions seats in the XZ plane: The arc opens along X, with rows stacked along Z (depth). Y is used for the vertical axis.

  • Each seat is rotated around the Y axis to face the center of the hemicycle.

  • The Scale Lock feature propagates any scale change to all three axes, ensuring uniform seat sizing.

  • Rounding errors in seat distribution are compensated on the last row to ensure the total always matches the requested element count.

  • For best performance with large seat counts (500+), avoid triggering Rebuild frequently, use live update (radius/angle/scale changes) when possible.