Projector - Revision history

Michiyo at 07:28, 1 September 2026

2026-09-01T07:28:26Z

← Older revision		Revision as of 07:28, 1 September 2026
Line 92:		Line 92:
	</syntaxhighlight>		</syntaxhighlight>

	Right-clicking the visible projected screen opens the normal OpenComputers screen interface. The interface accepts mouse and keyboard input. An OpenComputers [[~~Keyboard~~\|keyboard]] placed next to the projector can also be used for normal in-world screen input.		Right-clicking the visible projected screen opens the normal OpenComputers screen interface. The interface accepts mouse and keyboard input. An OpenComputers [[Block/keyboard\|keyboard]] placed next to the projector can also be used for normal in-world screen input.

	The screen's text buffer is saved with the projector, and the emulated screen component is restored when the projector's chunk is loaded.		The screen's text buffer is saved with the projector, and the emulated screen component is restored when the projector's chunk is loaded.

Michiyo at 07:27, 1 September 2026

2026-09-01T07:27:43Z

← Older revision		Revision as of 07:27, 1 September 2026
Line 3:		Line 3:
	[[File:projector.png\|Projector]]		[[File:projector.png\|Projector]]

	The projector is a long-range, flat display controlled by a ~~[[Computer\|~~computer]]. It can either render a 320x200 pixel framebuffer directly, or emulate a normal OpenComputers <code>screen</code> component with a 160x50 character display.		The projector is a long-range, flat display controlled by a computer. It can either render a 320x200 pixel framebuffer directly, or emulate a normal OpenComputers <code>screen</code> component with a 160x50 character display.

	The projected image is not a physical block and does not need a wall or other screen block behind it. The projector raycasts in its facing direction and places the display on the first collidable block it reaches, up to 12.5 blocks away. If no block is hit, it uses the maximum distance. The projection is scaled with distance, so a nearby surface produces a smaller image. A tiny offset from the target surface prevents z-fighting.		The projected image is not a physical block and does not need a wall or other screen block behind it. The projector raycasts in its facing direction and places the display on the first collidable block it reaches, up to 12.5 blocks away. If no block is hit, it uses the maximum distance. The projection is scaled with distance, so a nearby surface produces a smaller image. A tiny offset from the target surface prevents z-fighting.

Michiyo: /* Placement and modes */

2026-09-01T07:26:26Z

Placement and modes

← Older revision		Revision as of 07:26, 1 September 2026
Line 9:		Line 9:
	== Placement and modes ==		== Placement and modes ==

	The projector faces away from the player when placed. Its [[Item/~~wrench~~\|scrench]] has a special function: right-clicking the projector toggles between pixel mode and screen mode instead of rotating the block. The selected mode is saved with the projector.		The projector faces away from the player when placed. Its [[Item/scrench\|scrench]] has a special function: right-clicking the projector toggles between pixel mode and screen mode instead of rotating the block. The selected mode is saved with the projector.

	Only the component for the active mode is visible on the OpenComputers network:		Only the component for the active mode is visible on the OpenComputers network:

Michiyo: Created page with "= Projector = Projector The projector is a long-range, flat display controlled by a computer. It can either render a 320x200 pixel framebuffer directly, or emulate a normal OpenComputers `screen` component with a 160x50 character display. The projected image is not a physical block and does not need a wall or other screen block behind it. The projector raycasts in its facing direction and places the display on the first c..."

2026-09-01T07:23:41Z

Created page with "= Projector = Projector The projector is a long-range, flat display controlled by a computer. It can either render a 320x200 pixel framebuffer directly, or emulate a normal OpenComputers <code>screen</code> component with a 160x50 character display. The projected image is not a physical block and does not need a wall or other screen block behind it. The projector raycasts in its facing direction and places the display on the first c..."

New page

= Projector =

[[File:projector.png|Projector]]

The projector is a long-range, flat display controlled by a [[Computer|computer]]. It can either render a 320x200 pixel framebuffer directly, or emulate a normal OpenComputers <code>screen</code> component with a 160x50 character display.

