Comandos de controle C0, C1 e CSI do texto da legenda. Mais...

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

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

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

Ir para o código-fonte desse arquivo.

Estruturas de Dados
struct	CC_ControlCodes_CallbackData_t

struct	CaptionClosedControls_t

struct	csi_arg_Pn

Definições e Macros
#define	DEBUG_CAPTION_CLOSED_CONTROLCODE

#define	CAPTION_CTRL_SET(code, callback) { code, callback, #code }

#define	CTRL_C0_NULL 0x00

#define	CTRL_C0_BELL 0x07

#define	CTRL_CSI_FB 0x20

#define	CTRL_CSI_IB 0x3b

#define	CTRL_CSI_MAX_Pn_ARGS 5

#define	CTRL_CSI_MAX_Pn_FIELDS (5+1)

Definições de Tipos
typedef uint8_t	CaptionClosed_CtrlCode_t

Enumerações
enum	CaptionClosed_CtrlCodes_C0 { CTRL_C0_APB = 0x08 , CTRL_C0_APF = 0x09 , CTRL_C0_APD = 0x0a , CTRL_C0_APU = 0x0b , CTRL_C0_CS = 0x0c , CTRL_C0_APR = 0x0d , CTRL_C0_LS1 = 0x0e , CTRL_C0_LS0 = 0x0f , CTRL_C0_PAD_0x01 = 0x10 , CTRL_C0_PAD_0x02 = 0x11 , CTRL_C0_PAD_0x03 = 0x12 , CTRL_C0_PAD_0x04 = 0x13 , CTRL_C0_PAD_0x05 = 0x14 , CTRL_C0_PAD_0x06 = 0x15 , CTRL_C0_PAPF = 0x16 , CTRL_C0_PAD_0x17 = 0x17 , CTRL_C0_CAN = 0x18 , CTRL_C0_SS2 = 0x19 , CTRL_C0_PAD_0x1a = 0x1a , CTRL_C0_ESC = 0x1b , CTRL_C0_APS = 0x1c , CTRL_C0_SS3 = 0x1d , CTRL_C0_RS = 0x1e , CTRL_C0_US = 0x1f }

enum	CaptionClosed_CtrlCodes_C1 { CTRL_C1_BKF = 0x80 , CTRL_C1_RDF = 0x81 , CTRL_C1_GRF = 0x82 , CTRL_C1_YLF = 0x83 , CTRL_C1_BLF = 0x84 , CTRL_C1_MGF = 0x85 , CTRL_C1_CNF = 0x86 , CTRL_C1_WHF = 0x87 , CTRL_C1_SSZ = 0x88 , CTRL_C1_MSZ = 0x89 , CTRL_C1_NSZ = 0x8a , CTRL_C1_SZX = 0x8b , CTRL_C1_PAD_0x8c = 0x8c , CTRL_C1_PAD_0x8d = 0x8d , CTRL_C1_PAD_0x8e = 0x8e , CTRL_C1_PAD_0x8f = 0x8f , CTRL_C1_COL = 0x90 , CTRL_C1_FLC = 0x91 , CTRL_C1_CDC = 0x92 , CTRL_C1_POL = 0x93 , CTRL_C1_WMM = 0x94 , CTRL_C1_MAC = 0x95 , CTRL_C1_PAD_0x96 = 0x96 , CTRL_C1_HLC = 0x97 , CTRL_C1_RPC = 0x98 , CTRL_C1_SPL = 0x99 , CTRL_C1_STL = 0x9a , CTRL_C1_CSI = 0x9b , CTRL_C1_PAD_0x9c = 0x9c , CTRL_C1_TIM = 0x9d , CTRL_C1_PAD_0x9e = 0x9e , CTRL_C1_PAD_0x9f = 0x9f }

enum	CaptionClosed_CtrlCodes_C1_CSI { CTRL_C1_CSI_SWF = 0x53 , CTRL_C1_CSI_PAD_0x54 = 0x54 , CTRL_C1_CSI_PAD_0x55 = 0x55 , CTRL_C1_CSI_SDF = 0x56 , CTRL_C1_CSI_SSM = 0x57 , CTRL_C1_CSI_SHS = 0x58 , CTRL_C1_CSI_SVS = 0x59 , CTRL_C1_CSI_PAD_0x5a = 0x5a , CTRL_C1_CSI_PAD_0x5b = 0x5b , CTRL_C1_CSI_PAD_0x5c = 0x5c , CTRL_C1_CSI_PAD_0x5d = 0x5d , CTRL_C1_CSI_PAD_0x5e = 0x5e , CTRL_C1_CSI_SDP = 0x5f , CTRL_C1_CSI_PAD_0x60 = 0x60 , CTRL_C1_CSI_PAD_0x61 = 0x61 , CTRL_C1_CSI_PAD_0x62 = 0x62 , CTRL_C1_CSI_ORN = 0x63 , CTRL_C1_CSI_PAD_0x64 = 0x64 , CTRL_C1_CSI_CFS = 0x65 , CTRL_C1_CSI_PAD_0x66 = 0x66 , CTRL_C1_CSI_PAD_0x67 = 0x67 , CTRL_C1_CSI_PAD_0x68 = 0x68 , CTRL_C1_CSI_PAD_0x69 = 0x69 , CTRL_C1_CSI_PAD_0x6a = 0x6a , CTRL_C1_CSI_PAD_0x6b = 0x6b , CTRL_C1_CSI_PAD_0x6c = 0x6c , CTRL_C1_CSI_PAD_0x6d = 0x6d , CTRL_C1_CSI_RCS = 0x6e }

enum	CC_ControlCodes_TableJump_e { CC_CTRLCODE_SET_UNKNOWN = 0x00 , CC_CTRLCODE_SET_C0 = CTRL_C0_APB , CC_CTRLCODE_SET_C1 = CTRL_C1_BKF }

enum	CC_Color_CMLA_t { SET_CMLA0_BLACK , SET_CMLA1_FULL_INTENSITY_RED , SET_CMLA2_FULL_INTENSITY_GREEN , SET_CMLA3_FULL_INTENSITY_YELLOW , SET_CMLA4_FULL_INTENSITY_BLUE , SET_CMLA5_FULL_INTENSITY_MAGNETA , SET_CMLA6_FULL_INTENSITY_CYAN , SET_CMLA7_FULL_INTENSITY_WHITE , SET_CMLA8_TRANSPARENT , SET_CMLA9_HALF_INTENSITY_RED , SET_CMLA10_HALF_INTENSITY_GREEN , SET_CMLA11_HALF_INTENSITY_YELLOW , SET_CMLA12_HALF_INTENSITY_BLUE , SET_CMLA13_HALF_INTENSITY_MAGNETA , SET_CMLA14_HALF_INTENSITY_CYAN , SET_CMLA15_HALF_INTENSITY_WHITE , SET_CMLA_t_eMax }

Funções
const char *	caption_closed_controls_get_name (const uint8_t code)

bool	csi_arg_Pn_load (CC_ControlCodes_CallbackData_t *d)

bool	caption_closed_controls_is_table (const uint8_t byte, enum CC_ControlCodes_TableJump_e table)

bool	caption_closed_controls_load (enum CC_ControlCodes_TableJump_e table, const uint8_t argv, const uint16_t argc, uint16_t pos, CaptionClosed_t *caption)

