Trabalhando com a Linguagem de Consulta

Altium Training

Altium Essentials: PCB Global Editing and List Panel

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Num relance

Gerenciar centenas de objetos de projeto individualmente pode tornar as atualizações de esquemáticos e PCBs mais lentas. Este artigo apresenta a linguagem de consulta do Altium Designer e explica como usar consultas lógicas para localizar, realçar, selecionar e editar grupos específicos de objetos. Ele aborda o escopo dos filtros, a construção de consultas com o Query Helper e o Query Builder, os controles de exibição e as formas de reutilizar consultas. Nesta página, você também encontra listas de operadores de expressões de consulta lógica e de funções de consulta globais do sistema. Continue lendo para ter mais controle sobre os objetos do seu projeto e tornar as atualizações repetitivas mais eficientes.

- Saiba como as consultas identificam objetos específicos e como o escopo do filtro determina quais documentos e objetos são pesquisados.
- Descubra como construir e verificar expressões de consulta e, em seguida, controlar a seleção, o zoom e o mascaramento dos resultados.
- Entenda como aplicar e limpar filtros, reutilizar consultas favoritas e recentes e usar parênteses para tornar as expressões mais claras.
Aprofunde-se com a IA:

O que é uma consulta?

Talvez o maior desafio ao trabalhar em um projeto eletrônico complexo seja gerenciar um grande número de objetos de projeto. Dos componentes, rótulos de rede e strings de texto nas folhas do esquemático às centenas de componentes e trilhas que compõem o roteamento na PCB,  você precisa conseguir acessar, revisar e editar esses objetos. Como na maioria dos aplicativos Windows, você pode clicar duas vezes em um objeto e editar suas propriedades. Isso funciona bem para um único objeto, mas não é algo que você queira fazer se precisar editar mais de 300 strings de designadores de componentes ou alterar todas as vias da PCB. Para esses tipos de atualização, você precisa acessar vários objetos simultaneamente. 

Os editores de esquemático e de PCB do Altium Designer contam com um poderoso mecanismo de consulta. Ao inserir consultas nesse mecanismo, você pode filtrar os objetos para localizar e editar exatamente aqueles de que precisa.

O poderoso sistema de filtragem e edição de dados do Altium Designer permite instruir o software a retornar um conjunto específico de objetos. Essa instrução é inserida na forma de uma consulta. Uma consulta é uma string que você insere usando palavras-chave e sintaxe específicas e que retorna os objetos desejados. O que fazer com esses objetos fica a seu critério. Talvez você queira realçá-los e esmaecer todos os outros objetos, ou talvez queira examinar ou ordenar suas propriedades e modificar atributos específicos que todos eles compartilham.

Há vários locais em que você pode aplicar uma consulta, mas a central de comando são os Filter painéis mostrados nas imagens abaixo. Pressione F12 para exibir/ocultar o painel Filter .

Os painéis PCB Filter e SCH Filter com consultasOs painéis PCB Filter e SCH Filter com consultas

Os painéis PCBLIB Filter e SCHLIB Filter com consultas
Os painéis PCBLIB Filter e SCHLIB Filter com consultas

Os controles do painel são usados para definir a quais objetos a consulta será aplicada e como tratar os objetos que atendem à consulta, assim como aqueles que não atendem.

A linguagem de consulta também é usada na caixa de diálogo PCB Rules and Constraints Editor para definir os escopos das regras de projeto (consulte a página Definição, delimitação do escopo e gerenciamento de regras de projeto de PCB para saber mais). Observe que o conjunto de objetos abrangidos por uma regra de projeto depende não apenas da consulta, mas também do tipo de regra (por exemplo, uma regra de Largura abrange apenas trilhas, uma regra de Estilo de via de roteamento abrange apenas vias etc.). Portanto, os resultados do realce e da delimitação do escopo dos objetos ao usar a mesma expressão de consulta no painel Filter e no escopo da regra podem ser diferentes.

Onde estão os resultados da consulta?