The projected image is not a physical block and does not need a wall or other screen block behind it. The projector raycasts in its facing direction and places the display on the first collidable block it reaches, up to 12.5 blocks away. If no block is hit, it uses the maximum distance. The projection is scaled with distance, so a nearby surface produces a smaller image. A tiny offset from the target surface prevents z-fighting.

== Placement and modes ==

The projector faces away from the player when placed. Its [[Item/wrench|scrench]] has a special function: right-clicking the projector toggles between pixel mode and screen mode instead of rotating the block. The selected mode is saved with the projector.

Only the component for the active mode is visible on the OpenComputers network:

* Pixel mode exposes a <code>projector</code> component and hides the <code>screen</code> component.
* Screen mode exposes a native <code>screen</code> component and hides the <code>projector</code> component.

The two component addresses are separate. Use <code>component.list("projector")</code> or <code>component.list("screen")</code> after changing modes; do not expect the projector's address to be the screen's address.

== Pixel mode ==

Pixel mode provides a 320x200 RGBA framebuffer. Coordinates are one-based, with <code>(1, 1)</code> at the upper-left corner. Colors may be supplied as <code>0xRRGGBB</code> for an opaque color or <code>0xAARRGGBB</code> for an explicit alpha value. Color <code>0</code> is transparent black.

The projector component provides these callbacks:

{| class="wikitable"
! Callback
! Description
|-
| <code>getResolution()</code>
| Returns <code>320, 200</code>.
|-
| <code>isProjecting()</code>
| Returns whether the projector is on and powered.
|-
| <code>turnOn()</code> / <code>turnOff()</code>
| Enable or disable projection.
|-
| <code>get(x, y)</code>
| Returns the RGB color at a pixel.
|-
| <code>set(x, y, color)</code>
| Sets one pixel.
|-
| <code>fill(x, y, width, height, color)</code>
| Fills a rectangle.
|-
| <code>clear()</code>
| Clears the framebuffer to transparent black.
|-
| <code>setRaw(data)</code>
| Sets row-major RGBA bytes. There are four bytes per pixel; incomplete data clears the remaining pixels.
|}

Pixel mode consumes energy while the projector is on. Large updates are sent to clients as compressed framebuffer updates, so a saved framebuffer can be restored when its chunk is loaded.

Example:

<syntaxhighlight lang="lua">
local component = require("component")
local projector = component.proxy(component.list("projector")())

projector.clear()
projector.fill(1, 1, 320, 200, 0xFF101820)
projector.fill(20, 20, 280, 160, 0xFF204060)
projector.set(25, 25, 0xFFFFCC00)
</syntaxhighlight>

== Screen mode ==

Screen mode emulates a native OpenComputers T3 screen:

* Resolution: 160x50 characters
* Maximum color depth: 8-bit
* Standard <code>screen</code> and <code>gpu</code> APIs
* Normal screen text, color, palette, mouse, and keyboard behavior

Use a graphics card to draw to the projected screen just as with any other OpenComputers screen. If it is the only screen available, the GPU may already be bound to it; binding explicitly makes a program unambiguous.

<syntaxhighlight lang="lua">
local component = require("component")
local gpu = component.gpu
local screenAddress = component.list("screen")()

gpu.bind(screenAddress)
gpu.setResolution(160, 50)
gpu.setDepth(8)
gpu.setBackground(0x102030)
gpu.setForeground(0xFFFFFF)
gpu.fill(1, 1, 160, 50, " ")
gpu.set(2, 2, "Hello from the projector")
</syntaxhighlight>

Right-clicking the visible projected screen opens the normal OpenComputers screen interface. The interface accepts mouse and keyboard input. An OpenComputers [[Keyboard|keyboard]] placed next to the projector can also be used for normal in-world screen input.

The screen's text buffer is saved with the projector, and the emulated screen component is restored when the projector's chunk is loaded.

== Power and troubleshooting ==

The projector must be connected to a powered OpenComputers network. In pixel mode, check for the <code>projector</code> component. In screen mode, check for the <code>screen</code> component instead. The inactive mode is intentionally absent from component listings.

If a program cached a component address before switching modes, enumerate the active component again. Component addresses can also change when a component is recreated, so programs should prefer component type/name discovery over hard-coding an address.