Game Window¶

The Game.window() method provides access to the GameWindow class, which manages the window that hosts your game's rendering component. Use it to control window properties like title, icon, resolution, cursor, and display mode.

// Access the game window
GameWindow window = Game.window();

Window Setup¶

Set up the window before or after game initialization:

public static void main(String[] args) {
  // Set game info first (used for window title)
  Game.info().setName("My Game");
  Game.info().setVersion("v1.0.0");

  Game.init(args);

  // Set window icon after initialization
  Game.window().setIcon(Resources.images().get("icon.png"));

  Game.start();
}

Window Title¶

The window title defaults to your game's name from Game.info(). You can customize it:

Game.window().setTitle("My Awesome Game - Main Menu");

Window Icon¶

Set a custom window icon (displayed in the title bar and taskbar):

BufferedImage icon = Resources.images().get("icon.png");
Game.window().setIcon(icon);

Resolution and Scaling¶

Getting Resolution¶

// Get current window resolution
Dimension resolution = Game.window().getResolution();
int width = resolution.width;
int height = resolution.height;

// Get host screen resolution
Dimension screenResolution = Game.window().getHostScreenResolution();

Resolution Scaling¶

When resolution scaling is enabled, all players see the same proportional view of the game world regardless of their physical window size. When disabled, players with larger windows or higher resolutions see a wider viewport of the map.

Enable in config.properties:

gfx_enableResolutionScale=true

Or programmatically:

Game.config().graphics().setEnableResolutionScale(true);

Base Render Scale¶

Control how much the game is scaled up from its native resolution:

// Set base render scale (default is 3.0)
Game.graphics().setBaseRenderScale(4f);

Fullscreen Mode¶

Toggle between windowed and fullscreen display:

// Check if fullscreen
boolean isFullscreen = Game.window().isFullscreen();

// Enable fullscreen
Game.window().setFullscreen(true);

// Return to windowed mode
Game.window().setFullscreen(false);

Configure default in config.properties:

gfx_fullscreen=false

Custom Cursor¶

LITIENGINE supports custom mouse cursors for a more polished game experience.

// Set a custom cursor image
BufferedImage cursorImage = Resources.images().get("cursor.png");
Game.window().cursor().set(cursorImage, 16, 16);

// Enable/disable the cursor visibility
Game.window().cursor().setVisible(true);

// Reset to system default cursor
Game.window().cursor().reset();

The cursor offset parameters (16, 16) define the hotspot position relative to the top-left corner of the cursor image.

Window Events¶

Listen for window state changes:

Game.window().addWindowListener(new WindowAdapter() {
  @Override
  public void windowGainedFocus(WindowEvent e) {
    // Game window gained focus
  }

  @Override
  public void windowLostFocus(WindowEvent e) {
    // Game window lost focus - consider pausing
  }
});

Configuration Options¶

Key window-related settings in config.properties:

# Enable/disable resolution scaling
gfx_enableResolutionScale=true

# Start in fullscreen mode
gfx_fullscreen=false

# Maximum FPS (0 = unlimited, syncs to monitor if vsync enabled)
cl_maxFps=60

# Show game metrics (FPS, UPS) in corner
cl_showGameMetrics=false

Common Patterns¶

Initialize Window with Custom Settings¶

public static void main(String[] args) {
  Game.info().setName("My Game");
  Game.info().setVersion("v1.0.0");

  Game.init(args);

  // Configure window appearance
  Game.window().setIcon(Resources.images().get("icon.png"));
  Game.window().cursor().set(Resources.images().get("cursor.png"), 8, 8);

  // Set render scale for pixel art look
  Game.graphics().setBaseRenderScale(4f);

  Game.start();
}

Toggle Fullscreen at Runtime¶

Input.keyboard().onKeyPressed(KeyEvent.VK_F11, e -> {
  Game.window().setFullscreen(!Game.window().isFullscreen());
});