Protocole version 1.2
Introduction
mimoLive utilise la technologie Quartz Composer d'Apple et ses documents pour les couches. Comme mimoLive doit communiquer au document Quartz Composer certains paramètres environnementaux et en lire les résultats, nous avons conçu un protocole que vous devez suivre pour profiter de toutes les fonctionnalités offertes par mimoLive. Vous trouverez ci-après toutes les informations techniques relatives à ce protocole.
Si vous souhaitez apprendre à créer des calques personnalisés avec Quartz Composer, veuillez lire "Creating Customer Layers for mimoLive":fr:pro:custom_layer:creating_custom_layers.
Propriétés
Vous pouvez modifier le protocole dans Quartz Composer en sélectionnant Éditeur ⇢ Modifier les informations (⌥⌘I)
| Nom | Exigée | Type | Valeur de l'échantillon |
|---|---|---|---|
| catégorie | Chaîne | ||
| droit d'auteur | Chaîne | 2016 MySoftwareCompany | |
| description | Chaîne | Lecture d'une entrée plein écran | |
| nom | oui | Chaîne | Lecteur plein écran |
| DÉCRYPTÉ tv_Catégories | Chaîne | Toile de fond,Plein écran | |
| tv_Debug | Booléen | ||
| tv_FileData_ nom d'entrée- | Données | (fichier XML importé) | |
| nom_du_fichier_de_la_télévision nom d'entrée- | Chaîne | Classement.xml | |
| tv_HelpURL | Chaîne | ||
| tv_HiddenInputKeys | Tableau de chaînes de caractères | ||
| tv_InputLabel_ nom d'entrée- | Chaîne | Entrée vidéo | |
| tv_LayerIdentifier | oui | Chaîne | com.example.layer.mylayer |
| tv_LayerVersion | oui | Nombre (réel) | 1.01 |
| tv_LayerPreview | Données | (fichier PNG importé) | |
| tv_LayerProtocolVersion | oui | Nombre (réel) | 1 |
| tv_SortKey | Chaîne | ||
| tv_StepSize_ nom d'entrée- | Nombre (réel) | 0.1 | |
| DÉCRYPTÉ tv_Tagline | Chaîne | Lecture d'une entrée plein écran | |
| tv_UseAudioFromSource | Chaîne | tvIn_VideoSourceA | |
| tv_UnitLabel_ nom d'entrée- | Chaîne |
catégorie
La catégorie est généralement définie par le compositeur Quartz et n'est pas nécessaire pour les couches mimoLive. Pour les catégories mimoLive, voir tv_Catégories au lieu de cela.
droit d'auteur
Le copyright est généralement défini par le compositeur Quartz et n'est pas nécessaire pour les couches mimoLive.
description
Quartz Composer standard - la longueur du texte doit être d'environ 3 lignes pour qu'il s'intègre bien dans l'aperçu.
nom
Le nom est affiché dans mimoLive. Utilisez un nom court et unique pour retrouver rapidement votre couche.
protocoles
Ce tableau est généralement défini par le compositeur Quartz et n'est pas nécessaire pour les couches mimoLive.
tv_Catégories
DÉCRYPTÉ
Les catégories étaient utilisées pour regrouper et filtrer les couches. Actuellement, elles sont ignorées, mais elles peuvent être réactivées. Utilisez une liste de catégories prédéfinies séparées par des virgules ou définissez vos propres catégories.
- Audio" - Couches permettant d'utiliser une source audio
- Superposition" - Couches qui superposent des données ou des images : Lower Thirds, Titre, Logo, ...
- Plein écran" - Couches qui, au moins via les paramètres par défaut, offrent un plein écran - par exemple Animations, Vidéo unique, Carte météo
- Toile de fond" - Couches qui servent de toile de fond ou d'arrière-plan à d'autres éléments situés au-dessus.
- Texte" - Couches qui fournissent une sorte d'affichage de texte, par exemple Crédits, Lower Thirds, En-tête
- Données" - Couches qui affichent des données, par exemple les cours de la bourse, les résultats du basket-ball, etc.
- Image" - Couches qui fournissent un moyen d'affichage à l'aide d'une image statique.
- Multividéo" - Couches qui combinent au moins deux sources, soit en ajoutant au moins une source en plus des couches inférieures, soit en utilisant deux sources ou plus.
- 3D" - Couches qui fournissent une sorte de positionnement en 3D des éléments, par exemple Presenter
- Segment" - Couches qui fournissent une animation chronométrée pour séparer les segments, par exemple Digital Upgrade Beitrag
- Effet" - Couches qui fournissent des effets de superposition, par exemple Loupe, Spotlight, Zoom...
- Demo" - Couches qui sont principalement destinées à démontrer des capacités plutôt qu'à fournir des fonctionnalités génériques utiles, par exemple la carte météo, qui affiche simplement une carte de l'Allemagne.
- Consommateur" - Les couches qui utilisent l'image composée, par exemple le sélecteur vidéo, le zoom, le présentateur.
- Générateur" - Couches qui fournissent une sorte de sortie générée, par exemple des animations.
- Debug" - Couches utiles pour le débogage qui ne sont pas visibles dans le produit final
tv_Debug
Indiquer à l'application que cette composition ne doit être utilisée que dans un environnement de débogage.
tv_FileData_
Un blob de données qui sera créé et écrit dans le document pour un fichier d'entrée lors de la création de la couche. Cela fonctionne pour les fichiers texte qui seront fournis dans un _TypeFilePath ou les fichiers .mov pour les entrées d'images. Voir nom_du_fichier_de_la_télévision .
nom_du_fichier_de_la_télévision
Le nom de fichier correspondant au tv_FileData_ . Requis si une entrée tv_FileData_* est existante.
tv_HelpURL
Cette chaîne peut contenir une URL contenant des informations utiles sur la manière d'utiliser cette couche. mimoLive présente un bouton " ?" dans la fenêtre contextuelle d'information pour chaque couche. Si l'utilisateur clique sur ce bouton, l'URL sera ouverte par le navigateur Internet par défaut du système.
tv_HiddenInputKeys
Dans ce tableau, la composition contient des clés d'entrée qui doivent être cachées de l'interface utilisateur.
tv_InputLabel_
Peut être utilisé pour fournir une autre étiquette de nom pour la clé d'entrée donnée dans la vue des paramètres. Il est également possible d'utiliser des chaînes vides pour l'absence d'étiquette. Fonctionne comme la fonction tv_hide_ouput Le nom de l'entrée du protocole doit être complet (par exemple "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifier
Pour l'identification, Boinx a expédié des compositions et trié les différentes versions. Doit être unique. Il est recommandé d'utiliser un domaine à notation inversée. Exemple : com.mysoftware.layers.videofullscreen
tv_LayerVersion
Pour faire correspondre différentes versions d'une composition dans un document ou une application. Les numéros de version majeurs indiquent une incompatibilité et ne correspondent pas à d'autres versions majeures (par exemple, vous devez augmenter la version majeure si le nom des clés d'entrée change). Les numéros de version mineurs doivent être compatibles vers le haut et peuvent être incrémentés de 0,001 pour chaque itération. Par exemple, il faut s'assurer que le chargement des paramètres d'une couche 1.0 pour une couche 1.013 doit se faire exactement de la même manière, ce qui signifie que les nouvelles clés, si elles sont présentes, doivent avoir une valeur par défaut qui ne les montre pas ou qui équivaut à l'aspect de la version précédente.
tv_LayerPreview
Données d'image à utiliser pour la prévisualisation d'un calque dans la liste des calques. Cela permet d'obtenir une meilleure expérience que l'aperçu rapide par défaut. L'image de prévisualisation doit avoir une taille de 256 × 256 pixels.
tv_LayerProtocolVersion
Pour une compatibilité ascendante future si mimoLive modifie le protocole de manière significative. Actuellement, la valeur doit être fixée à 1.
tv_SortKey
Définit le tri des couches dans mimoLive. Vous pouvez ainsi trier les filtres en fonction de leur probabilité d'utilisation. Actuellement, un schéma de 2 lettres majuscules est utilisé, par exemple "BM", "DE", "DM", etc. REMARQUE : cette fonction n'est pas utilisée pour le moment, mais le sera à l'avenir.
tv_StepSize_
Peut être utilisé pour fournir un StepSize personnalisé pour les jog wheels - un mouvement de souris d'un pixel correspond alors à cette quantité de changement (également +/- clic).
tv_Tagline
DÉCRYPTÉ
Chaîne d'une ligne qui sera affichée dans le popover d'information du référentiel de couches.
tv_UseAudioFromSource
Actuellement, mimoLive ne peut afficher qu'une seule commande audio dans l'interface utilisateur. Cette propriété indique la touche d'entrée qui doit être contrôlée. Remplissez le champ avec la touche d'entrée correspondante complète. (Pour des raisons de compatibilité ascendante, ce champ accepte également "A", "B" ou "C", ce qui correspond aux clés tvIn_VideoSourceAImage, tvIn_VideoSourceBImage ou tvIn_VideoSourceCImage. S'il n'est pas fourni, mimoLive suppose qu'aucun son ne sera utilisé avec cette couche.
tv_UnitLabel_
Peut être utilisé pour fournir une étiquette d'unité, par exemple "pt" pour la touche d'entrée donnée dans la vue des paramètres. Aussi court que possible. Aide à communiquer la signification de l'entrée. Les entrées de l'unité Boinx seront automatiquement étiquetées "px".
Entrées
| Nom | Type |
|---|---|
| tvIn_AccountTwitterConsumerKey | Chaîne |
| tvIn_AccountTwitterConsumerSecret | Chaîne |
| tvIn_AccountTwitterTokenKey | Chaîne |
| tvIn_AccountTwitterTokenSecret | Chaîne |
| tvIn_CompositedLayersImage | Image |
| tvIn_FrameCount | Index |
| tvIn_FrameDuration | Nombre |
| tvIn_CompositedLayersImage | Image |
| tvIn_InTransitionDirection | Index Direction de la transition Direction |
| tvIn_InTransitionDuration | Nombre |
| tvIn_InTransitionType | Index Type de transition Type |
| tvIn_KeyboardModifierAlt | Booléen |
| tvIn_KeyboardModifierCommand | Booléen |
| tvIn_KeyboardModifierControl | Booléen |
| tvIn_KeyboardModifierFunction | Booléen |
| tvIn_KeyboardModifierShift | Booléen |
| tvIn_Obscured | Booléen |
| tvIn_OnAir | Booléen |
| tvIn_OSVersion | Chaîne |
| tvIn_OutTransitionDirection | Index Direction de la transition Direction |
| tvIn_OutTransitionDuration | Nombre |
| tvIn_OutTransitionType | Index Type de transition Type |
| tvIn_PreviewMode | Booléen |
| tvIn_Reset | Booléen (Signal) |
| tvIn_RuntimeIdentifier | Chaîne |
| tvIn_Shared_ | tout type de valeur |
| tvIn_ShowDuration | Nombre |
| tvIn_ShowTimer | Nombre |
| tvIn_Switch | Booléen (Signal) |
| tvIn_TransitionDirection | Index Direction de la transition Direction |
| tvIn_TransitionDuration | Nombre |
| tvIn_TransitionType | Index Type de transition Type |
| tvIn_UISnapColor | Couleur |
| tvIn_VideoSourceA B C D | Image |
tvIn_AccountTwitterConsumerKey
tvIn_AccountTwitterConsumerSecret
tvIn_AccountTwitterTokenKey
tvIn_AccountTwitterTokenSecret
Ces quatre entrées AccountTwitter sont utilisées pour introduire dans la composition les données de connexion provenant des préférences de compte Twitter de mimoLive. Les valeurs sont utilisées avec le patch JSON et le patch OAuth afin de lire les données du service Twitter.
tvIn_CompositedLayersImage
Si cette entrée est présente dans une composition et qu'il y a du contenu provenant des couches inférieures, le résultat du dessin de ces couches inférieures sera introduit dans cette entrée.
tvIn_FrameCount
Cette entrée permet d'obtenir le nombre total d'images rendues après le démarrage de mimoLive. Si des images ont été supprimées parce que la charge de rendu est trop élevée, le nombre d'images sautera par-dessus les nombres d'images supprimées.
tvIn_FrameDuration
La durée de la trame est l'intervalle de temps entre chaque rendu, en secondes.
tvIn_InTransitionDirection
Direction dans laquelle la direction de la transition sera exécutée.
tvIn_InTransitionDuration
Une valeur en secondes que le tvIn_InTransitionType sera effectuée.
tvIn_InTransitionType
Si utile pour un calque qui permet à l'utilisateur de choisir le type de transition en cours. Voir également Type de transition.
tvIn_KeyboardModifierAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_KeyboardModifierFunction
tvIn_KeyboardModifierShift
Ces champs de saisie booléens seront définis comme vrais lorsque l'utilisateur appuiera sur la touche modificatrice correspondante du clavier. Cette fonction est principalement utilisée pour la manipulation directe. Veuillez vous référer aux lignes du guide de l'utilisateur Apple Human pour savoir quelle touche modificatrice doit être utilisée pour quelle fonction dans l'interface utilisateur.
tvIn_Obscured
Cette entrée est fixée à true si le calque n'a pas besoin d'effectuer de rendu parce qu'un calque au-dessus l'obscurcira de toute façon en dessinant tout l'écran. Cela peut être utilisé pour éviter un dessin lourd par des couches qui ne sont pas visibles mais qui sont définies pour être en direct. (Par exemple, dans le cas du calque Twitter, le calque est toujours appelé même s'il est masqué par un autre calque au-dessus et a la possibilité de maintenir la connexion internet avec le service Twitter).
tvIn_OnAir
Cette entrée commence avec la valeur "true". Lorsque l'entrée prend la valeur "false", la composition doit effectuer toute transition sortante, puis activer sa sortie "Done" lorsque celle-ci est terminée. La composition sera alors désactivée. Il peut arriver que l'application désactive une couche sans attendre le drapeau done.
tvIn_OSVersion
Cette chaîne de caractères sera définie comme la version actuelle d'OS X (par exemple, "Version 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Une valeur en secondes de la tvIn_OutTransitionType sera exécutée. Voir également Direction de la transition.
tvIn_OutTransitionDuration
Une valeur en secondes de la tvIn_OutTransitionType sera effectuée.
tvIn_OutTransitionType
Si utile pour un calque qui permet à l'utilisateur de choisir le type de transition en cours. Voir également Type de transition.
tvIn_PreviewMode
Peut être utilisé pour indiquer à la composition qu'elle est en mode prévisualisation.
tvIn_Reset
Utile pour réinitialiser la logique de la composition. Ce drapeau est activé lorsqu'un calque passe de l'état désactivé à l'état actif ou lorsqu'on passe de l'état actif à l'état inactif. tvIn_Switch est disponible.
tvIn_RuntimeIdentifier
Aide les calques à communiquer entre l'instance de prévisualisation et l'instance réelle. Défini dynamiquement par mimoLive.
tvIn_Shared_
Voir Partage des valeurs entre les couches Valeurs entre les couches.
tvIn_ShowDuration
Si l'utilisateur a renseigné la durée de l'émission dans les paramètres de l'émission, cette valeur sera exprimée en secondes.
tvIn_ShowTimer
La minuterie de l'émission reflète l'affichage de la minuterie de l'émission du document mimoLive en secondes.
tvIn_Switch
Cette option est activée à la place de tvIn_Reset]] lorsqu'une couche est commutée d'un réglage à un autre sans que la couche soit désactivée. Si cette entrée n'existe pas, la fonction [[#tvIn_Reset lorsqu'une couche est commutée d'un paramètre à un autre sans que la couche ne soit désactivée. Si cette entrée n'existe pas, le paramètre [[#tvIn_Reset est défini à la place pour maintenir la compatibilité avec les couches plus anciennes.
tvIn_TransitionDirection
Une direction dans laquelle le Direction de la transition sera effectuée.
tvIn_TransitionDuration
Une valeur en secondes de la tvIn_InTransitionType sera effectuée.
tvIn_TransitionType
Si utile pour un calque qui permet à l'utilisateur de choisir le type de transition en cours. Voir également Type de transition.
tvIn_UISnapColor
Pour que l'interface utilisateur reste cohérente, mimoLive fournit une "couleur d'accrochage" dans laquelle les lignes directrices sont dessinées dans l'aperçu lorsque l'interface utilisateur s'accroche à une certaine valeur (par exemple, maintenez la touche "shift" enfoncée pendant la rotation d'un calque Placer en mode d'affichage personnalisé, les lignes directrices seront dessinées dans cette couleur lorsque l'angle de rotation s'accrochera à 0, 45 ou 90 degrés).
tvIn_VideoSource
Une couche peut avoir jusqu'à 8 entrées de sources vidéo dynamiques : "A", "B", "C" et ainsi de suite. Elles seront représentées par une zone de dépôt si l'utilisateur fait glisser une source vidéo du référentiel de sources vers la pile de calques. //Note : Pour des raisons de compatibilité ascendante, l'extension "Image" de ces entrées est ignorée.
Options d'entrée
Touches de saisie correspondantes
Si une touche d'entrée vidéo est présente, les touches d'entrée suivantes seront également renseignées en conséquence :
(par exemple, "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| Clé | Type | Description |
|---|---|---|
| AudioGain | Nombre | TBD |
| AudioLevel0 | Nombre | Niveau du canal audio gauche en db après le contrôle du gain |
| Niveau audio1 | Nombre | Niveau du canal audio droit en db après le contrôle du gain |
| AudioLevel0Raw | Nombre | Niveau du canal audio gauche en db avant le contrôle de gain |
| AudioLevel1Raw | Nombre | Niveau du canal audio droit en db avant le contrôle de gain |
| AudioPanning | Nombre | TBD |
| AudioVolume | Nombre | TBD |
| Données | Structure | Un dictionnaire de métadonnées de la source. Actuellement, les clés implémentées sont les suivantes "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" |
| Nom | Chaîne | Nom de la source d'image associée. Il peut être utilisé pour afficher son nom dans l'aperçu ou pour calculer le nom par défaut de la variante de la couche. Voir aussi tvOut_SettingName . |
| Durée restante | Nombre | En secondes. Sera fourni pour les sources vidéo. -1 si la source vidéo est en boucle (ou toute autre source). |
| TallyState | Index | État de la source connectée, voir États de totalisation États |
| Type | Index | Valeur de type de source type |
Regroupement des entrées
Le regroupement est fourni dans l'interface utilisateur - pour cela, le préfixe de l'entrée est pertinent. La syntaxe fonctionne comme suit tvGroup___. Veuillez noter le double trait de soulignement _ _ après le nom du groupe comme séparateur du nom de l'entrée.
Un groupe spécial est défini pour les entrées qui doivent toujours être masquées : tvGroup_Hidden_Inputs__ Ce groupe peut être rendu visible en faisant passer mimoLive en mode de débogage dans le fichier debug|Préférences de débogage|Préférences de débogage. Certains calques utilisent ces champs cachés pour communiquer entre l'"instance de prévisualisation" et l'"instance en direct" (par exemple, le calque Video Switcher indique à l'instance de prévisualisation quelle source vidéo est actuellement en direct).
Masquer les entrées de manière dynamique
Chaque entrée de protocole sera masquée dans l'interface utilisateur si l'option tvOut_hide_ La sortie est réglée sur "true". Cette valeur est observée par l'application et peut être modifiée dynamiquement. Notez que vous devez utiliser le nom complet de l'entrée, y compris "tvIn" (par exemple, utilisez la sortie tvOut_hide_tvIn_Text_TypeMultiline pour l'entrée tvIn_Text_TypeMultiline).
Sorties
| Nom | Type |
|---|---|
| tvOut_Cursor | Chaîne |
| tvOut_Done | Booléen (Signal) |
| tvOut_hide_ | Booléen |
| tvOut_Opaque | Booléen |
| tvOut_SettingName | Chaîne |
| tvOut_Share_ | tout type |
| tvOut_TimeRemaining | Nombre |
| tvOut_UseCompositedLayersImage | Booléen |
| tvOut_TallyState | Index des États de totalisation États |
| tvSet_ | Type d'entrée à définir |
| tvSetSignal_ | Booléen |
| tvSetAudioVolume_ (définition du volume audio) | Nombre |
| tvSetAudioVolumeSignal_ | Booléen |
tvOut_Cursor
Cette sortie spécifie l'aspect du curseur de la souris si le pointeur de la souris se trouve au-dessus de la vue de prévisualisation ou de la vue de sortie du programme. Veuillez vous référer à Documentation de la classe NSCursor d'Apple) pour les valeurs valides. Les curseurs de souris supplémentaires fournis par mimoLive sont "moins" et "plus".
*Supprimer le postfixe "_Cursor" ou "Cursor" des constantes NSCursor d'Apple (par exemple, utiliser "openHand" pour obtenir un curseur de souris main ouverte).
tvOut_Done
Utilisé pour indiquer à la couche suivante que cette couche est terminée. Voir tvIn_OnAir pour la documentation.
tvOut_hide_
Peut être utilisé pour masquer dynamiquement les valeurs d'entrée dans la vue des paramètres. Voir Masquer les entrées de manière dynamique .
tvOut_Opaque
Permet d'indiquer à l'application que les couches inférieures à celle-ci ne doivent pas être dessinées. Valeur par défaut "false". Cette valeur est remplacée par toute source connectée contenant de l'alpha.
tvOut_SettingName
Les compositions peuvent suggérer un nom utile pour un environnement sur la base de certaines données.
tvOut_Share_
Voir Partage des valeurs entre les couches .
tvOut_TimeRemaining
Permet à l'application d'afficher un compte à rebours important (par exemple, 5 secondes avant la fin d'un film). Actuellement, on utilise "-1" pour indiquer qu'il n'y a pas d'information sur le temps restant ou "-2" s'il s'agit d'un film en boucle.
tvOut_UseCompositedLayersImage
Utilisé pour optimiser les performances lors de l'utilisation de calques inférieurs avec des transitions, etc. Il indique à l'application que le calque a actuellement besoin de l'image des calques composés. mimoLive insérera les calques sous l'image composée lors du prochain cycle de rendu. Si "tvOut_UseCompositedLayersImage" n'est pas présent, mimoLive considère que les calques situés sous l'image doivent toujours être insérés. Optimisation du dessin uniquement, tous les médias seront néanmoins affichés. Utilisé uniquement si tvIn_CompositedLayersImage est présent.
tvOut_TallyState
Cette couche de sortie peut écraser l'état de tally automatique de la source actuellement connectée à cette entrée. Ceci est utile pour les transitions ou si la source n'est pas utilisée pour la sortie, l'état du tally peut être désactivé (par exemple, le commutateur vidéo utilise 3 caméras mais n'en montre qu'une à la fois, il faut donc régler l'état du tally pour les sources non utilisées sur "TVTallyStateOff"). Voir États de totalisation pour la liste des états de comptage.
tvSet_
Dans mimoLive, un calque ou un filtre peut manipuler ses propres paramètres. Cela sert principalement à mettre en œuvre la fonction de manipulation directe dans l'aperçu de la variante du calque (par exemple, si l'utilisateur fait glisser l'horloge analogique dans l'aperçu, le calque indique à mimoLive quelles touches d'entrée doivent être remplacées par quelle valeur). Cependant, cette fonctionnalité est également utilisée pour transférer des données en direct de l'instance de sortie de programme à l'instance de prévisualisation et vice versa (par exemple, dans le calque Commutateur vidéo, l'instance de sortie de programme indique à l'instance de prévisualisation quelle source vidéo est actuellement en direct et l'instance de prévisualisation peut indiquer à l'instance de sortie de programme quelle source vidéo l'utilisateur a sélectionnée à l'écran).
Pour utiliser cette fonction, vous avez besoin de deux sorties correspondant au champ d'entrée que vous souhaitez manipuler : Dans 'tvSet_', vous indiquez la nouvelle valeur que vous souhaitez définir et dans 'tvSetSignal_', vous signalez que la valeur est valide et doit être stockée.
tvSetSignal_
Voir tvSet_ .
tvSetAudioVolume_ (définition du volume audio)
Cette sortie contrôle le volume de la source audio associée (ou de l'audio d'une source vidéo). Les valeurs valides sont 0=silent à 1=full. La composition doit définir le "tvSetAudioVolumeSignal_" correspondant chaque fois qu'elle souhaite modifier le niveau du volume audio. Par exemple, ceci est utile si le calque a une transition en fondu et qu'il souhaite également faire un fondu audio.
tvSetAudioVolumeSignal_
Voir tvSetAudioVolume_ (définition du volume audio) .
Partage des valeurs entre les couches
Un calque peut envoyer des données à d'autres calques de la pile de calques qui se trouvent au-dessus de lui. Les données sont stockées par mimolive par sa clé de partage jusqu'au prochain cycle de rendu. Si un calque est utilisé plusieurs fois (ou si la même clé de partage est utilisée dans différents calques), les données sont écrasées par le calque supérieur. Pour définir ces données de partage, utilisez une sortie "tvOut_Share_". Vous pouvez stocker n'importe quel type de données QuartzComposer, mais il est recommandé d'utiliser une structure car vous n'avez besoin que d'une seule sortie pour plusieurs valeurs. Du côté de la couche réceptrice, vous aurez besoin d'une entrée "tvIn_Shared_" correspondante avec le même type de données. Veuillez noter que la couche de réception doit se trouver au-dessus de la couche d'envoi dans la pile de couches.
Le partage des valeurs est utile si vous avez besoin des mêmes données dans plusieurs couches (par exemple, le nom des adversaires locaux et invités dans un jeu).
Définitions de type (alias conventions d'appellation)
| Clé | Type | Description |
|---|---|---|
| *_TypeAudio | Image | Il s'agit d'un cas très particulier : Un _TypeAudio ne peut assigner que des sources contenant de l'audio (par exemple, les sources Movie, les sources Video ou les sources Audio Only). La couche contrôlera cette source (à l'avenir) ainsi que les valeurs de volume audio pour les canaux gauche et droit via les entrées "_TypeAudioAudioLevel0" et "_TypeAudioAudioLevel1". |
| *_TypeBoinxX | Nombre | Un nombre saisi en coordonnées Boinx X - par exemple, -1 est le premier pixel, 1 est le dernier pixel des dimensions actuelles de l'écran - sera présenté à l'utilisateur en pixels. |
| *_TypeBoinxY | Nombre | Un nombre saisi en coordonnées Boinx Y - par exemple, -1 est le pixel du bas, 1 est le pixel du haut des dimensions actuelles de l'écran. sera présenté à l'utilisateur en pixels |
| *_TypeDirectoryPath | Chaîne | Il en résulte un bouton "Choisir..." dans l'interface utilisateur, qui peut également afficher un contrôle de chemin. |
| *_TypeDuration | Nombre | Temps en secondes - sera affiché en minutes:secondes et peut avoir une interface utilisateur personnalisée. |
| *_TypeFilePath | Chaîne | Il en résulte un bouton "Choisir..." dans l'interface utilisateur, qui peut également afficher un contrôle de chemin. |
| *_TypeFontBoinxSize | Chaîne | Taille de la police en coordonnées Boinx Y (par exemple, 2 est la hauteur du plein écran), voir note ci-dessous |
| *_TypeFontColor | Couleur | Entrée de couleur régulière pour spécifier une couleur de texte, voir note ci-dessous |
| *_TypeFontName | Chaîne | Il en résultera un sélecteur de polices, voir la note ci-dessous. |
| *_TypeMultiline | Chaîne | Un champ de texte multiligne qui permet de saisir le retour |
| *_TypePassword | Chaîne | Affiche une boîte de texte pour le mot de passe. Important : le mot de passe lui-même est stocké en texte clair et lisible dans le document ! |
| *_TypeSignal | Booléen | Pour un signal pulsé à image unique, utilisez les patchs Pulse ou Watcher. |
*Les champs _TypeFontName, _TypeFontBoinxSize et _TypeFontColor sont combinés en un seul élément Font Chooser UI dans la vue des paramètres des calques s'ils ont la même étiquette de base.
Modèles de filtres
Ces entrées et propriétés sont spécifiques à la création d'une composition Quartz à utiliser comme filtre d'image dans mimoLive. La plupart des définitions précédentes s'appliquent également aux filtres.
Entrées du filtre
Les champs de saisie suivants sont requis par Quartz Composer pour la composition d'un filtre :
| Nom | Type | Description |
|---|---|---|
| Mode de prévisualisation de l'entrée du protocole | Bool | Peut être utilisé pour indiquer à la composition qu'elle est en mode prévisualisation. |
| Protocole d'entrée_X | Nombre | est toujours 0. |
| Entrée_protocole_Y | Nombre | est toujours 0. |
Propriétés du filtre
Les propriétés suivantes sont définies par mimoLive. tv_FilterIdentifier et tv_FilterVersion sont nécessaires pour gérer le filtre et son chemin de mise à jour avec les nouvelles versions :
| Nom | Type | Valeur de l'échantillon | Description |
|---|---|---|---|
| tv_FilterIdentifier | Chaîne | com.boinx.mimoLive.layer.placer | Pour l'identification, Boinx a livré des compositions et trié différentes versions |
| tv_FilterVersion | Nombre (double) | 1 | Pour faire correspondre différentes versions d'une composition dans un document ou une application. Les numéros de version majeurs indiquent une incompatibilité et ne correspondent pas à d'autres versions majeures. Les numéros de versions mineures doivent être compatibles avec les versions supérieures et s'incrémenter de 0,001 à chaque itération. Par exemple, il faut s'assurer que le chargement des paramètres d'un calque 1.0 pour un calque 1.013 doit être exactement le même, ce qui signifie que les nouvelles clés, si elles sont présentes, doivent avoir une valeur par défaut qui ne les montre pas ou qui équivaut à l'aspect de la version précédente. |
| tv_FilterOutputIsOpaque | BOOL | Détermine si la sortie d'un filtre est opaque. La valeur par défaut est NO |
Les énumérations
Le type d'index de Quartz Composer permet de créer des index nommés. Ils peuvent être édités dans l'éditeur de Quartz Composer en ajoutant un séparateur d'entrée en mode index.
Type de source
La source sera l'une des valeurs suivantes
- 0 - Image
- 1 - Film, un film aura une durée restante
- 2 - Appareil photo, peut aussi être une composition
Direction de la transition
Vous pouvez définir vos propres orientations. Les couches expédiées utilisent les valeurs suivantes.
- Aucun
- Gauche
- Droit
- Haut de la page
- En bas
Type de transition
Vous pouvez définir vos propres types de transition. Voici quelques exemples de valeurs utiles.
- Dissoudre
- Essuyer
États de totalisation
Il existe plusieurs états Tally pour les sources vidéo définies qui seront représentées dans l'interface utilisateur et l'application compagnon Tally Light.
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = Programme TVTallyState