Referência do Arquivo caption-closed.h

Interpretação do texto da legenda (closed caption) e do seu estado: cores, tamanho dos caracteres, posição e formato de exibição. Mais...

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

Gráfico de dependência de inclusões para caption-closed.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_Dimension_t
struct	CC_Color_t
struct	CaptionClosed_t
struct	CaptionClosed_t::APS

Definições e Macros
#define	CC_Dimension_is_equal(dimen1, dimen2)    ((dimen1).width == (dimen2).width && (dimen1).height == (dimen2).height)
#define	CC_Color_is_equal(color1, color2)

Enumerações
enum	CC_CharacterSize_t {   CC_CharacterSize_Small = 0x01 , CC_CharacterSize_Middle = 0x02 , CC_CharacterSize_Standard = 0x03 , CC_CharacterSize_t_eMax = 0x04 ,   CC_CharacterSize_Custom = 0x05 , CC_CharacterSize_UNKNOWN = 0xff }
enum	CC_Format_t {   CC_Format_HOR_STAN_DENSITY = 0x00 , CC_Format_VER_STAN_DENSITY = 0x01 , CC_Format_HOR_HIGH_DENSITY = 0x02 , CC_Format_VER_HIGH_DENSITY = 0x03 ,   CC_Format_HOR_WEST_LANG = 0x04 , CC_Format_HOR_1920x1080 = 0x05 , CC_Format_VER_1920x1080 = 0x06 , CC_Format_HOR_960x540 = 0x07 ,   CC_Format_VER_960x540 = 0x08 , CC_Format_HOR_720x480 = 0x09 , CC_Format_VER_720x480 = 0x0a , CC_Format_HOR_1280x720 = 0x0b ,   CC_Format_VER_1280x720 = 0x0c , CC_Format_t_eMax = 0x0d }
enum	CC_Rcs_t {   CC_Rcs_BLACK = 0 , CC_Rcs_FULL_INTENSITY_RED = 1 , CC_Rcs_FULL_INTENSITY_GREEN = 2 , CC_Rcs_FULL_INTENSITY_YELLOW = 3 ,   CC_Rcs_FULL_INTENSITY_BLUE = 4 , CC_Rcs_FULL_INTENSITY_MAGNETA = 5 , CC_Rcs_FULL_INTENSITY_CYAN = 6 , CC_Rcs_FULL_INTENSITY_WHITE = 7 ,   CC_Rcs_TRANSPARENT = 8 , Cc_Rcs_HALF_INTENSITY_RED = 9 , Cc_Rcs_HALF_INTENSITY_GREEN = 10 , Cc_Rcs_HALF_INTENSITY_YELLOW = 11 ,   Cc_Rcs_HALF_INTENSITY_BLUE = 12 , Cc_Rcs_HALF_INTENSITY_MAGNETA = 13 , Cc_Rcs_HALF_INTENSITY_CYAN = 14 , Cc_Rcs_HALF_INTENSITY_WHITE = 15 ,   CC_Rcs_t_eMax = 16 }

Funções
bool	caption_closed_run (const CaptionManagement_t *m, CaptionClosed_t *cc)
uint8_t	char_latin9_to_utf8 (const char *const from, char *const to, uint8_t to_len)

Descrição detalhada

Interpretação do texto da legenda (closed caption) e do seu estado: cores, tamanho dos caracteres, posição e formato de exibição.

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

caption_closed_run() percorre o statement body (texto + comandos de controle) e:

• converte cada caractere ISO-8859-15 para UTF-8 e o entrega ao hook de texto (veja caption-hooking.h);
• executa cada comando C0/C1 (veja caption-closed-controls.h), atualiza o CaptionClosed_t e chama o hook de controles.

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

Definições e macros

CC_Dimension_is_equal

#define CC_Dimension_is_equal	(		dimen1,
			dimen2
	)		((dimen1).width == (dimen2).width && (dimen1).height == (dimen2).height)

Compara duas CC_Dimension_t.

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

CC_Color_is_equal

#define CC_Color_is_equal	(		color1,
			color2
	)

Valor:

  ((color1).r == (color2).r && (color1).g == (color2).g && \
   (color1).b == (color2).b && (color1).a == (color2).a)

Compara duas CC_Color_t.

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

Enumerações

CC_CharacterSize_t

enum CC_CharacterSize_t

Tamanho dos caracteres (comandos SSZ, MSZ, NSZ e SZX).

