Trabalhando com objetos de texto

Num relance

Este artigo mostra como posicionar, formatar e editar objetos de texto no Altium Designer, tanto em documentos de PCB quanto em footprints de PCB, incluindo textos de linha única, quadros de texto com várias linhas e opções como códigos de barras e códigos QR. Ele também explica como funcionam as strings especiais, de onde vêm seus valores, como são exibidas e como podem ser usadas para mostrar informações da placa, do projeto, do sistema e de parâmetros diretamente na PCB ou nos arquivos de saída gerados. Se você procura um guia prático para aproveitar melhor os textos na sua placa e na documentação, este artigo ajudará você a usar esses recursos com confiança. Continue lendo.

- Aprenda a posicionar e editar objetos de texto, alternar entre os modos String e Frame e usar atalhos de teclado para girar, espelhar, inverter e mudar de camada.
- Entenda o que são strings especiais, como adicioná-las e como elas podem exibir informações da PCB, do projeto, de variantes, de componentes e do sistema.
- Veja como os objetos de texto podem atender às necessidades de documentação e fabricação por meio de quadros de texto com quebra automática de linha e suporte a códigos de barras e códigos QR.
Aprofunde-se com a IA:

Um objeto de Texto insere uma string de linha única ou um quadro de texto com várias linhas na camada selecionada, em diversos estilos e formatos de exibição, incluindo padrões populares de códigos de barras e códigos QR. Pode ser um texto definido pelo usuário ou um tipo específico de string, denominado string especial, que pode ser usado para exibir informações da placa ou do sistema ou o valor de parâmetros do usuário na placa. O quadro de texto é uma área retangular redimensionável que pode conter várias linhas de texto e pode quebrar as linhas e recortar o texto automaticamente para mantê-lo dentro dos limites do quadro.

Objetos de Texto posicionados
Objetos de Texto posicionados

Os objetos de Texto podem ser inseridos tanto no editor de PCB quanto no editor de footprints de PCB, selecionando o comando Place » String ou Place » Text Frame nos menus principais. Após iniciar o comando de inserção de strings, o cursor mudará para uma mira e você entrará no modo de inserção de texto. Um objeto de texto aparecerá vinculado ao cursor:

  1. Posicione o cursor e clique ou pressione Enter para inserir um objeto de texto.
  2. Continue inserindo outros objetos de texto ou clique com o botão direito ou pressione Esc para sair do modo de inserção.
Dependendo do comando de inserção selecionado (Place » String ou Place » Text Frame), o objeto de Texto que está sendo inserido estará no modo String ou Frame, que pode ser alterado no painel Properties durante ou após a inserção.

Outras ações que podem ser realizadas durante a inserção:

  • Pressione Spacebar para girar o objeto de texto no sentido anti-horário ou Shift+Spacebar para girá-lo no sentido horário. A rotação segue o valor de Rotation Step definido na  página PCB Editor – General da caixa de diálogo Preferences.
  • Pressione as teclas X ou Y para espelhar o objeto de texto ao longo do eixo X ou Y.
  • Pressione a tecla L para transferir o objeto de texto para o outro lado da placa.
  • Pressione as teclas + e - (no teclado numérico) para percorrer, para frente e para trás, todas as camadas visíveis do projeto e alterar rapidamente a camada de inserção.

O método de edição gráfica permite selecionar um objeto de texto posicionado diretamente na área de projeto e alterar sua localização, rotação, orientação e tamanho.

Quando um objeto de texto é selecionado, as seguintes alças de edição ficam disponíveis:

Um Texto selecionado
Um Texto selecionado

  • Clique e arraste B para girar o objeto de texto em torno de seu ponto de referência A (indicado pelo pequeno x).
  • Clique e arraste C para redimensionar a caixa delimitadora do objeto de texto nas direções vertical e horizontal simultaneamente.
  • Clique e arraste D para redimensionar a caixa delimitadora do objeto de texto nas direções vertical e horizontal separadamente.
  • Clique em qualquer ponto do objeto de texto afastado das alças de edição e arraste para reposicioná-lo. Durante o arraste, o comentário pode ser girado ou espelhado:
    • Pressione Spacebar para girar o objeto de texto no sentido anti-horário ou Shift+Spacebar para girá-lo no sentido horário. A rotação segue o valor de Rotation Step definido na página PCB Editor – General da caixa de diálogo Preferences.
    • Pressione as teclas X ou Y para espelhar o objeto de texto ao longo do eixo X ou Y.
  • O texto padrão de um objeto de string recém-inserido é String. Após a inserção (a menos que tenha sido alterado antes ou durante a inserção), altere esse texto conforme necessário usando a janela de entrada de texto ao visualizar as propriedades da string no painel Properties.
  • O software permite inserir objetos de Texto como símbolos de códigos de barras diretamente em uma PCB, em qualquer camada, permitindo que os códigos de barras sejam facilmente impressos na PCB como parte do processo de fabricação. Para saber mais sobre o uso de um objeto de Texto como código de barras, consulte a seção Adicionar um código de barras da página Incluir códigos de barras & logotipos.
  • O software permite inserir objetos de Texto como códigos QR diretamente em uma PCB, em qualquer camada, permitindo que os códigos QR sejam facilmente impressos na PCB como parte do processo de fabricação. Para saber mais sobre o uso de um objeto de Texto como código QR, consulte a seção Adicionar um código QR da página Incluir códigos de barras & logotipos.

