Trabalhando com a Linguagem de Consulta
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
- 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.
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 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.
Painel de filtro de esquemático

Localize e realce objetos rapidamente usando consultas lógicas no painel SCH Filter.
Resumo
O painel SCH Filter permite construir filtros por meio da criação de consultas lógicas. Um filtro definido pode então ser aplicado ao documento de esquemático ativo ou a todos os documentos de esquemático abertos, permitindo selecionar e editar vários objetos com maior precisão e eficiência.
Acesso ao painel
O painel pode ser acessado das seguintes maneiras:
- Clique no botão Painéis no canto inferior direito do editor quando o editor de esquemático estiver ativo e selecione Filtro de esquemático no menu pop-up.
- Clique em View » Panels » SCH Filter.
- Pressione a tecla de atalho F12.
Definição do escopo do filtro
A primeira região do painel contém controles para definir o escopo do filtro:
A área Limit search to fornece controles para refinar ainda mais o escopo do filtro:
- All Objects - aplica o filtro a todos os objetos de projeto.
- Selected Objects - aplica o filtro somente aos objetos de projeto que estão selecionados no momento.
- Non Selected Objects - aplica o filtro somente aos objetos de projeto que não estão selecionados no momento.
O campo suspenso Consider objects in permite controlar onde o filtro é aplicado. Escolha entre as seguintes opções:
- Current Document - aplica a filtragem apenas ao documento de esquemático ativo (padrão).
- Open Documents - aplica a filtragem a todos os documentos de esquemático abertos.
- Project Documents - aplica a filtragem a todos os documentos de esquemático abertos que sejam documentos-fonte do mesmo projeto principal.
Definição de consultas de filtro
A região central do painel permite construir filtros por meio da inserção de consultas lógicas. Você pode digitar uma consulta diretamente no campo. Enquanto você digita, uma lista de sugestões de possíveis palavras-chave aparece para ajudar.
O Assistente de consultas está disponível para ajudar na criação de consultas. Essa função pode ser muito útil se você tiver dúvidas sobre a sintaxe de uma consulta ou sobre as possíveis palavras-chave que deseja usar. Para usar o Assistente de consultas, clique no botão Helper para abrir a caixa de diálogo Assistente de consultas. O mecanismo de consulta analisa o documento e lista todos os objetos disponíveis, além de palavras-chave genéricas para uso nas consultas.
Use a seção superior da caixa de diálogo para compor uma expressão de consulta usando os SCH Functions e System Functions disponíveis. A seção central da caixa de diálogo fornece uma série de operadores para usar na construção de uma expressão. Use o botão Check Syntax para verificar se a sintaxe de uma expressão está correta.
Quando a expressão da consulta estiver definida conforme necessário, clicar em OK preencherá a região central do painel SCH Filter com a consulta, deixando o filtro pronto para ser aplicado.
Definição do realce do filtro
Antes de aplicar a consulta, é recomendável definir como você deseja que o resultado da filtragem apareça visualmente na área de trabalho do projeto. As regiões Objects passing/not passing the filter do painel fornecem várias opções que, em conjunto, formam os controles de realce para filtragem permanente.
As opções disponíveis na área Objects passing the filter permitem controlar a exibição visual, na área de trabalho, de todos os objetos que estão dentro do escopo e correspondem à expressão de consulta específica do filtro:
- Select - quando habilitada (padrão), os objetos filtrados serão selecionados na área de trabalho.
- Zoom - quando habilitada (padrão), os objetos filtrados serão ampliados e centralizados (quando possível) na janela do editor de projeto.
As opções disponíveis na área Objects not passing the filter permitem controlar a exibição visual, na área de trabalho, de todos os objetos que não estão dentro do escopo e/ou não correspondem à expressão de consulta específica do filtro:
- Deselect - quando habilitada (padrão), todos os objetos que não estão dentro do escopo do filtro terão sua seleção desfeita na área de trabalho.
- Mask out - quando habilitada (padrão), os objetos filtrados aparecerão totalmente visíveis na janela do editor de projeto, enquanto todos os outros objetos ficarão esmaecidos. Com o mascaramento aplicado, todos os objetos fora do escopo do filtro ficarão indisponíveis para seleção/edição.
Qualquer combinação dessas opções pode ser habilitada. Por exemplo, você pode querer que todos os objetos filtrados que estejam dentro do escopo da consulta sejam ampliados, centralizados e selecionados na janela do editor de projeto, aplicando também o mascaramento para eliminar a poluição visual causada por outros objetos de projeto.
Aplicação e limpeza do filtro
Depois de definir a consulta e configurar as opções do painel conforme necessário, o filtro pode ser aplicado clicando no botão Apply ou pressionando Enter.
Para remover o filtro aplicado no momento pelo painel, apague a expressão de consulta no painel e clique no botão Apply ou pressione Enter. Todos os objetos na área de trabalho do projeto ficarão totalmente visíveis e disponíveis para seleção/edição.
Menus de contexto
Clicar com o botão direito no painel SCH Filter dá acesso a opções e comandos adicionais por meio de um menu de contexto.
O menu oferece os seguintes comandos:
- Add to Favorites - adiciona a expressão de consulta exibida no painel à lista de consultas favoritas. A consulta aparecerá como uma nova entrada na guia Favorites da caixa de diálogo Gerenciador de expressões. Quando uma consulta é adicionada à lista de favoritas, ela é exibida na parte superior do menu de contexto. As dez consultas adicionadas mais recentemente à lista de favoritas serão exibidas no menu (a mais recente no topo), permitindo acessar e reutilizar rapidamente suas expressões de consulta favoritas.
- Organize Favorites - use este comando para acessar a guia Favorites da caixa de diálogo Gerenciador de expressões, na qual você pode organizar (renomear, excluir) as entradas da lista de consultas favoritas conforme necessário.
- Examples - clique para acessar um submenu de filtros de exemplo predefinidos. Ao escolher um filtro de exemplo, a expressão de consulta correspondente será carregada na região central do painel.
- History - clique para acessar um submenu com as nove expressões de consulta usadas mais recentemente, obtidas da lista de histórico de consultas do painel. Clique na entrada More para acessar a guia History da caixa de diálogo Gerenciador de expressões, na qual você pode percorrer a lista completa do histórico de consultas e aplicar uma delas, além de limpar o histórico conforme necessário.
- Show Scope Options - use este comando para alternar a exibição da região de escopo do filtro no painel.
- Show Masking Options - use este comando para alternar a exibição da região de realce do filtro no painel.
Notas
Geral
- Pressionar a tecla F12 alterna a visibilidade do painel na área de trabalho.
- Ao usar a caixa de diálogo Assistente de consultas para criar uma consulta, clicar dentro de uma palavra-chave digitada ou em uma palavra-chave de uma das listas disponíveis e pressionar F1 abrirá a ajuda dessa palavra-chave específica. Também é possível acessar a ajuda de uma palavra-chave clicando dentro dela na região central do painel SCH Filter e pressionando F1.
- Dependendo do formato e do tamanho do painel, o conteúdo será organizado dinamicamente na horizontal ou na vertical.
Ao criar expressões de consulta
- É altamente recomendável usar parênteses sempre que houver qualquer possibilidade de a consulta não ser interpretada corretamente.
-
Os parênteses têm a maior precedência na ordem definida para os diversos operadores disponíveis, que determina como as consultas são interpretadas pelo software (quando você não tiver usado parênteses). A sequência dessa ordem é a seguinte:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Essa ordem de precedência é semelhante à usada em linguagens do tipo Pascal; o uso generoso de parênteses elimina dúvidas e facilita a leitura das consultas por outras pessoas. - As ambiguidades são resolvidas da esquerda para a direita.
- Os parênteses são avaliados de dentro para fora, e os níveis iguais são processados da esquerda para a direita.
- Como as opções de exibição dos objetos que atendem ou não ao filtro aplicado são separadas, você pode aplicar novas consultas de filtro para refinar os resultados da filtragem anterior.
- A filtragem aplicada ao usar consultas do painel SCH Filter é permanente. Ao mascarar objetos do projeto que não atendem ao filtro, a intensidade do mascaramento é controlada pela barra deslizante na parte inferior do painel.
- Um filtro permanente deve ser removido aplicando uma consulta vazia no painel SCH Filter.
Painel SCHLIB Filter
Localize e realce rapidamente objetos da biblioteca de esquemáticos usando consultas lógicas no painel SCHLIB Filter.
Resumo
O painel SCHLIB Filter permite criar filtros por meio de consultas lógicas. Um filtro definido pode então ser aplicado ao componente ativo da biblioteca de esquemáticos ou a todos os componentes da biblioteca de esquemáticos ativa, permitindo selecionar e editar vários objetos com maior precisão e eficiência. A exibição visual dos objetos pode ser definida com base naqueles que atendem aos critérios de busca do filtro e naqueles que não atendem.
Acesso ao painel
O painel pode ser acessado das seguintes maneiras:
- Clique no botão Painéis no canto inferior direito da área de trabalho e selecione SCHLIB Filter.
- Clique em View » Panels » SCHLIB Filter nos menus principais.
- Use a tecla de atalho F12.
Definição do escopo do filtro
A região esquerda do painel SCHLIB Filter contém controles para definir (limitar) o escopo do filtro.
As opções de escopo são:
- All Objects - aplica o filtro a todos os objetos do projeto.
- Selected Objects - aplica o filtro apenas aos objetos do projeto que estão selecionados no momento.
- Non Selected Objects - aplica o filtro apenas aos objetos do projeto que não estão selecionados no momento.
- Whole Library - controla se a filtragem é aplicada apenas ao componente ativo (opção desabilitada) ou a todos os componentes do documento da biblioteca de esquemáticos ativa (opção habilitada).
Definição de consultas de filtro
A região central do painel SCHLIB Filter permite criar filtros por meio da inserção de consultas lógicas.
Você pode digitar uma consulta diretamente no campo e, enquanto digita, uma lista de sugestões de palavras-chave será exibida para ajudar.
Assistente de consultas
Além da lista de sugestões, o painel também oferece o Assistente de Consultas para auxiliar na criação de consultas. Esse recurso pode ser muito útil se você não tiver certeza sobre a sintaxe de uma consulta ou sobre as possíveis palavras-chave que deseja usar. Para usar o Assistente de Consultas, clique no botão Helper para abrir a caixa de diálogo Query Helper. O mecanismo de consultas subjacente analisa o documento e lista todos os objetos disponíveis, juntamente com palavras-chave genéricas para uso em consultas.
Use a seção superior da caixa de diálogo para compor uma expressão de consulta usando os SCH Functions e System Functions disponíveis. A região central da caixa de diálogo fornece diversos operadores para uso na construção de uma expressão. Use o botão Check Syntax para verificar se uma expressão está sintaticamente correta.
Quando a expressão da consulta estiver definida conforme necessário, clique em OK para carregar a consulta na região central do painel SCHLIB Filter. Aplique o filtro usando o botão Apply.
Quando aplicado à biblioteca inteira, os pinos que atenderem ao filtro serão destacados em todos os outros componentes.
Para obter mais informações sobre a aplicação de filtros, consulte a seção Applying and Clearing a Filter abaixo.
Definição do destaque do filtro
Antes de aplicar a consulta no painel SCHLIB Filter, é recomendável definir como você deseja que o resultado da filtragem apareça visualmente na área de trabalho do editor de projetos. A região à direita do painel fornece várias opções que, em conjunto, formam os controles de destaque para filtragem permanente.
As opções Objects passing the filter permitem controlar como todos os objetos que estão dentro do escopo e correspondem à expressão de consulta específica do filtro serão exibidos visualmente na área de trabalho.
- Select - quando habilitada (padrão), os objetos filtrados serão selecionados na área de trabalho.
- Zoom - quando habilitada (padrão), os objetos filtrados serão ampliados e centralizados (quando possível) na janela do editor de bibliotecas. A ação de zoom pode ser determinada pelas opções de Zoom Library Components definidas na página Esquemático - Zoom automático da biblioteca da caixa de diálogo Preferences.
Por outro lado, as opções Objects not passing the filter permitem controlar como todos os objetos que do not estão dentro do escopo e/ou correspondem à expressão de consulta específica do filtro serão exibidos visualmente na área de trabalho.
- Deselect - quando habilitada (padrão), todos os objetos que não estiverem dentro do escopo do filtro serão desmarcados na área de trabalho.
- Mask out - quando habilitada (padrão), todos os objetos que não estiverem dentro do escopo do filtro serão mascarados na janela do editor de bibliotecas. Use o controle deslizante para definir o nível de mascaramento.
Aplicação e limpeza de um filtro
Depois de definir uma consulta e configurar as opções do painel conforme necessário, o filtro poderá ser aplicado clicando no botão Apply do painel ou pressionando Enter.
Para limpar o filtro aplicado no momento a partir do painel, limpe (selecione e exclua) a expressão de consulta na região central do painel e, em seguida, clique no botão Apply ou pressione Enter. Todos os objetos na área de trabalho do projeto voltarão a ficar totalmente visíveis e disponíveis para seleção/edição.
Para limpar a filtragem na área de trabalho e manter a expressão de consulta carregada na região central do painel, use o botão Clear Current Filter na barra de ferramentas Sch Lib Standard (atalho Shift+C).
Menu de contexto
Clicar com o botão direito do mouse no painel SCHLIB Filter dá acesso a opções e comandos adicionais por meio de um menu de contexto.
O menu fornece os seguintes comandos:
- Add to Favorites - use para adicionar a expressão de consulta exibida no momento na região central do painel à lista de consultas favoritas. A consulta aparecerá como uma nova entrada na guia Favorites da caixa de diálogo Gerenciador de Expressões. Ao ser adicionada à lista de consultas favoritas, a consulta será exibida na parte superior do menu de contexto. As dez consultas adicionadas mais recentemente à lista de favoritos serão exibidas no menu (a mais recente na parte superior), permitindo acessar e reutilizar rapidamente suas expressões de consulta favoritas.
- Organize Favorites - use para acessar a guia Favorites da caixa de diálogo Gerenciador de Expressões, na qual você pode organizar (renomear, excluir) as entradas da lista de consultas favoritas.
- Examples - clique para acessar um submenu de filtros de exemplo predefinidos. Ao escolher um filtro de exemplo, a expressão de consulta subjacente associada será carregada na região central do painel.
- History - clique para acessar um submenu contendo as nove expressões de consulta usadas mais recentemente, extraídas da lista de histórico de consultas do painel. Clique na entrada More para acessar a guia History da caixa de diálogo Gerenciador de Expressões, na qual você pode navegar pela lista completa do histórico de consultas e aplicar uma consulta, além de limpar a lista de histórico conforme necessário.
- Show Scope Options - use para alternar a exibição da região de escopo do filtro no painel.
- Show Masking Options - use para alternar a exibição da região de destaque do filtro no painel.
Notas
Geral
- Pressionar a tecla F12 alterna a visibilidade do painel na área de trabalho.
- A filtragem aplicada ao usar consultas do painel SCHLIB Filter é permanente durante a sessão. Um filtro permanente deve ser limpo por uma ação Clear correspondente (aplicação de uma consulta vazia a partir do painel SCHLIB Filter).
- Dependendo do formato e do tamanho do próprio painel SCHLIB Filter, o conteúdo será organizado dinamicamente na horizontal ou na vertical.
Construção de expressões de consulta
- É altamente recomendável usar parênteses sempre que houver qualquer possibilidade de a consulta não ser interpretada corretamente.
-
Os parênteses têm a maior precedência dentro de uma ordem de precedência definida para os diversos operadores disponíveis, que determina como as consultas são interpretadas pelo software (quando o usuário não inclui parênteses). A sequência dessa ordem é a seguinte:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Essa ordem de precedência é semelhante à usada em linguagens do tipo Pascal. No entanto, o uso abundante de parênteses elimina dúvidas e torna as consultas resultantes mais fáceis de serem lidas por outras pessoas. - As ambiguidades são resolvidas da esquerda para a direita.
- Os parênteses são avaliados de dentro para fora, e os níveis iguais são processados da esquerda para a direita.
Painel PCB Filter