Agora que você escreveu uma consulta no painel Filter , como acessar os objetos retornados por ela? Há duas maneiras de acessar e editar objetos no ambiente do Altium Designer.

  • Graficamente - após aplicar um filtro, o comportamento padrão é mascarar (esmaecer e tornar não editáveis) todos os objetos que não atenderam à consulta, deixando apenas os que atenderam. Esse modo é excelente para localizar e revisar objetos na área de trabalho. Como os objetos mascarados não são editáveis, comandos como Ctrl+A (selecionar tudo) se aplicam apenas aos objetos retornados pela consulta.

  • List painel - o painel List (Shift+F12) oferece uma visualização dos dados do seu projeto semelhante a uma planilha. Por padrão, ele exibe todos os objetos do projeto, mas, após a aplicação de um filtro, exibe apenas os objetos retornados pela consulta. O painel List apresenta comportamentos padrão de planilha para classificação e seleção, permitindo editar diretamente uma ou várias células. 

O painel PCB List e o painel SCH List  exibem os resultados das consultas PSB/SCH da seção anterior.O painel PCB List e o painel SCH List  exibem os resultados das consultas PSB/SCH da seção anterior.

Opções de destaque

Sempre que uma consulta é aplicada (ou o recurso de filtragem de dados é utilizado de outra forma), cada objeto do documento de destino passa a integrar os resultados dessa ação de filtragem. No entanto, a forma como os objetos presentes nos resultados e os objetos que não estão nos resultados são exibidos posteriormente depende das opções de destaque selecionadas no painel Filter . Há três opções de destaque disponíveis, totalmente independentes entre si, portanto você pode selecionar uma, duas ou todas.

Zoom

Quando a opção Zoom está habilitada no momento em que a consulta é aplicada, a visualização do documento de destino é atualizada para exibir a região ocupada por todos os objetos presentes nos resultados. A exibição de cada um dos demais objetos na visualização atualizada depende de sua localização em relação a essa região; assim, cada um desses objetos pode acabar sendo exibido totalmente, parcialmente ou nem sequer ser exibido. 

Essa opção costuma ser selecionada em conjunto com uma ou ambas as outras opções. Se a opção Mask não estiver habilitada, os objetos que não estiverem nos resultados ainda serão exibidos na visualização gráfica se estiverem dentro dos limites atualizados. À primeira vista, selecionar apenas essa opção pode parecer inútil, mas pode haver situações em que você queira atualizar a visualização gráfica para abranger determinados objetos, sem alterar o estado de seleção ou de mascaramento de nenhum dos objetos do documento.

Selecionar

Quando a opção Select está habilitada, todos os objetos presentes nos resultados ficam selecionados, enquanto os demais objetos ficam desmarcados. Os objetos selecionados são exibidos de forma mais destacada do que os objetos não selecionados.

Se a opção Selecionar estiver selecionada quando a consulta atual for aplicada, todos os objetos que fizerem parte do conjunto de resultados passarão para o estado selecionado, enquanto todos os demais objetos (que não fazem parte do conjunto de resultados) passarão para o estado não selecionado. Normalmente, essa opção é selecionada imediatamente antes de procedimentos de edição global, pois apenas os objetos atualmente selecionados têm suas propriedades atualizadas nesse momento. Mas há outras ocasiões em que a opção Selecionar pode ser útil, como quando determinados objetos precisam ser movidos, copiados ou excluídos.

Mascarar

A opção de destaque Mask determina o estado atualizado de mascaramento dos objetos no documento de destino. Quando selecionada, todos os objetos presentes nos resultados são mascarados, enquanto os demais objetos ficam sem máscara. A principal característica dos objetos mascarados é que nem eles nem suas propriedades podem ser editados. (Os objetos mascarados são exibidos esmaecidos na visualização em lista, mas não aparecem nessa visualização a menos que a opção all objects esteja selecionada no painel List .) A principal característica dos objetos mascarados é que o objeto e suas propriedades não podem ser editados.

O Construtor de consultas

