Tag To

This function block lets you publish a value under a short text tag so other blocks in the same scene can retrieve it. Use it together with the Tag From block to pass data around without direct connections.

πŸ“₯ Inputs

This function block has no input sockets.

πŸ“€ Outputs

Generic Provides the value published by the matching Tag From block.

πŸ•ΉοΈ Controls

Tag Enter a short text label used to identify the value you want to publish. The same text must be used on the matching Tag From block to receive this value.

(hint: keep the tag concise and avoid leading/trailing spaces)

🎨 Features

  • Lightweight in-scene referencing for sharing data between distant parts of a design.

  • Works without drawing a cable: matching is done based on the Tag text.

  • Ideal for passing configuration values, flags, or intermediate results when a direct connection is inconvenient.

βš™οΈ Running mechanism

When the scenario runs, this block looks for a Tag From block in the same scene whose Tag text exactly matches the one entered here. If a match is found, the published value from that block is returned on the Generic output. If no match is found the block reports an error and is marked invalid.

πŸ“ Usage instructions

  1. Place a Tag From block somewhere in your scene and set its Tag to a chosen label.

  2. In this block set the same Tag label.

  3. Connect the output of this block to any consumer that accepts generic data, or use it to bridge distant parts of the flow.

πŸ’‘ Tips and Tricks

  • Always pair this block with the Tag From block β€” they form a simple publish/subscribe pair.

  • Use short unique tags to avoid accidental collisions. Tags are matched exactly, so watch for extra spaces.

  • Combine with Show Image or Image Logger when you need to forward an image preview or save images originating from a different part of the flow.

  • For data that must be shared across scenes or stored for later, consider combining with Data Write Global and Data Read Global as an alternative approach.

  • Use alongside CSV Export to send logged values to a file; the Generic output can carry structured data prepared elsewhere.

πŸ› οΈ Troubleshooting

  • If you see an error about a missing match: check that a Tag From block exists in the same scene and that its Tag text matches exactly (no extra spaces).

  • If the output is empty or unexpected: verify that the publishing Tag From block is active and producing a value before this block runs.

  • To prevent confusion, keep a short naming convention for tags (for example, use lowercase with underscores).

Last updated