FormWren
Pre-release docs

Rounded Rectangle documentation

Workflow Summary

Create the core shape, choose a rendering path, then continue with profiling, export, or troubleshooting only when needed.

1 — Create and edit

Start With The Core Object

  1. From Unity's main menu, choose Tools > Rounded Rectangle > Create > Rounded Rectangle.
  2. Press F to frame the object.
  3. Drag a Scene handle for size or radius.
  4. Enter an exact value in RoundedRectangleGenerator.

Need the complete first-use route? Open Quick Start.

3 — Verify ownership

Edit The Component That Owns The Result

  • World Mesh: MeshRenderer draws; RoundedRectangleGenerator owns shape and style.
  • Canvas Mesh UI: RoundedRectCanvasGraphic draws; generator owns shape/style; RectTransform owns Canvas size.
  • Canvas SDF: RoundedRectSDFGraphic draws; a paired generator owns base shape/style; the SDF graphic owns effects.

Use the control locator in Reference when a control is hard to find.

4 — Compare a working setup

Open The Closest Example

Use a showcase scene for readable first edits, the Build Test scene for a compact path comparison, and the Stress Test matrix for edge cases. The Examples page names the exact scene and object to select.

5 — Finish for the intended use

Measure Or Export When Needed

Measure
Profile the real scene, compare live and cached states, and record batching, frame time, overdraw, memory, and capture spikes. Continue to Performance.
Export
Use Tools > Rounded Rectangle > Export for one live SDF or a supported selected Canvas subtree of Rounded Rectangle SDF/mesh visuals. Text/icons and editable selection layers remain separate. Continue to Raster export.

6 — Recover or report

Recover Or Report A Problem

  1. Name the Unity version and render pipeline.
  2. Name the base path: World Mesh, Canvas Mesh UI, or Canvas SDF.
  3. Name the component that draws the visible result.
  4. Disable cached rendering before judging live SDF edits.
  5. Record the first Console error and the smallest scene/object that reproduces it.

Start from the visible symptom in Troubleshooting; check version and pipeline requirements in Compatibility.