O editor de PCB inclui uma caixa de diálogo Query Builder dedicada. Essa caixa de diálogo permite criar consultas complexas escolhendo condições de teste em listas suspensas. Uma vantagem do Query Builder é permitir criar uma consulta que abranja diferentes tipos de objetos.

A caixa de diálogo 'Construção de consulta' (parte do recurso 'Construtor de consultas') auxilia quem tem menos experiência na especificação de consultas; uma consulta é gerada automaticamente com conteúdo correspondente às condições especificadas pelo projetista.

A seção à esquerda dessa caixa de diálogo contém controles cuja finalidade é auxiliar o projetista na tarefa de especificar quais propriedades são necessárias para que cada objeto do documento seja retornado pela consulta gerada nessa caixa de diálogo. À medida que cada condição é especificada ou editada, o conteúdo da consulta correspondente é atualizado e exibido na seção à direita da caixa de diálogo. Se, em seguida, a caixa de diálogo for fechada clicando no botão OK (ou Aplicar), a consulta associada será aplicada ou seu conteúdo será copiado de volta para o painel Filtro (dependendo de como a caixa de diálogo foi aberta inicialmente).

A caixa de diálogo Query Builder pode ser aberta nos seguintes locais (conforme mostrado na imagem abaixo):

Quando a caixa de diálogo Query Builder é acessada a partir da caixa de diálogo PCB Rules and Constraints Editor, ela exibe apenas opções adequadas a esse tipo de regra.

A imagem abaixo mostra a caixa de diálogo Query Builder sendo usada para criar uma consulta que abrange tanto pads quanto vias na rede 5V.

A caixa de diálogo Query Builder
A caixa de diálogo Query Builder

  • Adicione outras condições para restringir o conjunto de objetos de projeto desejado, conforme necessário. As condições podem ser combinadas com AND ou OR. O operador lógico padrão é AND.
  • Para alterar o operador lógico entre as condições, clique na entrada AND ou OR na coluna Condition Type/Operator e selecione o operador desejado. A prévia da consulta será atualizada de acordo.
  • A caixa de diálogo Query Builder (Building Query from Board ) oferece um método mais simples de criar uma consulta usando tipos e valores de condição sensíveis ao contexto, que permitem usar apenas os “blocos de construção” relevantes. Para criar consultas avançadas com especificação completa de palavras-chave e sintaxe de operadores, use a caixa de diálogo Assistente de consultas.
  • Você pode ajustar qualquer condição na sua expressão de consulta a qualquer momento, clicando na entrada dessa condição na coluna Condition Type/Operator e escolhendo a nova condição desejada entre as entradas disponíveis na lista suspensa. A prévia da consulta será atualizada de acordo.
  • Use os atalhos de teclado Ctrl+Up Arrow e Ctrl+Down Arrow para mover a entrada de condição selecionada para cima ou para baixo na estrutura. 
  • Use os atalhos de teclado Ctrl+Right Arrow e Ctrl+Left Arrow para aumentar ou diminuir o recuo na posição selecionada na estrutura (adicionar/remover parênteses).

O Assistente de consultas

O próximo passo para desenvolver suas habilidades de criação de consultas é usar a caixa de diálogo Query Helper . A caixa de diálogo Query Helper inclui uma caixa Query na qual você pode inserir a consulta desejada, usando também os botões de sintaxe abaixo do campo Query (por exemplo, And, Or, <, Not,  Like, etc.), além de uma lista completa de todas as palavras-chave de consulta no campo Categories .

A caixa de diálogo “Assistente de consultas” oferece auxílio aos projetistas que desejam especificar suas próprias consultas. Uma breve descrição é fornecida para cada palavra-chave listada, mas a ajuda on-line pode ser acessada pressionando a tecla F1 enquanto uma palavra-chave estiver destacada. Isso abre a caixa de diálogo Biblioteca de documentação do Altium Designer, que fornece detalhes sobre quais objetos de um documento são retornados pela palavra-chave destacada, como usá-la e um ou mais exemplos de uso.

