This commit is contained in:
2025-10-13 17:37:32 +02:00
parent 09f33e461d
commit 22b3f74de2
15 changed files with 155 additions and 352 deletions

View File

@@ -1,211 +1,45 @@
# Text Texture Generator - Professional Text-to-Texture Converter for Blender
# Text Texture Generator Blender Add-on
**Advanced procedural text rendering with high-fidelity material integration for professional 3D workflows**
A reliable text-to-texture workflow that lives entirely inside Blender 4.0+.
## Technical Overview
## Why Artists Keep It Installed
The Text Texture Generator is an advanced Blender addon that transforms text input into high-quality, production-ready image textures with comprehensive customization capabilities. Built for professional 3D artists and studios, this tool eliminates the need for external graphics software by providing sophisticated text rendering directly within Blender's material workflow.
- 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.
The addon utilizes advanced text processing algorithms to convert large text blocks into crisp, scalable textures with professional typography control. Every generated texture integrates seamlessly with Blender's material system, automatically creating optimized node setups that maintain full editability and non-destructive workflows.
## Core Workflow
Designed for technical users who demand precision and control, the addon features a sophisticated 9-point anchor positioning system, advanced effect processing (including stroke, shadow, glow, and normal map generation), and intelligent preset management for consistent results across projects. The high-resolution output capability—limited only by your hardware—ensures compatibility with professional rendering requirements and close-up detail work.
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`.
Cross-platform compatibility across Windows, macOS, and Linux environments, combined with Blender 4.0+ optimization, makes this tool suitable for diverse studio pipelines and collaborative workflows where consistency and reliability are paramount.
## Editions
## Core Features
### Free Edition (included)
### Advanced Text Processing
- 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.
- **Extended Character Support**: Process lengthy copy with full Unicode compatibility
- **Professional Typography Control**: Precise font selection, sizing, and character spacing
- **Dynamic Text Scaling**: Resolution-independent text rendering with crisp edge quality
### Pro Edition (BlenderMarket, Superhive & Gumroad)
### Precision Positioning System
Everything in the Free Edition, plus:
- **9-Point Anchor System**: Top-left, top-center, top-right, middle-left, center, middle-right, bottom-left, bottom-center, bottom-right positioning
- **Pixel-Perfect Alignment**: Sub-pixel positioning accuracy for precise text placement
- **Relative and Absolute Positioning**: Flexible positioning modes for different use cases
- **Real-time Preview**: Live positioning updates with immediate visual feedback
- **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.
- **Preset ecosystem.** Save styles either with the current `.blend` or in Blenders 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.
### Professional Effects Suite
## Built For These Pipelines
- **Advanced Stroke Control**: Variable width, color, and opacity with anti-aliasing
- **Multi-layer Shadow System**: Drop shadows, inner shadows, and complex shadow effects
- **Procedural Glow Effects**: Customizable glow radius, intensity, and color blending
- **Normal Map Generation**: Automatic height-to-normal conversion for surface detail
- **Effect Layering**: Combinable effects with individual control and blending modes
### High-Resolution Output
- **Scalable Resolution**: Flexible output sizing with no artificial caps
- **Format Optimization**: PNG, JPEG, and OpenEXR support with compression options
- **Memory Management**: Efficient processing for large textures without system overload
- **Batch Processing**: Multiple texture generation with consistent settings
### Version Strategy
#### **🆓 Free Version - Full Core Experience**
- **Complete Text Rendering Pipeline**: Professional typography with unrestricted texture dimensions
- **Essential Positioning System**: 9-point anchor positioning with pixel-perfect alignment
- **Seamless Blender Integration**: Automatic material node creation and assignment
- **Professional Font Support**: System font detection and custom font file compatibility
- **Full Color Control**: Complete RGBA customization with transparency support
- **No Time Limits**: Use forever - perfect for testing and smaller projects
#### **⭐ Full Version - Unleash Professional Power**
- **Ultra-High Resolution**: Generate stunning textures at any resolution your project demands
- **Advanced 3D Effects**: Automatic normal map generation with customizable depth and blur
- **Complete Preset Ecosystem**: Simplified two-tier preset management with import/export for team workflows
- **Professional Batch Processing**: Advanced utility operations and workflow automation tools
- **Extended Material Pipeline**: Advanced styling options and specialized production tools
- **Future-Proof Investment**: All upcoming premium features included with purchase
**Why This Approach Works**: The free version gives you complete access to core functionality - try it risk-free to see if it fits your workflow, then upgrade when you need professional features for bigger projects.
### Smart Preset Management
- **Simplified Two-Tier System**: Streamlined Persistent (default) and Blend File storage with unified UI
- **Intuitive Storage Selection**: Simple "Save with .blend file" checkbox controls destination
- **Clear Visual Indicators**: 🏠 (persistent) and 📄 (blend file) icons for instant recognition
- **Priority System**: Blend file presets automatically override persistent ones with same name
- **User-Defined Presets**: Save and organize custom configurations with improved interface
- **Project-Specific Presets**: Maintain consistent styling across project assets
- **Preset Import/Export**: Share configurations between team members
- **Auto-Migration**: Seamlessly migrates old three-tier presets to new streamlined system
### Material Integration
- **Automatic Node Creation**: Seamless integration with Blender's shader editor
- **Non-Destructive Workflow**: Maintains editability after material application
- **Multi-Channel Output**: Simultaneous generation of diffuse, normal, and effect maps
- **Material Library Compatibility**: Works with existing material libraries and asset management
## Technical Specifications
- **Blender Compatibility**: Blender 4.0+ (optimized for latest versions)
- **Architecture**: Cross-platform Python implementation
- **Memory Requirements**: Minimum 4GB RAM (8GB recommended for 4K textures)
- **Storage**: 50MB installation footprint, variable cache depending on usage
- **Processing**: Multi-threaded rendering for performance optimization
- **Color Space**: sRGB and Linear workflow support with automatic color management
- **File Formats**: PNG, JPEG, OpenEXR output with configurable compression
- **Unicode Support**: Full international character set compatibility
- **API Integration**: Scriptable interface for automation and pipeline integration
## Workflow Integration
### Studio Pipeline Compatibility
The Text Texture Generator integrates seamlessly into professional 3D production pipelines through its non-destructive approach and standard file format outputs. Generated textures maintain full compatibility with industry-standard rendering engines including Cycles, EEVEE, and external renderers through standard texture mapping workflows.
### Asset Management Integration
The addon's preset system aligns with professional asset management workflows, enabling consistent branding and styling across large projects. Presets can be version-controlled and shared across team members, ensuring visual consistency in collaborative environments.
### Automation and Scripting
Advanced users can leverage the addon's scriptable interface for batch processing and automated texture generation. This capability is particularly valuable for localization workflows, dynamic content generation, and large-scale asset production where manual intervention would be inefficient.
### Quality Assurance Workflows
The real-time preview system and high-resolution output capabilities support rigorous quality assurance processes, allowing teams to verify text legibility and visual impact before final rendering. The non-destructive workflow ensures that changes can be made efficiently throughout the production cycle.
## Use Cases
### Architectural Visualization
- **Signage and Wayfinding**: Generate realistic building signage with proper perspective and lighting integration
- **Environmental Graphics**: Create branded environmental elements with consistent typography
- **Technical Drawings**: Add annotations and labels directly within 3D scenes
### Product Visualization
- **Packaging Design**: Apply product labels and packaging text with accurate material properties
- **Brand Integration**: Implement corporate typography and messaging across 3D marketing materials
- **User Interface Elements**: Create realistic UI text for product demonstrations
### Game Development
- **Environmental Storytelling**: Generate in-world text elements with appropriate aging and wear
- **UI Texture Creation**: Develop game interface elements with consistent styling
- **Localization Assets**: Efficiently create text variants for multiple languages
### Motion Graphics and VFX
- **Title Sequences**: Generate high-quality text elements for 3D title animation
- **Environmental Integration**: Seamlessly blend text elements into live-action footage
- **Technical Visualization**: Create explanatory text and labels for technical demonstrations
### Educational and Technical Content
- **Scientific Visualization**: Add precise labels and annotations to technical models
- **Training Materials**: Develop educational content with clear, readable text elements
- **Documentation Assets**: Generate visual documentation with integrated text components
## System Requirements
### Minimum Requirements
- **Operating System**: Windows 10 (64-bit), macOS 10.15+, or Linux (Ubuntu 18.04+ equivalent)
- **Blender Version**: Blender 4.0.0 or newer
- **Processor**: Intel Core i5 / AMD Ryzen 5 or equivalent
- **Memory**: 4GB RAM
- **Storage**: 100MB available disk space
- **Graphics**: OpenGL 3.3 compatible graphics card
### Recommended Configuration
- **Operating System**: Windows 11, macOS 12+, or recent Linux distribution
- **Blender Version**: Latest stable Blender release
- **Processor**: Intel Core i7 / AMD Ryzen 7 or better
- **Memory**: 8GB RAM or more
- **Storage**: 500MB available disk space (for cache and presets)
- **Graphics**: Dedicated graphics card with 2GB+ VRAM
### Professional Workstation Specifications
- **Processor**: Multi-core CPU for optimal batch processing performance
- **Memory**: 16GB+ RAM for large texture generation and complex scenes
- **Storage**: SSD storage recommended for improved cache performance
- **Display**: High-resolution monitor for accurate text preview and detail work
## Installation & Setup
### Standard Installation
1. Download the addon ZIP file from BlenderMarket
2. Launch Blender 4.0+ and navigate to Edit > Preferences > Add-ons
3. Click "Install" and select the downloaded ZIP file
4. Enable the "Text Texture Generator" addon in the add-ons list
5. The addon panel will appear in the 3D Viewport's N-panel under the "Text Texture" tab
### Professional Setup Recommendations
- **Preset Organization**: Create a dedicated preset library structure for team consistency
- **Path Configuration**: Configure output paths to align with project asset organization
- **Performance Optimization**: Adjust cache settings based on available system resources
- **Backup Configuration**: Include addon presets in project backup and version control workflows
### Team Deployment
For studio environments, the addon supports centralized installation and preset distribution. Configuration files can be shared across workstations to ensure consistent setup and reduce onboarding time for team members.
## Support & Updates
### Technical Support
Professional technical support is available through BlenderMarket's messaging system. Common technical issues and workflow questions are addressed through comprehensive documentation and video tutorials included with the addon.
### Update Policy
Regular updates ensure compatibility with new Blender releases and introduce performance improvements based on user feedback. Updates are delivered through BlenderMarket's automatic update system, with detailed changelog documentation for each release.
### Community Resources
Access to a growing community of professional users sharing techniques, presets, and workflow optimizations. Community-contributed presets and examples demonstrate advanced applications and creative possibilities.
### Long-term Maintenance
Ongoing development ensures compatibility with evolving Blender architecture and industry workflow requirements. Feature requests from professional users directly influence development priorities and enhancement roadmaps.
- 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.