Strings especiais

Embora os objetos de texto possam ser usados para inserir texto definido pelo usuário na camada atual da PCB, não é only texto definido pelo usuário que pode ser inserido. Para auxiliar na produção de documentação, utiliza-se o conceito de special strings. Essas strings funcionam como marcadores de posição para informações do design, do sistema ou do projeto que serão exibidas na PCB no momento da geração dos arquivos de saída.

Exemplos de strings especiais de design, sistema e parâmetros de projeto, mostradas como strings de origem (na primeira imagem) e convertidas (na segunda imagem). 
Exemplos de strings especiais de design, sistema e parâmetros de projeto, mostradas como strings de origem (na primeira imagem) e convertidas (na segunda imagem).

As strings especiais disponíveis em um documento de PCB vêm de várias fontes:

  • Um conjunto padrão de strings especiais predefinidas é fornecido para uso em novos documentos de PCB.
  • Strings especiais personalizadas podem ser adicionadas pela definição de parâmetros adicionais no nível do projeto (esses parâmetros são definidos na guia Parameters da caixa de diálogo Project Options) e no nível da variante (esses parâmetros são definidos na caixa de diálogo Edit Project Variant ou no painel Properties em seu modo Variant no Variant Manager).
  • Parâmetros do usuário adicionados aos componentes no ambiente de esquemático são transferidos por meio de uma ECO e ficam disponíveis para os componentes da PCB. Se uma string especial que faz referência a um parâmetro de componente for adicionada a um footprint de PCB na biblioteca de origem, essa string será interpretada na camada mecânica de destino ou na camada de serigrafia quando o componente da PCB for inserido.