A caixa de diálogo pode ser acessada das seguintes maneiras:

  • Clique no botão Helper no painel Filter .

PCB Filter acesso ao painel 

SCH Filter acesso ao painel

O botão Helper fica disponível após clicar em Advanced na caixa de diálogo File-based Libraries Search.

File-based Libraries Search acesso à caixa de diálogoFile-based Libraries Search acesso à caixa de diálogo

Use a seção Query na parte superior da caixa de diálogo para compor uma expressão de consulta usando as funções disponíveis. Na caixa de texto, você pode revisar e/ou editar a expressão de pesquisa. Digite diretamente na caixa de texto para editar a expressão de pesquisa. Para pesquisar palavras-chave específicas a serem adicionadas, comece a digitar. Enquanto você digita, a caixa de diálogo oferece um menu suspenso com as palavras-chave disponíveis que correspondem ao texto digitado até o momento. Clique em uma palavra-chave para completar automaticamente sua seleção. Se a palavra-chave desejada estiver destacada, pressionar Enter também completará sua seleção automaticamente.

Percorra a Categories de palavras-chave disponíveis para encontrar a desejada. Use o campo Mask se não tiver certeza de qual é a palavra-chave exata. Por exemplo, no Query Helperdo editor de esquemáticos, inserir *har no campo Mask encontrará palavras-chave que se aplicam especificamente a chicotes, como mostrado na imagem abaixo. Observe que o campo Mask atua tanto no campo Name da palavra-chave quanto no campo Description , portanto, pode ser a maneira mais rápida de encontrar possíveis palavras-chave.

Se você pressionar F1 quando uma palavra-chave estiver destacada ou o cursor estiver dentro de uma palavra-chave inserida, a documentação dessa palavra-chave será aberta. Esse é o recurso mais valioso para aprender o comportamento básico de cada palavra-chave de consulta.

Clique duas vezes em uma palavra-chave na grade para adicioná-la à consulta na posição atual do cursor.

A região central da caixa de diálogo inclui botões de sintaxe que oferecem diversos operadores para usar na construção de uma expressão. Para obter mais informações sobre a função individual de cada botão de sintaxe, consulte a seção Operadores lógicos de expressões de consulta abaixo. Use o botão Check Syntax (no canto inferior esquerdo da caixa de diálogo) para verificar se uma expressão está sintaticamente correta.

Histórico de consultas

À medida que você insere e aplica uma nova consulta em um painel de filtro (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter), ela é adicionada a uma lista de histórico de consultas. Clique no botão History do painel para acessar essa lista. A caixa de diálogo Expression Manager é aberta com a aba History ativa.

A aba Histórico da caixa de diálogo Expression Manager fornece uma lista de expressões de consulta usadas anteriormente. Aqui, é mostrado um exemplo do histórico de consultas do esquemático. Passe o mouse sobre a imagem para ver uma lista de exemplo semelhante para a PCB.A aba Histórico da caixa de diálogo Expression Manager fornece uma lista de expressões de consulta usadas anteriormente. Aqui, é mostrado um exemplo do histórico de consultas do esquemático. Passe o mouse sobre a imagem para ver uma lista de exemplo semelhante para a PCB.

Para usar uma consulta do histórico da lista, selecione sua entrada e clique no botão Apply Expression ou clique duas vezes diretamente na entrada. A caixa de diálogo será fechada e a expressão da consulta será carregada na região central do painel de filtro correspondente.

Uma consulta do histórico pode ser adicionada à lista de consultas favoritas selecionando sua entrada e clicando no botão Add To Favorites. Use o botão Clear History se quiser limpar a lista do histórico.

Até nove das expressões de consulta usadas mais recentemente na lista estarão disponíveis no submenu History do menu de contexto do painel de filtro.

