Edição em português | Original: Inglês
Mudar para inglês →
⚡ Official Page

Atualizações da API do Web CAD

A atualização mais recente do DWG FastView WebCADAPI apresenta vários recursos importantes para aprimorar o gerenciamento de desenhos CAD. Os usuários agora podem extrair informações de bloco e elementos de texto de arquivos CAD para o formato TXT, facilitando o manuseio e a análise de dados. A nova função de extração de texto fornece detalhes como coordenadas e camadas, enquanto os usuários podem controlar sua ativação por meio de parâmetros de conversão.

Além disso, a API suporta a gravação de anotações de volta em desenhos CAD, permitindo atualizações usando arquivos de texto salvos. Um novo recurso de conversão também permite que arquivos DWF sejam transformados em formatos DWG ou OCF, com opções para controle de versão e seleção de formato. Essas atualizações melhoram significativamente a funcionalidade para usuários de CAD, simplificando os processos de extração e integração de dados.

Extração de informações de bloco


A nova versão adicionou a função de extração de blocos, que pode extrair informações de blocos de desenhos CAD para arquivos txt, incluindo nome do bloco, camada, informações de atributos, etc. Só é necessário fornecer o fluxo do arquivo de desenho CAD ou o endereço de download da URL para extrair informações de blocos.

O resultado retornado é o endereço de download do arquivo txt.

O formato dos dados no arquivo txt é o seguinte:

{
"entcounts":{
"AcDbBlockReference":2
},
"blockcounts":{
" Round Air Outlet":1,  //Block name and total number of block
"Air outlet":1  // Block name and total number of block
},
"xrefs":{
},
"layers":{  //Layer information
"10":{  //Layer handle
"name":"0",  //Layer name
"status":0,  //Layer status
"color":7, //Layer colour
"handle":"10", //Layer handle
"count":2
},
"2B0":{
"name":"C-HAVC-Outlet",
"status":0,
"color":16,
"handle":"2B0",
"count":2
},
"2B1":{
"name":"C-HAVC-HVAC equipment",
"status":0,
"color":16,
"handle":"2B1",
"count":1
}
},
"spaces":[{
"name":"*Model_Space",   // Layout dictionary name
"layout":"Model",  //Layout name
"handle":"1F",  //Layout handle
"entities":[],
"blocks":[{
"handle":"36BB",  //The handle of the block
"layer":"2B0",  //The layout handle of the block
"name":"Air outlet",  //Block name
"parent":"1F",  / The layout handle of the block
"position":[731121.705682, 1059970.188720, 0],  //Block base coordenadas
"extMin":[730788.738739, 1059637.221777, 0],  //Block bounding box coordenada left
"extMax":[731454.672625, 1060303.155663, 0], //Top and bottom right coordenadas
"scale":[-1, 1, 1],   //Scaling ratio of tile x、y、z
"angle":3.141593,  //Block rotation angle, the unit is radian
"atts":[], //Block attribute information
"dyn":true  //Dynamic block or not
}, {
"handle":"377F",
"layer":"10",
"name":"the round air outlet",
"parent":"1F",
"position":[732113.914672, 1059939.081392, 0],
"extMin":[731659.073369, 1059484.240089, 0],
"extMax":[732568.755975, 1060393.922695, 0],
"scale":[1, 1, 1],
"angle":1.047198,
"atts":[],
"dyn":false
}]
}, {
"name":"*Paper_Space",
"layout":"Layout 1",
"handle":"D2",
"entities":[],
"blocks":[]
}, {
"name":"*Paper_Space0",
"layout":"Layout 2",
"handle":"D6",
"entities":[],
"blocks":[]
}]
}

Extração de informações de texto


A nova função de extração de texto foi adicionada, que pode gerar todas as informações de texto nos desenhos para arquivos txt. Os arquivos de texto registram as coordenadas, camadas, tipos e outras informações de cada caractere. Os usuários podem processar os arquivos de texto por si mesmos para obter funções como pesquisa de texto, localização e estatísticas.

Os métodos de instalação e uso da nova versão são os mesmos de antes. Apenas na função de conversão de ocf, um parâmetro txt foi adicionado. Quando é False, a função de extração de texto não é ativada e é a mesma de antes. Quando é True, as informações de texto são extraídas e o endereço de download do arquivo txt é incluído no resultado retornado.

