How do I handle mobile screen orientation changes with Push?

Push doesn't have built-in mobile support, but you can listen to `love.resize` events and call `push:resize` to adjust. Initialize in fullscreen mode using `love.window.getDesktopDimensions()` for basic adaptation.

Can I apply multiple shaders to different parts of my game with Push?

Yes, Push supports multiple shaders. Use `push:setShader({shader1, shader2})` for global effects or `push:setupCanvas` with named canvases and shader tables to apply shaders to specific layers.

How does Push compare to LÖVE's built-in scaling functions?

Push abstracts away manual scaling and aspect ratio maintenance, offering a higher-level API with features like pixel-perfect mode and canvas management. LÖVE's built-in functions require more code for similar results.

What's the best way to convert mouse coordinates when using Push?

Use `push:toGame(x, y)` to convert screen coordinates to your fixed game resolution. This ensures accurate input handling, but check for nil returns when coordinates are outside the game area.

Does Push support high-DPI displays like Retina screens?

Yes, Push includes a `highdpi` option in `push:setupScreen` to enable support for high-DPI modes, ensuring crisp graphics on compatible screens without extra configuration.

How to set up custom canvases for layered rendering with Push?

Use `push:setupCanvas` with a list of canvas definitions, each with a name and optional shader. Then, switch between canvases during drawing using `push:setCanvas(canvasName)` for organized rendering.

Push — LÖVE Resolution Handling Library

What is Push?

Push is a resolution-handling library for the LÖVE game framework that simplifies adapting games to different screen sizes and resolutions. It allows developers to design their game at a fixed internal resolution while automatically scaling and adjusting the output to fit various window dimensions, maintaining aspect ratios and supporting features like pixel-perfect scaling and shader effects.

Target Audience

LÖVE developers creating 2D games who need a straightforward way to handle multiple screen resolutions and aspect ratios without managing complex scaling logic themselves.

Value Proposition

Developers choose Push for its simplicity and focused feature set—it provides essential resolution-handling tools with a clean API, reducing boilerplate code and letting them concentrate on game content rather than display intricacies.

A simple resolution-handling library for LÖVE

Use Cases

Best For

Creating 2D games in LÖVE that need to run at a consistent internal resolution
Handling multiple screen sizes and aspect ratios without manual scaling calculations
Adding post-processing shader effects to LÖVE games with built-in canvas support
Developing pixel-perfect games with integer scaling options
Adapting LÖVE games for both desktop and mobile screen orientations
Simplifying coordinate conversion for input handling across scaled displays

Not Ideal For

Projects not using the LÖVE framework (as it's LÖVE-specific)
Games requiring frequent, dynamic resolution switching beyond basic window resizing
Developers needing advanced, automatic mobile UI adaptations like layout scaling
Teams that prefer full control over rendering without any abstraction layer

Pros & Cons

Pros

Simple Setup and API

With just `push:setupScreen` and `push:start/finish`, developers can handle resolution scaling, reducing boilerplate code as shown in the setup examples.

Versatile Display Options

Supports multiple modes like fullscreen, windowed, pixel-perfect, and high-dpi, allowing flexible presentation without complex configuration.

Integrated Canvas and Shaders

Provides built-in canvas support and allows applying multiple shaders for post-processing, simplifying advanced graphical effects with table-based shader lists.

Handy Coordinate Conversion

Includes `push:toGame` and `push:toReal` functions to easily convert between screen and game coordinates, essential for accurate input handling across scaled displays.

Cons

No Native Mobile Support

The README explicitly states it does not have built-in support for mobile platforms, requiring manual handling for orientation changes and fullscreen initialization.

Limited to LÖVE Ecosystem

As a LÖVE-specific library, it's not applicable to other game frameworks, restricting its use to projects within that environment.

Basic Mobile Guidance Only

While it offers guidance like using fullscreen mode and resize listeners, it lacks advanced features such as automatic UI scaling for different mobile devices.

Frequently Asked Questions

What is Push?

Target Audience

LÖVE developers creating 2D games who need a straightforward way to handle multiple screen resolutions and aspect ratios without managing complex scaling logic themselves.

Value Proposition

Use Cases

Best For

Creating 2D games in LÖVE that need to run at a consistent internal resolution
Handling multiple screen sizes and aspect ratios without manual scaling calculations
Adding post-processing shader effects to LÖVE games with built-in canvas support
Developing pixel-perfect games with integer scaling options
Adapting LÖVE games for both desktop and mobile screen orientations
Simplifying coordinate conversion for input handling across scaled displays

Not Ideal For

Projects not using the LÖVE framework (as it's LÖVE-specific)
Games requiring frequent, dynamic resolution switching beyond basic window resizing
Developers needing advanced, automatic mobile UI adaptations like layout scaling
Teams that prefer full control over rendering without any abstraction layer

Pros & Cons

Pros

Simple Setup and API

With just `push:setupScreen` and `push:start/finish`, developers can handle resolution scaling, reducing boilerplate code as shown in the setup examples.

Versatile Display Options

Supports multiple modes like fullscreen, windowed, pixel-perfect, and high-dpi, allowing flexible presentation without complex configuration.

Integrated Canvas and Shaders

Provides built-in canvas support and allows applying multiple shaders for post-processing, simplifying advanced graphical effects with table-based shader lists.

Handy Coordinate Conversion

Includes `push:toGame` and `push:toReal` functions to easily convert between screen and game coordinates, essential for accurate input handling across scaled displays.

Cons

No Native Mobile Support

The README explicitly states it does not have built-in support for mobile platforms, requiring manual handling for orientation changes and fullscreen initialization.

Limited to LÖVE Ecosystem

As a LÖVE-specific library, it's not applicable to other game frameworks, restricting its use to projects within that environment.

Basic Mobile Guidance Only

While it offers guidance like using fullscreen mode and resize listeners, it lacks advanced features such as automatic UI scaling for different mobile devices.

Frequently Asked Questions

Push

What is Push?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

Push

What is Push?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?