Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:pipeline:other_commands:create_text_data [2024/06/17 17:07] – removed sgranger
+++ visual3d:documentation:pipeline:other_commands:create_text_data [2025/08/01 16:34] (current) – wikisysop
@@ Line 1: / Line 1: @@
+====== Create Text Data ======
+===== Overview =====
+The **Create_Text_Data** command is used to generate a text-based signal in Visual3D. Unlike standard numeric signals, this command allows a signal to be created where each frame contains text data instead of numeric values. This can be helpful for labeling data, embedding annotations, or tracking categorical information frame-by-frame in a trial.
+===== Pipeline Command =====
+The command below is as seen in the Visual3D application. The parameters allow for customization of how the text signal is created"
+<code>
+Create_Text_Data
+/SIGNAL_FOLDER=
+/SIGNAL_NAMES=
+! /TEXT_DATA=
+! /TEXT_FILE_NAME=
+! /PROMPT_ON_EMPTY=TRUE
+;
+</code>
+===== Command Parameters =====
+The following table outlines the available parameters and their functions.
+|**Parameter**|**Description**|
+|**/SIGNAL_FOLDER=**|The folder where the new text signal will be saved (e.g. PROCESSED)|
+|**/SIGNAL_NAMES=**|Name(s) of the signal(s) to be created.|
+|**! /TEXT_DATA=**|Inline text data to be inserted directly in the command.|
+|**! /TEXT_FILE_NAME=**| External text file to load the text data from (one entry per line)|
+|**! /PROMPT_ON_EMPTY=**|If TRUE, prompts the user to input data if no text or file is provided.|
+Note: Either /TEXT_DATA or /TEXT_FILE_NAME must be used. If neither is included, the user will be prompted manually during execution.
+===== Dialog =====
+The command can be edited either in the text editor or inj dialog form. To open the dialog, either double-click the command in the pipeline workshop or click 'Edit'.
+Below is the dialog box for the **Create_Text_Data** command:
+{{:visual3d:documentation:pipeline:other_commands:create_text_dlg.png?600|}}
+This dialog provides three different methods to supply text to the signal.
+  * Box 1: Displays and accepts input in RTF (Rich Text Format)
+  * Box 2: Displays and accepts input as plain formatted text.
+  * Box 3: Allows the user to browse and select an external text or RTF file to load.
+Additional Options
+  * Return with RTF Formatting: If selected, the contents of Box 1 will be used. This is useful if you are working with styled text.
+  * Return Text: Uses Box 2 (Plain Text) as the input source
+  * Return Filename: Uses the selected file path from Box 3 to load the contents of an external file.\
+If no text or file is provided, and the /PROMPT_ON_EMPTY=TRUE parameter is enabled, this dialog will appear during execution prompting the user to manually enter the text data.
+===== Examples =====