Skip to main content

renwindow

Functionality to create and manage windows.

_restore​

function renwindow._restore()
  -> number

Restore Window

create​

function renwindow.create(title: string, width?: integer, height?: integer)
  -> renwindow

Create a new window

@param title — the title given to the newly created window

@param width — if nil or less than 1 will be calculated from display

@param height — if nil or less than 1 will be calculated from display

get_color​

function renwindow.get_color(window: renwindow, x: number, y: number)
  -> color: (renderer.color)?

Gets the window pixel color of the specified position.

get_refresh_rate​

function renwindow.get_refresh_rate(window: renwindow)
  -> refresh_rate: number?

Gets the display refresh rate of a window. Returns nil if it cannot be determined.

get_renderer_info​

function renwindow.get_renderer_info(window: renwindow)
  -> { backend: string|"sdlgpu"|"sdlrenderer"|"surface", power: string, device: string }

Gets renderer information for the backend currently attached to the window. backend is always set. power and device are only set by backends where the fields apply and the information is available.

get_size​

function renwindow.get_size(window: renwindow)
  -> width: number
  2. height: number

Get width and height of a window

set_vsync​

function renwindow.set_vsync(window: renwindow, enabled: boolean)

Enable or disable vertical synchronization for the window swapchain. When enabled the backend presents tear-free (synced to the display refresh); when disabled it presents every rendered frame for the lowest latency, which may tear. No-op on backends without a controllable present mode (software).