KsStudio – Pinos e nós

Este tópico descreve como as fábricas e a instanciação de pinos podem ser exibidas usando o Utilitário KSStudio.

Fábricas de pinos

As fábricas de pinos de um filtro de áudio descrevem todos os pinos que o filtro pode instanciar. Em geral, os filtros KS hospedam uma ou mais fábricas de pinos. Para obter mais informações, consulte Fábricas de pinos.

Na Vista de Topologia de Objetos do Utilitário KSStudio, as fábricas de pinos estão localizadas em um filtro para que o fluxo de dados seja desenhado da esquerda para a direita. Os vários tipos de pinos e suas representações são mostrados abaixo.

Fluxo de Comunicação e Fluxo de Dados

Instanciação de pinos

Existem várias maneiras de instanciar um pino no KSStudio.

• Instanciação manual. Esse método é útil se você deseja controlar o formato do pino. Clique com o botão direito do mouse em uma fábrica de pinos e escolha Instanciar no menu pop-up. Isso produz a caixa de diálogo de parâmetros KSPIN_CONNECT.

Esta caixa de diálogo mostra uma estrutura apropriada (com base em KSPIN_CONNECT) usada para instanciar um pino. A estrutura mostrada é o resultado de uma chamada para o manipulador de interseção de filtros de intervalo de dados. Os membros da estrutura e subestruturas podem ser alterados clicando duas vezes sobre eles. O membro PinToHandle pode ser preenchido escolhendo uma instância de pino na árvore .ConnectTo na parte inferior da caixa de diálogo. Quando a caixa de diálogo é confirmada, a estrutura KSPIN_CONNECT é passada como um parâmetro para KsCreatePin.

• Instanciação automática. Esse método é usado para conectar pinos. É muito mais fácil do que a instanciação manual, mas não permite nenhum controle sobre o formato do pino. Em vez disso, ele depende dos mecanismos de negociação de formato dos próprios pinos. Basta arrastar uma fábrica de pinos para uma instância de pino ou outro pino. O mecanismo de negociação é diferente para diferentes combinações de pontos de extremidade:

  • Arraste a Fábrica A do Pino de Origem de Comunicação para a Instância B do Pino do Coletor de Comunicação. A negociação de formato é trivial aqui, uma vez que o formato do pino instanciado (B) já está definido. A fábrica de pinos (A) é instanciada especificando o identificador do pino instanciado (B) como o parâmetro PinConnectTo e o formato do pino instanciado (B) como o formato de dados. Arrastar uma instância de pino para uma fábrica de pinos é uma pequena variação desse método que obtém o mesmo resultado.

  • Arraste a Fábrica A do Pino de Origem de Comunicação para a Fábrica B do Pino do Coletor de Comunicação. A negociação de formato aqui é realizada usando o mecanismo de interseção de intervalo de dados. O intervalo de dados da fábrica de pino de origem (A) é enviado para o identificador de interseção de intervalo de dados da fábrica de pinos de coletor (B). Se essa chamada for bem-sucedida, a Fábrica B de Pinos será instanciada com esse formato. A Fábrica A de Pinos é então instanciada com o mesmo formato e com o identificador da Instância de Pinos (B) como o membro PinHandleTo. Arrastar uma fábrica de pinos do coletor de comunicação para um pino de origem de comunicação é uma pequena variação desse método que alcança o mesmo resultado.

Para cada pino instanciado usando os métodos acima, as representações da instância de pino são adicionadas ao Vista da Topologia de Objetos e ao Vista de Detalhes do Objeto.

Nós

Os nós são usados para descrever o caminho do fluxo de dados através de um filtro. Eles também são utilizados para declarar o escopo de efeito que resulta de uma chamada de propriedade, conforme descrito abaixo em "Propriedades e eventos em nós".

Para visualizar os nós de um filtro na visualização gráfica, clique com o botão direito do mouse no filtro e escolha "Ver nós".

Quando você clica em um nó na visualização gráfica, as seguintes ações de interface do usuário são invocadas:

• Cada caminho através do nó selecionado é realçado no filtro

• A representação correspondente do nó na visualização em árvore é selecionada

Observe que nós órfãos (sem conexões) são desenhados no canto superior esquerdo do domínio gráfico dos filtros.

Propriedades e eventos em nós

As chamadas de propriedade e eventos são feitas por meio de destinos de comunicação (filtros e pinos). Como um parâmetro para essas chamadas de propriedade e evento, um ordinal de nó pode ser especificado. Nesse sentido, uma chamada de propriedade é dita estar em um nó por meio de um pino ou filtro.

O KSStudio representa visualmente essas relações no Vista de Topologia de Objetos e na Vista de Detalhes do Objeto.

Quando um pino é instanciado, os nós são adicionados como itens filho da instância do pino na Vista de Detalhes do Objeto. As propriedades são consultadas nos nós, por meio do pino. Observe que a maioria das propriedades nos nós faz sentido apenas por meio do pino ou do filtro, mas não de ambos.

Confira também

Utilitário KSStudio

KSStudio – Filtros e fábricas de filtros

KSStudio – KSProperties e eventos

KSStudio – Monitor KS

KSStudio – Exemplos de Uso