Desenho 2D
Formas 2D de sobreposição em modo imediato (linhas, círculos, retângulos, polilinhas) em espaço de mundo ou de ecrã.
Namespace: caffeine.draw2d
beginFrame#
Lua: caffeine.draw2d.beginFrame
text
beginFrame()
Inicia um novo frame de sobreposição, limpando as formas draw2d anteriores. Chame-o uma vez no início do desenho.
Devolve: nada
Exemplo
lua
caffeine.draw2d.beginFrame()
line#
Lua: caffeine.draw2d.line
text
line(a, b, color[, thickness[, space]])
Desenha uma linha na sobreposição 2D.
| Parâmetros | Tipo | Descrição |
|---|---|---|
a | table | Início {x, y}. |
b | table | Fim {x, y}. |
color | table | {r, g, b, a} em 0..1 (cada um com 1 por omissão). |
thickness | number | Espessura da linha (por omissão 1). |
space | string | "world" (por omissão) ou "screen". |
Devolve: nada
Exemplo
lua
caffeine.draw2d.line({x=0,y=0},{x=5,y=5},{r=1,g=0,b=0,a=1}, 2)
circle#
Lua: caffeine.draw2d.circle
text
circle(center, radius, color[, thickness[, space]])
Desenha o contorno de um círculo (32 segmentos).
| Parâmetros | Tipo | Descrição |
|---|---|---|
center | table | Centro {x, y}. |
radius | number | Raio. |
color | table | {r, g, b, a} em 0..1 (cada um com 1 por omissão). |
thickness | number | Espessura da linha (por omissão 1). |
space | string | "world" (por omissão) ou "screen". |
Devolve: nada
Exemplo
lua
caffeine.draw2d.circle({x=0,y=0}, 3, {r=0,g=1,b=0,a=1})
rect#
Lua: caffeine.draw2d.rect
text
rect(min, max, color[, thickness[, space]])
Desenha o contorno de um retângulo.
| Parâmetros | Tipo | Descrição |
|---|---|---|
min | table | Canto {x, y}. |
max | table | Canto oposto {x, y}. |
color | table | {r, g, b, a} em 0..1 (cada um com 1 por omissão). |
thickness | number | Espessura da linha (por omissão 1). |
space | string | "world" (por omissão) ou "screen". |
Devolve: nada
Exemplo
lua
caffeine.draw2d.rect({x=-1,y=-1},{x=1,y=1},{r=1,g=1,b=0,a=1})
poly#
Lua: caffeine.draw2d.poly
text
poly(points, color[, closed[, thickness[, space]]])
Desenha uma polilinha ou o contorno de um polígono.
| Parâmetros | Tipo | Descrição |
|---|---|---|
points | table | Lista de {x, y}; pelo menos 2 pontos, senão nada é desenhado. |
color | table | {r, g, b, a} em 0..1 (cada um com 1 por omissão). |
closed | boolean | Fechar a forma (por omissão false). |
thickness | number | Espessura da linha (por omissão 1). |
space | string | "world" (por omissão) ou "screen". |
Devolve: nada
Exemplo
lua
caffeine.draw2d.poly({{x=0,y=0},{x=2,y=0},{x=1,y=2}}, {r=1,g=1,b=1,a=1}, true)