Callbacks dos comandos C0
Todas recebem os dados do comando e retornam TRUE quando o comando foi executado. Retornam FALSE para comandos não suportados em closed caption ou com parâmetros inválidos.
bool	callback_controls_c0_APB (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_APF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_APD (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_APU (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_CS (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_APR (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_LS1 (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_LS0 (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_PAPF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_CAN (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_SS2 (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_ESC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_APS (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_SS3 (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_RS (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c0_US (const CC_ControlCodes_CallbackData_t *d)

Callbacks dos comandos C1
bool	callback_controls_c1_BKF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_RDF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_GRF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_YLF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_BLF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_MGF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CNF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_WHF (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_SSZ (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_MSZ (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_NSZ (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_SZX (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_COL (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_FLC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CDC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_POL (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_WMM (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_MAC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_HLC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_RPC (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_SPL (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_STL (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_TIM (const CC_ControlCodes_CallbackData_t *d)

Callbacks dos subcomandos CSI
callback_controls_c1_CSI_load() trata o CSI (0x9b): localiza o byte final, lê os parâmetros com csi_arg_Pn_load() e chama a callback do subcomando. Nos subcomandos, CC_ControlCodes_CallbackData_t::data aponta para os parâmetros (struct csi_arg_Pn).
bool	callback_controls_c1_CSI_load (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_swf (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_ssm (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_shs (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_svs (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_orn (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_cfs (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_rcs (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_sdf (const CC_ControlCodes_CallbackData_t *d)

bool	callback_controls_c1_CSI_sdp (const CC_ControlCodes_CallbackData_t *d)

Descrição detalhada

Comandos de controle C0, C1 e CSI do texto da legenda.

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

O texto da legenda mistura caracteres e comandos de controle (ARIB STD-B24, Volume 1, 7.2; ABNT NBR 15606-1; ARIB TR-B14, 6.5):

C0 (0x08 a 0x1f): posição do cursor (APR, APS...), limpar a tela (CS), caracteres especiais (SS3) etc.;
C1 (0x80 a 0x9f): cores (BKF ~ WHF, COL), tamanho dos caracteres (SSZ, MSZ, NSZ, SZX) etc.;
CSI (0x9b): sequências estendidas, no formato CSI P1 ; P2 ; ... 0x20 F, onde os parâmetros são números decimais em ASCII e o byte final F identifica o comando (SWF, SDF, SDP...).

Cada comando tem uma callback callback_controls_*, chamada por caption_closed_controls_load(). Ela lê os parâmetros, atualiza o CaptionClosed_t e avança a posição de leitura além dos parâmetros. Quando a callback retorna TRUE, o hook de controles é chamado (veja caption-hooking.h).

Comandos que não devem ser usados em closed caption (apenas em superimpose) retornam FALSE, mas ainda assim pulam os seus parâmetros, para que não sejam tratados como texto.

Exemplo de texto de legenda (TV Globo):

* 00000000  0c 9b 37 20 53 9b 31 37  36 3b 39 39 20 5f 9b 36 |..7.S.176;99._.6|
* 00000010  30 38 3b 33 39 30 20 56  9b 33 36 3b 33 36 20 57 |08;390.V.36;36.W|
* 00000020  9b 32 20 58 9b 31 36 20  59 9b 38 20 6e 88 1c 4c |.2.X.16.Y.8.n..L|
* 00000030  40 87 90 50 5b 4d 41 54  45 55 53 5d 20 4f 20 43 |@..P[MATEUS].O.C|
* 00000040  41 4c 49 58 54 4f 20 56  41 49 0d 52 45 53 4f 4c |ALIXTO.VAI.RESOL|
* 00000050  56 45 52 20 4f 20 50 52  4f 42 4c 45 4d 41 20 44 |VER.O.PROBLEMA.D|
* 00000060  4f 20 43 41 52 52 4f 2c  0d 4f 20 4d 41 49 53 20 |O.CARRO,.O.MAIS.|
* 00000070  52 c1 50 49 44 4f 20 50  4f 53 53 cd 56 45 4c 2e |R.PIDO.POSS.VEL.|
*
* 0c              CS: limpa a tela
* 9b 37 20 53     CSI SWF(7): formato 960x540 horizontal
* 9b ... 20 5f    CSI SDP(176;99): posição da área de exibição
* 9b ... 20 56    CSI SDF(608;390): tamanho da área de exibição
* 9b ... 20 57    CSI SSM(36;36): tamanho dos caracteres
* 9b 32 20 58     CSI SHS(2): espaçamento horizontal
* 9b 31 36 20 59  CSI SVS(16): espaçamento vertical
* 9b 38 20 6e     CSI RCS(8): cor de raster transparente
* 88              SSZ: caracteres pequenos
* 1c 4c 40        APS(12, 0): cursor na linha 12, coluna 0
* 87              WHF: texto branco
* 90 50           COL: fundo preto
* 0d              APR: nova linha
* c1, cd          'Á' e 'Í' em ISO-8859-15
*

Definição no arquivo caption-closed-controls.h.

Definições e macros

◆ DEBUG_CAPTION_CLOSED_CONTROLCODE

#define DEBUG_CAPTION_CLOSED_CONTROLCODE

Inclui o campo CaptionClosedControls_t::code_name nas tabelas de comandos, usado por caption_closed_controls_get_name() nas mensagens de depuração.

Definição na linha 68 do arquivo caption-closed-controls.h.

◆ CAPTION_CTRL_SET

#define CAPTION_CTRL_SET	(	code,
		callback
	)	{ code, callback, #code }

Monta uma entrada das tabelas de comandos.

Definição na linha 101 do arquivo caption-closed-controls.h.

◆ CTRL_C0_NULL

#define CTRL_C0_NULL 0x00

NUL: ignorado.

Definição na linha 122 do arquivo caption-closed-controls.h.

◆ CTRL_C0_BELL

#define CTRL_C0_BELL 0x07

BEL: ignorado em closed caption.

Definição na linha 123 do arquivo caption-closed-controls.h.

◆ CTRL_CSI_FB

#define CTRL_CSI_FB 0x20

Byte intermediário (0x20) que antecede o byte final do CSI.

Definição na linha 315 do arquivo caption-closed-controls.h.

◆ CTRL_CSI_IB

#define CTRL_CSI_IB 0x3b

Separador de parâmetros do CSI (';').

Definição na linha 316 do arquivo caption-closed-controls.h.

◆ CTRL_CSI_MAX_Pn_ARGS

#define CTRL_CSI_MAX_Pn_ARGS 5

Máximo de parâmetros lidos de um CSI.

Definição na linha 318 do arquivo caption-closed-controls.h.

◆ CTRL_CSI_MAX_Pn_FIELDS

#define CTRL_CSI_MAX_Pn_FIELDS (5+1)

Máximo de dígitos de um parâmetro, mais o '\0' (até "65535").

Definição na linha 319 do arquivo caption-closed-controls.h.

Definições dos tipos

◆ CaptionClosed_CtrlCode_t

typedef uint8_t CaptionClosed_CtrlCode_t

Código de um comando de controle (C0, C1 ou CSI).

Definição na linha 71 do arquivo caption-closed-controls.h.

Enumerações

◆ CaptionClosed_CtrlCodes_C0

enum CaptionClosed_CtrlCodes_C0

Comandos C0 (ARIB TR-B14, Tabela 3.11; ARIB STD-B24, Tabela 7-14).

Os valores sem uso são preenchidos com PAD, para que o código menos 0x08 seja o índice direto na tabela de callbacks.

Enumeradores
CTRL_C0_APB	Active Position Backward: volta o cursor.
CTRL_C0_APF	Active Position Forward: avança o cursor.
CTRL_C0_APD	Active Position Down: desce o cursor.
CTRL_C0_APU	Active Position Up: sobe o cursor.
CTRL_C0_CS	Clear Screen: limpa a tela.
CTRL_C0_APR	Active Position Return: início da próxima linha.
CTRL_C0_LS1	Locking Shift 1.
CTRL_C0_LS0	Locking Shift 0.
CTRL_C0_PAD_0x01	Sem uso (0x10).
CTRL_C0_PAD_0x02	Sem uso (0x11).
CTRL_C0_PAD_0x03	Sem uso (0x12).
CTRL_C0_PAD_0x04	Sem uso (0x13).
CTRL_C0_PAD_0x05	Sem uso (0x14).
CTRL_C0_PAD_0x06	Sem uso (0x15).
CTRL_C0_PAPF	Parameterized Active Position Forward: avança P1 posições.
CTRL_C0_PAD_0x17	Sem uso.
CTRL_C0_CAN	Cancel.
CTRL_C0_SS2	Single Shift 2: o próximo caractere vem do conjunto G2.
CTRL_C0_PAD_0x1a	Sem uso.
CTRL_C0_ESC	Escape: designação de conjuntos de caracteres (ISO/IEC 2022).
CTRL_C0_APS	Active Position Set: posiciona o cursor em P1 (linha) e P2 (coluna).
CTRL_C0_SS3	Single Shift 3: o próximo caractere vem do conjunto G3 (ex: ♪).
CTRL_C0_RS	Record Separator.
CTRL_C0_US	Unit Separator.

Definição na linha 121 do arquivo caption-closed-controls.h.

◆ CaptionClosed_CtrlCodes_C1

enum CaptionClosed_CtrlCodes_C1

Comandos C1 (ARIB TR-B14, Tabela 3.11; ARIB STD-B24, Tabela 7-15).

Os valores sem uso são preenchidos com PAD, para que o código menos 0x80 seja o índice direto na tabela de callbacks.

Enumeradores
CTRL_C1_BKF	Black Foreground: texto preto.
CTRL_C1_RDF	Red Foreground: texto vermelho.
CTRL_C1_GRF	Green Foreground: texto verde.
CTRL_C1_YLF	Yellow Foreground: texto amarelo.
CTRL_C1_BLF	Blue Foreground: texto azul.
CTRL_C1_MGF	Magenta Foreground: texto magenta.
CTRL_C1_CNF	Cyan Foreground: texto ciano.
CTRL_C1_WHF	White Foreground: texto branco.
CTRL_C1_SSZ	Small Size: caracteres pequenos.
CTRL_C1_MSZ	Middle Size: caracteres médios.
CTRL_C1_NSZ	Normal Size: caracteres normais.
CTRL_C1_SZX	Character Size Controls: tamanho especificado por P1.
CTRL_C1_PAD_0x8c	Sem uso.
CTRL_C1_PAD_0x8d	Sem uso.
CTRL_C1_PAD_0x8e	Sem uso.
CTRL_C1_PAD_0x8f	Sem uso.
CTRL_C1_COL	Colour Controls: cor do texto/fundo (P1, ou 0x20 P2 para a paleta).
CTRL_C1_FLC	Flashing Control: pisca.
CTRL_C1_CDC	Conceal Display Controls.
CTRL_C1_POL	Pattern Polarity Controls.
CTRL_C1_WMM	Writing Mode Modification.
CTRL_C1_MAC	Macro Command.
CTRL_C1_PAD_0x96	Sem uso.
CTRL_C1_HLC	Highlighting Character Block: contorno.
CTRL_C1_RPC	Repeat Character: repete o próximo caractere.
CTRL_C1_SPL	Stop Lining: fim do sublinhado.
CTRL_C1_STL	Start Lining: início do sublinhado.
CTRL_C1_CSI	Control Sequence Introducer: sequência estendida, veja CaptionClosed_CtrlCodes_C1_CSI.
CTRL_C1_PAD_0x9c	Sem uso.
CTRL_C1_TIM	Time Controls: espera/temporização.
CTRL_C1_PAD_0x9e	Sem uso.
CTRL_C1_PAD_0x9f	Sem uso.

Definição na linha 184 do arquivo caption-closed-controls.h.

◆ CaptionClosed_CtrlCodes_C1_CSI

enum CaptionClosed_CtrlCodes_C1_CSI

Subcomandos do CSI: o byte final F da sequência CSI P1 ; P2 ; ... 0x20 F (ARIB STD-B24, Tabela 7-17).

Os valores sem uso são preenchidos com PAD, para que o código menos 0x53 seja o índice direto na tabela de callbacks.

Enumeradores
CTRL_C1_CSI_SWF	Set Writing Format: formato de exibição.
CTRL_C1_CSI_PAD_0x54	Sem uso.
CTRL_C1_CSI_PAD_0x55	Sem uso.
CTRL_C1_CSI_SDF	Set Display Format: tamanho da área de exibição.
CTRL_C1_CSI_SSM	Character Composition Dot Designation: tamanho dos caracteres.
CTRL_C1_CSI_SHS	Set Horizontal Spacing: espaçamento horizontal.
CTRL_C1_CSI_SVS	Set Vertical Spacing: espaçamento vertical.
CTRL_C1_CSI_PAD_0x5a	Sem uso.
CTRL_C1_CSI_PAD_0x5b	Sem uso.
CTRL_C1_CSI_PAD_0x5c	Sem uso.
CTRL_C1_CSI_PAD_0x5d	Sem uso.
CTRL_C1_CSI_PAD_0x5e	Sem uso.
CTRL_C1_CSI_SDP	Set Display Position: posição da área de exibição.
CTRL_C1_CSI_PAD_0x60	Sem uso.
CTRL_C1_CSI_PAD_0x61	Sem uso.
CTRL_C1_CSI_PAD_0x62	Sem uso.
CTRL_C1_CSI_ORN	Ornament Control: contorno/sombra dos caracteres.
CTRL_C1_CSI_PAD_0x64	Sem uso.
CTRL_C1_CSI_CFS	Character Font Set: fonte.
CTRL_C1_CSI_PAD_0x66	Sem uso.
CTRL_C1_CSI_PAD_0x67	Sem uso.
CTRL_C1_CSI_PAD_0x68	Sem uso.
CTRL_C1_CSI_PAD_0x69	Sem uso.
CTRL_C1_CSI_PAD_0x6a	Sem uso.
CTRL_C1_CSI_PAD_0x6b	Sem uso.
CTRL_C1_CSI_PAD_0x6c	Sem uso.
CTRL_C1_CSI_PAD_0x6d	Sem uso.
CTRL_C1_CSI_RCS	Raster Colour Command: cor de raster.

Definição na linha 262 do arquivo caption-closed-controls.h.

◆ CC_ControlCodes_TableJump_e

enum CC_ControlCodes_TableJump_e

Início de cada tabela de comandos: o código menos este valor é o índice na tabela de callbacks.

Enumeradores
CC_CTRLCODE_SET_UNKNOWN	Não é um comando.
CC_CTRLCODE_SET_C0	Tabela C0 (0x08 a 0x1f).
CC_CTRLCODE_SET_C1	Tabela C1 (0x80 a 0x9f).

Definição na linha 346 do arquivo caption-closed-controls.h.

◆ CC_Color_CMLA_t

enum CC_Color_CMLA_t

Cores da paleta CMLA (Colour Map Lower Address), usada pelos comandos de cor (BKF ~ WHF e COL).

Enumeradores
SET_CMLA0_BLACK	Preto.
SET_CMLA1_FULL_INTENSITY_RED	Vermelho.
SET_CMLA2_FULL_INTENSITY_GREEN	Verde.
SET_CMLA3_FULL_INTENSITY_YELLOW	Amarelo.
SET_CMLA4_FULL_INTENSITY_BLUE	Azul.
SET_CMLA5_FULL_INTENSITY_MAGNETA	Magenta.
SET_CMLA6_FULL_INTENSITY_CYAN	Ciano.
SET_CMLA7_FULL_INTENSITY_WHITE	Branco.
SET_CMLA8_TRANSPARENT	Transparente.
SET_CMLA9_HALF_INTENSITY_RED	Vermelho, meia intensidade.
SET_CMLA10_HALF_INTENSITY_GREEN	Verde, meia intensidade.
SET_CMLA11_HALF_INTENSITY_YELLOW	Amarelo, meia intensidade.
SET_CMLA12_HALF_INTENSITY_BLUE	Azul, meia intensidade.
SET_CMLA13_HALF_INTENSITY_MAGNETA	Magenta, meia intensidade.
SET_CMLA14_HALF_INTENSITY_CYAN	Ciano, meia intensidade.
SET_CMLA15_HALF_INTENSITY_WHITE	Branco, meia intensidade.
SET_CMLA_t_eMax	Quantidade de cores.

Definição na linha 386 do arquivo caption-closed-controls.h.

Funções

◆ caption_closed_controls_get_name()

const char * caption_closed_controls_get_name ( const uint8_t code )

Nome de um comando, para mensagens de depuração.

Parâmetros

code	Código C0, C1 ou do subcomando CSI.

Retorna: O nome (ex: "CTRL_C0_APS"), ou "UNKNOWN".

◆ callback_controls_c0_APB()

bool callback_controls_c0_APB ( const CC_ControlCodes_CallbackData_t * d )

APB: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_APF()

bool callback_controls_c0_APF ( const CC_ControlCodes_CallbackData_t * d )

APF: aceito, sem efeito no estado.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_APD()

bool callback_controls_c0_APD ( const CC_ControlCodes_CallbackData_t * d )

APD: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_APU()

bool callback_controls_c0_APU ( const CC_ControlCodes_CallbackData_t * d )

APU: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_CS()

bool callback_controls_c0_CS ( const CC_ControlCodes_CallbackData_t * d )

CS: liga CaptionClosed_t::need_clear.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_APR()

bool callback_controls_c0_APR ( const CC_ControlCodes_CallbackData_t * d )

APR: aceito; o hook de controles recebe a quebra de linha.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_LS1()

bool callback_controls_c0_LS1 ( const CC_ControlCodes_CallbackData_t * d )

LS1: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_LS0()

bool callback_controls_c0_LS0 ( const CC_ControlCodes_CallbackData_t * d )

LS0: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_PAPF()

bool callback_controls_c0_PAPF ( const CC_ControlCodes_CallbackData_t * d )

PAPF: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_CAN()

bool callback_controls_c0_CAN ( const CC_ControlCodes_CallbackData_t * d )

CAN: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_SS2()

bool callback_controls_c0_SS2 ( const CC_ControlCodes_CallbackData_t * d )

SS2: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_ESC()

bool callback_controls_c0_ESC ( const CC_ControlCodes_CallbackData_t * d )

ESC: não suportado; pula a sequência inteira.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_APS()

bool callback_controls_c0_APS ( const CC_ControlCodes_CallbackData_t * d )

APS: atualiza CaptionClosed_t::APS (2 parâmetros).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_SS3()

bool callback_controls_c0_SS3 ( const CC_ControlCodes_CallbackData_t * d )

SS3: entrega o caractere G3 em UTF-8 ao hook de texto.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_RS()

bool callback_controls_c0_RS ( const CC_ControlCodes_CallbackData_t * d )

RS: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c0_US()

bool callback_controls_c0_US ( const CC_ControlCodes_CallbackData_t * d )

US: aceito, sem efeito no estado.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_BKF()

bool callback_controls_c1_BKF ( const CC_ControlCodes_CallbackData_t * d )

BKF: texto preto.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_RDF()

bool callback_controls_c1_RDF ( const CC_ControlCodes_CallbackData_t * d )

RDF: texto vermelho.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_GRF()

bool callback_controls_c1_GRF ( const CC_ControlCodes_CallbackData_t * d )

GRF: texto verde.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_YLF()

bool callback_controls_c1_YLF ( const CC_ControlCodes_CallbackData_t * d )

YLF: texto amarelo.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_BLF()

bool callback_controls_c1_BLF ( const CC_ControlCodes_CallbackData_t * d )

BLF: texto azul.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_MGF()

bool callback_controls_c1_MGF ( const CC_ControlCodes_CallbackData_t * d )

MGF: texto magenta.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CNF()

bool callback_controls_c1_CNF ( const CC_ControlCodes_CallbackData_t * d )

CNF: texto ciano.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_WHF()

bool callback_controls_c1_WHF ( const CC_ControlCodes_CallbackData_t * d )

WHF: texto branco.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_SSZ()

bool callback_controls_c1_SSZ ( const CC_ControlCodes_CallbackData_t * d )

SSZ: caracteres pequenos.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_MSZ()

bool callback_controls_c1_MSZ ( const CC_ControlCodes_CallbackData_t * d )

MSZ: caracteres médios.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_NSZ()

bool callback_controls_c1_NSZ ( const CC_ControlCodes_CallbackData_t * d )

NSZ: caracteres normais.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_SZX()

bool callback_controls_c1_SZX ( const CC_ControlCodes_CallbackData_t * d )

SZX: guarda P1 em CaptionClosed_t::char_size_custom.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_COL()

bool callback_controls_c1_COL ( const CC_ControlCodes_CallbackData_t * d )

COL: cor do texto, do fundo ou de meia intensidade.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_FLC()

bool callback_controls_c1_FLC ( const CC_ControlCodes_CallbackData_t * d )

FLC: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CDC()

bool callback_controls_c1_CDC ( const CC_ControlCodes_CallbackData_t * d )

CDC: não suportado; pula 1 ou 2 parâmetros.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_POL()

bool callback_controls_c1_POL ( const CC_ControlCodes_CallbackData_t * d )

POL: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_WMM()

bool callback_controls_c1_WMM ( const CC_ControlCodes_CallbackData_t * d )

WMM: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_MAC()

bool callback_controls_c1_MAC ( const CC_ControlCodes_CallbackData_t * d )

MAC: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_HLC()

bool callback_controls_c1_HLC ( const CC_ControlCodes_CallbackData_t * d )

HLC: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_RPC()

bool callback_controls_c1_RPC ( const CC_ControlCodes_CallbackData_t * d )

RPC: não suportado; pula 1 parâmetro.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_SPL()

bool callback_controls_c1_SPL ( const CC_ControlCodes_CallbackData_t * d )

SPL: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_STL()

bool callback_controls_c1_STL ( const CC_ControlCodes_CallbackData_t * d )

STL: não suportado em closed caption.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_TIM()

bool callback_controls_c1_TIM ( const CC_ControlCodes_CallbackData_t * d )

TIME: não suportado; pula 2 parâmetros.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_load()

bool callback_controls_c1_CSI_load ( const CC_ControlCodes_CallbackData_t * d )

CSI: lê a sequência e despacha o subcomando.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_swf()

bool callback_controls_c1_CSI_swf ( const CC_ControlCodes_CallbackData_t * d )

SWF: formato, caracteres por linha e linhas.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_ssm()

bool callback_controls_c1_CSI_ssm ( const CC_ControlCodes_CallbackData_t * d )

SSM: tamanho dos caracteres (P1 x P2).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_shs()

bool callback_controls_c1_CSI_shs ( const CC_ControlCodes_CallbackData_t * d )

SHS: espaçamento horizontal (P1).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_svs()

bool callback_controls_c1_CSI_svs ( const CC_ControlCodes_CallbackData_t * d )

SVS: espaçamento vertical (P1).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_orn()

bool callback_controls_c1_CSI_orn ( const CC_ControlCodes_CallbackData_t * d )

ORN: não implementado.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_cfs()

bool callback_controls_c1_CSI_cfs ( const CC_ControlCodes_CallbackData_t * d )

CFS: não implementado.

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_rcs()

bool callback_controls_c1_CSI_rcs ( const CC_ControlCodes_CallbackData_t * d )

RCS: cor de raster (P1, de 0 a 15).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_sdf()

bool callback_controls_c1_CSI_sdf ( const CC_ControlCodes_CallbackData_t * d )

SDF: tamanho da área de exibição (P1 x P2).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ callback_controls_c1_CSI_sdp()

bool callback_controls_c1_CSI_sdp ( const CC_ControlCodes_CallbackData_t * d )

SDP: posição da área de exibição (P1, P2).

Parâmetros

d	Dados do comando (veja CC_ControlCodes_CallbackData_t).

Retorna: TRUE se o comando foi executado.

◆ csi_arg_Pn_load()

bool csi_arg_Pn_load ( CC_ControlCodes_CallbackData_t * d )

Lê os parâmetros decimais de uma sequência CSI, separados por ';'.

Parâmetros

d	`d->argv` aponta para o primeiro parâmetro, `d->argc` é a quantidade de bytes de parâmetros e `d->data` aponta para a struct csi_arg_Pn que recebe os valores.

Retorna: TRUE se ao menos um parâmetro foi lido.

◆ caption_closed_controls_is_table()

bool caption_closed_controls_is_table	(	const uint8_t *	byte,
		enum CC_ControlCodes_TableJump_e *	table
	)

Verifica se um byte é um comando C0 ou C1.

Parâmetros

byte	Byte do texto da legenda.
table	Recebe a tabela do comando, ou CC_CTRLCODE_SET_UNKNOWN.

Retorna: TRUE se o byte é um comando.

◆ caption_closed_controls_load()

bool caption_closed_controls_load	(	enum CC_ControlCodes_TableJump_e	table,
		const uint8_t *	argv,
		const uint16_t	argc,
		uint16_t *	pos,
		CaptionClosed_t *	caption
	)

Executa o comando C0/C1 em argv[*pos].

Chama a callback do comando, que avança pos além dos parâmetros, e, se ela retornar TRUE, chama o hook de controles.

Parâmetros

table	Tabela do comando, obtida por caption_closed_controls_is_table().
argv	Buffer do texto da legenda.
argc	Quantidade de bytes disponíveis a partir de `pos`.
pos	Posição do comando em `argv`; ao retornar, aponta para o último byte consumido pelo comando.
caption	Estado da legenda.

Retorna: TRUE se o comando foi executado.

Estruturas de Dados

Definições e Macros

Definições de Tipos

Enumerações

Funções

Descrição detalhada

Definições e macros

◆ DEBUG_CAPTION_CLOSED_CONTROLCODE

◆ CAPTION_CTRL_SET

◆ CTRL_C0_NULL

◆ CTRL_C0_BELL

◆ CTRL_CSI_FB

◆ CTRL_CSI_IB

◆ CTRL_CSI_MAX_Pn_ARGS

◆ CTRL_CSI_MAX_Pn_FIELDS

Definições dos tipos

◆ CaptionClosed_CtrlCode_t

Enumerações

◆ CaptionClosed_CtrlCodes_C0

◆ CaptionClosed_CtrlCodes_C1

◆ CaptionClosed_CtrlCodes_C1_CSI

◆ CC_ControlCodes_TableJump_e

◆ CC_Color_CMLA_t

Funções

◆ caption_closed_controls_get_name()

◆ callback_controls_c0_APB()

◆ callback_controls_c0_APF()

◆ callback_controls_c0_APD()

◆ callback_controls_c0_APU()

◆ callback_controls_c0_CS()

◆ callback_controls_c0_APR()

◆ callback_controls_c0_LS1()

◆ callback_controls_c0_LS0()

◆ callback_controls_c0_PAPF()

◆ callback_controls_c0_CAN()

◆ callback_controls_c0_SS2()

◆ callback_controls_c0_ESC()

◆ callback_controls_c0_APS()

◆ callback_controls_c0_SS3()

◆ callback_controls_c0_RS()

◆ callback_controls_c0_US()

◆ callback_controls_c1_BKF()

◆ callback_controls_c1_RDF()

◆ callback_controls_c1_GRF()

◆ callback_controls_c1_YLF()

◆ callback_controls_c1_BLF()

◆ callback_controls_c1_MGF()

◆ callback_controls_c1_CNF()

◆ callback_controls_c1_WHF()

◆ callback_controls_c1_SSZ()

◆ callback_controls_c1_MSZ()

◆ callback_controls_c1_NSZ()

◆ callback_controls_c1_SZX()

◆ callback_controls_c1_COL()

◆ callback_controls_c1_FLC()

◆ callback_controls_c1_CDC()

◆ callback_controls_c1_POL()

◆ callback_controls_c1_WMM()

◆ callback_controls_c1_MAC()

◆ callback_controls_c1_HLC()

◆ callback_controls_c1_RPC()

◆ callback_controls_c1_SPL()

◆ callback_controls_c1_STL()

◆ callback_controls_c1_TIM()

◆ callback_controls_c1_CSI_load()

◆ callback_controls_c1_CSI_swf()

◆ callback_controls_c1_CSI_ssm()

◆ callback_controls_c1_CSI_shs()

◆ callback_controls_c1_CSI_svs()

◆ callback_controls_c1_CSI_orn()

◆ callback_controls_c1_CSI_cfs()

◆ callback_controls_c1_CSI_rcs()

◆ callback_controls_c1_CSI_sdf()

◆ callback_controls_c1_CSI_sdp()

◆ csi_arg_Pn_load()

◆ caption_closed_controls_is_table()

◆ caption_closed_controls_load()