image-20240918-105452.png

The Pie Slice plug-in is used with the Pie Values plug-in to create and animate a pie chart of up to 20 slices.

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

Pie Slice Properties

  • Obj Min / Max: Maps the input values to the values on the cylinder object. Adjust these together with Bar Max/Min on the Pie Values plug-in to get the required effect between input values and visual effect.

  • Offset: Offsets the slice from the center of the pie chart.

  • Text Offset: Offsets the text label from the center of the pie chart.

  • Control Text Values: Sets the type of text. Available options are No, Integer, Float and Formatted.

  • Initialize: Initializes the value of the pie slice.

  • Offset Scale with Size and Offset Scale: (Engine 5.6 or newer)

The Pie Slice plug-in separates a slice from the pie by moving its container outward along the slice's own centerline (bisector). Because a slice is a wedge, moving it outward by a given distance opens a gap between it and its neighbors that is proportional to the sine of half the slice angle. The consequence: with the same Offset value on every slice, wide slices visibly separated much further than narrow ones, and uniformly separated "exploded pie" animations were not achievable.

  • Offset Scale With Size (checkbox, default: on)

    • On — legacy behavior. Offset is the distance the slice container travels outward. The resulting gap between neighboring slices grows with slice size.

    • Off — uniform-gap behavior. Offset now defines the gap between the slice and its neighbors, and the plug-in automatically computes the travel distance needed for each slice to produce that same gap. All slices appear separated by the same distance regardless of their size.

  • Offset Scale (numeric, default: 4.0, range 1.0–100.0)

    • Limits how far a slice may travel when Offset Scale With Size is off. The travel distance is capped at Offset × Offset Scale.

    • This cap is needed because a very thin slice would require an extremely large travel distance to open the same gap as a wide one, which would fling it off the pie. Raise the value to let thin slices reach their full uniform gap; lower it to keep all slices close to the pie center.

Existing scenes are unaffected. The default (Offset Scale With Size on) reproduces the pre-5.6 behavior exactly, so scenes built with earlier versions render identically.

Practical guidance

Uncheck Offset Scale With Size on every Pie Slice container in the chart, then animate Offset to get an evenly separated "exploding pie". Setting it on only some slices produces mixed behavior.

With the default Offset Scale of 4.0, slices of roughly 29° or wider (about 8% of the pie) reach the full uniform gap; thinner slices hit the cap and separate slightly less than the others. Approximate thresholds for other values:

Offset Scale

Slices reaching the full uniform gap

1.0

180° and wider (cap is effectively always active)

2.0

60° and wider (~17% of the pie)

4.0 (default)

~29° and wider (~8% of the pie)

10.0

~11.5° and wider (~3% of the pie)

100.0

~1° and wider

See Also