KsStudio : Broches et nœuds
Cette rubrique décrit comment les usines de broches et l’instanciation des broches peuvent être affichées à l’aide de l’Utilitaire KSStudio.
Fabriques de connexions logicielles
Les usines de broches d’un filtre audio décrivent toutes les broches que le filtre peut instancier. En général, les filtres KS hébergent une ou plusieurs usines de broches. Pour plus d’informations, veuillez consulter la section Usines de broches.
Dans la Vue de la topologie des objets de l’Utilitaire KSStudio, les usines de broches sont situées sur un filtre de manière à ce que le flux de données soit dessiné de gauche à droite. Les différents types de broches et leurs représentations sont montrés ci-dessous.
Flux de communication et flux de données
Instanciation des broches
Il existe plusieurs façons d’instancier une broche dans KSStudio.
- Instanciation manuelle. Cette méthode est utile si vous souhaitez contrôler le format de la broche. Faites un clic droit sur une usine de broches et choisissez Instancier dans le menu contextuel. Cela produit la boîte de dialogue des paramètres
KSPIN_CONNECT.
Cette boîte de dialogue montre une structure appropriée (basée sur KSPIN_CONNECT) utilisée pour instancier une broche. La structure affichée est le résultat d’un appel au gestionnaire d’intersection de plage de données des filtres. Les membres de la structure et des sous-structures peuvent être modifiés en double-cliquant dessus. Le membre PinToHandle peut être rempli en choisissant une instance de broche dans l’arborescence .ConnectTo en bas de la boîte de dialogue. Lorsque la boîte de dialogue est confirmée, la structure KSPIN_CONNECT est passée en paramètre à KsCreatePin.
Instanciation automatique. Cette méthode est utilisée pour connecter les broches ensemble. Elle est beaucoup plus facile que l’instanciation manuelle, mais ne permet aucun contrôle sur le format de la broche. Elle repose plutôt sur les mécanismes de négociation de format des broches elles-mêmes. Il suffit de faire glisser une usine de broches sur une instance de broche ou une autre broche. Le mécanisme de négociation est différent pour différentes combinaisons de points de terminaison :
Faites glisser l’usine de broches source de communication A sur l’instance de broche récepteur de communication B.. La négociation de format est triviale ici puisque le format de la broche instanciée (B) est déjà défini. L’usine de broches (A) est simplement instanciée en spécifiant la poignée de la broche instanciée (B) comme paramètre PinConnectTo, et le format de la broche instanciée (B) comme format de données. Faire glisser une instance de broche sur une usine de broches est une légère variation de cette méthode qui aboutit au même résultat.
Faites glisser l’usine de broches source de communication A sur l’usine de broches récepteur de communication B.. La négociation de format ici est accomplie en utilisant le mécanisme d’intersection de plage de données. La plage de données de l’usine de broches source (A) est soumise au gestionnaire d’intersection de plage de données de l’usine de broches de réception (B). Si cet appel réussit, alors l’usine de broches B est instanciée avec ce format. L’usine de broches A est ensuite instanciée avec le même format, et avec la poignée de la nouvelle instance de broche (B) comme membre
PinHandleTo. Faire glisser une usine de broches de réception sur une broche source de communication est une légère variation de cette méthode qui aboutit au même résultat.
Pour chaque broche instanciée en utilisant les méthodes ci-dessus, des représentations de l’instance de broche sont ajoutées à la fois à la Vue de la topologie des objets et à la Vue des détails de l’objet.
Nœuds
Les nœuds sont utilisés pour décrire le chemin du flux de données à travers un filtre. Ils sont également utilisés pour déclarer la portée de l’effet résultant d’un appel de propriété comme décrit ci-dessous dans « Propriétés et événements sur les nœuds ».
Pour afficher les nœuds d’un filtre dans la vue graphique, faites un clic droit sur le filtre et choisissez « afficher les nœuds ».
Lorsque vous cliquez sur un nœud dans la vue graphique, les actions de l’interface utilisateur suivantes sont invoquées :
Chaque chemin à travers le nœud sélectionné est mis en surbrillance dans le filtre
La représentation correspondante du nœud dans la vue en arborescence est sélectionnée
Notez que les nœuds orphelins (nœuds sans connexions) sont dessinés dans le coin supérieur gauche du domaine graphique des filtres.
Propriétés et événements sur les nœuds
Les appels de propriété et d’événement sont effectués via des cibles de communication (filtres et broches). En tant que paramètre de ces appels de propriété et d’événement, un ordinal de nœud peut être spécifié. En ce sens, un appel de propriété est dit être sur un nœud, à travers une broche ou un filtre.
KSStudio représente visuellement ces relations à la fois dans la Vue de la topologie des objets et dans la Vue des détails de l’objet.
Lorsqu’une broche est instanciée, des nœuds sont ajoutés en tant qu’éléments enfants de l’instance de broche dans la Vue des détails de l’objet. Les propriétés de ces nœuds sont interrogées sur les nœuds, à travers la broche. Notez que la plupart des propriétés sur les nœuds ont du sens uniquement à travers la broche ou à travers le filtre, mais pas à travers les deux.
Voir aussi
KSStudio : Filtres et usines de filtres