BYTEPATH项目中的Draft模块：LÖVE 2D图形绘制利器-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00033/article/details/148993132

BYTEPATH项目中的Draft模块：LÖVE 2D图形绘制利器

BYTEPATH A replayable arcade shooter with a focus on build theorycrafting. 项目地址: https://gitcode.com/gh_mirrors/by/BYTEPATH

模块概述

Draft是专为LÖVE 2D游戏引擎设计的轻量级图形绘制模块，它简化了各种基本和复杂形状的创建过程。作为BYTEPATH项目的重要组成部分，Draft模块为开发者提供了一套直观的API，可以快速实现游戏中的各种图形元素绘制需求。

核心特性

多模式支持：支持填充(fill)和线框(line)两种绘制模式
丰富的形状库：提供从简单到复杂的40+种形状绘制方法
灵活的参数控制：每个形状都可以单独设置绘制模式
顶点获取功能：在不绘制的情况下获取形状顶点数据
高级连接器：提供多种点连接方式，创造复杂视觉效果

快速入门

初始化模块

local Draft = require('draft')
-- 默认使用填充模式
local draft = Draft()
-- 或者指定线框模式
local draft = Draft('line')

基本绘制示例

function love.draw()
    -- 绘制两个矩形
    draft:rectangle(300, 100, 50, 30)
    draft:rectangle(500, 100, 50, 30)
    
    -- 绘制菱形
    draft:rhombus(400, 200, 65, 65)
    
    -- 使用线框模式绘制弓形
    draft:bow(390, 280, 100, 2.5, 0, 10, 'line')
end

形状分类详解

基础形状

Draft模块提供了最基础的图形绘制方法，这些是构建更复杂形状的基础：

line: 绘制直线
triangleIsosceles: 等腰三角形
triangleRight: 直角三角形
rectangle: 矩形
polygon: 自定义多边形

中级形状

基于基础形状构建的常用图形：

square: 正方形
rhombus: 菱形
diamond: 钻石形
trapezoid: 梯形
parallelogram: 平行四边形

高级形状

更复杂的几何图形：

star: 星形
egg: 蛋形
gem: 宝石形
kite: 风筝形

曲线形状

Draft模块特别强大的曲线绘制能力：

circle: 圆形
ellipse: 椭圆
arc: 圆弧
pie: 扇形
compass: 极坐标曲线(最强大的曲线工具)

高级技巧

动态模式切换

-- 获取当前模式
local current_mode = draft:getMode()

-- 切换为线框模式
draft:setMode('line')

仅获取顶点数据

-- 获取矩形顶点但不绘制
local vertices = draft:rectangle(100, 100, 50, 80, false)

使用compass创建自定义曲线

compass是Draft模块中最强大的曲线工具，它允许你通过极坐标方程定义任意曲线：

-- 示例：创建心形曲线
local function heartScale(angle)
    return 1 + math.sin(angle)
end

draft:compass(400, 300, 100, math.pi*2, 0, 32, true, heartScale)

连接器应用

连接器可以创造有趣的视觉效果，特别是在粒子系统或背景元素中：

function love.draw()
    -- 创建蛋形顶点
    local v = draft:egg(400, 300, 150, 1, 1, 20, 'line')
    
    -- 使用网状连接器
    draft:linkWeb(v)
    
    -- 或者使用阶梯连接器
    draft:linkSteps(v1, v2)
end