Differences

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

--- visual3d:documentation:pipeline:signal_commands:rename_signals [2024/12/26 19:09] – wikisysop
+++ visual3d:documentation:pipeline:signal_commands:rename_signals [2025/05/09 20:38] (current) – Added headers. More work needed to bring the page up to pipeline command standard. wikisysop
@@ Line 1: / Line 1: @@
 ====== Rename Signals ======
-Rename a signal in the Workspace.
+As the name suggests, the Rename_Signal command allows users to rename signals in the workspace.
 <code>
@@ Line 15: / Line 15: @@
 </code>
-==== Example: Rename a DERIVED signal in all files including CalFiles ====
+===== Examples =====
+==== Example 1: Renaming multiple signals ====
+Multiple signals can be renamed with a single command by concatening "original" and "new" signal names with the + character.
+<code>
+Rename_Signals
+/FILE_NAME=*.c3d
+/SIGNAL_TYPES=TARGET
+/SIGNAL_FOLDER=ORIGINAL
+/SIGNAL_NAMES=lft1+lft2
+/NEW_SIGNAL_NAME=lft1a+lft2a
+! /APPEND_TO_OLD_SIGNAL_NAME=FALSE
+! /INCLUDE_CALFILE=FALSE
+! /CALFILE_ONLY=FALSE
+;
+</code>
+==== Example 2: Rename a DERIVED signal in all files including CalFiles ====
+Signals can be renamed across all files in the workspace by using the * wildcard in the FILE_NAME parameter.
 <code>
@@ Line 29: / Line 50: @@
 </code>
-==== Example: Rename a signal in the GLOBAL workspace ====
+==== Example 3: Rename a signal in the GLOBAL workspace ====
+There are two methods for renaming a signal in the [[visual3d:documentation:definitions:global_workspace|GLOBAL workspace]]. The first is to make the GLOBAL workspace active; the second is to prefix the signal name.
-METHOD1 - Make the Global Workspace Active
+=== METHOD 1 - Make the Global Workspace Active ===
 <code>
@@ Line 45: / Line 68: @@
 </code>
-METHOD2 - Add a prefix to the signal name indicating that it is GLOBAL
+=== METHOD 2 - Add a prefix to the signal name indicating that it is GLOBAL ===
 <code>