Observações sobre o uso de strings especiais

  • Uma string especial é identificada por começar com o caractere . (ponto) (por exemplo, .Layer_Name, .Net_Count, etc.).  Se uma string começar com ".", toda a string será tratada como uma string "especial". Essa sintaxe também é usada ao fazer referência a um parâmetro do usuário: o nome do parâmetro é precedido pelo caractere "." (ponto).
  • Para incluir mais de uma string especial em um texto da PCB, coloque cada string especial entre apóstrofos ( ' ); por exemplo: '.Pcb_File_Name_No_Path' '.Print_Date'.
  • Você também pode usar texto, espaços e caracteres especiais entre strings especiais concatenadas, por exemplo: FileName= '.Pcb_File_Name_No_Path' : PrintDate = '.Print_Date'.
  • Espaços e caracteres especiais também podem ser usados nos nomes de parâmetros de projeto e de variante.
  • Os valores de algumas strings especiais só podem ser visualizados quando a saída correspondente é gerada, incluindo .Legend, .Plot_File_Name e .Printout_Name. A maioria das strings especiais pode ser visualizada na tela.

    Ao gerar a documentação de um projeto de PCB e liberá-la em um Workspace, é necessário haver uma forma de indicar a qual Item e Revisão a documentação se refere, assim como a configuração do projeto utilizada na liberação e qualquer variante aplicável que a determine. Um conjunto de strings especiais está disponível para gerenciar isso, incluindo .PCBConfigurationName, .ItemAndRevision e .VariantName. Essas strings especiais só são interpretadas quando a saída é gerada (exceto ao visualizar a PCB em 3D, o que, por si só, é considerado uma saída). As informações fornecidas por essas strings podem ser vistas nas saídas geradas, incluindo arquivos Gerber/ODB++, impressões da arte final, impressões da PCB, impressões 3D da PCB, vídeos 3D da PCB e desenhos de montagem.
  • As strings especiais são convertidas automaticamente para exibição na tela. Se a string não puder ser convertida, será exibido o valor da string digitada ou uma mensagem. Por exemplo, se o projeto não estiver sob controle de versão e a string especial .VersionControl_RevNumber for posicionada na PCB, a mensagem Not in Version Control será exibida.
  • Para ajudar a identificar strings especiais, o painel Configuração de visualização inclui uma opção Special Strings. Quando essa opção está habilitada, todos os objetos de texto posicionados que resultam da conversão de strings especiais serão sobrepostos com um rótulo contendo o nome da string especial não convertida.

Posicionamento de uma string especial

Para usar uma string especial em uma PCB, posicione um objeto de texto e selecione um dos nomes de strings especiais na lista suspensa do campo Texto (modo String) ou na lista suspensa  (modo Frame) no painel Properties.

Acesso às strings especiais de um objeto de texto posicionado.
Acesso às strings especiais de um objeto de texto posicionado.

As seguintes strings especiais predefinidas, baseadas no sistema, estão disponíveis para uso em um documento de PCB:

  • .Application_BuildNumber – a versão do software em que a PCB está carregada no momento. Ao gerar uma saída Gerber, use essa string para registrar a compilação do software em que o projeto foi criado.
  • .Arc_Count – o número de arcos na PCB.
  • .BlindVia_Count – o número de vias cegas na PCB.
  • .Board_Height – a dimensão vertical da placa de circuito impresso.
  • .Board_Width – a dimensão horizontal da placa de circuito impresso. 
  • .BuriedVia_Count – o número de vias enterradas na PCB.
  • .Comment – a string de comentário de um componente (posicionada em qualquer camada no editor de bibliotecas como parte do footprint do componente).
  • .Component_Count – o número de componentes na PCB.
  • .ComponentMixed_Count – o número de componentes com pads mistos na PCB.
  • .ComponentSMD_Count – o número de componentes com pads SMD na PCB.
  • .ComponentThru_Count – o número de componentes com pads de furo passante na PCB.
  • .ComputerName – o nome do computador no qual o software está instalado e em execução.
  • .CopperInner_Weight_Max – o peso máximo de cobre nas camadas internas.
  • .CopperOuter_Weight_Max – o peso máximo de cobre nas camadas externas.
  • .Designator – a string do designador de um componente (posicionada em qualquer camada no editor de bibliotecas como parte do footprint do componente).
  • .Fill_Count – o número de preenchimentos na PCB.
  • .Hole_Count – o número de furos na PCB.
  • .Hole_Size_Min – o diâmetro mínimo dos furos na PCB.
  • .Hole_Size_Num – o número de diâmetros de furo distintos na PCB.
  • .Item – o Item ao qual os dados gerados se referem (por exemplo, D-810-2000). Os dados serão usados para fabricar esse item.
  • .ItemAndRevision – o item e a revisão específica desse Item aos quais os dados gerados se referem, no formato <Item ID>-<Revision ID> (por exemplo, D-810-2000-01.A.1). Os dados serão usados para fabricar essa revisão específica desse item.
  • .ItemRevision – a revisão específica do Item à qual os dados gerados se referem (por exemplo, 01.A.1). Os dados são armazenados nessa Revisão do Item no servidor de destino.
  • .ItemRevisionBase – a parte do Nível Base do esquema de nomenclatura de uma Revisão do Item (por exemplo, 1).
  • .ItemRevisionLevel1 – a parte do Nível 1 do esquema de nomenclatura de uma Revisão do Item (por exemplo, A).
  • .ItemRevisionLevel1AndBase – as partes do Nível 1 e do Nível Base do esquema de nomenclatura de uma Revisão do Item (por exemplo, A.1).
  • .ItemRevisionLevel2 – a parte do Nível 2 do esquema de nomenclatura de uma Revisão do Item (por exemplo, 01).
  • .ItemRevisionLevel2AndLevel1 – as partes do Nível 2 e do Nível 1 do esquema de nomenclatura de uma Revisão do Item (por exemplo, 01.A).
  • .Layer_Count – o número de camadas de cobre na PCB.
  • .Layer_Name – o nome da camada na qual a string está posicionada.
  • .Legend – uma legenda de símbolos para desenhos de furação mecânica. Esta string só é válida quando posicionada na camada de desenho de furação. Observação: este é um recurso legado; posicione um objeto de tabela de furação para obter informações mais detalhadas sobre os furos.
  • .MicroVia_Count – o número de microvias na PCB.
  • .ModifiedDate – o registro da data de modificação da PCB; ele é preenchido automaticamente. Exemplo: 23/09/2015.
  • .ModifiedTime – o registro da hora de modificação da PCB; ele é preenchido automaticamente.
  • .Net_Count – o número total de redes distintas na PCB.
  • .Net_Names_On_Layer – os nomes de todas as redes na camada específica. Esta string só é válida quando posicionada em uma camada de plano interno.
  • .Pad_Count – o número de pads na PCB.
  • .PadSMD_Count – o número de pads SMD na PCB.
  • .PadThru_Count – o número de pads de furo passante na PCB.
  • .Pattern – os nomes dos footprints de componentes usados na PCB.
  • .Pcb_File_Name – o caminho e o nome do arquivo do documento de PCB.
  • .Pcb_File_Name_No_Path – o nome do arquivo do documento de PCB.
  • .PCBConfigurationName – exibe o nome do conjunto de dados a partir do qual a saída foi gerada, conforme definido no Liberador de projetos. Observe que os nomes das configurações padrão Source, Fabrication e Assembly não podem ser editados (por exemplo, a saída de Fabricação exibirá Fabricação para .PCBConfigurationName). As configurações personalizadas definidas pelo usuário exibirão o nome definido pelo usuário quando esta string especial for usada (mostrar imagem).
  • .Plot_File_Name – para saídas Gerber geradas, esta string identifica o nome do arquivo de plotagem Gerber. Para saídas impressas, ela identifica a camada representada na saída. Para saídas ODB++, ela identifica o nome da pasta pai na qual os arquivos são armazenados.
  • .Poly_Count – o número de polígonos na PCB (incluindo preenchimentos poligonais, planos internos e planos divididos).
  • .Print_Date – a data da impressão/plotagem.
  • .Print_Scale – o fator de escala da impressão/plotagem.
  • .Print_Time – a hora da impressão/plotagem.
  • .Printout_Name – o nome da impressão.
  • .SlotHole_Count – o número de furos oblongos na PCB.
  • .SolderMask_Bottom – disponibilidade da máscara de solda inferior. Se não houver uma camada de máscara de solda inferior, o parâmetro terá o valor No mask. Se houver uma camada de máscara de solda inferior, mas sua cor não estiver definida, o parâmetro terá o valor No color. Se houver uma camada de máscara de solda inferior com a cor definida, o parâmetro exibirá a cor, seja pelo nome (Green, Black, Blue, Red, etc.) ou pelo código RGBA (por exemplo, #FF0065FF).
  • .SolderMask_Top – disponibilidade da máscara de solda superior. Se não houver uma camada de máscara de solda superior, o parâmetro terá o valor No mask. Se houver uma camada de máscara de solda superior, mas sua cor não estiver definida, o parâmetro terá o valor No color. Se houver uma camada de máscara de solda superior com a cor definida, o parâmetro exibirá a cor, seja pelo nome (Green, Black, Blue, Red, etc.) ou pelo código RGBA (por exemplo, #FF0065FF).
  • .SquareHole_Count – o número de furos quadrados na PCB.
  • .StackedVia_Count – o número de vias empilhadas na PCB.
  • .String_Count – o número de strings na PCB.
  • .Thru_Via_Count – o número de vias passantes na PCB.
  • .Total_Thickness – a espessura da placa.
  • .Total_Thickness(Board Layer Stack) – a espessura do empilhamento de camadas da placa.
  • .Track_Count – o número de trilhas na PCB.
  • .VariantName – a variante do projeto a partir da qual a saída foi gerada.
  • .VersionControl_PrjFolderRevNumber – o número da revisão atual do projeto, que é incrementado sempre que um commit completo do projeto (ou seja, incluindo o arquivo do projeto) é realizado. É necessário usar o controle de versão para que esta string contenha alguma informação.
  • .VersionControl_ProjFolderRevNumber – o número da revisão atual do projeto, que é incrementado sempre que um commit completo do projeto (ou seja, incluindo o arquivo do projeto) é realizado. É necessário usar o controle de versão para que esta string contenha alguma informação.
  • .VersionControl_ProjFolderRevNumberShort – um hash Git em formato curto (os primeiros oito caracteres) do projeto. É necessário usar o controle de versão para que esta string contenha alguma informação.
  • .VersionControl_RevNumber – o número da revisão atual do documento. É necessário usar o controle de versão para que esta string contenha alguma informação.
  • .VersionControl_RevNumberShort – um hash Git em formato curto (os primeiros oito caracteres) do número da revisão atual do documento. É necessário usar o controle de versão para que esta string contenha alguma informação.
  • .Via_Count – o número de vias na PCB.
A lista completa de strings especiais disponíveis também incluirá aquelas derivadas de parâmetros definidos pelo usuário no nível do projeto.
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

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

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

Documentação Legada

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

Contents