Observe que o conteúdo da lista History é comum aos painéis de filtro (e pode ser acessado por eles) em um domínio de projeto (SCH Filter / SCHLIB Filter no domínio de edição de esquemáticos; PCB Filter / PCBLIB Filter no domínio de edição de PCB). Algumas expressões de consulta podem não retornar resultados quando usadas no Editor de Esquemáticos, especialmente se tiverem sido criadas para buscar objetos disponíveis apenas no Editor de Bibliotecas de Esquemáticos.

Consultas favoritas

Qualquer consulta definida pode ser adicionada a uma lista de consultas favoritas de duas maneiras:

  • Clique no botão Add To Favorites ou clique com o botão direito na região principal Query Expression e escolha o comando Add to Favorites no menu de contexto para adicionar a expressão de consulta atualmente definida na região central do painel de filtro ativo.
  • Selecione uma entrada do histórico de consultas na guia History da caixa de diálogo Expression Manager e clique no botão Add To Favorites.

As expressões de consulta favoritas são armazenadas e gerenciadas na guia Favorites da caixa de diálogo Expression Manager. O acesso pode ser feito usando o botão Favorites em um painel de filtro (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) ou clicando com o botão direito na região principal Query Expression de um painel de filtro e escolhendo o comando Organize Favorites no menu de contexto. Na área de projeto, a caixa de diálogo pode ser acessada usando a tecla de atalho Y e selecionando Organize Favorites no menu pop-up de filtragem.

Acesse uma lista das suas consultas favoritas pelo painel de filtro do editor ou pela área de projeto, usando o menu pop-up de filtragem.Acesse uma lista das suas consultas favoritas pelo painel de filtro do editor ou pela área de projeto, usando o menu pop-up de filtragem.

Quando uma expressão de consulta é adicionada à lista Favorites , ela recebe um nome exclusivo. Por padrão, é atribuído um nome genérico — Favorite_n — em que n é o próximo número disponível ainda não utilizado. O nome de uma entrada pode ser alterado a qualquer momento usando um dos seguintes métodos:

  • Selecionando a entrada da consulta e clicando no botão Rename.
  • Selecionando a entrada da consulta e escolhendo o comando Editar no menu do botão direito.
  • Selecionando a entrada da consulta e clicando novamente no campo Name.

Em cada caso, digite o novo nome desejado e clique fora do campo Name para efetivar a alteração.

Para editar uma expressão de consulta favorita, selecione sua entrada na lista e clique no botão Edit (ou clique com o botão direito e escolha Edit no menu de contexto). A caixa de diálogo Edit Favorite será aberta. Use essa caixa de diálogo para modificar o nome da consulta favorita, alterar a própria expressão e também determinar como os objetos do projeto serão tratados (tanto os que atendem ao filtro quanto os que não atendem).

Modifique uma consulta favorita existente usando a caixa de diálogo Edit Favorite, mostrada aqui para esquemáticos (à esquerda) e PCB (à direita).Modifique uma consulta favorita existente usando a caixa de diálogo Edit Favorite, mostrada aqui para esquemáticos (à esquerda) e PCB (à direita).

Para remover uma consulta da lista Favorites , selecione sua entrada na lista e clique no botão Remove ou escolha o comando Remove no menu do botão direito. Uma caixa de diálogo será exibida solicitando a confirmação da remoção.

Observe que o conteúdo da lista Favorites  é comum aos painéis de filtro (e pode ser acessado por eles) em um domínio de projeto (SCH Filter / SCHLIB Filter no domínio de edição de esquemáticos; PCB Filter / PCBLIB Filter no domínio de edição de PCB). Algumas expressões de consulta podem não retornar resultados quando usadas no Editor de Esquemáticos, especialmente se tiverem sido criadas para buscar objetos disponíveis apenas no Editor de Bibliotecas de Esquemáticos.

Como usar consultas favoritas

Há três maneiras de usar suas consultas favoritas:

  1. Na guia Favorites da caixa de diálogo Expression Manager — selecione a entrada e clique no botão Apply Expression ou clique duas vezes na entrada. A caixa de diálogo será fechada e a expressão da consulta será carregada na região central do painel de filtro correspondente.

  2. Na parte superior do menu do botão direito do painel de filtro (ficam disponíveis até dez das expressões de consulta adicionadas mais recentemente à lista Favorites ).

  3. No menu pop-up de filtragem da área de projeto (pressione Y) — até dez expressões de consulta favoritas são listadas na parte superior do menu. A expressão de consulta escolhida será carregada na região central do painel de filtro correspondente.