Introdução dos parâmetros no arquivo de texto:

"space": {
"name": "*Model_Space", // The layout model name where the text is located
"handle": 31, //Layout handle
"entities": [
{
"handle": 72965, //Text handle
"layer": 16, // The handle of the layer where the text is located, corresponds to the handle in the layer information at the beginning of the txt file.
"texts": [
{
"content": "Document Number:XYD", //The content of the text
"box": [ // The coordenadas of the bounding box where the text is located. The first two are the x and y coordenadas of the top left corner of the rectangular bounding box, and the last two are the x and y coordenadas of the lower right corner.
776.935514,
202.314079,
800.633838,
206.005699
],
"mask": 1 //The type of the text,
}
]
},

A enumeração de tipos de texto de máscara:
1, texto de linha única
2, Texto multilinha
3,Texto de anotação
4,Texto da tabela
5,Texto dentro de blocos
6,Texto dentro de referências externas
7, Texto dentro da anotação do Líder
8, texto de definição de atributo
9, Texto dentro de entidades personalizadas de AEC de arquitetura
10,Entidades associadas a hiperlinks

O front-end pode usar os valores de coordenadas dentro da caixa. As duas primeiras coordenadas são os valores mínimos, e as duas últimas coordenadas são os valores máximos. Chame a função de posicionamento da caixa delimitadora para mover a viewport para o local correspondente à fonte.

const box = {
min: {
x: 776.935514,
y: 202.314079
},
max: {
x: 800.633838,
y: 206.005699
}
}
gstarSDK.focusToBox(box,true) //The front-end is positioned at the viewport location corresponding to the bounding box coordenadas.

Escreva anotações de volta no desenho


A nova versão adicionou uma interface para escrever anotações de volta ao desenho CAD. Os gráficos anotados podem ser escritos de volta ao desenho em formato dwg, para que possam ser visualizados no software CAD para PC.

annotationStream、annotationUrl:O arquivo de fluxo de anotação ou endereço de download do arquivo de anotação requer o armazenamento das strings de anotação em um arquivo de texto. Não há limite para o formato do arquivo, geralmente txt é suficiente.

dwgVersion: O formato de versão recomendado dos desenhos CAD gerados é a versão 3.

dwgVersion、fileUrl: O arquivo de fluxo de desenho CAD ou o endereço URL de download do desenho será usado para escrever anotações no desenho.

De acordo com o ID da tarefa, você pode ver os resultados retornados pela consulta, onde dwgUrl é o endereço de download do novo desenho após a anotação ser escrita.


Conversão de desenho DWF


A nova versão adiciona uma função de conversão e exibição de desenhos DWF, que pode converter DWF em DWG ou diretamente em arquivos no formato OCF.

dwg controla se deve gerar desenhos em formato dwg. O padrão é gerar dwgVersion para controlar a versão do desenho dwg gerado.

OCF é para controlar se deve converter e gerar para arquivo ocf ou não, o padrão é Não.

FileStream、fileUrl:endereço de download do desenho dwf e fluxo de arquivo

De acordo com o ID da tarefa, você pode consultar os resultados retornados e os resultados convertidos em DWF podem ser obtidos.

Itens é uma lista, porque o desenho dwf pode ter várias páginas, então uma página será convertida em um dwg ou ocf, então pode haver várias.

allZip é um arquivo de pacote compactado, que conterá todos os arquivos em itens, empacotados em um pacote compactado, que pode ser baixado diretamente e depois descompactado, então não há necessidade de baixá-los um por um em itens.

A atualização mais recente do DWG FastView WebCADAPI aprimora o gerenciamento de desenhos CAD ao introduzir novos recursos, como extração de informações de bloco e texto em arquivos TXT, permitindo um manuseio de dados mais fácil. Os usuários podem escrever anotações de volta em desenhos CAD e converter arquivos DWF em formatos DWG ou OCF, com opções para controle de versão. Essas melhorias simplificam os processos de extração de dados, anotação e conversão de arquivos, beneficiando significativamente os usuários de CAD.