Open Property Sets

O que faz

Um property set é um pacote nomeado de campos anexado a uma entidade do desenho: pset.seguranca.defensa.corpo com as propriedades def.comprimento, def.material, e assim por diante. É a forma de o projeto guardar, na própria entidade, o que a geometria não diz.

O assunto tem duas metades, e quase toda dúvida vem de confundi-las:

Os dois depósitos dos dados

• Open Property Sets — o registro portável. Um registro por entidade, dentro da entidade, num formato que qualquer leitor de DWG entende (veja O formato). Não precisa de Object Enabler, nunca vira proxy, e todo CAD o preserva ao abrir e salvar. É a fonte da verdade.
• O property set nativo (AEC). Só existe sob um vertical da Autodesk. Quando o host é o Civil 3D, cada gravação do CapCad é repetida no set nativo, resolvendo o identificador estável para o nome de exibição do estilo. Fora do Civil 3D só o registro portável é gravado.

O que une os dois é o identificador estável. Cada set e cada propriedade do estilo tem um var (interno, com pontos, minúsculo — pset.vertical.placa, def.comprimento) e um name (o nome que aparece no CAD, sem pontos — PSET-VERTICAL-PLACA, COMP). O registro guarda sempre o var; o name serve à exibição e ao lado nativo. Renomear uma propriedade no estilo não desconecta nada, e a migração entre dois estilos que nomeiam o mesmo campo de forma diferente funciona.

Fluxo de trabalho

1. Defina os sets no estilo. Aba Property Sets do Editor de estilos: o var de cada set, o nome que levará no CAD, a lista de propriedades com tipo e valor padrão, e as regras que anexam o set automaticamente.
2. Anexe os sets às entidades. Pela palette, com Adicionar property sets...; com Aplicar regras, que anexa a cada entidade os sets cujas regras combinam com ela; ou automaticamente, quando o Assistente 3D converte o desenho com Open Property Sets marcado.
3. Preencha os valores. Na palette, no lugar; por fórmula ou fonte automática, sem digitar nada; ou no Excel, exportado e importado pela palette.
4. Confira. Auditoria... na palette mede, no espaço atual, quão completos estão os dados: que entidades deveriam ter um set e não têm e, por propriedade, quantos valores estão preenchidos, vazios ou com erro.
5. Entregue. CAPCAD_PROJECT_IFC, ou a aba IFC do gerenciador.

No Civil 3D, acrescente um passo antes de anexar: instale as definições no desenho (CAPCAD_PSET_INSTALL ou a aba Instalar do gerenciador), para que o lado nativo tenha onde pendurar os valores.

A palette

CAPCAD_PSET_EDIT abre CapCad Properties, uma palette ancorável no formato da janela Properties do próprio CAD. Ela acompanha a seleção: o cabeçalho nomeia o tipo da entidade e, num bloco, o seu nome; uma seleção múltipla mostra a contagem. Abaixo vêm as seções recolhíveis:

Um valor editado na grade é gravado na hora. Com várias entidades selecionadas, uma linha cujo valor difere entre elas mostra *VÁRIOS*, e uma edição é gravada em todas. No Civil 3D o set nativo recebe o mesmo valor.

Propriedades automáticas e de fórmula são somente leitura; uma propriedade obrigatória vazia é marcada com *.

Quando o estilo não pode ser carregado, a palette mostra DEFINIÇÕES: CÓPIA DO DESENHO e lê os nomes, tipos e padrões dos sets da cópia que o desenho guarda, de modo que os dados continuam legíveis e editáveis.

O gerenciador

CAPCAD_PSET_MANAGER abre CapCad Property Sets, modeless, reaproveitado a cada execução. No topo, fixos em todas as abas: o rótulo Desenho ativo:, Editor de estilos..., Palette Open Property Sets e Editar definições.... Embaixo, um log que espelha a linha de comando e uma barra de status.

Os outros comandos

CAPCAD_PSET_INSTALL — instalar as definições no desenho (Civil 3D)

Pede CapStyle path: e cria, nas definições nativas do desenho, um set para cada entrada da seção Property Sets do estilo, sob o name. Quando um set já existe ele é sincronizado com o estilo: propriedades faltantes são acrescentadas e propriedades que saíram do estilo são removidas, com seus valores. Migre antes se renomeou uma propriedade e quer manter os valores.

CAPCAD_PSET_LIST — listar os sets nativos de uma entidade (Civil 3D)

Pede uma entidade e escreve, para cada set nativo anexado, uma linha por propriedade no formato id, tipo, nome = valor. Lê só o lado nativo; para ver o registro portável, use a palette.

CAPCAD_PROJECT_IFC — exportar para IFC

No AutoCAD e no Civil 3D abre a aba IFC do gerenciador. No BricsCAD, GstarCAD, ZWCAD e ARES Commander pede o arquivo .ifc e exporta direto. Cada entidade com dados Open Property Sets vira um elemento IfcSign do IFC 4.3 na sua posição no mundo, com um IfcPropertySet por set. As propriedades são tipadas pelo estilo: km em metros como IfcLengthMeasure, area como IfcAreaMeasure, integer e real como números, o resto como texto; um valor numérico que não converte vira um rótulo de texto, nunca um número inventado.

O vocabulário do estilo

O Editor de estilos oferece dez categorias canônicas de set, cada uma ligada a um catálogo de colunas do CapCad, de onde vêm as propriedades sugeridas:

Os vars são identificadores internos e ficam como estão em todo idioma. Um set pode aplicar-se a mais de uma categoria (Aplica-se a no editor, all para todas), e sets fora desta lista são aceitos como personalizados.

Tipos de propriedade