Você também pode definir uma tecla de atalho para uma consulta favorita personalizando o menu Filtro. Para obter mais informações sobre como personalizar o ambiente do Altium Designer, consulte Configuração e personalização do Altium Designer.

Como usar os exemplos incluídos

Tanto o editor de esquemáticos quanto o editor de PCB incluem um conjunto de consultas de exemplo. Esses exemplos estão disponíveis no menu de filtragem, acessado clicando com o botão direito na região de expressões do painel de filtro ou usando a tecla de atalho Y na área de projeto. Posicione o cursor sobre Examples para visualizar o submenu.

Ao selecionar uma entrada no submenu, a consulta correspondente àquele filtro é aplicada. Para visualizar a consulta usada em um dos exemplos, consulte a lista History após aplicá-lo. Você também pode acessar essa lista no menu pop-up de filtragem.

Para limpar a filtragem, pressione Shift+C na área de projeto ou clique com o botão direito na área de projeto e selecione o comando Clear Filter no menu de contexto.

Ferramentas de criação de consultas

Talvez a maneira mais fácil de escrever uma consulta seja deixar que o Altium Designer a escreva para você! Você pode fazer isso usando a caixa de diálogo Find Similar Objects  ou a caixa de diálogo Query Builder .

Caixa de diálogo Localizar objetos semelhantes

Quando você usa a caixa de diálogo Localizar objetos semelhantes, ela gera uma consulta para localizar os objetos desejados. Se a opção Create Expression estiver habilitada, essa consulta será exibida no painel Filter . Essa é uma excelente técnica para aprender diferentes palavras-chave de consulta.

A caixa de diálogo Find Similar Objects é aberta quando você clica com o botão direito em qualquer objeto não mascarado no documento de projeto e seleciona Find Similar Objects no menu de contexto.

Imagem à esquerda: versão para PCB; imagem à direita: versão para SCHImagem à esquerda: versão para PCB; imagem à direita: versão para SCH

Esta caixa de diálogo permite encontrar objetos semelhantes àquele em que você clicou com o botão direito e, em seguida, definir quais atributos do objeto devem ser iguais (ou diferentes) para que haja uma correspondência. Suponha que você queira alterar todos os pads GND do seu projeto. Você pode clicar com o botão direito em um desses pads, escolher Find Similar Objects e, em seguida, alterar o campo Net de Any (a configuração padrão) para Same. Todos os pads GND serão selecionados quando você clicar em Apply na caixa de diálogo. Se a opção Create Expression estiver habilitada, a seguinte consulta aparecerá no painel Filter : (ObjectKind = 'Pad') And (Net = 'GND').

Como exemplo em um esquemático, você pode alterar a propriedade Color de todos os objetos de alimentação que tenham uma determinada propriedade Text (por exemplo, 'GND') em um documento para o mesmo valor. Como exemplo em uma PCB, você pode alterar a propriedade Hole Size de todas as vias que tenham uma determinada propriedade Via Diameter em um documento para o mesmo valor.

Para obter mais informações sobre o uso da caixa de diálogo Find Similar Objects, consulte Uso das ferramentas de localização de objetos semelhantes.

Opção Limpar existentes

Habilite a opção Clear Existing para limpar qualquer seleção ou máscara de edição existente antes de aplicar a pesquisa. Desabilite essa opção se estiver realizando pesquisas sucessivas e quiser acumular os resultados.

Barra de ferramentas Filtro

