Referência do Arquivo caption-hooking.h

Registro das callbacks (hooks) que recebem o texto e os comandos da legenda durante o caption_closed_run(). Mais...

#include "caption-common.h"
#include "caption-closed.h"

Gráfico de dependência de inclusões para caption-hooking.h:

Este grafo mostra quais arquivos estão direta ou indiretamente relacionados com esse arquivo:

Ir para o código-fonte desse arquivo.

Definições de Tipos
typedef void(*	CaptionHookingControls_t) (CaptionClosed_t *cc, const uint8_t cmd)
typedef void(*	CaptionHookingString_t) (CaptionClosed_t *cc, const char *string, const uint8_t len)

Funções
void	caption_hooking_set_controls (CaptionHookingControls_t callback)
void	caption_hooking_set_string (CaptionHookingString_t callback)

Descrição detalhada

Registro das callbacks (hooks) que recebem o texto e os comandos da legenda durante o caption_closed_run().

Autor

Jorge Pereira jpere.nosp@m.iran.nosp@m.@gmai.nosp@m.l.co.nosp@m.m

Data

Thu Aug 12 13:49:21 BRT 2010

Durante o caption_closed_run(), cada caractere de texto é convertido para UTF-8 e entregue ao hook de texto, e cada comando de controle C0/C1 reconhecido é entregue ao hook de controles.

Exemplo:

static void
on_string (CaptionClosed_t *cc, const char *utf8, const uint8_t len)
{
  fwrite (utf8, 1, len, stdout);
}
 
static void
on_controls (CaptionClosed_t *cc, const uint8_t cmd)
{
  if (cmd == CTRL_C0_APR) // Active Position Return: nova linha
    putchar ('\n');
}
 
caption_hooking_set_string (on_string);
caption_hooking_set_controls (on_controls);

Aviso

Os hooks são globais: existe apenas um de cada tipo para todo o processo, e eles não devem ser alterados enquanto outra thread executa o caption_closed_run(). Use CaptionClosed_t::userdata para identificar o contexto dentro do hook.

Definição no arquivo caption-hooking.h.

Definições dos tipos

CaptionHookingControls_t

typedef void(* CaptionHookingControls_t) (CaptionClosed_t *cc, const uint8_t cmd)

Hook chamado para cada comando de controle reconhecido.

Parâmetros

cc	Estado da legenda, já atualizado pelo comando.
cmd	Código do comando: C0 (CaptionClosed_CtrlCodes_C0), C1 (CaptionClosed_CtrlCodes_C1) ou, para o CSI, o código do subcomando (CaptionClosed_CtrlCodes_C1_CSI).

Definição na linha 50 do arquivo caption-hooking.h.

CaptionHookingString_t

typedef void(* CaptionHookingString_t) (CaptionClosed_t *cc, const char *string, const uint8_t len)

Hook chamado para cada caractere de texto.

Parâmetros

cc	Estado da legenda (cores, tamanho, posição) no momento do caractere.
string	Caractere em UTF-8. Não termina com '\0'.
len	Quantidade de bytes em string (1 a 3).

Definição na linha 60 do arquivo caption-hooking.h.

Funções

caption_hooking_set_controls()

void caption_hooking_set_controls

(

CaptionHookingControls_t

callback

)

Registra o hook de comandos de controle (C0/C1).

Parâmetros

callback

O hook, ou NULL para desligar.

caption_hooking_set_string()

void caption_hooking_set_string

(

CaptionHookingString_t

callback

)

Registra o hook de texto.

Parâmetros

callback

O hook, ou NULL para desligar.