Getting Started
Fast, repeatable workflow
- Select an engine from the sidebar: T (Textile) · B (Bricks) · V (Voronoi) · G (Growth) · P (P6M) · R (Raster).
- Adjust parameters in the engine's control panel.
- Press Generate to rebuild the result.
- Export as PNG, OBJ+MTL, STL, or SVG depending on the engine.
- Use Save Preset to store your configuration as a reusable JSON file.
Tip: keep Seed fixed for reproducible outputs
Tip: increase export width only at the end
Tier Limits
Performance caps per tier
| Limit | PRO | STUDIO | Applies to |
|---|
| Max PNG export width | 4096 | 16384 | All engines with PNG export |
| Max mesh resolution | 32 | 64 | Textile (poly-quality) |
| Max density | 40 | 80 | Textile (density-input) |
| Max output dimension | — | 15000 | Raster (width / height) |
If a preset exceeds your tier cap, values are automatically clamped inside the engine.
Exports
Formats vary per engine
PNG - raster image for web / print previews.
OBJ + MTL - 3D geometry + materials for DCC apps (Blender, 3ds Max, etc.).
STL - watertight 3D mesh for fabrication and printing.
SVG - vector paths for Illustrator, CAD, laser cutting (Studio: Bricks / Voronoi / P6M / Raster).
Presets (JSON)
Save · Share · Reload
Use Save Preset to download a .json file with all current parameters.
Use Load Preset to restore them. Presets are the recommended way to create "Relic Packs"
and maintain consistent outputs across sessions.
AI Relic
Stability AI texture generation
Workflow: paste your Stability API Key → press Save → write a prompt → press AI Relic.
The key is stored locally in your browser and is never uploaded to any server.
Parametric weave pattern generator with cloth drape simulation and 3D STL export.
Weave Parameters
| Control | Description |
|---|
| Relic Type | Selects the base weave pattern (plain, twill, satin, etc.). |
| Density | Grid density / repetition count. Higher = more detailed weave. |
| Resolution | Mesh resolution. Higher = smoother geometry but heavier files. |
| Strand Width | Visual thickness of each woven strand. |
| Weave Amplitude | Over/under wave intensity. Higher = deeper interlacing effect. |
| Cross Section | Strand cross-section shape: Rectangle (Width × Height) or Circle (Diameter). |
Simulation & Texture
| Control | Description |
|---|
| Upload Texture | Applies an image as a color / bitmap source for the weave. |
| Toggle Drape | Shows a cloth drape simulation preview. |
| Clear Texture | Removes the current texture. |
Actions & Export
| Control | Description |
|---|
| Generate | Builds / updates the output with current parameters. |
| Export Tile (STL) | Exports a single repeatable tile as a 3D STL file. |
| Export Relic (STL) | Exports the full relic as a 3D STL file. |
Parametric brick wall generator with stagger modes, gradient / image color mapping, and OBJ export.
Geometry
| Control | Description |
|---|
| Rows | Number of brick rows in the wall. |
| Wall Width (px) | Canvas width in pixels. |
| Brick Depth (mm) | Extrusion depth for 3D OBJ export. |
| Export Width (px) | Final raster export width. |
| Grout H / Grout V | Horizontal and vertical grout spacing. |
| Bevel | Corner softening on each brick. |
Stagger
| Control | Description |
|---|
| Mode | Stagger behavior: running bond, stack, random, etc. |
| Min % / Max % | Range for randomized brick widths in stagger modes. |
Color
| Control | Description |
|---|
| Background | Grout / background color behind bricks. |
| Mode | Solid, Gradient, or Image Mapping. |
| Gradient start / end | Gradient color endpoints. |
| Direction | Gradient direction: vertical / horizontal. |
| Tone noise % | Random color variation per brick for organic feel. |
| Upload Image | Map an image onto the wall as color source. |
| Average Color per Brick | When image-mapped, uses average pixel color per brick (mosaic). |
| Posterize levels | Reduces gradient to stepped bands for print / laser aesthetics. |
Actions
| Control | Description |
|---|
| Generate | Builds / updates with current parameters. |
| Export PNG | Raster image export. |
| Export OBJ+MTL | 3D geometry + material export. |
| AI Relic | AI-assisted texture generation via Stability AI. |
| Save / Load Preset | JSON preset management. |
Voronoi diagram generator with gradient/image fill, 3D depth extrusion, and OBJ export.
Diagram
| Control | Description |
|---|
| Width / Height (px) | Canvas dimensions. |
| Points | Number of Voronoi sites. More points = finer cells. |
| Seed | Fixed seed for reproducible layouts. |
| New Seed | Randomize for a fresh variation. |
Style
| Control | Description |
|---|
| Border Color / Thickness | Stroke color and weight for cell outlines. |
| Background | Background color behind the diagram. |
| Corner Radius | Rounds cell corners for softer graphics. |
Color
| Control | Description |
|---|
| Mode | Solid, Gradient, or Image Mapping. |
| Gradient Colors / Direction | Gradient endpoints and orientation. |
| Gradient Steps (Posterize) | Stepped banding for design aesthetics. |
| Upload Image | Image-based color mapping. |
| Average Color per Cell | Mosaic mode: each cell samples average pixel color. |
3D Export & Actions
| Control | Description |
|---|
| Cell Depth (Z) | Extrusion thickness for 3D export. |
| Depth Variance (%) | Randomizes depth per cell for organic variation. |
| Export PNG / OBJ+MTL | Raster and 3D export. |
| AI Relic | Stability AI texture generation. |
| Save / Load Preset | JSON preset management. |
L-system growth simulator with 3D branching, OBJ/STL export, and organic randomness controls.
Growth Seed
| Control | Description |
|---|
| Seed Type | Selects the base L-system preset. |
| Axiom (Start) | Starting string for the L-system. |
| Rules | Replacement rules that control branching patterns. |
Growth Parameters
| Control | Description |
|---|
| Age (Generations) | Number of L-system iterations. More = more complex. |
| Angle (°) | Turn angle used by the turtle renderer. |
| Step Length | Forward step size for each segment. |
| Thickness / Thick. Factor | Branch line weight and taper ratio. |
| Bush Angle (3D only) | Out-of-plane branching angle for 3D mode. |
| Distribution | Controls how branches are distributed spatially. |
Coloring & Randomness
| Control | Description |
|---|
| Mode / Color A / Color B | Coloring mode and color palette. |
| Angle Rand (°) | Random variation added to turn angle per step. |
| Len Rand (%) | Random variation in segment length. |
| Random Seed | Fixed seed for reproducibility; leave empty for random. |
Actions
| Control | Description |
|---|
| Generate Relic | Builds the L-system output. |
| Export OBJ / STL / PNG | 3D and raster exports. |
| Save Preset | Stores all parameters to JSON. |
| Zoom Extents / Center | Camera view controls. |
Symmetry group pattern generator - hexagonal, radial, and polygon grids with image-driven tile mapping.
Geometry
| Control | Description |
|---|
| Width / Height (px) | Canvas dimensions. |
| Pattern Type | Selects the tiling pattern:
Asanoha · Six-Point Star · Simple Hex · Flower of Life · Circle Grid · Radial Mandala · Elaborate Polygon NEW
|
| Rings / Slices | Controls for Radial Mandala: number of concentric rings and angular divisions. |
| Grid Scale | Base cell size in pixels. Affects tile density. |
| Rotation (°) | Global pattern rotation. |
| Shape Sides | Polygon vertex count (3–12). Used by all polygon-based patterns; defines the polygon shape for Elaborate Polygon. |
| Shape Pointiness | 0–1 slider. Controls spike depth for Asanoha and Star patterns. |
| Subdivisions | Internal line detail for Asanoha pattern. |
Elaborate Polygon - a new pattern type that places regular N-sided polygons on an orthogonal grid. The number of sides is controlled by the existing Shape Sides slider (3 = triangles, 4 = squares, 5 = pentagons, 6 = hexagons, etc. up to 12).
Image Mapping
A new panel available for all pattern types. Upload a reference image and use its luminance data to drive per-tile transformations. Darker regions produce larger tiles and more rotation; lighter regions produce smaller tiles and less rotation.
| Control | Description |
|---|
| Tile Size by Image | Enable checkbox. When active, each tile's scale is modulated by the average darkness of the reference image at that tile's position. |
| Upload Size/Rotation Image | File upload button. Loads the reference image used for both size and rotation mapping. |
| Min Scale (%) | Slider (5–100%). Sets the minimum tile size. Lightest image regions shrink tiles to this percentage; darkest regions remain at 100%. |
| Tile Rotation by Image | Enable checkbox. When active, each tile is rotated around its center axis proportionally to the image darkness at its position. |
| Max Rotation (°) | Slider (0–360°). Maximum rotation applied at the darkest image regions. Lighter regions get proportionally less rotation. |
Compatibility: Image mapping works with all pattern types - Asanoha, Star, Hex, Flower, Circles, Radial Mandala, and Elaborate Polygon.
For circle-based patterns (Flower of Life, Circle Grid), size mapping affects circle radius; rotation has no visible effect on circles.
For Radial Mandala, image-driven rotation is added on top of the natural radial rotation of each cell.
Style
| Control | Description |
|---|
| Line Color | Stroke color for tile outlines. |
| Line Thickness | Stroke weight. |
| Fill Shapes | Toggle shape filling on/off. |
| Background | Canvas background color. |
Color
| Control | Description |
|---|
| Mode | Solid, Gradient, or Image Mapping (for color fill). |
| Fill Color | Single color used in Solid mode. |
| Gradient Colors / Direction | Gradient endpoints and orientation. |
| Gradient Steps (Posterize) | Stepped bands. 0 = smooth gradient. |
| Upload Image | Image-based color fill (separate from the Image Mapping reference image). |
| Mosaic Mode | Average color per tile for a mosaic effect. |
3D Export
| Control | Description |
|---|
| Cell Depth (Z) | Extrusion thickness for 3D OBJ export. |
| Depth Variance (%) | Randomized depth per tile for organic look. |
Actions
| Control | Description |
|---|
| Export PNG | Raster image export. |
| Export SVG | Vector export for Illustrator / CAD / laser cutting. |
| Export OBJ+MTL | 3D geometry + material export. |
| AI Relic | Stability AI texture generation. |
| Save / Load Preset | JSON preset management. |
Photo mosaic engine. Reconstructs a source image by replacing each pixel region with the best-matching tile from an uploaded image library, based on perceptual color analysis.
Source Image & Output
| Control | Description |
|---|
| Upload Source Image | Loads the target image that will be reconstructed as a mosaic. |
| Width / Height (px) | Final output resolution (64–15,000 px). Auto-populated from source image on load. |
| Units display | Shows number of tile units across and down. Updates in real time from tile size and spacing. |
| Lock Aspect Ratio | When locked, changing one dimension auto-adjusts the other to match the source image ratio. |
| Fit to Source Ratio | Sets dimensions to match source proportions (capped at 4,000 px on longest side). |
Tile Library
| Control | Description |
|---|
| Add Tile Images (Max 20) | Upload up to 20 images as mosaic tiles. Average color computed on upload. |
| Thumbnail gallery | Grid preview of loaded tiles. Click × to remove individual tiles. |
| Tile counter | Displays current / maximum tile count. |
Mosaic Parameters
| Control | Description |
|---|
| Tile Size (px) | Size of each mosaic tile (4–120 px). Smaller = finer detail, more tiles. |
| Layout Mode | Grid — standard row/column alignment. Brick (50% Stagger) — odd rows offset by half a tile width. |
| Color Matching | CIE L*a*b* (perceptual, default) · RGB Euclidean · HSL Weighted (hue-prioritized). |
| Color Blend % | Tints each placed tile toward the source region's color (0–100%). |
| Repetition Avoidance | Radius (0–10) for penalizing repeated tile usage in neighboring cells. |
| Tile Spacing (px) | Gap between tiles (0–10 px). |
| Seed | Fixed seed for reproducible tile selection. |
Actions & Export
| Control | Description |
|---|
| Generate Mosaic | Builds the mosaic at full output resolution. |
| Export PNG | Downloads the mosaic at full output resolution. |
| Export SVG | Vector export with embedded tile images as base64 data URIs. |
| Save / Load Preset | JSON preset management. Tile images are not stored — re-upload after loading. |
Same as PRO with higher tier caps for density and mesh resolution.
Weave Parameters
| Control | Description |
|---|
| Relic Type | Selects the base weave pattern. |
| Density | Grid density (Studio max: 80). |
| Resolution | Mesh resolution (Studio max: 64). |
| Strand Width / Amplitude | Strand visual weight and wave intensity. |
| Cross Section | Rectangle or Circle strand profile. |
Actions & Export
| Control | Description |
|---|
| Generate / Export Tile / Export Relic | Same as PRO. |
Bricks
RF | B · SVG · STUDIO
Same as PRO + SVG vector export.
All Panels
All controls identical to PRO. Studio adds Export SVG for vector output.
Voronoi
RF | V · SVG · STUDIO
Same as PRO + SVG vector export.
All Panels
All controls identical to PRO. Studio adds Export SVG for vector output.
Same as PRO with higher PNG export width cap (16384).
All Panels
All controls identical to PRO. Studio supports higher export resolution.
P6M
RF | P · SVG · Updated
Same as PRO (including Elaborate Polygon + Image Mapping) + SVG vector export.
New Features
Elaborate Polygon pattern type + Image Mapping panel (Tile Size by Image, Tile Rotation by Image) - identical to PRO. See PRO tab for full documentation.
Studio adds Export SVG - vector output suitable for Illustrator, CAD workflows, and laser/plotter fabrication.
Raster
RF | R · NEW · STUDIO
Photo mosaic engine — output resolution up to 15,000 × 15,000 px. See PRO tab for full parameter documentation.
Studio Features
Raster engine with CIE L*a*b* perceptual color matching, Grid + Brick layout modes, color blending, repetition avoidance, and configurable output dimensions up to 15,000 px. Exports PNG and SVG.
Studio: Export Pack
Batch export (STUDIO only)
The Export Pack button appears in the STUDIO sidebar. It runs a batch loop:
randomizes the seed (if present), triggers generate, and clicks export repeatedly.
Use it to quickly produce multiple design variants from one configuration.
Unified Suite Architecture
Technical overview
Each engine runs in an isolated iframe environment. This enables safe execution,
dynamic switching without page reload, independent memory isolation, and unified navigation
across the entire Relics Forge ecosystem.
Version Notes
Current release highlights
- NEW - Raster Engine (R): Photo mosaic generator — reconstructs a source image using up to 20 uploaded tile images with CIE L*a*b* perceptual color matching, brick/grid layouts, and output dimensions up to 15,000 px.
- NEW - Viewport Zoom: 2D engines (Bricks, Voronoi, P6M, Raster) include scroll-wheel zoom-to-cursor, middle-button pan, and a zoom toolbar with Fit reset. Available in PRO and STUDIO.
- NEW - Elaborate Polygon: P6M engine now includes a new pattern type that renders regular N-sided polygons on an orthogonal grid.
- NEW - Image Mapping: All P6M pattern types support tile size and rotation modulation via an uploaded reference image (luminance-based mapping).
- SVG export available in STUDIO for Bricks, Voronoi, and P6M engines.
- Cross Section control added to Textile engine (Rectangle / Circle strand profiles).
- Tier caps: PRO is capped lower; STUDIO supports higher limits for export width, density, and mesh resolution.
- Export Pack (batch) is exclusive to STUDIO and appears in the suite sidebar.
PRO vs STUDIO
Feature comparison
| Feature | PRO | STUDIO |
|---|
| All 6 Parametric Engines (incl. Raster) | 5 engines | ✓ all 6 |
| Viewport Zoom (B / V / P / R) | ✓ | ✓ |
| Elaborate Polygon + Image Mapping | ✓ | ✓ |
| SVG Export (Bricks / Voronoi / P6M / Raster) | - | ✓ |
| Export Pack (batch) | - | ✓ |
| Higher Tier Caps | - | ✓ |
| AI Relic (Stability AI) | ✓ | ✓ |
| Presets (JSON) | ✓ | ✓ |
Support / Troubleshooting
Quick checks
Exports don't download? Ensure your browser allows downloads / popups for this site.
Screen is blank? Press Generate - some engines render on demand.
Preset looks different? Check tier caps - values may be clamped to your tier limits.
AI Relic not working? Confirm your Stability API key is saved and your prompt is not empty.
Image Mapping not visible? The Image Mapping panel appears in the P6M engine controls. Upload a reference image and enable the checkboxes.
Zoom not responding? Scroll-wheel zoom requires the cursor over the viewer area. Middle-button pan uses a middle mouse click. Press Fit to reset if the canvas appears offset.
Raster mosaic looks blurry? The default Fit view scales down large outputs. Use scroll-wheel zoom to inspect at full resolution — what you see zoomed in matches the exported PNG.
