KsStudio - Pin e nodi
In questo argomento viene descritto come visualizzare le factory di pin e la creazione di istanze dei pin usando l'utilità KSStudio.
Pin Factory
Le pin factory di un filtro audio descrivono tutti i pin di cui il filtro può creare un'istanza. In generale, I filtri KS ospitano una o più pin factory. Per altre informazioni, vedere Pin Factory.
Nella visualizzazione Topologia oggetto dell'utilità KSStudio le pin factory si trovano in un filtro in modo che il flusso di dati venga disegnato da sinistra a destra. Di seguito sono riportati i vari tipi di pin e le relative rappresentazioni.
Flusso di comunicazione e Flusso di dati
Creazione di un'istanza di Pin
Esistono diversi modi per creare un'istanza di un pin in KSStudio.
- Creazione di un'istanza manuale. Questo metodo è utile se si desidera controllare il formato del pin. Fare clic con il pulsante destro del mouse su una factory di pin e scegliere Crea un'istanza dal menu popup. In questo modo viene generato il
KSPIN_CONNECTdialogo dei parametri.
Questa finestra di dialogo mostra una struttura appropriata (basata su KSPIN_CONNECT) usata per creare un'istanza di un pin. La struttura mostrata è il risultato di una chiamata al gestore di intersezione dell'intervallo di dati dei filtri. I membri della struttura e delle sottostruttura possono essere modificati facendo doppio clic su di essi. Il membro PinToHandle può essere popolato scegliendo un'istanza di pin da . Connessione Albero nella parte inferiore del dialogo. Quando il dialogo viene confermato, la struttura KSPIN_CONNECT viene passata come parametro a KsCreatePin.
Creazione automatica di istanze. Questo metodo viene usato per connettere i pin insieme. È molto più semplice rispetto alla creazione di un'istanza manuale, ma non consente alcun controllo sul formato del pin. Si basa invece sui meccanismi di negoziazione del formato dei pin stessi. È sufficiente trascinare una factory di pin in un'istanza di pin o in un altro pin. Il meccanismo di negoziazione è diverso per diverse combinazioni di endpoint:
Trascinare Communication Source Pin Factory A nell'istanza B del pin del sink di comunicazione. La negoziazione del formato è semplice perché il formato del pin di cui è già stata creata un'istanza (B) è già impostato. La factory pin (A) viene semplicemente creata un'istanza specificando l'handle del pin di cui è stata creata un'istanza (B) come parametro Pin Connessione To e il formato del pin di cui è stata creata un'istanza (B) come formato dati. Il trascinamento di un'istanza di pin in una pin factory è una variante secondaria di questo metodo che ottiene lo stesso risultato.
Trascinare Communication Source Pin Factory A sulla factory B del pin del sink di comunicazione. La negoziazione del formato viene eseguita usando il meccanismo di intersezione DataRange. DataRange della factory di pin di origine (A) viene inviato al gestore di intersezione DataRange della factory del pin sink (B). Se la chiamata ha esito positivo, viene creata un'istanza di Pin Factory B con questo formato. Pin Factory A viene quindi creata un'istanza con lo stesso formato e con l'handle di ora Pin Instance (B) del
PinHandleTomembro. Il trascinamento di una factory di pin sink di comunicazione in un pin di origine della comunicazione è una variante secondaria di questo metodo che ottiene lo stesso risultato.
Per ogni pin di cui è stata creata un'istanza usando i metodi precedenti, le rappresentazioni dell'istanza del pin vengono aggiunte sia alla visualizzazione Topologia oggetto che alla visualizzazione Dettagli oggetto.
Nodi
I nodi vengono usati per descrivere il percorso del flusso di dati tramite un filtro. Vengono usati anche per dichiarare l'ambito di effetto risultante da una chiamata di proprietà come descritto di seguito in "Proprietà ed eventi nei nodi".
Per visualizzare i nodi di un filtro nella visualizzazione grafico, fare clic con il pulsante destro del mouse sul filtro e scegliere "Visualizza nodi".
Quando si fa clic su un nodo nella visualizzazione grafico, vengono richiamate le azioni dell'interfaccia utente seguenti:
Ogni percorso attraverso il nodo selezionato è evidenziato nel filtro
La rappresentazione corrispondente del nodo nella visualizzazione albero è selezionata
Si noti che i nodi orfani (nodi senza connessioni) vengono disegnati nell'angolo superiore sinistro del dominio grafico dei filtri.
Proprietà ed eventi nei nodi
Le chiamate alle proprietà e agli eventi vengono effettuate tramite destinazioni di comunicazione (filtri e pin). Come parametro per queste proprietà e chiamate di eventi, è possibile specificare un ordinale di nodo. In questo senso, si dice che una chiamata di proprietà si trova in un nodo, tramite un pin o un filtro.
KSStudio rappresenta visivamente queste relazioni sia nella visualizzazione Topologia oggetto che nella visualizzazione Dettagli oggetto.
Quando viene creata un'istanza di un pin, i nodi vengono aggiunti come elementi figlio dell'istanza del pin nella visualizzazione Dettagli oggetto. Le proprietà in questi nodi vengono sottoposte a query sui nodi, tramite il pin. Si noti che la maggior parte delle proprietà nei nodi ha senso solo tramite il pin o tramite il filtro, ma non tramite entrambi.
Vedi anche
KSStudio - Filtri e filtri factory