O painel PCB Filter
Resumo
O painel PCB Filter fornece controles para criar filtros por meio da criação de consultas lógicas. Um filtro definido pode então ser aplicado à PCB ativa, permitindo selecionar e editar vários objetos com grande precisão e eficiência.
Acesso ao painel
O painel pode ser acessado no editor de PCB das seguintes maneiras:
- Clique no botão Painéis no canto inferior direito da área de trabalho e selecione PCB Filtro.
- Clique em View » Panels » PCB Filtro nos menus principais.
- Use a tecla de atalho F12 .
Seções do painel
O painel PCB Filter é composto por três regiões. As duas primeiras são áreas de listas selecionáveis que, em conjunto, definem o escopo da filtragem: Object e Layer.
A terceira região, Filter, exibe a consulta criada com base nos objetos e nas camadas selecionados no momento.
Criação de expressões de filtro simples
A região principal do painel fornece controles para criar rapidamente expressões de filtro simples voltadas para qualquer combinação de objetos. Os tipos de objeto são organizados em uma “matriz de objetos”, categorizados como objetos de rede (Net), objetos de componente (Comp) ou objetos livres (Free). A seguinte lista básica de objetos se repete nesses três grupos:
- Trilha
- Arco
- Via
- Pad
- Preenchimento
- Região
O objeto Text está disponível nos grupos Comp e Free ; no entanto, como esse tipo de objeto não possui associação com redes, ele não faz parte do grupo Net . Além disso, o grupo Free também inclui: Component, Component Body, Room e Polygon.
Se essas opções forem definidas como “Componente” e “Camada superior”, por exemplo, a visualização da placa destacará os componentes da camada superior. As seleções em ambas as seções do painel representam o efeito cumulativo de várias etapas de filtragem, que podem ser usadas para destacar rapidamente qualquer tipo de objeto de projeto.
Para usar um objeto na criação de uma expressão de filtro, ou seja, filtrar por esse objeto, marque a caixa de seleção correspondente a ele na matriz de objetos. Os comandos disponíveis no menu de contexto da região permitem marcar ou desmarcar rapidamente todas as entradas da matriz ou alternar o estado de todas as caixas de seleção da matriz.
Use a região Layer do painel para restringir o filtro a uma ou mais camadas específicas ou a uma classe específica de camadas. As entradas listadas refletem:
-
As classes de camadas definidas para a placa, cujos padrões são:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- As camadas definidas no empilhamento de camadas (conforme apresentadas no Editor de empilhamento de camadas).
- As camadas superior e inferior da máscara de pasta.
À medida que você faz as seleções de filtragem, a expressão de consulta resultante é criada dinamicamente e apresentada na região Filter do painel. Depois de definir a expressão de consulta do filtro conforme necessário, você deverá aplicá-la em uma ação separada. Para isso, clique no botão Apply to All na parte inferior do painel. Como alternativa, se quiser aplicar o filtro apenas aos objetos atualmente selecionados na área de trabalho, clique no botão Apply to Selected.
Filtragem por objeto
A seleção na lista Object do painel filtrará a visualização da placa para mostrar os objetos primitivos do projeto. Todos os objetos serão destacados, a menos que isso seja modificado pelas configurações nas listas de filtros Object e/ou Layer .