A Filter Toolbar está disponível para documentos PCB e permite mascarar todos os objetos de um documento, exceto aqueles que tenham uma propriedade especificada ou que façam parte de um componente especificado. O campo mais à direita da barra de ferramentas é usado para especificar o conteúdo de uma consulta. Você pode inserir a consulta no campo ou usar a lista suspensa para selecionar uma das consultas recentes (uma que exista na lista History  de consultas). Não é possível especificar quais opções usar quando as consultas são aplicadas pela Filter Toolbar e, em todos os casos, qualquer consulta anterior é apagada, e as opções de máscara e zoom são usadas com a consulta atual. Para usar as opções de consulta, utilize o painel Filter , a caixa de diálogo Query Builder, a caixa de diálogo Query Helper ou a caixa de diálogo Find Similar Objects .

  • Se a placa não estiver roteada, as conexões lógicas associadas à net escolhida ficarão visíveis quando o filtro for aplicado. Se a placa estiver roteada, a trilha roteada associada à net escolhida ficará visível quando o filtro for aplicado.
  • Com a máscara aplicada, todos os objetos fora do escopo do filtro ficarão indisponíveis para seleção/edição. A intensidade da máscara aplicada pode ser ajustada manualmente usando a barra deslizante Masked Objects, acessível na seção Mask and Dim Settings da aba View Options do painel Configuração de visualização.
  • Você pode limpar manualmente um filtro existente (e aplicado) a qualquer momento usando o atalho de teclado Shift+C ou clicando no botão da barra de ferramentas Filter .

Operadores de expressões lógicas de consulta

A seguir, apresentamos um resumo dos operadores que podem ser usados ao definir expressões lógicas de consulta com a linguagem de consulta.

Operadores aritméticos

Operador Descrição Exemplo
+ Operador de adição NetPinCount + NetViaCount
- Operador de subtração ArcStopAngle - ArcStartAngle
* Operador de multiplicação PadXSize_BottomLayer * PadYSize_BottomLayer
/ Operador de divisão HoleDiameter / ViaDiameter
Div Operador de divisão inteira Color Div 65536
Calcula Color dividido por 65536 e descarta a parte fracionária do resultado
Mod Operador de módulo Color Mod 256
Calcula o resto da divisão de Color por 256, sem determinar a parte fracionária do resultado

Operadores lógicos

Operador Descrição Exemplo
And Operador lógico E IsPad And OnMultiLayer
Para ser retornado, um objeto deve ser um pad e estar na camada Multi-Layer
&& Operador lógico E
(menor precedência)
IsPad && OnMultiLayer
Para ser retornado, um objeto deve ser um pad e estar na camada Multi-Layer
Or Operador lógico OU IsPad Or IsVia
Para ser retornado, um objeto deve ser um pad ou uma via
|| Operador lógico OU
(menor precedência)
IsPad || IsVia
Para ser retornado, um objeto deve ser um pad ou uma via
Xor Operador lógico OU EXCLUSIVO OnMultiLayer Xor (HoleDiameter <> 0)
Para ser retornado, um objeto deve estar na camada Multi-Layer e ter um valor de Hole Diameter igual a zero, ou não
estar na camada Multi-Layer e ter um valor de Hole Diameter diferente de zero.
Not Operador lógico NÃO Not OnMultiLayer
Para ser retornado, um objeto não deve estar na camada Multi-Layer

Ao usar o operador Not em expressões de consulta no editor de PCB para excluir primitivas de um tipo específico, observe que essas primitivas não serão excluídas se fizerem parte de objetos de grupo e esses objetos de grupo não forem também excluídos pela expressão. Por exemplo, a expressão de consulta Not IsPad retorna todos os objetos, exceto pads livres, mas retorna objetos de componentes que podem incluir pads; portanto, os pads dos componentes serão retornados por essa expressão. Além disso, os pads podem estar incluídos em nets, que também são consideradas objetos de grupo no editor de PCB. Para excluir todos os objetos de pad, deve-se usar a expressão de consulta Not IsPad And Not IsComponent And Not IsNet .

Operadores de comparação

