Difference between revisions of "love.graphics.draw (Português)"

(versão inicial em Português)
 
(translation update)
Line 1: Line 1:
Desenha objetos na tela.
+
<span style="color: #597E9A; font-size: 18pt">love.graphics.draw</span>
 +
{{#set:RealLink=love.graphics.draw (Português)}}
 +
{{#set:DisplayName=love.graphics.draw}}
 +
Desenha um objeto [[Drawable (Português)|Desenhável]] (uma [[Image (Português)|Imagem]], uma [[Canvas (Português)|Pintura]], um [[SpriteBatch (Português)|LoteDeSprites]], um [[ParticleSystem (Português)|SistemaDePartículas]], ou uma [[Mesh (Português)|Malha]]) na tela, com rotação, redimensionamento e inclinação opcionais.
 +
 
 +
Objetos são desenhados em relação ao seu sistema de coordenadas local. Por padrão, a origem se encontra no canto superior esquerdo da [[Image (Português)|Imagem]] e da [[Canvas (Português)|Pintura]]. Todos os argumentos de tamanho, inclinação e rotação transformam o objeto em relação a esse ponto. Além disso, a posição de origem pode ser especificada no sistema de coordenadas da tela.
 +
 
 +
É possível girar um objeto em torno de seu centro deslocando a origem para o centro. Para a rotação, ângulos devem ser dados em radianos. Também se pode usar um fator de redimensionamento negativo para virar a partir do centro.
 +
 
 +
Repare que os deslocamentos são aplicados antes de rotação, redimensionamento ou inclinação; redimensionamento e inclinação são aplicados antes da rotação.
 +
 
 +
Os limites da direita e debaixo do objeto são deslocados num ângulo definido pelos fatores de inclinação.
 
== Função ==
 
== Função ==
 
=== Sinopse ===
 
=== Sinopse ===
 
<source lang="lua">
 
<source lang="lua">
love.graphics.draw( objeto, x, y, r, sx, sy, ox, oy )
+
love.graphics.draw( desenhavel, x, y, r, ex, ey, ox, oy, ix, iy )
 
</source>
 
</source>
 
=== Argumentos ===
 
=== Argumentos ===
{{param|Drawable (Português)|objeto|Objeto a ser desenhado.}}
+
{{param|Drawable (Português)|desenhavel|Um objeto desenhável.|Desenhável}}
{{param|number (Português)|x|A posição em que o objeto será desenhado (eixo x).}}
+
{{param|number (Português)|x (0)|A posição em que o objeto será desenhado (eixo x).|número}}
{{param|number (Português)|y|A posição em que o objeto será desenhado (eixo y).}}
+
{{param|number (Português)|y (0)|A posição em que o objeto será desenhado (eixo y).|número}}
{{param|number (Português)|r (0)|Orientação (em radianos).}}
+
{{param|number (Português)|r (0)|Orientação (radianos).|número}}
{{param|number (Português)|sx (1)|Fator de escala (eixo x).}}
+
{{param|number (Português)|ex (1)|Fator de escala (eixo x).|número}}
{{param|number (Português)|sy (sx)|Fator de escala (eixo y).}}
+
{{param|number (Português)|ey (ex)|Fator de escala (eixo y).|número}}
{{param|number (Português)|ox (0)|Deslocamento da origem (eixo x).}}
+
{{param|number (Português)|ox (0)|Deslocamento da origem (eixo x).|número}}
{{param|number (Português)|oy (0)|Deslocamento da origem (eixo y).}}
+
{{param|number (Português)|oy (0)|Deslocamento da origem (eixo y).|número}}
=== Retornos ===
+
{{New feature (Português)|0.8.0|
 +
{{param|number (Português)|ix (0)|Fator de inclinação (eixo x).|número}}
 +
{{param|number (Português)|iy (0)|Fator de inclinação (eixo y).|número}}
 +
|080}}
 +
=== Retorna ===
 
Nada.
 
Nada.
=== Nota ===
+
 
love.graphics.draw() usa como referência padrão o canto superior esquerdo.
+
== Função ==
 +
{{newin (Português)|[[0.9.0]]|090|type=variant|text=Substituiu [[love.graphics.drawq (Português)|love.graphics.drawq]]}}
 +
=== Sinopse ===
 +
<source lang="lua">
 +
love.graphics.draw( imagem, quad, x, y, r, ex, ey, ox, oy, ix, iy )
 +
</source>
 +
=== Argumentos ===
 +
{{param|Image or Canvas (Português)|imagem|Uma [[Image (Português)|Imagem]] ou [[Canvas (Português)|Pintura]] para texturizar o Quad.|Imagem ou Pintura}}
 +
{{param|Quad (Português)|quad|O Quad a ser desenhado na tela.|Quad}}
 +
{{param|number (Português)|x|A posição em que o objeto será desenhado (eixo x).|número}}
 +
{{param|number (Português)|y|A posição em que o objeto será desenhado (eixo y).|número}}
 +
{{param|number (Português)|r (0)|Orientação (radianos).|número}}
 +
{{param|number (Português)|ex (1)|Fator de escala (eixo x).|número}}
 +
{{param|number (Português)|ey (ex)|Fator de escala (eixo y).|número}}
 +
{{param|number (Português)|ox (0)|Deslocamento da origem (eixo x).|número}}
 +
{{param|number (Português)|oy (0)|Deslocamento da origem (eixo y).|número}}
 +
{{param|number (Português)|ix (0)|Fator de inclinação (eixo x).|número}}
 +
{{param|number (Português)|iy (0)|Fator de inclinação (eixo y).|número}}
 +
=== Retorna ===
 +
Nada.
 +
 
 +
== Exemplos ==
 +
=== Desenhar uma imagem (a [https://love2d.org/w/images/c/c3/Resource-HamsterBall.png Bola de Hamster]) na posição 100 por 100 pixels. ===
 +
<source lang="lua">
 +
function love.load()
 +
  hamster = love.graphics.newImage("hamster.png")
 +
end
 +
function love.draw()
 +
  love.graphics.draw(hamster, 100, 100)
 +
end
 +
</source>
 +
=== Desenhar uma imagem (a [https://love2d.org/w/images/c/c3/Resource-HamsterBall.png Bola de Hamster]) a partir do centro, na posição 100 por 100 pixels, girado em 90 graus ===
 +
<source lang="lua">
 +
function love.load()
 +
  hamster = love.graphics.newImage("hamster.png")
 +
  largura = hamster:getWidth()
 +
  altura = hamster:getHeight()
 +
end
 +
function love.draw()
 +
  love.graphics.draw(hamster, 100, 100, math.rad(90), 1, 1, largura / 2, altura / 2)
 +
end
 +
</source>
 +
----
 +
{{newin|[[0.9.0]]|090|type=functionality}}
 +
=== Desenha a metade de cima de uma imagem (a [https://love2d.org/w/images/c/c3/Resource-HamsterBall.png Bola de Hamster]) na posição 100 por 100 pixels. ===
 +
<source lang="lua">
 +
function love.load()
 +
  imagem = love.graphics.newImage("hamster.png")
 +
  quad = love.graphics.newQuad(0, 0, 128, 64, imagem:getWidth(), imagem:getHeight())
 +
end
 +
 
 +
function love.draw()
 +
love.graphics.draw(imagem, quad, 100, 100)
 +
end
 +
</source>
 +
 
 
== Veja Também ==
 
== Veja Também ==
* [[parent::love.graphics (Português)]]
+
* [[parent::love.graphics (Português)|love.graphics]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Sub-Category::Drawing| ]]
 
{{#set:Description=Desenha objetos na tela.}}
 
{{#set:Description=Desenha objetos na tela.}}
== Outros Idiomas ==
+
{{#set:Since=000}}
 +
== Outras Línguas ==
 
{{i18n|love.graphics.draw}}
 
{{i18n|love.graphics.draw}}

Revision as of 00:06, 26 September 2014

love.graphics.draw


Desenha um objeto Desenhável (uma Imagem, uma Pintura, um LoteDeSprites, um SistemaDePartículas, ou uma Malha) na tela, com rotação, redimensionamento e inclinação opcionais.

Objetos são desenhados em relação ao seu sistema de coordenadas local. Por padrão, a origem se encontra no canto superior esquerdo da Imagem e da Pintura. Todos os argumentos de tamanho, inclinação e rotação transformam o objeto em relação a esse ponto. Além disso, a posição de origem pode ser especificada no sistema de coordenadas da tela.

É possível girar um objeto em torno de seu centro deslocando a origem para o centro. Para a rotação, ângulos devem ser dados em radianos. Também se pode usar um fator de redimensionamento negativo para virar a partir do centro.

Repare que os deslocamentos são aplicados antes de rotação, redimensionamento ou inclinação; redimensionamento e inclinação são aplicados antes da rotação.

Os limites da direita e debaixo do objeto são deslocados num ângulo definido pelos fatores de inclinação.

Função

Sinopse

love.graphics.draw( desenhavel, x, y, r, ex, ey, ox, oy, ix, iy )

Argumentos

Desenhável desenhavel
Um objeto desenhável.
número x (0)
A posição em que o objeto será desenhado (eixo x).
número y (0)
A posição em que o objeto será desenhado (eixo y).
número r (0)
Orientação (radianos).
número ex (1)
Fator de escala (eixo x).
número ey (ex)
Fator de escala (eixo y).
número ox (0)
Deslocamento da origem (eixo x).
número oy (0)
Deslocamento da origem (eixo y).
Disponível desde o LÖVE 0.8.0
número ix (0)
Fator de inclinação (eixo x).
número iy (0)
Fator de inclinação (eixo y).

Retorna

Nada.

Função

Disponível desde o LÖVE 0.9.0
Substituiu love.graphics.drawq.

Sinopse

love.graphics.draw( imagem, quad, x, y, r, ex, ey, ox, oy, ix, iy )

Argumentos

Imagem ou Pintura imagem
Uma Imagem ou Pintura para texturizar o Quad.
Quad quad
O Quad a ser desenhado na tela.
número x
A posição em que o objeto será desenhado (eixo x).
número y
A posição em que o objeto será desenhado (eixo y).
número r (0)
Orientação (radianos).
número ex (1)
Fator de escala (eixo x).
número ey (ex)
Fator de escala (eixo y).
número ox (0)
Deslocamento da origem (eixo x).
número oy (0)
Deslocamento da origem (eixo y).
número ix (0)
Fator de inclinação (eixo x).
número iy (0)
Fator de inclinação (eixo y).

Retorna

Nada.

Exemplos

Desenhar uma imagem (a Bola de Hamster) na posição 100 por 100 pixels.

function love.load()
   hamster = love.graphics.newImage("hamster.png")
end
function love.draw()
   love.graphics.draw(hamster, 100, 100)
end

Desenhar uma imagem (a Bola de Hamster) a partir do centro, na posição 100 por 100 pixels, girado em 90 graus

function love.load()
   hamster = love.graphics.newImage("hamster.png")
   largura = hamster:getWidth()
   altura = hamster:getHeight()
end
function love.draw()
   love.graphics.draw(hamster, 100, 100, math.rad(90), 1, 1, largura / 2, altura / 2)
end

Available since LÖVE 0.9.0
This functionality is not supported in earlier versions.

Desenha a metade de cima de uma imagem (a Bola de Hamster) na posição 100 por 100 pixels.

function love.load()
   imagem = love.graphics.newImage("hamster.png")
   quad = love.graphics.newQuad(0, 0, 128, 64, imagem:getWidth(), imagem:getHeight())
end

function love.draw()
	love.graphics.draw(imagem, quad, 100, 100)
end

Veja Também


Outras Línguas