text, real, integer, km, area, geographic, geographic_pair, datetime, filepath e autoincrement. Numa instalação no Civil 3D, integer e real mantêm o tipo e todo o resto vira Text; a distinção fica no estilo e é o que a exportação IFC usa.

Automática, fórmula, numerada e obrigatória

• Automática: o valor vem da entidade. Fontes: length, area, volume, layer, handle, type, block, x, y, z.
• Fórmula: o valor é calculado a partir de outras propriedades da mesma entidade, [Propriedade] para este set ou [Set:Propriedade] para outro, pelo nome de exibição ou pelo var. Aritmética, comparação, and/or/not, junção de textos com &, e as funções round, floor, ceil, abs, sqrt, min, max, if, len, upper, lower, left, right, text. Uma fórmula pode usar outra; um laço ou uma referência desconhecida grava #ERRO: motivo em vez de um valor. A fórmula vence a fonte automática.
• Autoincremento: um contador por desenho com início e passo.
• Formato de exibição: decimais, prefixo e sufixo. O valor gravado fica bruto; o formato é aplicado ao exibir.
• Obrigatória: a auditoria conta uma vazia como defeito e a palette a marca com *.

Regras de nome

O nome de exibição deve ser não vazio, de no máximo 256 caracteres para um set e 64 para uma propriedade, não pode começar com dígito e só pode usar letras, dígitos, _ e -. Espaços e pontos são recusados, e é por isso que o name não pode ser igual ao var.

O formato

Esta seção é o formato publicado. É o que torna os sets abertos: qualquer um os lê e grava sem CapCad instalado.

Onde estão os dados

Cada entidade com sets tem, no seu dicionário de extensão, um Xrecord sob a chave CAPCAD_PSET_MANAGER. Desenhos gravados por versões anteriores podem tê-lo sob CAPCAD_PSETS; leitores devem aceitar as duas, e um gravador que encontre a chave antiga a substitui pela nova.

O Xrecord contém um documento JSON em UTF-8, dividido em valores de texto de no máximo 255 caracteres (código de grupo DXF 1), em ordem. Concatene-os para recuperar o documento. Uma entidade sem sets não tem Xrecord: remover o último set remove o registro.

O documento

{
  "v": 1,
  "role": "pset.vertical.placa",
  "sets": {
    "pset.vertical.placa": {
      "placa.codigo": "R-1",
      "placa.area": "3.97",
      "placa.material": ""
    },
    "catter.qto": {
      "qto.quantidade": "1"
    }
  }
}

Todo valor é um texto, como digitado ou como calculado, sem formato de exibição aplicado: números usam . como separador decimal, valores km ficam como digitados, datas como texto. As chaves não diferenciam maiúsculas na leitura e são gravadas em ordem. Um set sem propriedades é um objeto vazio válido: o set está anexado sem valores. Chaves desconhecidas são ignoradas na leitura.

A cópia das definições

O desenho também guarda uma cópia da seção Property Sets do estilo, para que os sets continuem legíveis quando o estilo não está à mão. Ela mora no dicionário de objetos nomeados, no dicionário capcad, como um Xrecord sob a chave capcad.dwg.psets, dividido da mesma forma, contendo:

{
  "v": 1,
  "style": "capcad.default",
  "PropertySets": [
    {
      "var": "pset.vertical.placa",
      "name": "SINALIZACAO_VERTICAL-PLACA",
      "description": "",
      "appliesTo": ["pset.vertical.placa"],
      "appliesToTypes": ["BlockReference"],
      "appliesToLayers": ["SINA_VERT*"],
      "properties": [
        { "var": "placa.codigo", "name": "CODIGO", "description": "", "type": "text", "default": "", "required": true },
        { "var": "placa.area", "name": "AREA", "type": "area", "default": "", "auto": "area", "decimals": 2, "suffix": " m²" }
      ]
    }
  ]
}

Uma propriedade leva var, name, description, type e default, e opcionalmente sources (um mapa de tipo de item para coluna ou texto fixo), decimals, prefix, suffix, auto, formula, required, start e step. Um set leva var, name, description, properties, e opcionalmente appliesTo, appliesToTypes e appliesToLayers. Os mesmos objetos, na mesma forma, são o array PropertySets de um arquivo .capstyle.

Lendo em outro lugar

Qualquer biblioteca de DWG expõe dicionários de extensão e Xrecords: abra a entidade, pegue a entrada do dicionário com o nome acima, junte os textos, interprete o JSON. Para gravar, faça o inverso e mantenha os pedaços com 255 caracteres ou menos. Não é preciso registro, licença nem CapCad.

Lembrado entre sessões

O gerenciador lembra o último caminho usado em cada aba, a direção da ressincronização e o estado das caixas de simulação e de verificação de entidades. A palette lembra Recalcular automaticamente.

Notas

• O registro viaja com a entidade. Copiar, colar ou WBLOCK o leva junto. Como os valores são gravados por var e são autossuficientes, continuam legíveis no desenho de destino; a associação com as definições vem do estilo ativo lá, ou da cópia que o desenho guarda.
• Desenhos de versões anteriores são legíveis. Seus property sets são lidos como estão e, na próxima gravação, reescritos na forma atual.
• CAPCAD_XDATA_CLEAN não limpa property sets. Esse comando apaga o XData da entidade; o registro mora no dicionário de extensão, que é outro lugar. Veja Entidades, grupos e diagnóstico.
• Instalar sincroniza removendo. Instalar um estilo que perdeu uma propriedade apaga essa propriedade das definições nativas do desenho, e com ela os valores nativos. Migre antes.
• Dois caminhos a partir do Editor de estilos existem só no AutoCAD e no Civil 3D. O botão Pset Manager... e Aplicar ao dwg enviam CAPCAD_PSET_MANAGER e CAPCAD_PSET_INSTALL. O botão Editar definições... da palette funciona nos cinco CADs.