Protocolo versión 1.2
Introducción
mimoLive utiliza la tecnología Quartz Composer de Apple y sus documentos para las capas. Dado que mimoLive necesita indicar al documento Quartz Composer algunos parámetros del entorno, así como leer los resultados de los mismos, hemos diseñado un protocolo que debes seguir para poder aprovechar todas las funciones que mimoLive te ofrece. A continuación, encontrarás toda la información técnica sobre este protocolo.
Si desea aprender a crear capas personalizadas con Quartz Composer, lea "Creación de capas de cliente para mimoLive":es:pro:custom_layer:creating_custom_layers.
Propiedades
Puede editar el protocolo en Quartz Composer seleccionando Editor ⇢ Editar información (⌥⌘I).
Nombre | Requerido | Tipo | Valor de la muestra |
---|---|---|---|
categoría | Cadena | ||
copyright | Cadena | © 2016 MySoftwareCompany | |
descripción | Cadena | Reproduce una entrada a pantalla completa | |
nombre | sí | Cadena | Reproductor a pantalla completa |
DEPREDADO tv_Categorías | Cadena | Fondo,Pantalla completa | |
tv_Debug | Booleano | ||
tv_FileData_ Nombre de entrada. | Datos | (archivo XML importado) | |
tv_FileName_ Nombre de entrada. | Cadena | Clasificación.xml | |
tv_HelpURL | Cadena | ||
tv_HiddenInputKeys | Matriz de cadenas | ||
tv_InputLabel_ Nombre de entrada. | Cadena | Entrada de vídeo | |
tv_LayerIdentifier | sí | Cadena | com.example.layer.mylayer |
tv_LayerVersion | sí | Número (real) | 1.01 |
tv_LayerPreview | Datos | (archivo PNG importado) | |
tv_LayerProtocolVersion | sí | Número (real) | 1 |
tv_SortKey | Cadena | ||
tv_tamaño_paso Nombre de entrada. | Número (real) | 0.1 | |
DEPREDADO tv_Tagline | Cadena | Reproduce una entrada a pantalla completa | |
tv_UseAudioFromSource | Cadena | tvIn_VideoSourceA | |
tv_UnitLabel_ Nombre de entrada. | Cadena |
categoría
La categoría suele establecerla el compositor Quartz y no es necesaria para las capas mimoLive. Para las categorías mimoLive consulte tv_Categorías en su lugar.
copyright
El copyright suele establecerlo el compositor de Quartz y no es necesario para las capas mimoLive.
descripción
Quartz Composer estándar - manténgalo alrededor de 3 líneas de largo para que quepa bien en la vista previa.
nombre
El nombre se muestra dentro de mimoLive. Utilice un nombre corto y único para encontrar su capa rápidamente.
protocolos
Esta matriz suele ser establecida por el compositor Quartz y no es necesaria para las capas mimoLive.
tv_Categorías
DEPRENDIDOS
Las categorías se utilizaban para agrupar y filtrar las capas. Actualmente, se ignoran, pero pueden volver a activarse. Utilice una lista separada por comas de las siguientes categorías predefinidas o defina las suyas propias.
- "Audio" - Capas que ofrecen la posibilidad de utilizar una fuente de audio
- "Superposición" - Capas que superponen datos o imágenes: Lower Thirds, Título, Logotipo, ...
- "Pantalla completa" - Capas que al menos a través de la configuración predeterminada proporcionan una pantalla completa - por ejemplo, Animaciones, Vídeo único, Mapa meteorológico
- "Telón de fondo" - Capas que funcionan como telón de fondo/fondo para otras cosas en la parte superior.
- "Texto" - Capas que proporcionan algún tipo de visualización de texto, por ejemplo. Créditos, Lower Thirds, Encabezamiento
- "Datos" - Capas que muestran Datos, por ejemplo, teletipos de bolsa, resultados de baloncesto, etc.
- "Imagen" - Capas que proporcionan un medio de visualización utilizando una entrada de imagen estática
- "Multivídeo" - Capas que combinan al menos dos fuentes, ya sea añadiendo al menos una fuente además de las capas inferiores o utilizando dos o más fuentes.
- "3D" - Capas que proporcionan algún tipo de posicionamiento 3d de los elementos, por ejemplo, Presentador
- "Segmento" - Capas que proporcionan una animación temporizada para separar segmentos, por ejemplo, Actualización digital Beitrag
- "Efecto" - Capas que proporcionan algunos efectos de superposición, por ejemplo, Lupa, Spotlight, Zoom...
- "Demo" - Capas que están destinadas principalmente a demostrar capacidades en lugar de proporcionar una funcionalidad útil genérica, por ejemplo, Mapa del tiempo, que sólo muestra el tiempo.p. ej. Mapa meteorológico, que sólo muestra un mapa de Alemania.
- "Consumidor" - Capas que utilizan la imagen de capa compuesta, p. ej. Conmutador de vídeo, Zoom, Presentador
- "Generador" - Capas que proporcionan algún tipo de salida generada, p. ej. Animaciones
- "Depuración" - Capas útiles para la depuración que no son visibles en el producto final.
tv_Debug
Indicar a la aplicación que esta composición sólo debe utilizarse en un entorno de depuración.
tv_FileData_
Un blob de datos que se creará y escribirá en el documento para una entrada de archivo en la creación de capas. Esto funciona para archivos de texto que se proporcionarán en un _TypeFilePath o archivos .mov para entradas de imagen. Véase tv_FileName_ .
tv_FileName_
El nombre de archivo correspondiente al tv_FileData_ . Obligatorio si existe una entrada tv_FileData_*.
tv_HelpURL
Esta cadena puede almacenar una URL con información útil sobre cómo utilizar esta capa. mimoLive presentará un botón "?" en la ventana emergente de información para cada capa. Si el usuario hace clic en este botón, la URL se abrirá con el navegador de Internet predeterminado del sistema.
tv_HiddenInputKeys
En esta matriz, la composición contiene claves de entrada que deben ocultarse de la interfaz de usuario.
tv_InputLabel_
Puede utilizarse para proporcionar una etiqueta de nombre alternativa para la clave de entrada dada en la vista de parámetros. También son posibles cadenas vacías para ninguna etiqueta. Funciona como tv_hide_ouput , es decir, el nombre de entrada del protocolo debe estar completo (por ejemplo, "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifier
Para su identificación, Boinx envía composiciones y clasifica las diferentes versiones. Debe ser único. Se recomienda un dominio con anotación inversa. Ejemplo: com.mysoftware.layers.videofullscreen
tv_LayerVersion
Para emparejar diferentes versiones de una composición en un documento/aplicación. Los números de versión mayor denotan incompatibilidad y no coinciden con otras versiones mayores (por ejemplo, es necesario aumentar la versión mayor si cambia el nombre de las claves de entrada). Los números de versión menores deben ser compatibles al alza y pueden incrementarse en 0,001 por cada iteración. Por ejemplo, debe garantizarse que la carga de ajustes de una capa 1.0 para una 1.013 debe tener exactamente el mismo aspecto, lo que significa que las nuevas claves, si están presentes, deben tener un valor por defecto que no las muestre o que iguale el aspecto de la versión anterior.
tv_LayerPreview
Datos de imagen que se utilizarán para previsualizar una capa dentro de la lista de capas. Esto puede ofrecer una experiencia mejor que la vista previa rápida predeterminada. La imagen de vista previa debe ser de 256 × 256 píxeles.
tv_LayerProtocolVersion
Para compatibilidad futura si mimoLive cambia el protocolo de forma significativa. Actualmente debe establecerse en 1.
tv_SortKey
Define la ordenación de las capas en mimoLive. Así puede ordenar los filtros por la probabilidad de uso. Actualmente, se utiliza un esquema de 2 letras mayúsculas, por ejemplo, "BM", "DE", "DM", etc. NOTA: Actualmente esta función no se utiliza, pero se utilizará en el futuro.
tv_tamaño_paso
Se puede utilizar para proporcionar un StepSize personalizado para las jog wheels - el movimiento de un píxel del ratón corresponde entonces a esta cantidad de cambio (también +/- click).
tv_Tagline
DEPRECATED
Cadena de una línea que se mostrará en la ventana emergente de información en el repositorio de capas.
tv_UseAudioFromSource
Actualmente, mimoLive sólo puede mostrar un control de audio en la interfaz de usuario. Esta propiedad le indica qué tecla de entrada es la que se va a controlar. Rellene la tecla de entrada correspondiente completa. (Por compatibilidad con versiones anteriores, este campo también acepta "A", "B" o "C", que se traducen a las teclas tvIn_VideoSourceAImage, tvIn_VideoSourceBImage o tvIn_VideoSourceCImage. Si no se proporciona, mimoLive asume que no se utilizará audio con esta capa.
tv_UnitLabel_
Puede utilizarse para proporcionar una etiqueta de unidad, por ejemplo "pt" para la tecla de entrada dada en la vista de parámetros. Sea lo más breve posible. Ayuda a comunicar el significado de la entrada. Las entradas de unidad Boinx recibirán etiquetas automáticas "px".
Entradas
Nombre | Tipo |
---|---|
tvIn_AccountTwitterConsumerKey | Cadena |
tvIn_AccountTwitterConsumerSecret | Cadena |
tvIn_AccountTwitterTokenKey | Cadena |
tvIn_AccountTwitterTokenSecret | Cadena |
tvIn_CompositedLayersImage | Imagen |
tvIn_FrameCount | Índice |
tvIn_FrameDuration | Número |
tvIn_CompositedLayersImage | Imagen |
tvIn_InTransitionDirection | Índice Dirección de transición Dirección |
tvIn_InTransitionDuration | Número |
tvIn_InTransitionType | Índice Tipo de transición Tipo |
tvIn_KeyboardModifierAlt | Booleano |
tvIn_KeyboardModifierCommand | Booleano |
tvIn_KeyboardModifierControl | Booleano |
tvIn_KeyboardModifierFunction | Booleano |
tvIn_KeyboardModifierShift | Booleano |
tvIn_Obscured | Booleano |
tvIn_OnAir | Booleano |
tvIn_OSVersion | Cadena |
tvIn_OutTransitionDirection | Índice Dirección de transición Dirección |
tvIn_OutTransitionDuration | Número |
tvIn_OutTransitionType | Índice Tipo de transición Tipo |
tvIn_PreviewMode | Booleano |
tvIn_Reset | Booleano (Señal) |
tvIn_RuntimeIdentifier | Cadena |
tvIn_Shared_ | cualquier tipo de valor |
tvIn_ShowDuration | Número |
tvIn_ShowTimer | Número |
tvIn_Switch | Booleano (Señal) |
tvIn_TransitionDirection | Índice Dirección de transición Dirección |
tvIn_TransitionDuration | Número |
tvIn_TransitionType | Índice Tipo de transición Tipo |
tvIn_UISnapColor | Color |
tvIn_VideoSourceA B C D | Imagen |
tvIn_AccountTwitterConsumerKey
tvIn_AccountTwitterConsumerSecret
tvIn_AccountTwitterTokenKey
tvIn_AccountTwitterTokenSecret
Estas cuatro entradas AccountTwitter se utilizan para introducir los datos de inicio de sesión de las preferencias de cuenta de Twitter de mimoLive en la composición. Los valores se utilizan con el parche JSON y el parche OAuth para leer datos del servicio Twitter.
tvIn_CompositedLayersImage
Si esta entrada está presente en una composición y hay contenido de las capas inferiores, el resultado del dibujo de esas capas inferiores se introducirá en esta entrada.
tvIn_FrameCount
Esta entrada obtendrá el número total de fotogramas renderizados después de iniciar mimoLive. Si se han eliminado fotogramas porque la carga de renderizado es demasiado alta, el recuento de fotogramas saltará por encima de los números de fotogramas eliminados.
tvIn_FrameDuration
La duración del fotograma es el intervalo de tiempo entre cada renderización en segundos.
tvIn_InTransitionDirection
Dirección en la que se realizará la Dirección de Transición.
tvIn_InTransitionDuration
Un valor en segundos en el que se realizará el tvIn_InTransitionType.
tvIn_InTransitionType
Si es útil para una capa que permite al usuario elegir el tipo de transición en curso. Véase también Tipo de transición.
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
Esos campos de entrada booleanos se establecerán en verdadero mientras el usuario pulsa la tecla modificadora correspondiente en el teclado. Esta función se utiliza principalmente para la función de manipulación directa. Por favor, consulte las Líneas de la Guía del Usuario Humano de Apple para ver qué tecla modificadora se debe utilizar para cada función en la interfaz de usuario.
tvIn_Obscured
Esta entrada se establece en true si la capa no necesita renderizar ninguna salida porque una capa por encima la oscurecerá de todos modos dibujando toda la pantalla. Esto se puede utilizar para evitar el dibujo pesado de las capas que no son visibles, pero que están configuradas para estar activas. (Por ejemplo, en el caso de la capa de Twitter, la capa sigue siendo llamada incluso cuando está oscurecida por otra capa por encima y tiene la oportunidad de mantener la conexión a Internet con el servicio de Twitter).
tvIn_OnAir
Esta entrada comienza con un valor de "true". Una vez que la entrada pasa a "false" la composición debe hacer cualquier transición saliente, a continuación, establecer su salida Done cuando haya terminado. La composición se desactivará entonces. Puede ocurrir que la aplicación desactive una capa sin esperar a la bandera done.
tvIn_OSVersion
Esta entrada de cadena se ajustará a la versión actual de OS X (por ejemplo, "Versión 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Se realizará un valor en segundos del tipo tvIn_OutTransitionType. Consulte también Dirección de la transición.
tvIn_OutTransitionDuration
Se realizará un valor en segundos del tipo tvIn_OutTransitionType.
tvIn_OutTransitionType
Si es útil para una capa que permite al usuario elegir el tipo de transición en curso. Véase también Tipo de transición.
tvIn_PreviewMode
Puede utilizarse para indicar a la composición que está en modo de vista previa.
tvIn_Reset
Útil para restablecer la lógica de la composición. Esta bandera se activa cuando una capa se cambia a directo desde desactivado o cuando se cambia entre configuraciones y no hay ninguna entrada tvIn_Switch disponible.
tvIn_RuntimeIdentifier
Ayuda a las capas a comunicarse entre la vista previa y la instancia en vivo. Establecido dinámicamente por mimoLive.
tvIn_Shared_
Consulte Compartir valores entre capas Valores entre capas.
tvIn_ShowDuration
Si el usuario rellenó la duración del espectáculo en la Configuración del espectáculo, esta entrada tendrá el valor en segundos.
tvIn_ShowTimer
El temporizador de visualización reflejará la visualización del temporizador de visualización del documento mimoLive en segundos.
tvIn_Switch
Esta bandera se activa en lugar de tvIn_Reset]] cuando se cambia una capa de un ajuste a otro sin desactivar la capa. En caso de que esta entrada no exista, se activará el indicador [[#tvIn_Reset] cuando se cambie una capa de un ajuste a otro sin desactivar la capa. En caso de que esta entrada no exista, se establece en su lugar el [[#tvIn_Reset para mantener la compatibilidad con capas más antiguas.
tvIn_TransitionDirection
Una dirección en la que se realizará la Dirección de Transición.
tvIn_TransitionDuration
Se realizará un valor en segundos del tipo tvIn_InTransitionType.
tvIn_TransitionType
Si es útil para una capa que permite al usuario elegir el tipo de transición en curso. Véase también Tipo de transición.
tvIn_UISnapColor
Para mantener la coherencia de la interfaz de usuario, mimoLive proporciona un "color de ajuste" con el que se dibujan las líneas directrices en la vista previa siempre que la interfaz de usuario se ajuste a un valor determinado (por ejemplo, si se mantiene pulsada la tecla "Mayúsculas" mientras se gira una capa Placer en el modo de visualización personalizado, las líneas directrices se dibujarán en ese color cuando el ángulo de rotación se ajuste a 0, 45 o 90 grados).
tvIn_VideoSource
Una capa puede tener hasta 8 entradas de fuente de vídeo dinámico: "A", "B", "C" y así sucesivamente. Se representarán mediante una zona de caída si el usuario arrastra una fuente de vídeo desde el repositorio de fuentes a la pila de capas. //Nota: Por compatibilidad con versiones anteriores, se ignora la extensión "Image" en esas entradas.
Opciones de entrada
Teclas de entrada correspondientes
Si hay una tecla de entrada de vídeo, las teclas de entrada siguientes también se rellenarán con la información correspondiente:
(por ejemplo, "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
Clave | Tipo | Descripción |
---|---|---|
AudioGain | Número | TBD |
AudioNivel0 | Número | Nivel del canal de audio izquierdo en db después del control de ganancia |
Nivel de audio1 | Número | Nivel del canal de audio derecho en db después del control de ganancia |
AudioLevel0Raw | Número | Nivel del canal de audio izquierdo en db antes del control de ganancia |
AudioLevel1Raw | Número | Nivel del canal de audio derecho en db antes del control de ganancia |
AudioPanning | Número | TBD |
AudioVolumen | Número | TBD |
Datos | Estructura | Un diccionario de metadatos de la fuente. Actualmente, las claves implementadas son: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" |
Nombre | Cadena | Nombre de la fuente de imagen asociada. Puede utilizarse para mostrar su nombre en la vista previa o para calcular el nombre por defecto de la variante de capa. Véase tvOut_SettingName . |
Tiempo restante | Número | En segundos. Se proporcionará para fuentes de película. -1 si la fuente de vídeo está en bucle (o cualquier otra fuente). |
TallyState | Índice | Tally Estado de la fuente conectada, véase Estados del recuento Estados |
Tipo | Índice | Valor de tipo de fuente tipo |
Agrupación de entradas
La agrupación se proporciona en la interfaz de usuario - para ello es relevante el prefijo de la entrada. La sintaxis funciona como tvGroup___. Tenga en cuenta el doble guión bajo _ _ después del nombre del grupo como separador del nombre de la entrada.
Se define un grupo especial para las entradas que deben estar siempre ocultas: tvGroup_Hidden_Inputs__ Este grupo puede hacerse visible poniendo mimoLive en modo depuración en el depuración|Preferencias de depuración|Preferencias de depuración. Algunas capas están utilizando esos campos ocultos para comunicarse entre la "Instancia de previsualización" y la "Instancia en directo" (por ejemplo, la capa Conmutador de vídeo le está diciendo a la instancia de previsualización qué fuente de vídeo está actualmente en directo).
Ocultar entradas dinámicamente
Cada entrada de protocolo se ocultará en la interfaz de usuario si la salida tvOut_hide_ se establece en "true". Este valor es observado por la aplicación y puede cambiarse dinámicamente. Tenga en cuenta que debe utilizar el nombre completo de la entrada, incluyendo "tvIn" (por ejemplo, utilice la salida tvOut_hide_tvIn_Text_TypeMultiline para la entrada tvIn_Text_TypeMultiline).
Salidas
Nombre | Tipo |
---|---|
tvOut_Cursor | Cadena |
tvOut_Done | Booleano (Señal) |
tvOut_hide_ | Booleano |
tvOut_Opaque | Booleano |
tvOut_SettingName | Cadena |
tvOut_Share_ | cualquier tipo |
tvOut_TimeRemaining | Número |
tvOut_UseCompositedLayersImage | Booleano |
tvOut_TallyState | Índice de Estados del recuento Estados |
tvSet_ | Tipo de entrada a configurar |
tvSetSignal_ | Booleano |
tvSetAudioVolume_ | Número |
tvSetAudioVolumeSignal_ | Booleano |
tvOut_Cursor
Esta salida especifica el aspecto del cursor del ratón si el puntero del ratón está sobre la vista previa o sobre la vista de salida del programa. Consulte Documentación de la clase NSCursor de mimoLive) para conocer los valores válidos. Los cursores de ratón adicionales proporcionados por mimoLive son "menos" y "más".
Elimina el postfijo "_Cursor" o "Cursor" de las constantes NSCursor de Apple (por ejemplo, utiliza "openHand" para obtener un cursor de ratón de mano abierta).
tvOut_Done
Se utiliza para indicar a la capa siguiente que esta capa ha terminado. Consulte tvIn_OnAir para obtener documentación.
tvOut_hide_
Puede utilizarse para ocultar dinámicamente los valores de entrada en la vista de parámetros. Consulte Ocultar entradas dinámicamente .
tvOut_Opaque
Se utiliza para indicar a la aplicación que las capas por debajo de esta no tienen que ser dibujadas. Por defecto "false". Este valor se anula en cualquier fuente conectada que contenga alfa.
tvOut_SettingName
Las composiciones pueden sugerir un nombre útil para un entorno basado en alguna(s) entrada(s).
tvOut_Share_
Consulte Compartir valores entre capas .
tvOut_TimeRemaining
Permite que la aplicación muestre una cuenta atrás grande del temporizador (por ejemplo, 5 segundos hasta que termine una película). Actualmente se utiliza "-1" para indicar que no hay información sobre el tiempo restante o "-2" si se trata de una película en bucle.
tvOut_UseCompositedLayersImage
Se utiliza para optimizar el rendimiento cuando se utilizan capas por debajo con transiciones, etc. Indica a la aplicación que la capa actual necesita la entrada de la imagen de las capas compuestas. mimoLive pondrá las capas por debajo de la imagen compuesta en el siguiente ciclo de renderizado. Si "tvOut_UseCompositedLayersImage" no está presente mimoLive asume que las capas por debajo de la imagen siempre deben ser puestas. Sólo optimización de dibujo, todos los medios de comunicación se rodará sin embargo. Sólo se utiliza si tvIn_CompositedLayersImage está presente.
tvOut_TallyState
Esta capa de salida puede sobrescribir el estado de tally automático de la fuente que esté conectada en ese momento a esa entrada. Esto es útil para las transiciones o si la fuente no se utiliza para la salida, el estado de tally puede desactivarse (por ejemplo, el conmutador de vídeo utiliza 3 cámaras pero sólo muestra una a la vez, por lo que necesita establecer el estado de tally para las fuentes no utilizadas en "TVTallyStateOff"). Consulte Estados de tally para ver la lista de estados de tally.
tvSet_
En mimoLive, una capa o filtro puede manipular sus propios parámetros. Esto es principalmente para implementar la función de manipulación directa en la vista previa de la variante de capa (por ejemplo, si el usuario arrastra el Reloj analógico en la vista previa, la capa le dice a mimoLive qué teclas de entrada deben cambiarse a qué valor. Sin embargo, esta función también se utiliza para transferir datos en directo de la instancia de salida de programa a la instancia de vista previa y viceversa (por ejemplo, en la capa Conmutador de vídeo, la instancia de salida de programa le dice a la instancia de vista previa qué fuente de vídeo está actualmente en directo y la instancia de vista previa puede decirle a la instancia de salida de programa qué fuente de vídeo ha seleccionado el usuario en pantalla).
Para hacer uso de esta función necesitas dos salidas que se correspondan con el campo de entrada que quieras manipular: En 'tvSet_' das salida al nuevo valor que quieres establecer y con 'tvSetSignal_' señalas cuando el valor es válido y debe ser almacenado.
tvSetSignal_
Véase tvSet_ .
tvSetAudioVolume_
Esta salida controla el volumen de su fuente de audio asociada (o el audio de una fuente de vídeo). Los valores válidos son 0=silencioso a 1=completo. la composición tiene que establecer la correspondiente "tvSetAudioVolumeSignal_" cada vez que quiera cambiar el nivel de volumen de audio. Por ejemplo, esto es útil si la capa tiene una transición de fundido y quiere fundir el audio también.
tvSetAudioVolumeSignal_
Véase tvSetAudioVolume_ .
Compartir valores entre capas
Una capa puede enviar datos a otras capas de la pila de capas que estén por encima de ella. Los datos son almacenados por mimolive por su clave de compartición hasta el siguiente ciclo de renderizado. Si una capa se utiliza varias veces (o la misma clave de compartición se utiliza en diferentes capas) los datos son sobrescritos por la capa superior. Para establecer estos datos de compartición utilice una salida "tvOut_Share_". Puede almacenar cualquier tipo de datos QuartzComposer sin embargo, una estructura se recomienda porque sólo necesita una salida para múltiples valores. En el lado de la capa receptora, necesitará una entrada correspondiente "tvIn_Shared_" con el mismo tipo de datos. Ten en cuenta que la capa receptora debe estar encima de la capa emisora en la pila de capas.
La compartición de valores es útil si necesitas los mismos datos en varias capas (por ejemplo, el nombre de los adversarios Local e Invitado en un partido).
Definiciones de tipos (también conocidas como convenciones de nomenclatura)
Clave | Tipo | Descripción |
---|---|---|
*_TipoAudio | Imagen | Se trata de un caso muy especial: Un _TypeAudio sólo puede asignar fuentes que contengan audio (por ejemplo, fuentes de película, fuentes de vídeo o fuentes de sólo audio). La capa obtendrá el control sobre esta fuente (en el futuro) así como los valores de volumen de audio para los canales izquierdo y derecho a través de las entradas "_TypeAudioAudioLevel0" y "_TypeAudioAudioLevel1". |
*_TipoBoinxX | Número | Un número introducido en coordenadas Boinx X - por ejemplo, -1 es el primer píxel, 1 es el último píxel de las dimensiones de la pantalla actual. se presentará al usuario en píxeles |
*_TipoBoinxY | Número | Un número introducido en coordenadas Boinx Y - por ejemplo -1 es el píxel inferior, 1 es el píxel superior de las dimensiones actuales de la pantalla. se presentará al usuario en píxeles |
*_TipoDirectorioRuta | Cadena | El resultado es un botón "Elegir..." en la interfaz de usuario, que también puede mostrar un control de ruta. |
*_TipoDuración | Número | Tiempo en segundos - se mostrará en minutos:segundos y puede obtener una IU personalizada |
*_TipoRutaArchivo | Cadena | El resultado es un botón "Elegir..." en la interfaz de usuario, que también puede mostrar un control de ruta. |
*_TypeFontBoinxSize | Cadena | Tamaño de fuente en coordenadas Y de Boinx (por ejemplo, 2 es la altura de la pantalla completa), véase la nota siguiente |
*_TypeFontColor | Color | Entrada de color normal para especificar un color de texto, véase la nota siguiente |
*_TypeFontName | Cadena | Aparecerá un selector de fuentes, véase la nota siguiente |
*_TipoMultilínea | Cadena | Un campo de texto multilínea que permite introducir la devolución |
*_TipoContraseña | Cadena | Muestra un cuadro de texto con la contraseña. Importante: ¡La contraseña se guarda en texto plano y se puede leer en el documento! |
*_TipoSeñal | Booleano | Para una señal pulsada de un solo fotograma, utilice los patches Pulse o Watcher |
Los campos _TypeFontName, _TypeFontBoinxSize y _TypeFontColor se combinan en un único elemento de la interfaz de usuario del selector de fuentes en la vista de parámetros de capas si tienen la misma etiqueta base.
Plantillas de filtro
Esas entradas y propiedades son específicas para si está creando una Composición Quartz para usarla como filtro de imagen en mimoLive. La mayoría de las definiciones anteriores se aplican también a los filtros.
Entradas de filtro
Los siguientes campos de entrada son requeridos por Quartz Composer para la composición de un filtro:
Nombre | Tipo | Descripción |
---|---|---|
_protocolInput_PreviewMode | Bool | Puede utilizarse para indicar a la composición que está en modo de vista previa |
_protocoloEntrada_X | Número | es siempre 0. |
_protocoloEntrada_Y | Número | es siempre 0. |
Propiedades del filtro
Las siguientes propiedades están definidas por mimoLive. tv_FilterIdentifier y tv_FilterVersion son necesarias para gestionar el filtro y su ruta de actualización con versiones más recientes:
Nombre | Tipo | Valor de la muestra | Descripción |
---|---|---|---|
tv_FilterIdentifier | Cadena | com.boinx.mimoLive.layer.placer | Para su identificación, Boinx envió composiciones y clasificó diferentes versiones |
tv_FilterVersion | Número (doble) | 1 | Para emparejar diferentes versiones de una composición en un documento/aplicación. Los números de versión mayores denotan incompatibilidad y no coinciden con otras versiones mayores. Los números de versión menores deben ser compatibles al alza e incrementarse en 0,001 en cada iteración. Por ejemplo, debe garantizarse que los ajustes de carga de una capa 1.0 para una 1.013 deben tener exactamente el mismo aspecto, lo que significa que las nuevas claves, si están presentes, deben tener un valor predeterminado que no las muestre o que iguale el aspecto de la versión anterior. |
tv_FilterOutputIsOpaque | BOOL | Determina si la salida de un filtro es opaca. Por defecto es NO |
Enumeraciones
El tipo de índice de Quartz Composer permite índices con nombre. Pueden editarse en el Editor de Quartz Composer añadiendo un divisor de entrada en modo índice.
Tipo de fuente
La fuente será uno de los siguientes valores
- 0 - Imagen
- 1 - Película, una película tendrá un tiempo restante
- 2 - Cámara, también podría ser una composición
Dirección de transición
Puede definir sus propias direcciones. Las capas enviadas utilizan los siguientes valores.
- Ninguno
- Izquierda
- Derecha
- Arriba
- Abajo
Tipo de transición
Puede definir sus propios tipos de transición. He aquí algunos valores de ejemplo útiles.
- Disolver
- Limpiar
Estados del recuento
Hay varios estados de Tally definidos para las fuentes de vídeo que se representarán en la interfaz de usuario y en la aplicación complementaria Tally Light.
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram