setCinematicCaptions

Cliente

Define as legendas que a cinemática desenha na tela durante a reprodução. Substitui as legendas anteriores.

bool setCinematicCaptions(cinematic cinematic, table captions)

Parâmetros

Nome	Tipo	Descrição
cinematic	cinematic	A cinemática.
captions	table	Lista de legendas, em ordem de `time`.

Retorno

true se aplicou. false se a tabela é inválida, com um aviso dizendo o motivo.

Os tamanhos e distâncias são em pixels numa tela de 1080 linhas. Cada legenda tem:

time: quando aparece, em ms da cinemática (obrigatório).
length: quanto dura, em ms, acima de 0 (obrigatório).
text: o texto (obrigatório).
font: caminho de um .ttf num recurso (obrigatório).
size: de 4 a 400, 36 por padrão.
anchor: "top-left", "top", "top-right", "left", "center", "right", "bottom-left", "bottom" (padrão) ou "bottom-right".
align: "left", "center" (padrão) ou "right".
offsetX e offsetY: deslocamento a partir da âncora.
red, green e blue: de 0 a 255, branco por padrão. opacity: de 0 a 1, 1 por padrão.
fadeIn e fadeOut: ms de fade.
slideIn e slideOut: "none" (padrão), "left", "right", "top" ou "bottom". slideDistance: quanto desliza, 60 por padrão.
typing: ms por caractere para digitar o texto. 0 mostra tudo de uma vez.

Exemplo

local intro = createCinematic("cinematics/intro.cine")
setCinematicCaptions(intro, {
    { time = 500, length = 4000, text = "Los Santos, 1992", font = "fonts/title.ttf", size = 48, anchor = "top", offsetY = 80, fadeIn = 500, fadeOut = 500 },
    { time = 3000, length = 2500, text = "Cadê todo mundo?", font = "fonts/subs.ttf", typing = 40 },
})

Veja também

getCinematicCaptions setCinematicAudio dxCreateFont