A placa exibida com Component Body e Pad (In Any Component) selecionados em Object. Layer está definido como <All>.

A placa exibida com Object definido como Tracks (In Any Net) e Pads (In Any Net). Layer está definido como <All>.
Filtragem por camada
A seleção na lista Layer do painel filtra a visualização da placa para mostrar os objetos na camada física designada do projeto (camadas de sinal, máscara e serigrafia). Todos os objetos válidos da camada serão destacados, a menos que isso seja modificado pelas configurações nas listas de filtros Layer e/ou Objects .

A placa exibida com Object definido como Components e Pads (In Any Component). Layers está definido como Top Layer.

A placa exibida com Object definido como Trilhas (em qualquer Net). Layer está definido como Bottom Layer.
Seleção de objetos filtrados
A ação conjunta de filtragem fornecida pelo painel auxilia tanto na visualização quanto na seleção dos objetos de interesse do projeto da placa.
Somente os objetos destacados (filtrados) podem ser selecionados, facilitando a localização, a edição e a consulta de informações sobre o objeto.
Limpeza do filtro
Limpe o filtro atualmente aplicado clicando no botão Clear .
Configuração da filtragem visual
O resultado visual da filtragem aplicada ao documento na área de trabalho é determinado por uma série de controles de realce. O efeito aplicado na visualização do editor pode ser definido como Normal, Mask ou Dim, sendo que, na prática, Mask tem o efeito de realce mais evidente.
A lista suspensa Normal / Mask / Dim oferece opções para diferenciar visualmente os objetos filtrados dos não filtrados na área de trabalho.

