# Advanced Duplicator
Create pattern-based duplications with precise control over positioning, transforms, and animation timing. Generate grids, circles, spirals, and custom arrangements with automatic transform interpolation and staggered animation offsets.

## What is Advanced Duplicator?

Pattern-based duplication with transform and animation control.

**How it works:**

1. Select layer to duplicate
2. Choose from 6 duplication patterns
3. Configure transform variations (position, scale, rotation, opacity)
4. Add animation stagger for cascading effects
5. Preview before applying
6. One-click application

## Accessing Advanced Duplicator

**Access methods:**

<List type="bullet">
  <ListItem>**Right-click** layer → "Advanced Duplicate"</ListItem>
  <ListItem>**Keyboard shortcut:** Shift + Cmd/Ctrl + D</ListItem>
  <ListItem>**Left sidebar:** Click Duplicator icon</ListItem>
  <ListItem>**Edit menu:** Edit → Advanced Duplicate</ListItem>
</List>

**Requirements:**

<List type="bullet">
  <ListItem>Must have a layer selected</ListItem>
  <ListItem>Layer cannot be locked</ListItem>
  <ListItem>Works with single layer selection</ListItem>
</List>

## Duplication patterns

**Linear** — arrange in straight line

<List type="bullet">
  <ListItem>Count, direction (angle), spacing X/Y</ListItem>
  <ListItem>Use for: horizontal/vertical rows, diagonal lines</ListItem>
</List>

**Grid** — arrange in rows and columns

<List type="bullet">
  <ListItem>Rows, columns, row gap, column gap, stagger option</ListItem>
  <ListItem>Use for: icon grids, product galleries, tile layouts</ListItem>
</List>

**Circular** — arrange around a circle

<List type="bullet">
  <ListItem>Count, radius, start/end angle, orient to path</ListItem>
  <ListItem>Use for: radial menus, clock faces, circular progress indicators</ListItem>
</List>

**Spiral** — arrange in spiral from center outward

<List type="bullet">
  <ListItem>Count, start/end radius, revolutions, growth rate (linear/exponential)</ListItem>
  <ListItem>Use for: spiral galaxies, vortex effects, growing animations</ListItem>
</List>

**Confetti** — scatter duplicates in explosion-like pattern

<List type="bullet">
  <ListItem>Count, spread radius, seed</ListItem>
  <ListItem>Use for: confetti explosions, particle bursts, celebration effects</ListItem>
</List>

**Random** — distribute duplicates randomly within boundary

<List type="bullet">
  <ListItem>Count, boundary shape (rectangle/circle), min distance, seed</ListItem>
  <ListItem>Use for: random star fields, scattered objects, organic distributions</ListItem>
</List>

## Transform options

Apply graduated transform changes across duplicates.

**Available transforms:**

<List type="bullet">
  <ListItem>**Scale** — size progression (start/end percentage)</ListItem>
  <ListItem>**Rotation** — rotation progression (start/end degrees)</ListItem>
  <ListItem>**Opacity** — fade progression (start/end percentage)</ListItem>
  <ListItem>**Position Offset** — gradual position shift (start/end X,Y offset)</ListItem>
</List>

**Interpolation:**

<List type="bullet">
  <ListItem>Linear, Ease In, Ease Out, Ease In-Out</ListItem>
  <ListItem>Each transform has checkbox to enable/disable</ListItem>
</List>

## Animation offset

Stagger animation timing for cascading effects.

**Animation options:**

<List type="bullet">
  <ListItem>**Enable Animation Offset** — toggle stagger on/off</ListItem>
  <ListItem>**Offset Amount** — frame delay between duplicates</ListItem>
  <ListItem>**Direction** — Forward, Backward, Center Out, Random</ListItem>
</List>

## Preview and apply

**Live preview:**

<List type="bullet">
  <ListItem>Enable preview to see duplicates in real-time</ListItem>
  <ListItem>Non-destructive — original layer unchanged</ListItem>
  <ListItem>Adjust any setting to see instant update</ListItem>
</List>

**Applying duplication:**

1. Configure pattern, transforms, animations
2. Enable preview to verify results
3. Make final adjustments
4. Click "Apply" button
5. Duplicates created as real layers
6. Original layer remains selected
