O projeto CapCad

O que é um projeto

Um projeto CapCad é composto por duas coisas:

1. Uma pasta no disco que contém um arquivo project.config — um JSON com as configurações do projeto.
2. Um dicionário capcad gravado dentro do desenho que diz a qual pasta este dwg pertence e qual é o seu eixo ativo.

Nenhum arquivo é "aberto" para entrar num projeto. Você aponta o desenho para a pasta (no Gerenciador de Projeto ou no Gerenciador de Eixos) e, a partir daí, todo comando do CapCad rodado nesse desenho resolve suas configurações a partir dela.

O projeto é considerado ativo quando a pasta está definida e existe no disco. Se a pasta foi definida mas não existe mais (um disco de rede fora do ar, uma pasta renomeada), o projeto não fica ativo e nada é gravado no project.config.

O nome do projeto é o item ProjectName do project.config quando definido; se não estiver, é o nome da última pasta do caminho.

Os dois lugares onde as configurações ficam

O project.config é um JSON de dois níveis: tag → item → valor. A tag padrão é General; algumas seções têm tag própria (ProjectOverridenStyle, vertical).

Toda leitura de configuração segue esta ordem:

1. project.config, na tag pedida;
2. se vier vazio, o dicionário capcad do desenho;
3. se ainda vier vazio, o valor padrão que o comando chamador informar.

Toda escrita vai para o project.config, e só acontece se houver uma pasta de projeto ativa.

Desenho como projeto (sem pasta definida)

Quando o desenho não tem pasta de projeto, o CapCad não para: entra no modo que a própria ajuda do formulário anuncia — "Se não definida, dados serão gravados no próprio dwg".

Na prática:

• O store project.config fica vazio em memória e toda leitura cai direto no dicionário do desenho.
• O sistema de coordenadas escolhido é gravado na chave capcad.dwg.coordsys, dentro do dwg, em vez de ir para o project.config.
• O estilo escolhido é apenas guardado em memória para a sessão (o registro capcad.dwg.style do desenho continua sendo lido normalmente).
• As pastas de biblioteca continuam resolvendo pelas chaves capcad.dwg.folder.* do desenho e pelos defaults da biblioteca local.

É o modo natural para um dwg avulso, um estudo rápido ou um arquivo que chegou de outro escritório. A qualquer momento você pode definir uma pasta e o desenho passa a gravar nela.

O que fica guardado, e onde

O CapCad também grava duas preferências de usuário (não do projeto): a última pasta de eixos e o último arquivo de eixo usados. É delas que sai a oferta de reaproveitar o último projeto quando você abre um desenho ainda sem projeto definido.

As pastas do projeto

Cada categoria de biblioteca tem sua própria pasta. Todas são opcionais: sem valor configurado, o CapCad usa o default da biblioteca local instalada, que varia com o perfil de país ativo.

Como uma pasta é resolvida

Para as pastas de placas, a cadeia é:

1. o valor do project.config, se for um caminho absoluto;
2. o valor do project.config começando por \, resolvido embaixo da pasta de projeto (por exemplo \placas_custom → <projeto>\placas_custom);
3. a chave correspondente do dicionário do desenho (capcad.dwg.folder.placasoficials, …placascommon, …placascustom, …library);
4. o default da biblioteca local, que depende do perfil de país.

As placas convencionais têm ainda um degrau acima de todos: se houver uma pasta definida nas preferências do usuário, ela vence tudo. É o que a caixa Definir em preferências de usuário (não em projeto) liga — nesse modo a pasta vale para você em qualquer projeto, e o rótulo ao lado do campo muda de projeto para preferências.

Fora do perfil Brasil, quando nada resolve, o CapCad usa o pacote signs-<país> da biblioteca local e baixa o pacote do servidor quando a pasta está ausente ou vazia.

O sistema de coordenadas do projeto

O sistema de coordenadas não é um campo único: é resolvido por uma cadeia de prioridades, e o Gerenciador mostra de qual fonte ele veio.

A leitura no eixo é leve: o CapCad percorre o .capcad e lê apenas as propriedades do topo, sem carregar a geometria.

O Gerenciador de Projeto

CAPCAD_PROJECT_MANAGER abre o formulário modal de 7 abas. Duas outras entradas abrem o mesmo formulário já numa aba específica: CAPCAD_CRITERIA_MATERIAL_DEFAULT (aba Default Materiais) e CAPCAD_CRITERIA_TECHNICAL_DEFAULT (aba Default Diretrizes).

Aba Main num desenho sem projeto: pasta de projeto vazia, com o aviso de que os dados serão gravados no próprio dwg, o estilo caindo no capcad.default e a pasta de eixos opcional.

Aba Pastas: cada linha tem os botões Abrir, Copiar, Colar e "Default local", e a nota lembra que caminhos podem ser absolutos ou relativos à pasta principal do projeto.

A aba Main oferece ainda:

• Remover — apaga a definição de projeto deste desenho (o project.config no disco não é tocado).
• Abrir em explorer — abre a pasta de projeto no Windows Explorer.
• Eixos… — abre a pasta de eixos no Explorer.
• Sistema de coord.… — pergunta o sistema de coordenadas e o valida antes de gravar.
• Selecionar local… — escolhe um arquivo .capstyle (ou .json) como estilo do projeto.
• Estilos explorer… — abre o explorador de estilos.
• Projeto Exemplo — aponta o desenho para o projeto de exemplo instalado.

Os dois botões do rodapé decidem o destino do que você mexeu: Gravar e sair confirma, Sair sem gravar descarta.

O que os outros comandos leem do projeto

Notas

• A pasta precisa existir. Definir um caminho que não existe deixa o projeto inativo: as leituras continuam funcionando (caem no desenho), mas nada é gravado no project.config.
• Criar a pasta de projeto cria o arquivo. Ao apontar o desenho para uma pasta existente que ainda não tem project.config, o CapCad grava um arquivo vazio nela.
• O project.config é compartilhado. Vários desenhos podem apontar para a mesma pasta; todos enxergam as mesmas configurações na mesma hora.
• O formato é o mesmo em todos os CADs. Um projeto criado no AutoCAD é lido igual no BricsCAD, GstarCAD, ZWCAD e ARES Commander.

Veja também

• O eixo — o alinhamento central que o projeto aponta e do qual todas as estacas são medidas.
• Estilos — o que o estilo do projeto decide na representação gráfica.
• Layers e o catálogo de layers — como o estilo vira layers no desenho.
• Perfis de país — o que muda nos defaults de biblioteca e de norma.
• Gerenciador de Eixos — a outra porta de entrada para definir pasta de projeto e eixo.