love.graphics.print (Português)

love.graphics.print


Desenha texto na tela. Se nenhuma Fonte estiver configurada, uma irá ser criada e configurada (uma vez) se necessário.

Desde o LOVE 0.7.1, quando se usam funções de translação e redimensionamento ao desenhar texto, esta função supõe que o redimensionamento ocorra primeiro. Se você não programar com isso em mente, o texto não ficará na posição certa, ou talvez nem apareça na tela.

Ambos love.graphics.print e love.graphics.printf suportam codificação UTF-8. Você também vai precisar de uma Fonte apropriada para caracteres especiais.

Função

Sinopse

love.graphics.print( texto, x, y, r, ex, ey, ox, oy, ix, iy )

Argumentos

string texto
O texto a ser desenhado.
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).
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.

Exemplos

Um exemplo tosco

function love.draw()
    love.graphics.setColor(0, 255, 0, 255)
    love.graphics.print("Este é um exemplo bem tosco.", 10, 200)
    love.graphics.setColor(255, 0, 0, 255)
    love.graphics.print("Este exemplo tosco tem o dobro do tamanho.", 10, 250, 0, 2, 2)
    love.graphics.setColor(0, 0, 255, 255)
    love.graphics.print("Este exemplo é toscamente vertical.", 300, 30, math.pi/2)
end

Notas

Nas versões 0.8.0 e anteriores, love.graphics.print para no primeiro caracter "\0" (nulo). Isso pode dar problemas se você for acrescentar texto digitado pelo usuário para formar seu string, já que alguns desses caracteres serão unicode multibyte, provavelmente contendo bytes nulos.

Veja Também


Outras Línguas