Files
Text-Texture-Generator-for-…/USER_GUIDE.md
2025-10-13 19:08:28 +02:00

2.9 KiB
Raw Blame History

Text Texture Generator Quick User Guide

This guide keeps things short so you can start creating textures right away.


What It Does

  • Adds a Text Texture panel to Blender (3D Viewport, Shader Editor, Properties).
  • Lets you type text, pick fonts, set colors, and position everything directly in Blender.
  • Generates image textures (and optional normal maps) that are packed into your .blend file.

Requirements

  • Blender 4.0 or newer (Windows, macOS, Linux).
  • Pillow and CairoSVG install automatically with the addon (SVG overlays work out of the box).

Installation

  1. Open Blender → Edit > Preferences > Add-ons.
  2. Click Install..., choose the downloaded .zip (or extracted folder with __init__.py).
  3. Enable Text Texture Generator in the add-on list.
  4. Save preferences if you want it active next time.

First Run Checklist

  1. Select an object with a material (or create a new one).
  2. Open the Text Texture panel (press N in the 3D Viewport or Shader Editor and look for the tab).
  3. Type your text in the Main Text field.
  4. Choose a font: use the system list or toggle Use Custom Font and browse to a .ttf/.otf.
  5. Set the texture size (Width & Height) and background (transparent or solid color).
  6. Click Preview Texture to see a quick render.
  7. Click Generate Texture when youre happy. The image is created, packed, and ready in the Image Editor.

Common Options (Plain English)

  • Prepend / Append Text: Add lines before or after your main message (good for labels or subtitles).
  • Layout: Horizontal keeps everything in one line; Vertical stacks each section.
  • Anchor Grid: Choose where the text starts (center, top left, etc.). Offset sliders fine-tune the position.
  • Manual Position Mode: Switch to percentage or pixel input if you need exact placement.
  • Preview Background: Checker, solid color, or gradient so you can see how the text will look.
  • Save Presets: Store your favorite settings either with the .blend file or in Blenders config folder so you can reuse them later.
  • Normal Map (Pro): Flip on Generate Normal Map to add depth—strength, blur, and invert control the look.

Typical Workflow

  1. Enter and style your text.
  2. Use the preview to check spacing and colors.
  3. Generate the final texture.
  4. In the Shader Editor, click Create Shader to build a material with the new texture (and normal map if enabled).
  5. Apply the material to your object. Done.

Tips

  • Need multiple styles fast? Duplicate the blend file or save presets before you start experimenting.
  • Keep the preview size smaller while fine-tuning; switch to full resolution for final renders.
  • SVG logos? Add them as overlay components—the addon bundles CairoSVG and rasterizes them automatically.
  • For team projects, export presets (Add-on Panel > Presets > Export) so everyone can share the same look.