Projector+ Projection Viewer Script

PROJECTOR+ PROJECTION VIEWER SCRIPT

Projection Viewer is a general-purpose status and diagnostics display for Projectors and Console Blocks.

It shows where a projection is, how it is transformed, how large it is, and what blocks it contains. can be used for debugging projection alignment, locating projected blocks, and interaction with other Projector+ systems.

• Displays target status -- see whether the selected Projector or Console Block has an active projection.
• Shows transform values -- report projection rotation, offset, and other target information.
• Reports world bounds -- inspect the projection's position and occupied area in the world.
• Lists block information -- view definition counts or individual projected block positions.
• Searches by block name or type -- quickly locate batteries, armor, thrusters, and other matches.
• Includes a rotation test -- nudge the target's Z rotation one step at a time.

REQUIREMENT

Requires Projector+ API 2.0 to be enabled in the world.

The ProjectorPlusApi wrapper is already included in this script.

QUICK SETUP

• Load this script into a Programmable Block on the same construct as the target.
• Set the default target name and output limits in the TUNERS section.
• Compile, then run one of the commands below.
• Combine multiple options with semicolons when needed.

COMMANDS

types
blocks
find=battery
rotate
name=Exact Target Name

IMPORTANT NOTES

• Works with both Projectors and Console Blocks.
• The rotate command applies one Z-axis nudge each time it is run.
• Large projections may need smaller output limits to keep PB reports readable.