Operador Descrição Exemplo
< Operador menor que HoleDiameter < 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter menor que 40
<= Operador menor ou igual a HoleDiameter <= 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter menor ou igual a 40
>= Operador maior ou igual a HoleDiameter >= 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter maior ou igual a 40
> Operador maior que HoleDiameter > 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter maior que 40
<> Operador diferente de HoleDiameter <> 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter diferente de 40
= Operador igual a HoleDiameter = 40
Para ser retornado, um objeto deve ter um valor de Hole Diameter igual a 40
Between...And... Operador de intervalo inclusivo HoleDiameter Between 30 And 50
Para ser retornado, um objeto deve ter um valor de Hole Diameter maior ou igual a 30 e
menor ou igual a 50.
Like Operador Like Name Like 'ADDR?*'
Retorna objetos que tenham uma propriedade Name cuja cadeia de caracteres (texto) associada comece com ADDR e
contenha pelo menos mais um caractere

Caracteres curinga

Os caracteres curinga permitem especificar strings que não são definidas de forma exata. Esses caracteres são normalmente usados em conjunto com outros caracteres, resultando em strings parcialmente especificadas. Algumas palavras-chave excepcionais aceitam parâmetros de string que não são definidos de forma exata, mas, em geral, as strings só podem conter caracteres curinga quando são comparadas pelo operador Like.

Operador Descrição Exemplo
? Pode ser substituído por um único caractere de qualquer tipo Footprint Like 'DIP1?'
Retorna objetos cuja propriedade Footprint tem o valor DIP10, DIP12, DIP14 etc.
* Pode ser substituído por qualquer quantidade de caracteres, cada um dos quais pode ser de qualquer tipo Footprint Like 'SIP*'
Retorna objetos cuja propriedade Footprint tem o valor SIP1, SIP12, SIP216 etc. (Objetos cuja propriedade Footprint tem o valor SIP também são retornados, pois '*' também pode ser substituído por no caracteres)

Strings booleanas

Operador Descrição Exemplo
True Afirma o significado de uma palavra-chave IsPad = True
Para ser retornado, um objeto deve ser um pad
False Nega o significado de uma palavra-chave IsVia = False
Para ser retornado, um objeto não pode ser uma via

Parênteses e ordem de precedência

Vale a pena examinar a ordem de precedência dos operadores usados em expressões lógicas de consulta. Afinal, sem esse conhecimento, uma expressão pode não selecionar os objetos desejados.

Os parênteses têm a maior precedência na ordem definida para os vários operadores, que determina como as consultas são interpretadas pelo software (sempre que o usuário não tiver inserido parênteses). A sequência dessa ordem, da maior para a menor precedência, é a seguinte:

  1. Parênteses ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
Essa ordem de precedência é semelhante à usada em linguagens do tipo Pascal. As ambiguidades são resolvidas da esquerda para a direita. Os parênteses são avaliados de dentro para fora, e os níveis de mesma precedência são avaliados da esquerda para a direita.
É altamente recomendável usar parênteses sempre que houver qualquer possibilidade de a consulta não ser interpretada corretamente. O uso generoso de parênteses elimina dúvidas e facilita a leitura das consultas por outras pessoas.

Funções globais de consulta do sistema

Funções globais de consulta do sistema exibidas na caixa de diálogo Query Helper
Funções globais de consulta do sistema exibidas na caixa de diálogo Query Helper

Esta seção detalha as palavras-chave da linguagem de consulta disponíveis nos documentos de esquemático, PCB e biblioteca no Altium Designer. Para obter ajuda sobre uma palavra-chave de consulta específica, use as seções expansíveis a seguir ou selecione uma palavra-chave (ou clique dentro dela) — em Query Helper, em um painel Filter ou no campo Query de uma regra de projeto de PCB — e pressione F1 para acessar sua seção diretamente.

Para obter detalhes sobre as palavras-chave da linguagem de consulta disponíveis em editores e ferramentas específicos do Altium Designer, consulte as seguintes páginas:

Funções aritméticas

Funções trigonométricas

Funções exponenciais e logarítmicas

Funções de agregação

Funções do sistema

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents