# Text Texture Generator – Blender Add-on

A reliable text-to-texture workflow that lives entirely inside Blender 4.0+.

## Why Artists Keep It Installed

- Generate clean text textures without leaving Blender or juggling external editors.
- Shape typography fast: multi-line copy, prepend/append text blocks, horizontal or vertical layouts, and margin controls.
- Place designs precisely using a 9-point anchor grid, manual percentage/pixel coordinates, offsets, and optional canvas constraints.
- Work with any font in your library: automatic system font discovery plus drag-in custom `.ttf/.otf` support.
- Pick transparent or solid backgrounds with full RGBA control and iterate using the built-in preview window.
- One click to create the final image – every texture is packed into the `.blend` file and ready for node setups.

## Core Workflow

1. Enter your copy and choose fonts.
2. Dial in placement, dimensions, and colors.
3. Hit `Preview` to check the result, then `Generate` to store the texture in `bpy.data.images`.

## Editions

### Free Edition (included)

- Full text-to-texture pipeline at any resolution your hardware can handle.
- Prepend/append text blocks with horizontal or vertical layout modes.
- Anchor presets, manual coordinates (percent or pixels), offsets, and canvas constraints.
- RGBA text color, transparent or solid backgrounds, plus configurable preview backgrounds.
- System font browser and custom font loading.
- Preview generator that opens a Blender Image Editor window for instant feedback.

### Pro Edition (BlenderMarket, Superhive & Gumroad)

Everything in the Free Edition, plus:

- **Composition components.** Stack any number of text or image overlays, sequence them before/after the main copy, or position them absolutely with independent scale, rotation, spacing, and Z-order. SVG overlays rasterize automatically (via CairoSVG) so they stay pin-sharp.
- **Automatic normal maps.** Turn the alpha channel into a normal map with adjustable strength, blur radius, and inversion for emboss/deboss looks.
- **Shader builder.** Create Principled BSDF, Emission, or Transparent materials complete with normal-map hookups, light-path controls (disable shadows, reflections, or backfaces), and optional auto-assignment to the active object.
- **Plane instancing.** Drop a plane that matches your texture’s aspect ratio with the generated material applied and a Simple subdivision modifier ready for displacement workflows.
- **Preset ecosystem.** Save styles either with the current `.blend` or in Blender’s config folder, refresh them in one click, and import/export JSON bundles for backups or team sharing.
- **Adaptive text fitting.** Let the addon resize fonts within a range to keep layouts within your chosen canvas margins.

## Built For These Pipelines

- Product visualization that needs labels, packaging copy, or compliance text.
- Motion design titles and lower-thirds created straight inside 3D scenes.
- Game-ready signage, decals, and UI panels that need crisp alpha textures.
