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

# Window

**Category:** Executor
**Tier:** Basic

## Purpose

Controls the application window state, including fullscreen mode, resolution, and border visibility.

## 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/window_executor.png" alt="Window 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** (Pulse): Applies the window settings.

**Outputs**
None.

**Properties**
- **Mode** (String, "Windowed"): "Windowed", "Fullscreen", "Exclusive Fullscreen", "Maximized", "Minimized".
- **Resolution** (Vector2, (1920, 1080)): Target resolution (pixels). Valid only in Windowed/Fullscreen modes (depending on OS).
- **Borderless** (Bool, false): Remove window borders (for "Borderless Windowed" feel).
- **V-Sync** (Bool, true): Enable Vertical Sync (Maps to `DisplayServer.VSYNC_ENABLED`/`DISABLED`).

**Execution Behavior**

**Connect Logic**
- None.

**Tick Behavior**
- When activated:
    - **Mode**: Maps string to `DisplayServer.WINDOW_MODE_*`.
        - "Windowed" -> `WINDOW_MODE_WINDOWED`
        - "Fullscreen" -> `WINDOW_MODE_FULLSCREEN` (Note: Godot 4 treats this as "Borderless Fullscreen" usually, "Exclusive" is separate).
        - "Exclusive Fullscreen" -> `WINDOW_MODE_EXCLUSIVE_FULLSCREEN`
    - **Resolution**: Calls `DisplayServer.window_set_size(size)`.
        - *Centering Logic*: When switching to "Windowed", calculate center: `screen_pos + (screen_size / 2) - (window_size / 2)`. Use `DisplayServer.screen_get_position()` and `screen_get_size()`. Essential to prevent top-left jumping.
    - **Borderless**: Calls `DisplayServer.window_set_flag(DisplayServer.WINDOW_FLAG_BORDERLESS, value)`.
    - **V-Sync**: Maps boolean to Enum.
        - `true` -> `DisplayServer.window_set_vsync_mode(DisplayServer.VSYNC_ENABLED)`
        - `false` -> `DisplayServer.window_set_vsync_mode(DisplayServer.VSYNC_DISABLED)`

**State Changes**
None.

**Examples**

...

```{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>Window</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">Windowed</div></div><div class="real-inline-row" style="margin-top:4px;"><div class="real-inline-btn" style="background:#2f343d;">Verbose</div></div></div>
            </div>
        </div>
    </div>
```

## Properties

| Property | Type | Default | Notes |
|---|---|---|---|
| Mode | option | Windowed | Window mode to apply when this brick activates |
| Verbose | bool | False | Log window mode change to console (controlled by ladybug button) |