Utilidad KsStudio: Pines y nodos
En este tema se describe cómo se pueden mostrar las fábricas de pines y la creación de instancias de pines mediante la utilidad KSStudio.
Fábricas de pines
Las fábricas de pines de filtro de audio describen todas los pines de los que el filtro puede crear instancias. En general, los filtros de KS alojan uno o varios fábricas de pines. Para obtener más información, consulte Fábricas de pines.
En la vista Topología de objetos de la utilidad KSStudio, las fábricas de pines se encuentran en un filtro, de modo que el flujo de datos se dibuja de izquierda a derecha. Consulte a continuación los distintos tipos de pines y sus representaciones.
Flujo de comunicación y flujo de datos
Creación de instancias de pines
Hay varias maneras de crear instancias de un pin en KSStudio.
- Creación de instancias manual. Este método es útil si desea controlar el formato del pin. Haga clic con el botón derecho en una fábricas de pines y elija Crear instancia en el menú emergente. Esto hará que se abra el cuadro de diálogo de parámetros
KSPIN_CONNECT.
En este cuadro de diálogo aparece la estructura correspondiente (basada en KSPIN_CONNECT) que se usa para crear instancias de un pin. La estructura que se muestra es el resultado de una llamada al controlador de intersección de DataRange. Los miembros de la estructura y las subestructuras se pueden cambiar haciendo doble clic en ellos. El miembro PinToHandle se puede rellenar eligiendo una instancia de pin a partir del árbol .ConnectTo en la parte inferior del cuadro de diálogo. Cuando se confirma el cuadro de diálogo, la estructura de KSPIN_CONNECT pasa como parámetro a KsCreatePin.
Creación automática de instancias. Este método se usa para conectar pines unos con otros. Es mucho más fácil que la creación de instancias manual, aunque no permite ningún control sobre el formato de los pines. En su lugar, se basa en mecanismos de negociación de formato de pines. Basta con arrastrar una fábrica de pines a una instancia de pines u otro pin. El mecanismo de negociación es diferente para diferentes combinaciones de puntos de conexión:
Arrastre la fábrica de pines del origen de comunicación A a la instancia B del pin receptor de comunicación B. La negociación de formato aquí no es importante, ya que el formato del pin del que se ha creado la instancia (B) ya se ha configurado. Se crea una instancia de la fábrica de pines (A) indicando el identificador del pin de la que se ha creado la instancia (B) como el parámetro PinConnectTo y el formato del pin de la que se ha creado la instancia (B) como formato de datos. La acción de arrastrar una instancia de pin a una fábrica de pines es una ligera variación de este método que logra el mismo resultado.
Arrastre la fábrica de pines del origen de comunicación A a la fábrica de pines receptores de comunicación B. La negociación de formato aquí se realiza mediante el mecanismo de intersección de DataRange. El DataRange de la fábrica de pines de origen (A) se envía al controlador de intersección de DataRange de la fábrica de pines receptores (B). Si esta llamada se realiza correctamente, se crea una instancia de la fábrica de pines B con este formato. A continuación, se crea una instancia de la fábrica de pines A con el mismo formato y con el identificador de la fábrica de pines actual (B) como miembro de
PinHandleTo. La acción de arrastrar una la fábrica de pines receptores de comunicación a un pin de origen de comunicación es una ligera variación de este método que logra el mismo resultado.
De cada pin creado mediante los métodos anteriores, las representaciones de la instancia de pin se añaden a las vistas Topología de objeto y Detalles de objeto.
Nodos
Los nodos se usan para describir la ruta del flujo de datos a través de un filtro. También sirven para declarar el alcance de efecto que se deriva de una llamada a una propiedad, tal como se describe más adelante en "Propiedades y eventos en nodos".
Para ver los nodos de un filtro en la vista de gráfico, haga clic con el botón derecho en el filtro y elija "Ver nodos".
Al hacer clic en un nodo en la vista de gráfico, se invocan las siguientes acciones de interfaz de usuario:
Todas las rutas de acceso del nodo seleccionado se resaltan en el filtro
Se selecciona la representación correspondiente del nodo en la vista de árbol
Tenga en cuenta que los nodos huérfanos (nodos sin conexiones) se ven dibujados en la esquina superior izquierda de la parte gráfica de los filtros.
Propiedades y eventos en nodos
Las llamadas a propiedades y eventos se realizan a través de destinos de comunicación (filtros y pines). Como parámetro de estas llamadas a eventos y propiedades, se puede indicar un ordinal de nodo. En este sentido, se dice que la llamada a una propiedad está en un nodo a través de un pin o filtro.
KSStudio representa visualmente estas relaciones en la vista Topología de objeto KSStudio representa visualmente estas relaciones en la vista Topología de objeto y en la vista Detalles de objeto.
Cuando se crea la instancia de un pin, los nodos se agregan como elementos secundarios de la instancia del pin en la vista Detalles de objeto. Las propiedades de estos nodos se consultan en los nodos, a través del pin. Tenga en cuenta que la mayoría de las propiedades de los nodos tienen sentido solo a través del pin o del filtro, pero no a través de ambos.
Consulte también
KSStudio - Filtros y fábricas de filtros