---
generated_by: gdlink-build
generated_at: 2026-06-23T12:34:28Z
do_not_edit: true
title: XR Passthrough
brick_type: executor
tier: Pro
generated: true
---

# XR Passthrough

**Category:** Executor
**Tier:** Pro

## Purpose

Controls Mixed Reality (MR) passthrough features — camera feed overlay, alpha blending, and edge enhancement.

## Visual Reference

```{raw} html
<div class="illustration-container"><div class="illustration-box"><div class="box-header">As added to your scene</div><img src="https://gdlink.solventech.ca/guide/assets/images/bricks/xr_passthrough_executor.png" alt="XR Passthrough brick as it appears in the GDLink editor" loading="lazy" style="max-width:100%;height:auto;display:block;margin:0 auto;border-radius:8px;" /></div></div>
```

## Runtime Behavior

**Inputs**
- **Activate** (Boolean): Toggles passthrough on/off.

**Properties**

**Core (always visible)**
- **passthrough_mode** (Enum, default `"Overlay"`): `Overlay`, `Alpha`, `Composition Layer` (future)

**Overlay Mode**
- **opacity** (Float, default `1.0`): Passthrough feed opacity (0.0-1.0).
- **edge_enhancement** (Bool, default `false`): Apply edge detection filter to camera feed.

**Alpha Mode**
- **opacity** (Float, default `0.5`): Blend factor between virtual scene and camera feed.

**Composition Layer Mode (future, `visible_if: {passthrough_mode: "Composition Layer"}`)**
- **layer_type** (Enum): `Quad`, `Cylinder`, `Equirect`
- **viewport_path** (NodePath): SubViewport to render on the composition layer.
- **sort_order** (Int, default `0`): Layer rendering priority.

---

```{raw} html
<div class="illustration-container">
        <div class="illustration-box">
            <div class="box-header">Generated UI Mockup — showing expanded properties</div>
            <div class="real-node brick-executor">
                <div class="real-header">
                    <div class="real-title"><span class="brick-icon-fallback"></span> <span>XR Passthrough</span></div>
                    <div class="real-controls"><div class="real-checkbox"></div><div class="real-btn">-</div><div class="real-btn">x</div></div>
                </div>
                <div class="real-inner-panel"><div class="real-row name-row" style="position:relative;"><span class="real-label">Name:</span><div class="real-input" style="color:#666; font-style:italic;">Label this brick...</div><div class="real-port" style="left:-15px;"></div></div><div class="real-row"><span class="real-label">Mode:</span><div class="real-input-dropdown">Overlay</div></div><div class="real-row"><span class="real-label">Opacity:</span><div class="real-inline-input" style="border-bottom: 1px solid #2f333b;"><span>1.0</span></div><div class="real-val-btn" style="margin-left:4px;">v</div></div><div class="real-inline-row" style="margin-top:4px;"><div class="real-inline-btn" style="background:#2f343d;">Edge Enhance</div></div></div>
            </div>
        </div>
    </div>
```

## Properties

| Property | Type | Default | Notes |
|---|---|---|---|
| Mode | option | Overlay | Passthrough blend mode |
| Opacity | float | 1.0 | Passthrough feed opacity |
| Edge Enhance | bool | False | Apply edge detection filter to camera feed |