Selecione o tipo de filtragem visual aplicada usando a lista suspensa de modos de mascaramento.
O efeito de realce visual de cada modo de mascaramento:
- Normal - os objetos filtrados ficam visíveis na área de trabalho e a aparência dos objetos não filtrados permanece inalterada.
- Mask - os objetos filtrados são realçados na área de trabalho, enquanto todos os outros objetos ficam monocromáticos.
- Dim - os objetos filtrados são realçados na área de trabalho, enquanto todos os outros objetos mantêm suas cores, mas ficam esmaecidos.
Definição de consultas de filtro
A região central do painel oferece controles para criar filtros por meio da inserção de consultas lógicas.
Você pode digitar uma consulta diretamente no campo e, à medida que digita, uma lista de possíveis palavras-chave aparece para ajudar.
Estão disponíveis duas funções que auxiliam na criação de consultas: o Assistente de consultas e o Construtor de consultas. Essas funções podem ser muito úteis se você tiver dúvidas sobre a sintaxe de uma consulta ou sobre as possíveis palavras-chave que deseja usar.
Assistente de consultas
Para usar o Assistente de consultas, clique no botão Helper para abrir a caixa de diálogo Assistente de consultas. O mecanismo de consultas subjacente analisa o documento e lista todos os objetos disponíveis, além de palavras-chave genéricas para uso nas consultas.
Use a seção superior da caixa de diálogo para compor uma expressão de consulta usando os PCB Functions, PCB Object Lists e System Functions disponíveis. A região central da caixa de diálogo oferece uma variedade de operadores para usar na construção de uma expressão. Use o botão Check Syntax para verificar se a sintaxe de uma expressão está correta.
Quando a expressão da consulta estiver definida conforme necessário, clique em OK para carregar a consulta na região central do painel, pronta para aplicar o filtro.
Construtor de consultas
Para usar o Construtor de consultas, clique no botão Builder do painel para abrir a caixa de diálogo Construção de consulta a partir da placa. Essa caixa de diálogo permite criar uma consulta para selecionar objetos específicos no documento de projeto por meio da construção de uma sequência de condições combinadas com AND e/ou OR. O lado esquerdo da caixa de diálogo é usado para especificar as condições necessárias para selecionar o conjunto de objetos desejado. Inicialmente, a entrada na coluna Condition Type/Operator será Add first condition. Ao clicar uma vez nessa entrada, será exibida uma lista suspensa de tipos de condição.
Os tipos de condição listados serão apenas aqueles relevantes para um projeto de placa.
Selecione a condição desejada e clique na coluna Condition Value para acessar uma lista suspensa de valores possíveis para esse tipo de condição. À medida que você define uma condição no lado esquerdo da caixa de diálogo, uma prévia da consulta em construção é exibida no lado direito.
Continue adicionando 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, que é inserido automaticamente quando você adiciona outra condição.
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.
Especificação da precedência
Os botões
e
na parte superior da caixa de diálogo Construção de consulta a partir da placa permitem adicionar e remover parênteses ao redor da condição selecionada (aumentando e diminuindo o recuo). Isso permite estabelecer a precedência de determinadas condições combinadas logicamente com AND ou OR.
Por exemplo, considere a seguinte consulta construída:
InNet('5V') AND (OnLayer('TopLayer')
A primeira condição foi definida com o tipo de condição Belongs to Net e o valor 16M_IN. Em seguida, outra condição foi adicionada usando o tipo de condição Exists on Layer e o valor TopLayer.
Neste estágio, com a segunda condição selecionada na caixa de diálogo, o botão de seta para a direita foi acionado. Foram adicionados parênteses automaticamente ao redor da segunda condição e agora é possível adicionar uma condição dentro desse par de parênteses.
A terceira condição, com o tipo de condição Object Kind is e o valor Track, é então adicionada dentro dos parênteses.
Use a lista suspensa Show Level no canto superior esquerdo da caixa de diálogo para controlar a exibição dos níveis na sequência estruturada de condições. Basicamente, isso expande ou recolhe a exibição dos parênteses. A adição de parênteses cria efetivamente um novo nível. Você pode exibir os níveis de 1 a 5, mas, para quaisquer níveis adicionais, use a opção Show All Levels.
Como alternativa, clique nos símbolos de expansão ou recolhimento (associados a uma condição entre parênteses) para mostrar os próximos níveis ou ocultar o nível atual (e todos os níveis abaixo dele), respectivamente. Os botões
e
na parte superior da caixa de diálogo também podem ser usados para expandir ou recolher a condição selecionada.
Use os botões
e
na parte superior da caixa de diálogo para mover uma condição selecionada na sequência da consulta. No caso de uma condição com subníveis (ou seja, uma condição entre parênteses), qualquer condição na estrutura de níveis pode ser movida. Quando os níveis estão expandidos, uma condição pode ser movida para baixo ou para cima entre os níveis. Quando os níveis estão recolhidos, a condição é movida junto com a estrutura de níveis.
Para excluir uma condição, selecione-a e clique no botão
na parte superior da caixa de diálogo ou use a tecla Delete.
Quando a expressão da consulta estiver definida conforme necessário, clique em OK para carregar a consulta na região central do painel PCB Filter, pronta para aplicar o filtro.
Criação de regras de projeto
O painel PCB Filter também oferece um recurso para criar uma regra de projeto cujo escopo usará a expressão de consulta definida na região central do painel.
Para adicionar uma nova regra de projeto, clique no botão Create Rule do painel PCB Filter. A caixa de diálogo Choose Design Rule Type será aberta.
Essa caixa de diálogo lista todas as categorias e os tipos de regras disponíveis no documento de PCB. Escolha o tipo de regra que deseja criar e clique em OK (ou clique duas vezes diretamente na entrada). A caixa de diálogo Editor de regras e restrições de PCB será aberta.
O nome da regra recém-criada aparecerá selecionado na árvore de navegação à esquerda. A expressão de consulta da regra fica no painel superior direito da caixa de diálogo.
Uma regra do tipo escolhido é criada e a janela principal de edição da regra é exibida, pronta para que você defina restrições específicas para ela. A expressão de consulta do painel PCB Filter é inserida na região Full Query da caixa de diálogo. Ajuste as configurações da regra conforme necessário e aplique a nova regra.
Aplicar e limpar o filtro
Depois de definir uma consulta e configurar as opções no painel conforme necessário, o filtro pode ser aplicado clicando em um dos botões Apply do painel ou clicando em Enter.
Para limpar o filtro atualmente aplicado a partir do painel, apague (selecione e exclua) a expressão de consulta na região central do painel e, em seguida, clique em um dos botões Apply ou pressione Enter. Todos os objetos na área de trabalho do projeto voltarão a ficar totalmente visíveis e disponíveis para seleção/edição.
Menus de contexto
Clicar com o botão direito do mouse no painel PCB Filter permite acessar opções e comandos adicionais por meio de menus de contexto.
Clicar com o botão direito do mouse na região Object ou Layer do painel abre as seguintes opções do menu de contexto:
- Toggle Check - ative para alternar as opções. As opções atualmente selecionadas serão desmarcadas, enquanto as opções desmarcadas serão selecionadas.
- Check All - ative para selecionar todas as opções disponíveis.
- Uncheck All - ative para desmarcar todas as opções disponíveis.
Notas
Geral
- Pressionar a tecla F12 alterna a visibilidade do painel na área de trabalho.
- O construtor de consultas (caixa de diálogo Criar consulta a partir da placa) oferece um método simples de criar uma consulta, usando tipos de condições e valores sensíveis ao contexto que permitem usar apenas elementos 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.
- Como as opções de exibição dos objetos que atendem e dos que não atendem ao filtro aplicado são separadas, você pode aplicar novas consultas de filtro aproveitando os resultados das filtragens anteriores.
Ao criar expressões de consulta
-
É altamente recomendável usar parênteses sempre que houver qualquer possibilidade de a consulta não ser interpretada corretamente.
-
Os parênteses têm a maior precedência dentro da ordem de precedência definida para os diversos operadores disponíveis, que determina como as consultas são interpretadas pelo software (sempre que o usuário não tiver inserido parênteses). Essa ordem é a seguinte:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Essa ordem de precedência é semelhante à usada em linguagens do tipo Pascal. No entanto, o uso amplo de parênteses elimina dúvidas e facilita a leitura das consultas por outras pessoas. -
As ambiguidades são resolvidas da esquerda para a direita.
-
Os parênteses são avaliados de dentro para fora, e os níveis iguais são avaliados da esquerda para a direita.
Painel PCBLIB Filter
Resumo
O painel PCBLIB Filter fornece controles para criar filtros por meio de consultas lógicas. Um filtro definido pode então ser aplicado ao footprint do componente de PCB ativo ou a todos os footprints de componentes na biblioteca de PCB ativa, permitindo selecionar e editar vários objetos com grande precisão e eficiência.
Acesso ao painel
O painel pode ser acessado no Editor de Bibliotecas de PCB das seguintes maneiras:
- Clique no botão Painéis no canto inferior direito da área de trabalho e selecione a entrada PCBLIB Filter.
- Clique em View » Panels » PCBLIB Filter nos menus principais.
- Use a tecla de atalho F12.
Seções do painel
O painel PCBLIB Filter é composto por três regiões. As duas primeiras são áreas de listas selecionáveis que, juntas, definem o escopo da filtragem: Object e Layer. A terceira região, Filter, exibe a consulta criada com base nos objetos e nas camadas atualmente selecionados.
Criar expressões de filtro simples
A região principal do painel fornece controles para criar rapidamente expressões de filtro simples voltadas a qualquer combinação de objetos. Os tipos de objeto são organizados em uma “matriz de objetos”, categorizados como objetos de rede (Net), objetos de componente (Comp) ou objetos livres (Free). A seguinte lista básica de objetos se repete nesses três grupos:
- Trilha
- Arco
- Via
- Pad
- Preenchimento
- Região
O objeto Text está disponível nos grupos Comp e Free ; no entanto, como esse tipo de objeto não possui associação a redes, ele não faz parte do grupo Net . Além disso, o grupo Free também inclui Component, ComponentBody, Room e Polygon.
Se essas opções estiverem definidas como “Componentes” e “Camada superior”, por exemplo, a visualização da placa destacará os componentes da camada superior. As seleções em ambas as seções do painel representam o efeito cumulativo de várias etapas de filtragem, que podem ser usadas para destacar rapidamente qualquer tipo de objeto do projeto.
Para usar um objeto na criação de uma expressão de filtro, ou seja, filtrar por esse objeto, marque a caixa de seleção correspondente a ele na matriz de objetos. Os comandos disponíveis no menu de contexto da região permitem marcar ou desmarcar rapidamente todas as entradas da matriz, ou alternar o estado de todas as caixas de seleção da matriz, respectivamente.
Use a região Layer para restringir o filtro a uma ou mais camadas específicas ou a uma classe específica de camadas. As entradas listadas refletem:
-
As classes de camadas definidas para a placa, cujas classes padrão são:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- As camadas definidas no empilhamento de camadas (conforme apresentado em Empilhamento de camadas).
- As camadas superior e inferior de máscara de pasta.
À medida que você faz suas seleções de filtragem, a expressão de consulta resultante é criada dinamicamente e apresentada na região Filter do painel. Depois que a expressão de consulta do filtro tiver sido definida conforme necessário, você precisará aplicá-la em uma ação separada. Para isso, clique no botão Apply to All na parte inferior do painel. Como alternativa, se precisar aplicar o filtro apenas aos objetos que estão selecionados no espaço de trabalho, use o botão Apply to Selected.
Aplicação da filtragem
Os componentes da biblioteca de PCB são compostos por tipos de objetos primitivos (arcos, pads, trilhas etc.) dispostos em diferentes camadas da placa. Os objetos são 'livres' ou 'pertencem' a um objeto de grupo. Observe que selecionar Free na região Object destacará apenas os objetos que não fazem parte de um objeto de grupo.
Filtragem por objeto
A seleção na lista Object do painel filtrará a visualização da placa para mostrar objetos primitivos do projeto. Todos os objetos serão destacados, a menos que isso seja modificado pelas configurações na lista de filtros Layer .

A placa de exemplo é mostrada com Track e Arc selecionados em Object. Layer está definido como Top Overlay.
Filtragem por camada
A seleção na lista Layers do painel filtrará a visualização da placa para mostrar objetos na camada física de projeto especificada (camadas de sinal, máscara e serigrafia). Todos os objetos de camada válidos serão destacados, a menos que isso seja modificado pelas configurações na lista de filtros Object .

A placa de exemplo é mostrada com Object definido como Pad. Layer está definido como Top Layer.
Seleção de objetos filtrados
A ação conjunta de filtragem fornecida pelo painel PCBLIB Filter auxilia tanto na visualização quanto na seleção dos objetos de interesse do projeto da placa.
Somente os objetos destacados (filtrados) podem ser selecionados, facilitando a localização, a edição e a obtenção de informações sobre o objeto.
Remoção do filtro
Remova o filtro aplicado no momento usando o botão Clear do painel.
Configuração da filtragem visual
O resultado visual da filtragem aplicada ao documento no espaço de trabalho é determinado por uma série de controles de destaque. O efeito aplicado à visualização do editor pode ser definido como Normal, Mask ou Dim, sendo que, na prática, Mask tem o efeito de destaque mais evidente.
A lista suspensa Normal / Mask / Dim oferece opções para diferenciar visualmente os objetos filtrados dos não filtrados no espaço de trabalho.

Selecione o tipo de filtragem visual aplicada usando a lista suspensa de modos de mascaramento.
O efeito de destaque visual de cada modo de mascaramento:
- Normal - os objetos filtrados ficam visíveis no espaço de trabalho, e a aparência dos objetos não filtrados permanece inalterada.
- Mask - os objetos filtrados são destacados no espaço de trabalho, e todos os outros objetos ficam monocromáticos.
- Dim - os objetos filtrados são destacados no espaço de trabalho, enquanto todos os outros objetos mantêm suas cores, mas ficam esmaecidos.
Definição de consultas de filtro
A região central do painel permite criar filtros por meio da inserção de consultas lógicas.
Você pode digitar uma consulta diretamente no campo e, à medida que digita, uma lista de sugestões de palavras-chave possíveis aparecerá para ajudar.
Dois recursos estão disponíveis para auxiliar na criação de consultas: o Auxiliar de consultas e o Construtor de consultas. Esses recursos podem ser muito úteis se você tiver dúvidas sobre a sintaxe de uma consulta ou sobre as possíveis palavras-chave que deseja usar.
Auxiliar de consultas
Para usar o Auxiliar de consultas, clique no botão Helper para abrir a caixa de diálogo Auxiliar de consultas. O mecanismo de consulta subjacente analisa o documento e lista todos os objetos disponíveis, juntamente com palavras-chave genéricas para uso nas consultas.
Use a seção superior da caixa de diálogo para compor uma expressão de consulta usando os itens disponíveis em PCB Functions, PCB Object Lists e System Functions. A região central da caixa de diálogo fornece diversos operadores para uso na construção de uma expressão. Use o botão Check Syntax para verificar se a sintaxe de uma expressão está correta.
Quando a expressão da consulta tiver sido definida conforme necessário, clique em OK para carregar a consulta na região central do painel PCBLIB Filter, deixando-a pronta para aplicar o filtro.
Construtor de consultas
Para usar o Construtor de consultas, clique no botão Builder do painel PCBLIB Filter para abrir a caixa de diálogo Criação de consulta a partir da placa.
Essa caixa de diálogo permite criar uma consulta para localizar objetos específicos no documento de projeto, por meio da construção simples de uma sequência de condições combinadas com AND e/ou OR.
O lado esquerdo da caixa de diálogo é onde você especifica as condições necessárias para localizar o conjunto de objetos desejado. Inicialmente, a entrada na coluna Condition Type/Operator será Add first condition. Clique uma vez nessa entrada para abrir uma lista suspensa de tipos de condição.
Os tipos de condição listados incluirão apenas aqueles relevantes para um projeto de placa.
Selecione a condição e clique na coluna Condition Value para acessar uma lista suspensa de valores possíveis para esse tipo de condição. À medida que você define uma condição no lado esquerdo da caixa de diálogo, uma prévia da consulta em construção é mostrada no lado direito.
Continue adicionando 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 e é inserido automaticamente quando você adiciona outra condição.
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.
Especificação de precedência
Os botões
e
na parte superior da caixa de diálogo Criação de consulta a partir da placa permitem adicionar e remover parênteses em torno da condição selecionada no momento (aumentando e diminuindo o recuo). Isso permite definir a precedência de determinadas condições combinadas logicamente com AND ou OR.
A primeira condição foi definida com o tipo de condição Exists on Layer e o valor Top Layer. Em seguida, outra condição foi adicionada usando o tipo de condição Object Kind is com o valor Arc.
Nesta etapa, com a segunda condição selecionada na caixa de diálogo, o botão de seta para a direita foi clicado. Parênteses foram adicionados automaticamente ao redor da segunda condição, e agora é possível adicionar uma condição dentro desse par de parênteses.
A terceira condição, com o tipo de condição In Any Polygon, é então adicionada dentro dos parênteses.
Use a lista suspensa Show All Levels no canto superior esquerdo da caixa de diálogo para controlar a exibição dos níveis na sua sequência estruturada de condições. Basicamente, isso expande/recolhe a exibição dos parênteses. Adicionar parênteses cria efetivamente um novo nível. Você pode exibir os níveis de 1 a 5, mas, para quaisquer níveis adicionais, use a opção Show All Levels.
Como alternativa, clique nos símbolos de expansão ou recolhimento associados a uma condição entre parênteses para mostrar os próximos níveis ou ocultar o nível atual (e todos os níveis inferiores), respectivamente. Os botões
e
na parte superior da caixa de diálogo também podem ser usados para expandir ou recolher a condição selecionada.
Use os botões
e
na parte superior da caixa de diálogo para mover uma condição selecionada na sequência de consulta que está sendo construída. Para uma condição que tenha subníveis (ou seja, uma condição entre parênteses), qualquer condição na estrutura de níveis pode ser movida. Quando os níveis estão expandidos, uma condição pode ser movida para baixo ou para cima entre os níveis. Quando os níveis estão recolhidos, uma condição será movida por toda a estrutura de níveis.
Para excluir uma condição, selecione-a e clique no botão
na parte superior da caixa de diálogo ou use a tecla Delete.
Quando a expressão da consulta estiver definida conforme necessário, clique em OK para carregar a consulta na região central do painel PCBLIB Filter, pronta para aplicar o filtro.
Criação de regras de projeto
O painel PCBLIB Filter também oferece a possibilidade de criar uma regra de projeto. Seu escopo usará a expressão de consulta definida na região central do painel.
Para adicionar uma nova regra de projeto, clique no botão Create Rule do painel PCBLIB Filter. A caixa de diálogo Choose Design Rule Type será aberta.
Essa caixa de diálogo lista cada uma das categorias e tipos de regras disponíveis no documento PCB. Escolha o tipo de regra que deseja criar e clique em OK (ou clique duas vezes diretamente na entrada). A caixa de diálogo Editor de regras e restrições de PCB será aberta.
O nome da regra recém-criada aparece selecionado na árvore de navegação à esquerda. A expressão de consulta da regra fica no painel superior direito da caixa de diálogo.
Uma regra do tipo escolhido é criada, e a janela principal de edição da regra é exibida, pronta para que você defina restrições específicas para ela. A expressão de consulta do painel PCBLIB Filter é inserida na região Consulta completa da caixa de diálogo. Ajuste as configurações da regra conforme necessário e aplique a nova regra.
Aplicação e remoção do filtro
Depois de definir a consulta e configurar as opções no painel conforme necessário, o filtro pode ser aplicado clicando no botão Apply do painel ou pressionando Enter.
Para remover o filtro aplicado a partir do painel, limpe (selecione e exclua) a expressão de consulta na região central do painel e clique no botão Apply ou pressione Enter. Todos os objetos na área de trabalho do projeto voltarão a ficar totalmente visíveis e disponíveis para seleção/edição.
Menus do botão direito
Clique com o botão direito dentro do painel PCBLIB Filter para acessar opções e comandos adicionais por meio de menus pop-up.
Clicar com o botão direito na região Object ou Layer do painel abre as seguintes opções de menu de contexto:
- Toggle Check - ative para alternar as opções. As opções selecionadas serão desmarcadas, enquanto as opções desmarcadas serão selecionadas.
- Check All - ative para selecionar todas as opções disponíveis.
- Uncheck All - ative para desmarcar todas as opções disponíveis.
Notas
Geral
- Pressionar a tecla F12 alterna a visibilidade do painel na área de trabalho.
- O Construtor de consultas (caixa de diálogo Construção de consulta a partir da placa) oferece um método simples de construir uma consulta usando tipos de condição e valores sensíveis ao contexto, que permitem usar apenas os elementos relevantes na construção. Para a construção avançada de consultas com especificação completa de palavras-chave e sintaxe de operadores, use a caixa de diálogo Assistente de consultas.
- Como as opções de exibição dos objetos que atendem e dos que não atendem ao filtro aplicado são separadas, você pode aplicar novas consultas de filtro para refinar os resultados de filtragens anteriores.
Ao construir expressões de consulta
- É altamente recomendável usar parênteses sempre que houver alguma possibilidade de a consulta não ser interpretada corretamente.
-
Os parênteses têm a maior precedência dentro da ordem definida para os diversos operadores disponíveis, que determina como as consultas são interpretadas pelo software (quando o usuário não fornece parênteses). A sequência dessa ordem é a seguinte:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Essa ordem de precedência é semelhante à usada em linguagens do tipo Pascal. No entanto, o uso abundante de parênteses elimina dúvidas e facilita a leitura das consultas por outras pessoas. - As ambiguidades são resolvidas da esquerda para a direita.
- Os parênteses são avaliados de dentro para fora, e os níveis iguais são processados da esquerda para a direita.
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.
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):
- No painel PCB Filter, clique no botão Query Builder para criar uma consulta e carregar a expressão no painel.
- Na caixa de diálogo Editor de regras e restrições de PCB, clique no botão Builder para criar uma consulta que defina a quais objetos essa regra se aplica.
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
Opções e controles da caixa de diálogo Construtor de consultas
-
Show All Levels - use a lista suspensa para controlar a exibição dos níveis na expressão estruturada de condições. Basicamente, isso expande/recolhe a exibição dos parênteses. A adição de parênteses cria um novo nível, e você pode exibir os níveis de 1 a 5. Como alternativa, clique nos símbolos de expansão ou recolhimento para mostrar os próximos níveis ou ocultar o nível atual (e todos os níveis abaixo), respectivamente.
-
- use para remover os parênteses ao redor da condição atualmente selecionada (diminuindo o recuo). Isso permite definir a precedência de determinadas condições combinadas pelos operadores lógicos AND ou OR.
-
- use para adicionar parênteses ao redor da condição atualmente selecionada (aumentando o recuo). Isso permite definir a precedência de determinadas condições combinadas pelos operadores lógicos AND ou OR.
-
- use para mover uma condição selecionada para cima na expressão de consulta que está sendo criada. Para uma condição que possui subníveis (ou seja, uma condição entre parênteses), qualquer condição na estrutura de níveis pode ser movida. Quando os níveis estão expandidos, uma condição pode ser movida para cima através dos níveis. Quando os níveis estão recolhidos, uma condição é movida por toda a estrutura do nível.
-
- use para mover uma condição selecionada para baixo na expressão de consulta que está sendo criada. Para uma condição que possui subníveis (ou seja, uma condição entre parênteses), qualquer condição na estrutura de níveis pode ser movida. Quando os níveis estão expandidos, uma condição pode ser movida para baixo através dos níveis. Quando os níveis estão recolhidos, uma condição é movida por toda a estrutura do nível.
-
- use para expandir os símbolos e mostrar os próximos níveis.
-
- use para recolher os símbolos e ocultar o nível atual (e todos os níveis abaixo).
-
- use para excluir a condição selecionada.
- Condition Type/Operator - use esta região para especificar a(s) condição(ões) necessária(s) para selecionar o conjunto de objetos desejado. Inicialmente, a entrada na coluna Condition Type/Operator será Add first condition. Clique uma vez nessa entrada para abrir uma lista suspensa de tipos de condição. A lista depende do local de onde a caixa de diálogo foi aberta. Se você estiver criando uma consulta para uma regra de projeto específica na caixa de diálogo PCB Rules And Constraints Editor , a lista de condições mostrará apenas os tipos de condição possíveis para esse tipo de regra.
- Condition Value - escolha a primeira condição e clique na coluna Condition Value para acessar uma lista suspensa de valores possíveis para esse tipo de condição. À medida que você define uma condição, uma prévia da consulta em construção é exibida na região Query Preview.
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
-
Na caixa de diálogo Pesquisa em bibliotecas baseadas em arquivos (acessada clicando em
no canto superior direito do painel Componentes e escolhendo File-based Libraries Search no menu suspenso), clique no botão Helper .
File-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.
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.
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.
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.
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).
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.
Como usar consultas favoritas
Há três maneiras de usar suas consultas favoritas:
-
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.
-
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 ).
-
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.
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.
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 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.
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 .
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 |
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:
- Parênteses ()
- Not
- ^, *, /, Div, Mod, And
- +, -, Or, Xor
- =, <>, <, >, <=, >=
- &&, ||
Funções globais de consulta do sistema

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.
Funções aritméticas
ABS
Resumo
Retorna um número (real) cujo valor é igual ao valor absoluto do valor numérico do parâmetro. Se esse valor numérico for positivo, o número retornado terá o mesmo valor; caso contrário, o número retornado será igual ao valor numérico do parâmetro multiplicado por -1.
Sintaxe
ABS(X : Number / Numeric_String) : Number
Exemplo de uso
ABS(2.3)
Retorna 2.3.
ABS(-7.2)
Retorna 7.2.
CEIL
Resumo
Retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro. Se esse valor numérico for um inteiro exato, o número retornado terá exatamente o mesmo valor; caso contrário, o número retornado será o menor inteiro maior que o valor numérico do parâmetro.
Sintaxe
CEIL(X : Number / Numeric_String) : Number
Exemplo de uso
CEIL(5.0)
Retorna 5.
CEIL(5.33)
Retorna 6.
CEIL(-5.0)
Retorna -5.
CEIL(-5.33)
Retorna -5.
FLOOR
Resumo
Retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro. Se esse valor numérico for um inteiro exato, o número retornado terá exatamente o mesmo valor; caso contrário, o número retornado será o maior inteiro menor que o valor numérico do parâmetro.
Sintaxe
FLOOR(X : Number / Numeric_String) : Number
Exemplo de uso
FLOOR(5.0)
Retorna 5.
FLOOR(5.33)
Retorna 5.
FLOOR(-5.0)
Retorna -5.
FLOOR(-5.33)
Retorna -6.
FRAC
Resumo
Retorna um número (real) cujo valor depende da natureza do valor numérico do parâmetro:
- Se esse valor numérico for positivo, mas não for um inteiro exato, o número retornado será a diferença entre o valor numérico do parâmetro e o maior inteiro menor que o valor numérico do parâmetro.
- Se esse valor numérico for negativo, mas não for um inteiro exato, o número retornado será a diferença entre o valor numérico do parâmetro e o menor inteiro maior que o valor numérico do parâmetro.
- Se o valor numérico do parâmetro for um inteiro exato, o número retornado será 0.
Sintaxe
FRAC(X : Number / Numeric_String) : Number
Exemplo de uso
FRAC(5.0)
Retorna 0.
FRAC(5.33)
Retorna 0.33.
FRAC(-5.0)
Retorna 0.
FRAC(-5.33)
Retorna -0.33.
IIF
Resumo
Esta é uma construção de finalidade específica que contém três consultas. O valor da primeira consulta (entre o parêntese de abertura e a primeira vírgula) é avaliado. Se for True, a segunda consulta (entre as vírgulas) será retornada; caso contrário, a terceira consulta (entre a segunda vírgula e o parêntese de fechamento) será retornada.
Sintaxe
IIF(L : Boolean Query , A : Query , B : Query)
L, A e B são strings que especificam, cada uma, uma consulta; L precisa ser uma consulta booleana (ou seja, que retorne um resultado True ou False).
Exemplo de uso
IsArc And IIF(ArcStopAngle - ArcStartAngle >= 0 , ArcStopAngle - ArcStartAngle Between 30 And 60 , ArcStartAngle - ArcStopAngle Between 300 And 330)
Retorna todos os arcos cujo comprimento de arco é maior ou igual a 30 graus e menor ou igual a 60 graus. (A propriedade de comprimento de arco de um arco é um ângulo determinado subtraindo-se sua propriedade Ângulo inicial da propriedade Ângulo final. Um fator complicador é que a propriedade Ângulo final de um arco pode ser menor que sua propriedade Ângulo inicial, mas esta consulta avalia corretamente a propriedade de comprimento de arco real para todos os objetos de arco possíveis.)
IsComponent And IIF(Layer = 'Top Layer' , Rotation <> 0 , Rotation <> 180)
Retorna todos os componentes que estão no lado superior da PCB cuja propriedade Rotação não é 0 grau e todos os componentes que estão no lado inferior da PCB cuja propriedade Rotação não é 180 graus. (Os objetos de componente só podem estar na camada de sinal superior ou na camada de sinal inferior; portanto, qualquer componente que não esteja na camada de sinal superior deve estar na camada de sinal inferior.)
INT
Resumo
Retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro:
- Se esse valor numérico for positivo, mas não for um inteiro exato, o número retornado será o maior inteiro menor que o valor numérico do parâmetro.
- Se esse valor numérico for negativo, mas não for um inteiro exato, o número retornado será o menor inteiro maior que o valor numérico do parâmetro.
- Se esse valor numérico for um inteiro exato, o número retornado terá exatamente o mesmo valor.
Sintaxe
INT(X : Number / Numeric_String) : Number
Exemplos de uso
INT(5.0)
Retorna 5.
INT(5.33)
Retorna 5.
INT(-5.0)
Retorna -5.
INT(-5.33)
Retorna -5.
Dicas
Este é um nome alternativo para a função aritmética TRUNC.
MAX
Resumo
Retorna um número (real) cujo valor é igual ao valor máximo de todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplos de uso
MAX(2)
Retorna 2.
MAX(7,2,3)
Retorna 7.
Dicas
Pelo menos um parâmetro deve ser fornecido.
MIN
Resumo
Retorna um número (real) cujo valor é igual ao valor mínimo de todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplos de uso
MIN(2)
Retorna 2.
MIN(7,2,3)
Retorna 2.
Dicas
Pelo menos um parâmetro deve ser fornecido.
POWER
Resumo
Retorna um número (real) cujo valor é igual ao valor numérico do primeiro parâmetro elevado à potência do valor numérico do segundo parâmetro.
Sintaxe
POWER(X : Number / Numeric_String , Y : Number / Numeric_String) : Number
Exemplos de uso
POWER(3,2)
Retorna 9.
POWER(32,0.2)
Retorna 2.
POWER(16,-0.5)
Retorna 0,25.
ROUND
Resumo
Retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro:
- Se esse valor numérico for um inteiro exato, o número retornado terá exatamente o mesmo valor.
- Se esse valor numérico não for um inteiro exato, o número retornado será o inteiro mais próximo do valor numérico do parâmetro. Números positivos que estão exatamente no ponto médio entre inteiros adjacentes são arredondados upwards, enquanto números negativos que estão exatamente no ponto médio entre inteiros adjacentes são arredondados downwards.
Sintaxe
ROUND(X : Number / Numeric_String) : Number
Exemplos de uso
ROUND(5.0)
Retorna 5.
ROUND(5.33)
Retorna 5.
ROUND(5.5)
Retorna 6 (arredondado para cima).
ROUND(5.66)
Retorna 6.
ROUND(-5.0)
Retorna -5.
ROUND(-5.33)
Retorna -5.
ROUND(-5.5)
Retorna -6 (arredondado para baixo).
ROUND(-5.66)
Retorna -6.
SIGN
Resumo
Retorna o valor do sinal do parâmetro fornecido. Ou seja, retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro:
- Se esse valor numérico for positivo, o número retornado será 1.
- Se esse valor numérico for negativo, o número retornado será -1.
- Se esse valor numérico for exatamente zero, o número retornado será 0.
Sintaxe
SIGN(X : Number / Numeric_String) : Number
Exemplos de uso
SIGN(5.33)
Retorna 1.
SIGN(-5.33)
Retorna -1.
SIGN(0)
Retorna 0.
SQR
Resumo
Retorna um número (real) cujo valor é igual ao quadrado do valor numérico do parâmetro.
Sintaxe
SQR(X : Number / Numeric_String) : Number
Exemplos de uso
SQR(2)
Retorna 4.
SQR(14.1)
Retorna 198,81.
SQR(-1.5)
Retorna 2,25.
SQRT
Resumo
Retorna um número (real) cujo valor é igual à raiz quadrada (positiva) do valor numérico do parâmetro.
Sintaxe
SQRT(X : Number / Numeric_String) : Number
Exemplos de uso
SQRT(4)
Retorna 2.
SQRT(10)
Retorna 3,1623.
TRUNC
Resumo
Retorna um número inteiro cujo valor depende da natureza do valor numérico do parâmetro:
- Se esse valor numérico for positivo, mas não for um inteiro exato, o número retornado será o maior inteiro menor que o valor numérico do parâmetro.
- Se esse valor numérico for negativo, mas não for um inteiro exato, o número retornado será o menor inteiro maior que o valor numérico do parâmetro.
- Se esse valor numérico for um inteiro exato, o número retornado terá exatamente o mesmo valor.
Sintaxe
TRUNC(X : Number / Numeric_String) : Number
Exemplos de uso
TRUNC(5.0)
Retorna 5.
TRUNC(5.33)
Retorna 5.
TRUNC(-5.0)
Retorna -5.
TRUNC(-5.33)
Retorna -5.
Dicas
Este é um nome alternativo para a função aritmética INT.
ZERO
Resumo
Retorna um número inteiro cujo valor é 0 ou 1, dependendo do valor numérico do parâmetro. Se esse valor numérico for zero, o número retornado será 0; caso contrário, o número retornado será 1.
Sintaxe
ZERO(X : Number / Numeric_String) : Number
Exemplos de uso
ZERO(5.33)
Retorna 1.
ZERO(-5.33)
Retorna 1.
ZERO(0)
Retorna 0.
Funções trigonométricas
ACOS
Resumo
Retorna um número (real) cujo valor é igual ao ângulo do arco cosseno do número especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
ACOS(X : Number / Numeric_String) : Number
Exemplo de uso
ACOS(0)
Retorna 1.5708.
ACOS(0.5)
Retorna 1.0472.
ACOS(1)
Retorna 0.
ASIN
Resumo
Retorna um número (real) cujo valor é igual ao ângulo do arco seno do número especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
ASIN(X : Number / Numeric_String) : Number
Exemplo de uso
ASIN(0)
Retorna 0.
ASIN(0.5)
Retorna 0.5236.
ASIN(1)
Retorna 1.5708.
ATAN
Resumo
Retorna um número (real) cujo valor é igual ao ângulo do arco tangente do número especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
ATAN(X : Number / Numeric_String) : Number
Exemplo de uso
ATAN(0)
Retorna 0.
ATAN(1)
Retorna 0.7854.
ATAN(2.5)
Retorna 1.1903.
COS
Resumo
Retorna um número (real) cujo valor é igual ao cosseno do ângulo especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
COS(X : Number / Numeric_String) : Number
Exemplo de uso
COS(0)
Retorna 1.
COS(0.8)
Retorna 0.6967.
COS(1.57)
Retorna 0.0008.
COSH
Resumo
Retorna um número (real) cujo valor é igual ao cosseno hiperbólico do valor numérico do parâmetro.
Sintaxe
COSH(X : Number / Numeric_String) : Number
Exemplo de uso
COSH(TextHeight / TextWidth) < 70.5
Retorna objetos para os quais o cosseno hiperbólico da razão entre a distância TextHeight e a distância TextWidth é menor que 70.5. (Isso equivale a retornar objetos para os quais a razão entre a distância TextHeight e a distância TextWidth é menor que 4.9487).
(TextHeight / TextWidth) >= COSH(2.3)
Retorna objetos para os quais a razão entre a distância TextHeight e a distância TextWidth é maior ou igual ao cosseno hiperbólico de 2.3 (que é 5.0372).
COTAN
Resumo
Retorna um número (real) cujo valor é igual à cotangente do ângulo especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
COTAN(X : Number / Numeric_String) : Number
Exemplo de uso
COTAN(0.1)
Retorna 9.9666.
COTAN(0.8)
Retorna 0.9712.
COTAN(1.57)
Retorna 0.0008.
SIN
Resumo
Retorna um número (real) cujo valor é igual ao seno do ângulo especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
SIN(X : Number / Numeric_String) : Number
Exemplo de uso
SIN(0)
Retorna 0.
SIN(0.8)
Retorna 0.7174.
SIN(1.57)
Retorna 1.0.
SINH
Resumo
Retorna um número (real) cujo valor é igual ao seno hiperbólico do valor numérico do parâmetro.
Sintaxe
SINH(X : Number / Numeric_String) : Number
Exemplo de uso
SINH(TextWidth / TextHeight) < 0.17
Retorna objetos para os quais o seno hiperbólico da razão entre a distância TextWidth e a distância TextHeight é menor que 0.17. (Isso equivale a retornar objetos para os quais a razão entre a distância TextWidth e a distância TextHeight é menor que 0.1692).
(TextWidth / TextHeight) >= SINH(0.2)
Retorna objetos para os quais a razão entre a distância TextWidth e a distância TextHeight é maior ou igual ao seno hiperbólico de 0.2 (que é 0.2013).
TAN
Resumo
Retorna um número (real) cujo valor é igual à tangente do ângulo especificado pelo valor numérico do parâmetro; esse ângulo é expresso em radianos (e não em graus).
Sintaxe
TAN(X : Number / Numeric_String) : Number)
Exemplo de uso
TAN(0)
Retorna 0.
TAN(0.8)
Retorna 1.0296.
TAN(1.57)
Retorna 1255.7656.
TANH
Resumo
Retorna um número (real) cujo valor é igual à tangente hiperbólica do valor numérico do parâmetro.
Sintaxe
TANH(X : Number / Numeric_String) : Number
Exemplo de uso
TANH(TextWidth / TextHeight) < 0.17
Retorna objetos para os quais a tangente hiperbólica da razão entre a distância TextWidth e a distância TextHeight é menor que 0.17. (Isso equivale a retornar objetos para os quais a razão entre a distância TextWidth e a distância TextHeight é menor que 0.1717).
(TextWidth / TextHeight) >= TANH(0.2)
Retorna objetos para os quais a razão entre a distância TextWidth e a distância TextHeight é maior ou igual à tangente hiperbólica de 0.2 (que é 0.1974).
Funções exponenciais e logarítmicas
EXP
Resumo
Retorna um número (real) cujo valor é igual a e elevado à potência indicada pelo valor numérico do parâmetro. (O número e é a base dos logaritmos naturais e é aproximadamente igual a 2.7183).
Sintaxe
EXP(X : Number / Numeric_String) : Number
Exemplo de uso
EXP(0)
Retorna 1.
EXP(1)
Retorna 2.7183.
LG
Resumo
Retorna um número (real) cujo valor é igual ao logaritmo de base 10 do valor numérico do parâmetro.
Sintaxe
LG(X : Number / Numeric_String) : Number
Exemplo de uso
LG(1)
Retorna 0.
LG(10)
Retorna 1.
LG(25)
Retorna 1.3979.
LN
Resumo
Retorna um número (real) cujo valor é igual ao logaritmo natural (ou de base e) do valor numérico do parâmetro. (O número e é 2.7183).
Sintaxe
LN(X : Number / Numeric_String) : Number
Exemplo de uso
LN(1)
Retorna 0.
LN(2)
Retorna 0.6931.
LN(10)
Retorna 2.3026.
LOG
Resumo
Retorna um número (real) cujo valor é igual ao logaritmo de base 2 do valor numérico do parâmetro.
Sintaxe
LOG(X : Number / Numeric_String) : Number
Exemplo de uso
LOG(1)
Retorna 0.
LOG(2)
Retorna 1.
LOG(8)
Retorna 3.
LOG(10)
Retorna 3.3219.
Funções de agregação
AVG
Resumo
Retorna um número (real) cujo valor é igual à média dos valores de todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
AVG(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplo de uso
AVG(2)
Retorna 2.
AVG(7,2,3)
Retorna 4.
Dicas
- Pelo menos um parâmetro deve ser fornecido.
MAX
Resumo
Retorna um número (real) cujo valor é igual ao maior valor entre todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplo de uso
MAX(2)
Retorna 2.
MAX(7,2,3)
Retorna 7.
Dicas
Pelo menos um parâmetro deve ser fornecido.
MIN
Resumo
Retorna um número (real) cujo valor é igual ao menor valor entre todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplo de uso
MIN(2)
Retorna 2.
MIN(7,2,3)
Retorna 2.
Dicas
Pelo menos um parâmetro deve ser fornecido.
PROD
Resumo
Retorna um número (real) cujo valor é igual ao produto de todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
PROD(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplo de uso
PROD(2)
Retorna 2.
PROD(7,2,3)
Retorna 42.
Dicas
Pelo menos um parâmetro deve ser fornecido.
SUM
Resumo
Retorna um número (real) cujo valor é igual à soma de todos os parâmetros fornecidos. Cada parâmetro deve ser um número ou uma string numérica, e qualquer quantidade de parâmetros pode ser fornecida.
Sintaxe
SUM(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemplo de uso
SUM(2)
Retorna 2.
SUM(7,2,3)
Retorna 12.
Dicas
Pelo menos um parâmetro deve ser fornecido.
Funções do sistema
Copy
Resumo
Retorna uma substring de uma string. É possível especificar quantos caracteres a substring retornada terá e a posição na string que corresponderá ao primeiro caractere da substring retornada.
Sintaxe
Copy(S : String , Index : Integer , Count : Integer) : String
S é uma expressão do tipo string. Index e Count são expressões do tipo inteiro. Copy retorna uma substring contendo Count caracteres a partir de S[Index].
Se Index for maior que o comprimento de S, Copy retorna uma string vazia.
Se Count especificar mais caracteres do que os disponíveis, somente os caracteres de S[Index] até o final de S serão retornados.
Exemplo de uso
Copy('Cats and dogs',1,1)
Retorna 'C'. (Retorna 1 caractere da 1ª posição na string).
Copy('Cats and dogs',2,1)
Retorna 'a'. (Retorna 1 caractere da 2ª posição na string).
Copy('Cats and dogs',13,1)
Retorna 's'. (Retorna 1 caractere da 13ª posição na string).
Copy('Cats and dogs',14,1)
Retorna '' (uma string vazia). (Retorna 1 caractere da 14ª posição na string; no entanto, há apenas 13 caracteres na string, portanto uma string vazia é retornada).
Copy('Cats and dogs',1,2)
Retorna 'Ca'. (Retorna 2 caracteres a partir da 1ª posição na string).
Copy('Cats and dogs',2,2)
Retorna 'at'. (Retorna 2 caracteres a partir da 2ª posição na string).
Copy('Cats and dogs',12,2)
Retorna 'gs'. (Retorna 2 caracteres a partir da 12ª posição na string).
Copy('Cats and dogs',13,2)
Retorna 's'. (Retorna 2 caracteres a partir da 13ª posição na string; no entanto, há apenas 13 caracteres na string, portanto apenas 1 caractere é retornado).
Copy('Cats and dogs',15,2)
Retorna '' (uma string vazia). (Retorna 2 caracteres a partir da 15ª posição na string; no entanto, há apenas 13 caracteres na string, portanto uma string vazia é retornada).
Copy('Cats and dogs',1,6)
Retorna 'Cats a'. (Retorna 6 caracteres a partir da 1ª posição na string).
Copy('Cats and dogs',5,9)
Retorna ' and dogs'. (Retorna 9 caracteres a partir da 5ª posição na string).
Copy('Cats and dogs',8,5)
Retorna 'd dog'. (Retorna 5 caracteres a partir da 8ª posição na string).
Copy('Cats and dogs',8,6)
Retorna 'd dogs'. (Retorna 6 caracteres a partir da 8ª posição na string).
Copy('Cats and dogs',8,7)
Retorna 'd dogs'. (Retorna 7 caracteres a partir da 8ª posição na string; no entanto, há apenas 13 caracteres na string, portanto apenas 6 caracteres são retornados).
Length
Resumo
Retorna o número de caracteres contidos em uma string.
Sintaxe
Length(S : String) : Integer
S é a string cuja contagem de caracteres deve ser retornada.
Exemplo de uso
Length(Name) Between 4 And 7
Retorna objetos que possuem uma propriedade Name contendo entre 4 e 7 caracteres.
Length('Cat')
Retorna 3.
Length('Darryll')
Retorna 7.
Length('Cats and dogs')
Retorna 13.
Length('')
Retorna 0.
Pos
Resumo
Retorna o índice do primeiro caractere de uma substring especificada que ocorre em uma determinada string.
Sintaxe
Pos(Substr : String , S : String) : Integer
Pos procura uma substring, Substr, dentro de uma string, S. Substr e S são expressões do tipo string. Retorna um valor inteiro que corresponde ao índice do primeiro caractere de Substr.
Exemplo de uso
Pos('T',Name) = 1
Retorna todos os objetos que possuem uma propriedade Name cuja string associada apresenta a primeira ocorrência de 'T' na primeira posição; 'T1' e 'Time Table' são exemplos dessas strings. ('T' aparece duas vezes na string 'Time Table', mas sua primeira ocorrência está na primeira posição.)
Pos('A',Name) = 2
Retorna todos os objetos que possuem uma propriedade Name cuja string associada apresenta a primeira ocorrência de 'A' na segunda posição; 'RA1' e 'CABLE CHART' são exemplos dessas strings.
Pos('B',Name) = 0
Retorna todos os objetos que têm uma propriedade Name cuja string associada não contém 'B' em nenhuma posição; 'D1' e 'Time Table' são exemplos dessas strings. (A string 'Time Table' contém 'b' na oitava posição, mas Pos diferencia maiúsculas de minúsculas.)
Pos('D',Name) > 0
Retorna todos os objetos que têm uma propriedade Name cuja string associada contém 'D' em pelo menos uma posição, em qualquer local; 'Data Chart', 'U1D' e 'Install either D1 and D2 or D3 and D4, but never install all of these.' são exemplos dessas strings.
Pos('Con',Name) = 1
Retorna todos os objetos que têm uma propriedade Name cuja string associada contém a primeira ocorrência de 'Con' na primeira, segunda e terceira posições; 'Concatenate' é um exemplo dessa string. (A primeira ocorrência de 'Con' em 'Concatenate' corresponde aos três primeiros caracteres da string; o primeiro caractere de 'Con' é 'C', que ocupa a primeira posição em 'Concatenate'.)
Pos('ate',Name) = 5
Retorna todos os objetos que têm uma propriedade Name cuja string associada contém a primeira ocorrência de 'ate' na quinta, sexta e sétima posições; 'Concatenate' é um exemplo dessa string. (A primeira ocorrência de 'ate' em 'Concatenate' corresponde aos caracteres da quinta à sétima posição da string; o primeiro caractere de 'ate' é 'a', que ocupa a quinta posição em 'Concatenate'.)
Pos('ate',Name) = 0
Retorna todos os objetos que têm uma propriedade Name cuja string associada não contém 'ate' em nenhuma posição; 'C1' e 'TIME:' são exemplos dessas strings.
Pred
Resumo
Retorna um número (real) cujo valor é igual ao valor numérico do parâmetro menos 1.0.
Sintaxe
Pred(X : Number / Numeric_String) : Number
Exemplo de uso
Pred(4.1)
Retorna 3.1.
Pred(41.313)
Retorna 40.313.
Random
Resumo
Retorna um número aleatório entre 0 e X-1.
Sintaxe
Random(X) : Number
Exemplo de uso
Random(10)
Retorna um valor entre 0 e 9.
Random(100)
Retorna um valor entre 0 e 99.
Succ
Resumo
Retorna um número (real) cujo valor é igual ao valor numérico do parâmetro mais 1.0.
Sintaxe
Succ(X : Number / Numeric_String) : Number
Exemplo de uso
Succ(2.1)
Retorna 3.1.
Succ(41.313)
Retorna 42.313.





















