Push 项目使用教程

Push 项目使用教程

push A simple resolution-handling library for LÖVE 项目地址: https://gitcode.com/gh_mirrors/push/push

1. 项目目录结构及介绍

Push 项目的目录结构如下：

push/
├── examples/
│   └── ...
├── LICENSE
├── README.md
├── main.lua
├── push.lua
└── ...

目录结构介绍

• examples/: 包含一些示例代码，展示了如何使用 Push 库进行分辨率处理。
• LICENSE: 项目的许可证文件，Push 使用 MIT 许可证。
• README.md: 项目的说明文件，包含了项目的基本介绍和使用方法。
• main.lua: 项目的启动文件，包含了游戏的入口逻辑。
• push.lua: Push 库的核心文件，提供了分辨率处理的函数和方法。

2. 项目的启动文件介绍

main.lua

main.lua 是 Push 项目的启动文件，包含了游戏的入口逻辑。以下是 main.lua 的基本结构和功能介绍：

-- 引入 Push 库
local push = require "push"

-- 定义游戏的固定分辨率
local gameWidth, gameHeight = 1080, 720

-- 获取桌面分辨率
local windowWidth, windowHeight = love.window.getDesktopDimensions()

-- 设置屏幕分辨率
push:setupScreen(gameWidth, gameHeight, windowWidth, windowHeight, {fullscreen = true})

-- 游戏主循环
function love.draw()
    push:start()
    -- 在这里绘制游戏内容
    push:finish()
end

功能介绍

• 引入 Push 库: 使用 require "push" 引入 Push 库。
• 定义游戏的固定分辨率: 设置游戏的固定分辨率 gameWidth 和 gameHeight。
• 获取桌面分辨率: 使用 love.window.getDesktopDimensions() 获取当前桌面的分辨率。
• 设置屏幕分辨率: 使用 push:setupScreen() 设置游戏的屏幕分辨率，并启用全屏模式。
• 游戏主循环: 在 love.draw() 函数中使用 push:start() 和 push:finish() 来开始和结束绘制。

3. 项目的配置文件介绍

Push 项目没有专门的配置文件，所有的配置都在代码中进行。主要的配置项包括：

分辨率设置

push:setupScreen(gameWidth, gameHeight, windowWidth, windowHeight, {
    fullscreen = true,  -- 是否启用全屏模式
    resizable = false,  -- 是否允许窗口调整大小
    canvas = false,     -- 是否使用画布
    pixelperfect = false, -- 是否启用像素完美模式
    highdpi = false,    -- 是否启用高 DPI 模式
    stretched = false   -- 是否拉伸游戏到窗口尺寸
})

功能介绍

• fullscreen: 是否启用全屏模式。
• resizable: 是否允许窗口调整大小。
• canvas: 是否使用画布。
• pixelperfect: 是否启用像素完美模式。
• highdpi: 是否启用高 DPI 模式。
• stretched: 是否拉伸游戏到窗口尺寸。

通过这些配置项，可以灵活地调整 Push 库的行为，以适应不同的游戏需求。

push A simple resolution-handling library for LÖVE 项目地址: https://gitcode.com/gh_mirrors/push/push