Enumeradores
CC_CharacterSize_Small	Pequeno (SSZ).
CC_CharacterSize_Middle	Médio (MSZ).
CC_CharacterSize_Standard	Normal (NSZ).
CC_CharacterSize_t_eMax	Limite dos valores acima.
CC_CharacterSize_Custom	Tamanho especificado pelo SZX; o valor está em CaptionClosed_t::char_size_custom.
CC_CharacterSize_UNKNOWN	Desconhecido.

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

CC_Format_t

enum CC_Format_t

Formato de exibição (ARIB STD-B24, Tabela 9-7; comando CSI SWF).

Enumeradores
CC_Format_HOR_STAN_DENSITY	Horizontal, densidade padrão.
CC_Format_VER_STAN_DENSITY	Vertical, densidade padrão.
CC_Format_HOR_HIGH_DENSITY	Horizontal, alta densidade.
CC_Format_VER_HIGH_DENSITY	Vertical, alta densidade.
CC_Format_HOR_WEST_LANG	Horizontal, idiomas ocidentais.
CC_Format_HOR_1920x1080	Horizontal, 1920x1080.
CC_Format_VER_1920x1080	Vertical, 1920x1080.
CC_Format_HOR_960x540	Horizontal, 960x540.
CC_Format_VER_960x540	Vertical, 960x540.
CC_Format_HOR_720x480	Horizontal, 720x480.
CC_Format_VER_720x480	Vertical, 720x480.
CC_Format_HOR_1280x720	Horizontal, 1280x720.
CC_Format_VER_1280x720	Vertical, 1280x720.
CC_Format_t_eMax	Quantidade de formatos.

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

CC_Rcs_t

enum CC_Rcs_t

Cor de raster (comando CSI RCS, Raster Colour Command).

Enumeradores
CC_Rcs_BLACK	Preto.
CC_Rcs_FULL_INTENSITY_RED	Vermelho.
CC_Rcs_FULL_INTENSITY_GREEN	Verde.
CC_Rcs_FULL_INTENSITY_YELLOW	Amarelo.
CC_Rcs_FULL_INTENSITY_BLUE	Azul.
CC_Rcs_FULL_INTENSITY_MAGNETA	Magenta.
CC_Rcs_FULL_INTENSITY_CYAN	Ciano.
CC_Rcs_FULL_INTENSITY_WHITE	Branco.
CC_Rcs_TRANSPARENT	Transparente.
Cc_Rcs_HALF_INTENSITY_RED	Vermelho, meia intensidade.
Cc_Rcs_HALF_INTENSITY_GREEN	Verde, meia intensidade.
Cc_Rcs_HALF_INTENSITY_YELLOW	Amarelo, meia intensidade.
Cc_Rcs_HALF_INTENSITY_BLUE	Azul, meia intensidade.
Cc_Rcs_HALF_INTENSITY_MAGNETA	Magenta, meia intensidade.
Cc_Rcs_HALF_INTENSITY_CYAN	Ciano, meia intensidade.
Cc_Rcs_HALF_INTENSITY_WHITE	Branco, meia intensidade.
CC_Rcs_t_eMax	Quantidade de cores.

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

Funções

caption_closed_run()

bool caption_closed_run	(	const CaptionManagement_t *	m,
		CaptionClosed_t *	cc
	)

Processa o texto da legenda.

Percorre o statement body de m, entregando cada caractere (em UTF-8) ao hook de texto e executando cada comando de controle (que atualiza cc e chama o hook de controles). Veja caption-hooking.h.

Caracteres fora do ISO-8859-15 e comandos não suportados em closed caption são ignorados, junto com os seus parâmetros.

Parâmetros

m	Conteúdo do tipo CAPTION_HANDLER_TYPE_STATEMENT_BODY, lido por caption_management_load().
cc	Estado da legenda, mantido entre as chamadas.

Retorna

TRUE.

char_latin9_to_utf8()

uint8_t char_latin9_to_utf8	(	const char *const	from,
		char *const	to,
		uint8_t	to_len
	)

Converte um caractere ISO-8859-15 (Latin-9) para UTF-8.

Parâmetros

from	Caractere de origem (1 byte).
to	Recebe o caractere em UTF-8, terminado em '\0'.
to_len	Tamanho de to; deve ser 4 ou mais.

Retorna

A quantidade de bytes escritos em to, sem o '\0' (1 a 3).