Versão 1.2 do protocolo
Introdução
O mimoLive utiliza a tecnologia Quartz Composer da Apple e os seus documentos para as camadas. Uma vez que o mimoLive precisa de indicar ao documento Quartz Composer alguns parâmetros ambientais, bem como ler os resultados dos mesmos, concebemos um protocolo que tem de seguir para tirar partido de todas as funcionalidades que o mimoLive tem para oferecer. De seguida, encontrará toda a informação técnica sobre este protocolo.
Se quiser saber como criar camadas personalizadas com o Quartz Composer, leia "Criar camadas de cliente para o mimoLive":pt:pro:custom_layer:creating_custom_layers.
Propriedades
Pode editar o protocolo no Quartz Composer selecionando Editor ⇢ Editar informação (⌥⌘I)
| Nome | Necessário | Tipo | Valor da amostra |
|---|---|---|---|
| categoria | Cordas | ||
| direitos de autor | Cordas | © 2016 MySoftwareCompany | |
| descrição | Cordas | Reproduz uma entrada de ecrã inteiro | |
| nome | sim | Cordas | Leitor de ecrã completo |
| DEPRECADO tv_Categorias | Cordas | Fundo,Ecrã completo | |
| tv_Debug | Booleano | ||
| tv_FileData_ nome de entrada- | Dados | (ficheiro XML importado) | |
| tv_FileName_ nome de entrada- | Cordas | Classificações.xml | |
| tv_HelpURL | Cordas | ||
| tv_HiddenInputKeys | Conjunto de cadeias de caracteres | ||
| tv_InputLabel_ nome de entrada- | Cordas | Entrada de vídeo | |
| tv_LayerIdentifier | sim | Cordas | com.example.layer.mylayer |
| tv_LayerVersion | sim | Número (real) | 1.01 |
| tv_LayerPreview | Dados | (ficheiro PNG importado) | |
| tv_LayerProtocolVersion | sim | Número (real) | 1 |
| tv_SortKey | Cordas | ||
| tv_StepSize_ nome de entrada- | Número (real) | 0.1 | |
| DEPRECADO tv_Tagline | Cordas | Reproduz uma entrada de ecrã inteiro | |
| tv_UseAudioFromSource | Cordas | tvIn_VideoSourceA | |
| tv_UnitLabel_ nome de entrada- | Cordas |
categoria
A categoria é normalmente definida pelo compositor Quartz e não é necessária para camadas mimoLive. Para categorias do mimoLive veja tv_Categories.
direitos de autor
O copyright é normalmente definido pelo compositor Quartz e não é necessário para as camadas mimoLive.
descrição
Padrão do Quartz Composer - mantenha-o com cerca de 3 linhas para que caiba bem na pré-visualização.
nome
O nome é apresentado dentro do mimoLive. Utilize um nome curto e único para encontrar rapidamente a sua camada.
protocolos
Este conjunto é normalmente definido pelo compositor Quartz e não é necessário para as camadas mimoLive.
tv_Categorias
DEPRECADO
As categorias eram utilizadas para agrupar e filtrar as camadas. Atualmente, são ignoradas, mas podem ser activadas novamente. Utilize uma lista separada por vírgulas das seguintes categorias predefinidas ou defina as suas próprias categorias.
- "Audio" - Camadas que oferecem a possibilidade de utilizar uma fonte de áudio
- "Overlay" - Camadas que sobrepõem dados ou imagens: Lower Thirds, Título, Logótipo, ...
- "Fullscreen" - Camadas que, pelo menos através das definições predefinidas, oferecem um ecrã completo - por exemplo, Animações, Vídeo simples, Mapa meteorológico
- "Backdrop" - Camadas que funcionam como pano de fundo para outras coisas no topo.
- "Text" - Camadas que oferecem algum tipo de apresentação de texto, por exemplo. Créditos, Lower Thirds, Título
- "Dados" - Camadas que exibem dados, por exemplo, cotações de acções, resultados de basquetebol, etc.
- "Imagem" - Camadas que fornecem um meio de exibição usando uma entrada de imagem estática
- "Multivídeo" - Camadas que combinam pelo menos duas fontes, adicionando pelo menos uma fonte além das camadas abaixo ou usando duas ou mais fontes.
- "3D" - Camadas que fornecem algum tipo de posicionamento 3D de elementos, por exemplo, apresentador
- "Segmento" - Camadas que fornecem uma animação cronometrada para separar segmentos, por exemplo, Digital Upgrade Beitrag
- "Efeito" - Camadas que fornecem alguns efeitos de sobreposição, por exemplo, lupa, holofote, zoom...
- "Demonstração" - Camadas que se destinam principalmente a demonstrar capacidades em vez de fornecer uma funcionalidade útil genérica, por exemplo, mapa meteorológico, que apenas mostra a imagem do tempo.
- "Consumer" - Camadas que usam a imagem compositedlayers, por exemplo, Video Switcher, Zoom, Presenter
- "Generator" - Camadas que fornecem algum tipo de saída gerada, por exemplo, animações
- "Debug" - Camadas úteis para depuração que não são visíveis no produto final
tv_Debug
Dizer à aplicação que esta composição só deve ser utilizada num ambiente de depuração.
tv_FileData_
Uma bolha de dados que será criada e escrita no documento para uma entrada de ficheiro na criação da camada. Isso funciona para arquivos de texto que serão fornecidos em um _TypeFilePath ou arquivos .mov para entradas de imagem. Consulte tv_FileName_ .
tv_FileName_
O nome de ficheiro correspondente ao tv_FileData_ . Necessário se existir uma entrada tv_FileData_*.
tv_HelpURL
Esta cadeia pode armazenar um URL com informações úteis sobre como utilizar esta camada. O mimoLive apresentará um botão "?" na janela popover de informação para cada camada. Se o utilizador clicar neste botão, o URL será aberto pelo navegador de Internet predefinido do sistema.
tv_HiddenInputKeys
Nesta matriz, a composição contém chaves de entrada que devem ser ocultadas da interface do utilizador.
tv_InputLabel_
Pode ser utilizado para fornecer uma etiqueta de nome alternativo para a chave de entrada dada na vista de parâmetros. Também são possíveis cadeias de caracteres vazias para nenhum rótulo. Funciona como o tv_hide_ouput , por exemplo, o nome da entrada do protocolo deve estar completo (por exemplo, "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifier
Para identificação, a Boinx enviou composições e classificou diferentes versões. Deve ser único. Recomenda-se um domínio com anotação inversa. Exemplo: com.mysoftware.layers.videofullscreen
tv_LayerVersion
Para fazer corresponder diferentes versões de uma composição num documento/aplicação. Os números das versões principais indicam incompatibilidade e não correspondem a outras versões principais (por exemplo, é necessário aumentar a versão principal se o nome das chaves de entrada for alterado). Os números das versões secundárias devem ser compatíveis com as versões superiores e podem ser aumentados em 0,001 por cada iteração. Por exemplo, deve garantir-se que o carregamento de definições de uma camada 1.0 para uma 1.013 tem de ter exatamente o mesmo aspeto, o que significa que as novas chaves, se existirem, têm de ter um valor predefinido que não as mostre ou que seja igual ao aspeto da versão anterior.
tv_LayerPreview
Dados de imagem a serem utilizados para pré-visualizar uma camada dentro da lista de camadas. Isto pode proporcionar uma melhor experiência do que a pré-visualização rápida predefinida. A imagem de pré-visualização deve ter 256 × 256 pixéis.
tv_LayerProtocolVersion
Para futura compatibilidade com versões anteriores, se o mimoLive alterar significativamente o protocolo. Atualmente tem de ser definido para 1.
tv_SortKey
Define a ordenação das camadas no mimoLive. Assim, é possível ordenar os filtros pela probabilidade de utilização. Atualmente, é utilizado um esquema de 2 letras maiúsculas, por exemplo, "BM", "DE", "DM", etc. NOTA: Atualmente esta funcionalidade não é utilizada mas será no futuro.
tv_StepSize_
Pode ser utilizado para fornecer um StepSize personalizado para as jog wheels - o movimento de um pixel do rato corresponde então a esta quantidade de mudança (também +/- clique).
tv_Tagline
DEPRECATED
Cadeia de uma linha que será apresentada no popover de informações no repositório de camadas.
tv_UseAudioFromSource
Atualmente, o mimoLive só pode mostrar um controlo de áudio na interface do utilizador. Esta propriedade indica-lhe qual a tecla de entrada que deve ser controlada. Preencha a tecla de entrada correspondente completa. (Para compatibilidade com versões anteriores este campo também aceita "A", "B" ou "C" que é traduzido para a chave tvIn_VideoSourceAImage, tvIn_VideoSourceBImage ou tvIn_VideoSourceCImage. Se não for fornecido, o mimoLive assume que não será utilizado qualquer áudio com esta camada.
tv_UnitLabel_
Pode ser utilizado para fornecer uma etiqueta de unidade, por exemplo, "pt" para a tecla de entrada dada na vista de parâmetros. O mais curto possível. Ajuda a comunicar o significado da entrada. As entradas de unidades Boinx receberão automaticamente etiquetas "px".
Entradas
| Nome | Tipo |
|---|---|
| tvIn_AccountTwitterConsumerKey | Cordas |
| tvIn_AccountTwitterConsumerSecret | Cordas |
| tvIn_AccountTwitterTokenKey | Cordas |
| tvIn_AccountTwitterTokenSecret | Cordas |
| tvIn_CompositedLayersImage | Imagem |
| tvIn_FrameCount | Índice |
| tvIn_FrameDuration | Número |
| tvIn_CompositedLayersImage | Imagem |
| tvIn_InTransitionDirection | Índice Direção de transição Direção |
| tvIn_InTransitionDuration | Número |
| tvIn_InTransitionType | Índice Tipo de transição Tipo |
| tvIn_KeyboardModifierAlt | Booleano |
| tvIn_KeyboardModifierCommand | Booleano |
| tvIn_KeyboardModifierControl | Booleano |
| tvIn_KeyboardModifierFunction | Booleano |
| tvIn_KeyboardModifierShift | Booleano |
| tvIn_Obscured | Booleano |
| tvIn_OnAir | Booleano |
| tvIn_OSVersion | Cordas |
| tvIn_OutTransitionDirection | Índice Direção de transição Direção |
| tvIn_OutTransitionDuration | Número |
| tvIn_OutTransitionType | Índice Tipo de transição Tipo |
| tvIn_PreviewMode | Booleano |
| tvIn_Reset | Booleano (Sinal) |
| tvIn_RuntimeIdentifier | Cordas |
| tvIn_Shared_ | qualquer tipo de valor |
| tvIn_ShowDuration | Número |
| tvIn_ShowTimer | Número |
| tvIn_Switch | Booleano (Sinal) |
| tvIn_TransitionDirection | Índice Direção de transição Direção |
| tvIn_TransitionDuration | Número |
| tvIn_TransitionType | Índice Tipo de transição Tipo |
| tvIn_UISnapColor | Cor |
| tvIn_VideoSourceA B C D | Imagem |
tvIn_AccountTwitterConsumerKey
tvIn_AccountTwitterConsumerSecret
tvIn_AccountTwitterTokenKey
tvIn_AccountTwitterTokenSecret
Estas quatro entradas AccountTwitter são utilizadas para alimentar a composição com os dados de início de sessão das preferências de conta do Twitter do mimoLive. Os valores são utilizados com o Patch JSON e o Patch OAuth para ler os dados do serviço Twitter.
tvIn_CompositedLayersImage
Se esta entrada estiver presente numa composição e houver conteúdo das camadas inferiores, o resultado do desenho das camadas inferiores será introduzido nesta entrada.
tvIn_FrameCount
Esta entrada irá obter a contagem total de fotogramas renderizados depois de iniciar o mimoLive. Se os fotogramas foram perdidos porque a carga de renderização é demasiado elevada, a contagem de fotogramas irá saltar sobre esses números de fotogramas perdidos.
tvIn_FrameDuration
A duração do fotograma é o intervalo de tempo entre cada renderização em segundos.
tvIn_InTransitionDirection
Uma direção na qual a direção de transição será executada.
tvIn_InTransitionDuration
Um valor em segundos que o tvIn_InTransitionType será executado.
tvIn_InTransitionType
Se for útil para uma camada que permite ao utilizador escolher o tipo de transição em curso. Ver também Tipo de tipo de transição.
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
Estes campos de entrada booleanos serão definidos como verdadeiros quando o utilizador premir a tecla modificadora correspondente no teclado. Esta funcionalidade é utilizada principalmente para a funcionalidade de manipulação direta. Consulte as linhas do Apple Human User Guide para saber que tecla modificadora deve ser utilizada para que função na interface do utilizador.
tvIn_Obscured
Esta entrada é definida como verdadeira se a camada não precisar de renderizar qualquer saída porque uma camada acima irá obscurecê-la de qualquer forma, desenhando o ecrã inteiro. Isto pode ser usado para evitar o desenho pesado por camadas que não são visíveis mas estão definidas para serem activas. (Por exemplo, no caso da camada Twitter, a camada ainda é chamada mesmo quando obscurecida por outra camada acima e tem a oportunidade de manter a ligação à Internet para o serviço Twitter).
tvIn_OnAir
Esta entrada começa com um valor de "true" (verdadeiro). Quando a entrada passa a "falso", a composição deve efetuar qualquer transição de saída e, em seguida, definir a sua saída Concluído quando esta estiver concluída. A composição será então desactivada. Pode acontecer que a aplicação desligue uma camada sem esperar pelo sinalizador done.
tvIn_OSVersion
Esta entrada de cadeia será definida para a versão atual do OS X (por exemplo, "Versão 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Um valor em segundos do tvIn_OutTransitionType será executado. Consulte também Direção da transição.
tvIn_OutTransitionDuration
Um valor em segundos do tvIn_OutTransitionType será executado.
tvIn_OutTransitionType
Se for útil para uma camada que permite ao utilizador escolher o tipo de transição em curso. Ver também Tipo de tipo de transição.
tvIn_PreviewMode
Pode ser utilizado para informar a composição de que está no modo de pré-visualização.
tvIn_Reset
Útil para repor a lógica da composição. Este sinalizador é definido quando uma camada é comutada de desligada para ativa ou quando alterna entre definições e não está disponível uma entrada tvIn_Switch.
tvIn_RuntimeIdentifier
Ajuda as camadas a comunicar entre a pré-visualização e a instância em direto. Definido dinamicamente pelo mimoLive.
tvIn_Shared_
Consulte Compartilhando valores entre camadas Valores entre camadas.
tvIn_ShowDuration
Se o utilizador tiver preenchido a duração do espetáculo nas Definições do espetáculo, esta entrada terá o valor em segundos.
tvIn_ShowTimer
O temporizador de apresentação reflectirá a apresentação do temporizador de apresentação do documento mimoLive em segundos.
tvIn_Switch
Este sinalizador é definido em vez de tvIn_Reset]] quando uma camada é comutada de uma definição para outra sem desativar a camada. Caso esta entrada não exista, o [[#tvIn_Reset quando uma camada é comutada de uma definição para outra sem desativar a camada. Caso esta entrada não exista, o [[#tvIn_Reset é definido em vez disso para manter a compatibilidade com camadas mais antigas.
tvIn_TransitionDirection
Uma direção na qual a Direção de Transição será executada.
tvIn_TransitionDuration
Um valor em segundos do tvIn_InTransitionType será executado.
tvIn_TransitionType
Se for útil para uma camada que permite ao utilizador escolher o tipo de transição em curso. Ver também Tipo de tipo de transição.
tvIn_UISnapColor
Para manter a consistência da interface do utilizador, o mimoLive fornece uma "cor de encaixe" para desenhar as linhas de orientação na pré-visualização sempre que a interface do utilizador estiver a encaixar num determinado valor (por exemplo, mantenha premida a tecla "shift" enquanto roda uma camada do Placer no modo de visualização personalizado, então as linhas de orientação serão desenhadas nessa cor quando o ângulo de rotação encaixar em 0, 45 ou 90 graus)
tvIn_VideoSource
Uma camada pode ter até 8 entradas de fontes de vídeo dinâmicas: "A", "B", "C" e assim por diante. Serão representadas por uma zona de queda se o utilizador arrastar uma fonte de vídeo do repositório de fontes para a pilha de camadas. //Nota: Para efeitos de compatibilidade com versões anteriores, a extensão "Image" nestas entradas é ignorada.
Opções de entrada
Teclas de entrada correspondentes
Se estiver presente uma tecla de entrada de vídeo, as teclas de entrada seguintes também serão preenchidas com as informações correspondentes:
(por exemplo, "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| Chave | Tipo | Descrição |
|---|---|---|
| Ganho de áudio | Número | TBD |
| AudioLevel0 | Número | Nível do canal de áudio esquerdo em db após o controlo de ganho |
| AudioLevel1 | Número | Nível do canal de áudio direito em db após o controlo de ganho |
| AudioLevel0Raw | Número | Nível do canal de áudio esquerdo em db antes do controlo de ganho |
| AudioLevel1Raw | Número | Nível do canal de áudio direito em db antes do controlo de ganho |
| AudioPanning | Número | TBD |
| AudioVolume | Número | TBD |
| Dados | Estrutura | Um dicionário de metadados da fonte. Atualmente, as chaves implementadas são: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" |
| Nome | Cordas | Nome da fonte de imagem associada. Pode ser utilizado para mostrar o seu nome na pré-visualização ou para calcular o nome predefinido para a variante de camada. Veja tvOut_SettingName . |
| Tempo restante | Número | Em segundos. Será fornecido para fontes de filme. -1 se a fonte de filme estiver em loop (ou qualquer outra fonte). |
| TallyState | Índice | Tally Estado da fonte ligada, ver Estados de contagem Estados |
| Tipo | Índice | Valor de tipo de fonte tipo |
Agrupamento de entradas
O agrupamento é fornecido na interface do utilizador - para isso, o prefixo da entrada é relevante. A sintaxe funciona como tvGroup___. Tenha em atenção o sublinhado duplo _ _ a seguir ao nome do grupo como separador do nome da entrada.
Um grupo especial é definido para entradas que devem estar sempre ocultas: tvGroup_Hidden_Inputs__ Este grupo pode ser tornado visível mudando o mimoLive para o modo de depuração no debug|Debug Preferences|Debug Preferences. Algumas camadas estão usando esses campos ocultos para se comunicar entre a "instância de Pré-visualização" e a "instância ao vivo" (por exemplo, a camada de Comutador de Vídeo está dizendo à instância de Pré-visualização qual fonte de vídeo está atualmente ao vivo).
Ocultar entradas dinamicamente
Cada entrada de protocolo será oculta na IU se a saída tvOut_hide_ estiver definida como "true". Este valor é observado pela aplicação e pode ser alterado dinamicamente. Note que precisa de utilizar o nome completo da entrada, incluindo "tvIn" (por exemplo, utilize a saída tvOut_hide_tvIn_Text_TypeMultiline para a entrada tvIn_Text_TypeMultiline).
Saídas
| Nome | Tipo |
|---|---|
| tvOut_Cursor | Cordas |
| tvOut_Done | Booleano (Sinal) |
| tvOut_hide_ | Booleano |
| tvOut_Opaque | Booleano |
| tvOut_SettingName | Cordas |
| tvOut_Share_ | qualquer tipo |
| tvOut_TimeRemaining | Número |
| tvOut_UseCompositedLayersImage | Booleano |
| tvOut_TallyState | Índice de Estados de contagem Estados |
| tvSet_ | Tipo de entrada a definir |
| tvSetSignal_ | Booleano |
| tvSetAudioVolume_ | Número |
| tvSetAudioVolumeSignal_ | Booleano |
tvOut_Cursor
Esta saída especifica o aspeto do cursor do rato se o ponteiro do rato estiver sobre a pré-visualização ou a vista de saída do programa. Por favor consulte Apples NSCursor Class documentation) para valores válidos. Os cursores de rato adicionais fornecidos pelo mimoLive são "menos" e "mais".
Remover o postfixo "_Cursor" ou "Cursor" das constantes NSCursor da Apple (por exemplo, usar "openHand" para obter um cursor de rato de mão aberta).
tvOut_Done
Utilizado para dizer à camada seguinte que esta camada está concluída. Consulte tvIn_OnAir para obter documentação.
tvOut_hide_
Pode ser utilizado para ocultar dinamicamente os valores de entrada na vista de parâmetros. Consulte Ocultar entradas dinamicamente .
tvOut_Opaque
Utilizado para indicar à aplicação que as camadas abaixo desta não têm de ser desenhadas. Predefinição "false". Este valor sobrepõe-se a qualquer fonte ligada que contenha alfa.
tvOut_SettingName
As composições podem sugerir um nome útil para uma definição com base nalgumas entradas.
tvOut_Share_
Consulte Compartilhando valores entre camadas .
tvOut_TimeRemaining
Permite que a aplicação apresente uma contagem decrescente de um temporizador grande (por exemplo, 5 segundos até um filme terminar). Atualmente, utiliza-se "-1" para indicar que não há informação sobre o tempo restante ou "-2" se for um filme em loop.
tvOut_UseCompositedLayersImage
Utilizado para otimizar o desempenho quando utiliza camadas abaixo com transições, etc. Diz à aplicação que a camada necessita atualmente da entrada da imagem das camadas compostas. O mimoLive irá colocar as camadas abaixo da imagem composta no próximo ciclo de renderização. Se "tvOut_UseCompositedLayersImage" não estiver presente, o mimoLive assume que as camadas abaixo da imagem devem ser sempre colocadas. Apenas otimização de desenho, todos os meios de comunicação serão colocados no entanto. Apenas usado se tvIn_CompositedLayersImage estiver presente.
tvOut_TallyState
Esta camada de saída pode substituir o estado de contagem automático da fonte que está atualmente ligada a essa entrada. Isto é útil para transições ou, se a fonte não for utilizada para a saída, o estado de contagem pode ser desativado (por exemplo, o Video Switcher utiliza 3 câmaras, mas apenas mostra uma de cada vez, pelo que necessita de definir o estado de contagem para fontes não utilizadas como "TVTallyStateOff"). Consulte Tally States para obter a lista de estados de tally.
tvSet_
No mimoLive, uma camada ou filtro pode manipular os seus próprios parâmetros. Isto é principalmente para implementar a funcionalidade de manipulação direta na pré-visualização da variante da camada (por exemplo, se o utilizador arrastar o Relógio Analógico na pré-visualização, a camada diz ao mimoLive quais as teclas de entrada que devem ser alteradas para que valor. No entanto, esta funcionalidade também é utilizada para transferir dados em tempo real da instância de saída do programa para a instância de pré-visualização e vice-versa (por exemplo, na camada Comutador de Vídeo, a instância de saída do programa diz à instância de pré-visualização qual a fonte de vídeo que está atualmente em tempo real e a instância de pré-visualização pode dizer à instância de saída do programa qual a fonte de vídeo que o utilizador seleccionou no ecrã).
Para utilizar esta funcionalidade, são necessárias duas saídas que correspondem ao campo de entrada que se pretende manipular: Em 'tvSet_', o novo valor que se pretende definir é emitido e, com 'tvSetSignal_', é sinalizado quando o valor é válido e deve ser armazenado.
tvSetSignal_
Consulte tvSet_ .
tvSetAudioVolume_
Esta saída controla o volume da sua fonte de áudio associada (ou do áudio de uma fonte de vídeo). Os valores válidos são 0=silencioso a 1=completo. A composição tem de definir o "tvSetAudioVolumeSignal_" correspondente sempre que quiser alterar o nível do volume de áudio. Por exemplo, isto é útil se a camada tiver uma transição de desvanecimento e quiser também desvanecer o áudio.
tvSetAudioVolumeSignal_
Consulte tvSetAudioVolume_ .
Partilha de valores entre camadas
Uma camada pode enviar dados para outras camadas na pilha de camadas que estão acima dela própria. Os dados são armazenados pelo mimolive através da sua chave de partilha até ao próximo ciclo de renderização. Se uma camada for utilizada várias vezes (ou a mesma chave de partilha for utilizada em camadas diferentes), os dados são substituídos pela camada acima. Para definir estes dados de partilha, utilize uma saída "tvOut_Share_". Pode armazenar qualquer tipo de dados do QuartzComposer, mas recomenda-se uma estrutura porque só precisa de uma saída para vários valores. No lado da camada recetora, é necessária uma entrada "tvIn_Shared_" correspondente com o mesmo tipo de dados. Tenha em atenção que a camada recetora tem de estar no topo da camada emissora na pilha de camadas.
A partilha de valores é útil se necessitar dos mesmos dados em várias camadas (por exemplo, o nome dos adversários da Casa e do Convidado num jogo).
Definições de tipo (também conhecidas como convenções de nomeação)
| Chave | Tipo | Descrição |
|---|---|---|
| *_TipoAudio | Imagem | Este é um caso muito especial: Um _TypeAudio só pode atribuir fontes que contenham áudio (por exemplo, fontes de filme, fontes de vídeo ou fontes apenas de áudio). A camada terá controlo sobre esta fonte (no futuro), bem como sobre os valores do volume de áudio para os canais esquerdo e direito, através das entradas "_TypeAudioAudioLevel0" e "_TypeAudioAudioLevel1". |
| *_TypeBoinxX | Número | Um número introduzido em coordenadas Boinx X - por exemplo, -1 é o primeiro pixel, 1 é o último pixel das dimensões actuais do ecrã. será apresentado ao utilizador em pixels |
| *_TipoBoinxY | Número | Um número introduzido em coordenadas Boinx Y - por exemplo, -1 é o pixel inferior, 1 é o pixel superior das dimensões actuais do ecrã. será apresentado ao utilizador em pixels |
| *_TypeDirectoryPath | Cordas | O resultado é um botão "Escolher..." na interface do utilizador, talvez apresentando também um controlo de caminho |
| *_TipoDuração | Número | Tempo em segundos - será apresentado em minutos:segundos e pode ter uma IU personalizada |
| *_TypeFilePath | Cordas | O resultado é um botão "Escolher..." na interface do utilizador, talvez apresentando também um controlo de caminho |
| *_TypeFontBoinxSize | Cordas | Tamanho da letra em coordenadas Boinx Y (por exemplo, 2 é a altura do ecrã inteiro), ver nota abaixo |
| *_TypeFontColor | Cor | Entrada de cor regular para especificar uma cor de texto, ver nota abaixo |
| *_TypeFontName | Cordas | Isto resultará num seletor de tipos de letra, ver nota abaixo |
| *_TipoMultilinha | Cordas | Um campo de texto de várias linhas que permite a introdução de retorno |
| *_TypePassword | Cordas | Apresenta uma caixa de texto da palavra-passe. Importante: A própria palavra-passe é guardada em texto simples e pode ser lida no documento! |
| *_TypeSignal | Booleano | Para um sinal pulsado de um único fotograma, utilize os patches Pulse ou Watcher |
Os campos _TypeFontName, _TypeFontBoinxSize e _TypeFontColor são combinados num elemento UI de seleção de tipo de letra na vista de parâmetros de camadas se tiverem a mesma etiqueta de base.
Modelos de filtros
Estas entradas e propriedades são específicas se estiver a criar uma Composição de Quartzo para utilizar como um filtro de imagem no mimoLive. A maioria das definições anteriores também se aplica aos filtros.
Entradas de filtro
Os seguintes campos de entrada são exigidos pelo Quartz Composer para uma composição de filtro:
| Nome | Tipo | Descrição |
|---|---|---|
| _protocolInput_PreviewMode | Bool | Pode ser utilizado para informar a composição de que está no modo de pré-visualização |
| _protocolInput_X | Número | É sempre 0. |
| _protocolInput_Y | Número | É sempre 0. |
Propriedades do filtro
As seguintes propriedades são definidas pelo mimoLive. tv_FilterIdentifier e tv_FilterVersion são necessárias para tratar o filtro e o seu caminho de atualização com versões mais recentes:
| Nome | Tipo | Valor da amostra | Descrição |
|---|---|---|---|
| tv_FilterIdentifier | Cordas | com.boinx.mimoLive.layer.placer | Para identificação, a Boinx enviou composições e classificou diferentes versões |
| tv_FilterVersion | Número (duplo) | 1 | Para fazer corresponder diferentes versões de uma composição num documento/aplicação. Os números das versões principais indicam incompatibilidade e não correspondem a outras versões principais. Os números de versões secundárias devem ser compatíveis com versões superiores e aumentar 0,001 em cada iteração. Por exemplo, deve garantir-se que o carregamento de definições de uma camada 1.0 para uma 1.013 tem de ter exatamente o mesmo aspeto, o que significa que as novas teclas, se existirem, têm de ter uma predefinição que não as mostre ou que seja igual ao aspeto da versão anterior. |
| tv_FilterOutputIsOpaque | BOOL | Determina se a saída de um filtro é opaca. A predefinição é NÃO |
Enumerações
O tipo Índice do Quartz Composer permite índices nomeados. Podem ser editados no Editor do Quartz Composer, adicionando um divisor de entrada no modo de índice.
Tipo de fonte
A fonte será um dos seguintes valores
- 0 - Imagem
- 1 - Filme, um filme terá um tempo restante
- 2 - Câmara, também pode ser uma composição
Direção de transição
Pode definir as suas próprias direcções. As camadas enviadas estão a utilizar os seguintes valores.
- Nenhum
- Esquerda
- Direita
- Cima
- Baixo
Tipo de transição
Pode definir os seus próprios tipos de transição. Eis alguns exemplos de valores úteis.
- Dissolver
- Limpar
Estados de contagem
Existem vários estados Tally para fontes de vídeo definidas que serão representadas na interface do utilizador e na aplicação complementar Tally Light.
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram
