星外科技用户8109
Runtime Decal Text Document
输入“/”快速插入内容
Runtime Decal Text Document
Runtime Decal Text Document
用户8109用户8109
用户1683用户16833月14日修改
Functional Description
Runtime Decal Text is a lightweight Unreal Engine plugin that enables the dynamic generation and projection of text decals at runtime. It allows you to create multi-line text decals at runtime with full typographic control, including auto-scaling, outlines, shadows, and advanced layout options.
Core Features
•
Component-Based Projection: Features the TextDecalComponent. Simply drag it into a level or attach it to an Actor via C++/Blueprint to start projecting, just like a standard DecalComponent.
•
Dynamic Text & Custom Layout: Supports multi-line display with advanced typography controls including horizontal/vertical alignment, character spacing, and margins.
•
Auto-Scaling: Automatically calculates the optimal font scale based on the input string length and the defined canvas resolution. Manual scaling (Scale vector) is also supported.
•
Advanced Rendering Effects: Built-in support for text Outlines, Shadows, and thickness adjustment.
•
Full Blueprint API & Helper Library: Every parameter is exposed to Blueprints for real-time updates. Includes the UTextDecalHelper library for low-level Canvas-based rendering, supporting various blend modes (Opaque, Translucent, Multiplicative, Distance Field, etc.) via DrawText and DrawMaterial functions.
•
Render Target-Based Real-time Updates: Utilizes Render Targets for text generation. Developers can tune the RenderTargetSize to find the perfect balance between visual fidelity and performance (VRAM/Draw call overhead).
Parameters & Usage
Text/Layout
•
Text (FText): The specific text content to be displayed. Supports multi-line text input (Shift+Enter for line breaks). You can call SetText in Blueprints to modify the content in real-time.
•
Font (UFont): The immutable font asset used for rendering text. Assign a font asset from your project (.ttf/.otf); it is recommended to use a font that supports the selected language (e.g., containing Chinese characters).
•
HorizontalAlignment (Enum): The horizontal alignment style of the text. Options: LeftAlign, CenterAlign, RightAlign, Justify.
•
VerticalAlignment (Enum): The vertical alignment style of the text. Options: TopAlign, MiddleAlign, BottomAlign, etc.
•
Margin (FMargin): The outer margin of the text canvas. Controls the distance from the text to the RenderTarget edges; used to prevent text at the decal edges from being accidentally clipped.
•
HorizSpacingAdjust (float): Fine-tuning for horizontal character spacing. Positive values increase character spacing; negative values decrease it.