Automate Dynamic Text Replacements in Your Laser Projects
Variable Text enables automatic text substitution in your LightBurn projects. By using specially formatted expressions, you can dynamically replace text with alternate data when sending, previewing, or exporting your projects. This functionality is ideal for automating repetitive tasks like adding dates, serial numbers, or CSV data to your designs.
What Can Variable Text Replace?
- Date or Time Stamps: Automatically include current date and time.
- CSV File Entries: Import and use data rows from a CSV file.
- Serial Numbers: Seamlessly generate sequential numbering.
- Cut Settings: Add predefined cutting instructions to your design.
For details on formatting expressions, see Variable Text Formatting.
Selecting a Variable Text Mode
To set up Variable Text:
- Create Text: Use the Create Text tool to insert the desired formatted expression.
- Choose Text Mode: Select the appropriate mode from the dropdown menu in the Text Options Toolbar:
- Date/Time: Insert dynamic timestamps.
- Merge/CSV: Use entries from a CSV file.
- Serial Number: Generate sequential numbering.
- Cut Settings: Apply specific cutting data.
If you select Merge/CSV or Serial Number, additional controls will be available in the Variable Text Window.
Accessing the Variable Text Window
By default, the Variable Text Window is not enabled. To activate it:
- Navigate to Window → Variable Text.
- The window will appear docked behind the Cuts/Layers Window on the upper right of your workspace. Click the Variable Text tab to bring it forward.
Tip: The LightBurn interface is highly customizable. For more information, refer to Customizing the LightBurn Window.
Variable Text Window Features
The Variable Text Window provides powerful tools for managing dynamic text:
- Current: Displays the serial number or CSV row being used for substitution.
- Start & End: Define the sequence range for serial numbers or CSV rows.
- Advance By: Set how many entries to skip each time the sequence updates.
- Auto-Advance: Enable automatic updates of the Current value during project output.
- Test: Preview the output of your formatted expressions.
- Bake: Convert Variable Text expressions to static text, freezing the current values.
- Browse/Clear: Load or unload CSV files.
Offsets in Variable Text
Offsets allow incremental variations within Text Objects.
- Example: A Text Object with an Offset of 2 and a Current value of 1000 will output "1002."
- Batch Processing: Combine Offsets with the Advance By value to increment groups of designs, such as name tags or serial numbers.
Automatic Offsets
LightBurn tools like Grid Array, Circular Array, and Copy Along Path can automatically apply Offset values for seamless duplication with incrementing data.
Shape Properties for Variable Text
The Shape Properties Window offers additional controls to refine your Variable Text:
- Max Width: Limits the maximum width of Text Objects after substitution.
- Squeeze: Adjust text horizontally while maintaining height (or scale proportionally when disabled).
- Ignore Empty Vars: Removes newlines before empty Variable Text fields.
Conclusion
Variable Text in LightBurn enhances efficiency by automating text replacements in your laser engraving projects. Whether you’re adding serial numbers, timestamps, or CSV data, these tools simplify complex workflows and save time. Explore these features to streamline your projects today!