setCinematicCaptions

Cliente

Define los subtítulos que la cinemática dibuja en pantalla durante la reproducción. Reemplaza los subtítulos anteriores.

bool setCinematicCaptions(cinematic cinematic, table captions)

Parámetros

Nombre	Tipo	Descripción
cinematic	cinematic	La cinemática.
captions	table	Lista de subtítulos, en orden de `time`.

Retorno

true si se aplicaron. false si la tabla no es válida, con un aviso que dice el motivo.

Los tamaños y distancias son en píxeles en una pantalla de 1080 líneas. Cada subtítulo tiene:

time: cuándo aparece, en ms de la cinemática (obligatorio).
length: cuánto dura, en ms, mayor que 0 (obligatorio).
text: el texto (obligatorio).
font: ruta de un .ttf en un recurso (obligatorio).
size: de 4 a 400, 36 por defecto.
anchor: "top-left", "top", "top-right", "left", "center", "right", "bottom-left", "bottom" (por defecto) o "bottom-right".
align: "left", "center" (por defecto) o "right".
offsetX y offsetY: desplazamiento desde el ancla.
red, green y blue: de 0 a 255, blanco por defecto. opacity: de 0 a 1, 1 por defecto.
fadeIn y fadeOut: ms de fundido.
slideIn y slideOut: "none" (por defecto), "left", "right", "top" o "bottom". slideDistance: cuánto se desliza, 60 por defecto.
typing: ms por carácter para escribir el texto. 0 lo muestra todo de una vez.

Ejemplo

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 = "¿Dónde están todos?", font = "fonts/subs.ttf", typing = 40 },
})

Ver también

getCinematicCaptions setCinematicAudio dxCreateFont