在线CAD开发包图纸转换功能详解-CAD图纸云端共享

一、转换前准备：下载最新的云图开发包

图纸格式转换依赖 MxDraw 云图开发包，需根据操作系统联系厂家下载对应版本,如果对云图开发包的结构还不够了解，可查看往期云图开发包使用说明视频， 该文档内详细据介绍的了开发包的结构与功能，有助于更快上手使用图纸转换功能。

二、图纸转换核心原理

MxDraw云图开发包的图纸转换能力，核心依托于开发包内Bin目录下的MxCAD图纸转换程序（Windows系统直接位于Bin/MxCAD，Linux系统位于Bin/Linux/MxCAD）。所有图纸转换操作，无论采用哪种调用方式，本质都是触发该转换程序执行格式处理逻辑。

开发包针对不同操作系统（Windows/Linux）对转换程序的部署路径做了适配（如Linux下新增Linux子目录），且Linux系统需额外完成转换程序的权限配置，但核心调用逻辑跨平台保持一致。

三、图纸转换支持范围

MxDraw云图开发包的转换程序支持多格式互转，且所有格式转换均可自定义指定图纸转换范围，支持的转换格式包含：

DWG、DXF、MXWEB（MxCAD专用格式，提升在线加载速度）、PDF、JPG。

四、图纸转换两种实现方式

方式一：命令行直接调用转换程序

1. 前置准备

Windows系统：直接定位到开发包MxDrawCloudServer/Bin/MxCAD目录（转换程序所在路径）。

Linux系统：

A.定位到MxDrawCloudServer/Bin/Linux/MxCAD目录；

B.执行权限配置命令，赋予转换程序可执行权限：

sudochmod -R777 mxcadassembly
sudochmod -R777 ./mx/so/*
sudocp -r-f./mx/locale /usr/local/share/locale

注：可直接参考开发包内LinuxDemo启动说明.txt

2. 调用方式

在命令行终端（Windows：CMD/PowerShell；Linux：Shell）进入转换程序所在目录后，执行对应转换命令，具体转换命令请查看下文 五、文件格式转换命令详细说明

Winodws:

Linux:

方式二：调用1337端口转换接口

1. 前置准备

启动云图开发包的CAD核心引擎服务，确保1337端口服务正常运行：

Windows系统：双击MxDrawCloudServer/Mx3dServer.exe，点击“开始Web服务”，自动启动1337端口（Bin/MxDrawServer/Windows/app.js驱动）的CAD核心引擎服务。

Linux系统：执行启动脚本启动1337端口服务：./start_demo.sh

脚本会自动启动1337端口的CAD核心服务与3000端口的Web服务

2. 接口调用方式

通过请求调用1337端口下的图纸转换接口 localhost:1337/mxcad/convert，接口核心参数包含源文件路径/URL、目标格式、转换范围等，支持POST/GET方式调用（推荐POST）。具体接口参数设置请参考下文第五条-文件格式转换命令详细说明

基础调用示例（ POST）

Windows:

vardata ={
srcpath:"D:/Test/123.dwg",
outname:"123.mxweb"
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data
}).then((ret) =>{
console.log(ret.data)
alert(JSON.stringify(ret.data))
}).catch((err)=>{alert("网络错误") })

Linux:

curl-XPOST //localhost:1337/mxcad/convert \
-H"Content-Type: application/json"\
-d'{"srcpath":"/home/user/test/123.dwg","outname":"123.mxweb","outpath":"/home/user/output"}'

接口测试便捷方式

可直接通过开发包提供的可视化测试页面调用转换接口：

1.确保1337端口服务启动；
2.打开浏览器访问 //localhost:1337/servertest；
3.在页面中找到“DWG转换”相关测试模块，选择源文件、目标格式、转换范围，点击“运行”即可触发转换。

无论采用命令行还是接口调用方式，均基于同一套转换程序，保证转换逻辑、格式支持、范围控制的一致性：

命令行方式：适合批量离线转换、自动化脚本集成；

1337端口接口方式：适合在线业务系统集成，支持前端/第三方服务远程调用，无需直接操作底层程序。

五、文件格式转换命令详细说明

根据文档的整体风格（清晰的层级、代码块区分、表格参数说明、简洁的技术语言），对“DWG、DXF转MXWEB”部分的内容进行了格式调整和语言优化，使其更利于阅读且与全文保持一致：

5.1、DWG、DXF 转 MXWEB

支持将 AutoCAD 标准格式（.dwg、.dxf）转换为 MxCAD 专用的 Web 格式（.mxweb），以提升图纸在云端的加载与渲染速度。

(1) 命令行直接调用

① 默认转换（快速模式）
若未指定具体路径，程序将自动读取转换程序同级目录下的同名文件。

输出命名：原始文件名 + .mxweb（例如：1.dwg→ 1.dwg.mxweb）

输出位置：源文件同级目录

Windows:

# 转换 DWG 文件
mxcadassembly.exe1.dwg
# 转换 DXF 文件
mxcadassembly.exe1.dxf

Linux:

# 转换 DWG 文件
./mxcadassembly1.dwg
# 转换 DXF 文件
./mxcadassembly.exe1.dxf

② 自定义转换（高级模式）
支持指定源文件路径、输出目录及文件名，并可控制压缩策略。

•输出命名：若未写后缀，默认添加 .mxweb；也可手动指定 .mxweb后缀。

Winodws:

mxcadassembly.exe{"srcpath":"D:\test2.dwg","outpath":"D:\test","outname":"test", "compression":0}

Linux:

./mxcadassembly'{"srcpath":"/home/user/test2.dwg","outpath":"/home/user/test","outname":"test", "compression":0}'

参数说明：

请求示例：

Winodws:

vardata ={
srcpath:"C:/test/a.dwg",
outname:"123.mxweb",
outpath:"E:/"
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret) =>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err) =>{
alert("网络错误");
});

Linux:

curl-XPOST "//localhost:1337/mxcad/convert"\
-H"Content-Type: application/json"\
-d'{
"srcpath": "XXX/a.dwg",
"outname": "123.mxweb",
"outpath": "XXX"
}'

5.2、MXWEB 转 DWG、DXF

支持将 MxCAD Web 格式（.mxweb）逆向转换回 AutoCAD 标准格式（.dwg或 .dxf），以便在本地 CAD 软件中进行二次编辑或归档。

(1) 命令行直接调用

通过 JSON 参数指定源文件、输出路径及目标文件名。注意：输出文件名必须显式包含 .dwg或 .dxf后缀，以决定转换的目标格式。

Windows:

# 转换为 DWG 格式
mxcadassembly.exe{"srcpath":"D:\test.mxweb","outpath":"D:\","outname":"test.dwg"}
# 转换为 DXF 格式
mxcadassembly.exe {"srcpath":"D:\test.mxweb","outpath":"D:\","outname":"test.dxf"}

Linux:

# 转换为 DWG
./mxcadassembly'{"srcpath":"/home/user/data/test.mxweb","outpath":"/home/user/data/","outname":"test.dwg"}'
# 转换为 DXF
./mxcadassembly'{"srcpath":"/home/user/data/test.mxweb","outpath":"/home/user/data/","outname":"test.dxf"}'

关键参数说明：

srcpath: 待转换的 .mxweb源文件路径。
outpath: 转换后文件的保存目录。
outname: 必须包含后缀（如 test.dwg），程序将根据后缀自动识别转换目标格式。

(2) 接口调用方式

通过 POST 请求调用本地服务进行格式逆转。

请求示例：

Winodws:

vardata ={
srcpath:"D:/Test/123.mxweb",
outname:"123new.dwg",// 指定输出为 .dwg 格式
outpath:"D:/"
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret) =>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err) =>{
alert("网络错误");
});

Linux:

curl-XPOST "//localhost:1337/mxcad/convert"\
-H"Content-Type: application/json"\
-d'{
"srcpath": "XXX/123.mxweb",
"outname": "123new.dwg",
"outpath": "XXX"
}'

提示：与“DWG 转 MXWEB”不同，此过程必须在 outname中明确指定 .dwg或 .dxf后缀，否则无法完成格式转换。

5.3、DWG 转 PDF

支持将 AutoCAD 图纸（.dwg）直接转换为便携式文档格式（.pdf），适用于图纸预览、打印归档及非 CAD 环境下的分享。支持自定义输出分辨率及颜色策略。

(1) 命令行直接调用

通过 JSON 参数配置源文件、输出名称、图像尺寸及颜色模式。

Windows:

mxcadassembly.exe{'srcpath':'C:/test/1.dwg','outname':'1.pdf','width':'5000','height':'5000','colorPolicy':'mono','exportLayout':'false'}

Linux:

./mxcadassembly'{"srcpath":"/absolute/path/to/1.dwg","outname":"1.pdf","width":"5000","height":"5000","colorPolicy":"mono","exportLayout":"false"}'

参数说明：

注意：若不设置 colorPolicy，生成的 PDF 将保留原图色彩；设置为 mono可生成黑白灰度图纸，常用于工程打印以节省墨粉。

(2) 接口调用方式

通过 POST 请求调用本地服务，支持更灵活的动态参数配置（如布局导出控制等）。

请求示例：

Winodws:

vardata ={
srcpath:"C:/test/123.dwg",
outpath:"C:/",// 输出目录
outname:"123.pdf",// 输出文件名
width:"2000",// 自定义宽度
height:"2000",// 自定义高度
// colorPolicy: "mono", // 可选：取消注释以启用黑白模式
// exportLayout: "false" // 可选：控制是否导出布局空间
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret) =>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err) =>{
alert("网络错误");
});

Linux:

curl-XPOST "//localhost:1337/mxcad/convert"\
-H"Content-Type: application/json"\
-d'{
"srcpath": "XXX/XXX/123.dwg",
"outpath": "XX/",
"outname": "123.pdf",
"width": "2000",
"height": "2000"
}'

提示：接口调用时，colorPolicy和 exportLayout等为可选参数。若需生成黑白 PDF，请取消 colorPolicy: "mono"的注释。

5.4、DWG 与 DXF 互转

本功能支持 AutoCAD 两种主流格式之间的双向无损转换：

DWG 转 DXF：将二进制 DWG 文件转换为文本或二进制 DXF 格式，便于跨平台数据交换。

DXF 转 DWG：将 DXF 文件还原为标准的 DWG 格式，以优化存储体积和加载性能。

(1) 命令行直接调用

通过 outname参数的后缀名（.dxf或 .dwg）自动识别转换方向。

Winodws:

# DWG 转 DXF
mxcadassembly.exe{"srcpath":"D:\test.dwg","outpath":"D:\","outname":"test.dxf"}
# DXF 转 DWG
mxcadassembly.exe {"srcpath":"D:\test.dxf","outpath":"D:\","outname":"test.dwg"}

Linux:

# DWG 转 DXF
./mxcadassembly'{"srcpath":"/home/user/data/test.dwg","outpath":"/home/user/data/","outname":"test.dxf"}'
# DXF 转 DWG
./mxcadassembly'{"srcpath":"/home/user/data/test.dxf","outpath":"/home/user/data/","outname":"test.dwg"}'

操作逻辑：

程序读取 srcpath指定的源文件。

根据 outname中填写的后缀决定目标格式。

结果保存至 outpath指定目录（若为空则保存在源文件同级目录）。

(2) 接口调用方式

支持通过 POST 请求进行灵活转换，outpath为可选参数。

Winodws:

vardata ={
srcpath:"D:/Test/123.dwg",
outname:"123.dxf",// 修改后缀即可改变转换方向
outpath:"D:/"// 指定输出目录
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret) =>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err) =>{
alert("网络错误");
});

Linux:

curl-XPOST "//localhost:1337/mxcad/convert"\
-H"Content-Type: application/json"\
-d'{
"srcpath": "XXX/123.dwg",
"outname": "123.dxf",
"outpath": "XXX/"
}'

提示：转换方向完全由 outname的后缀决定。若源文件是 .dwg且 outname后缀为 .dxf，则执行 DWG 转 DXF；反之亦然。

5.5、指定范围裁剪 DWG

本功能支持从原始 DWG 图纸中裁剪出指定矩形范围内的图形内容，并生成新的独立 DWG 文件。适用于提取图纸局部细节、制作大样图或分割超大图纸。

(1) 命令行直接调用

通过 cmd参数指定为 cut_dwg模式，并定义裁剪区域的两个对角点坐标 (pt1_x, pt1_y)和 (pt2_x, pt2_y)。

Windows:

mxcadassembly.exe{'cmd':'cut_dwg','bd_pt1_x':'1000','bd_pt1_y':'1200','bd_pt2_x':'1400','bd_pt2_y':'1400','srcpath':'1.dwg','outname':'testcut_1.dwg'}

Linux:

./mxcadassembly'{"cmd":"cut_dwg","bd_pt1_x":"1000","bd_pt1_y":"1200","bd_pt2_x":"1400","bd_pt2_y":"1400","srcpath":"/home/user/test/1.dwg","outname":"/home/user/test/testcut_1.dwg"}'

参数说明：

注意：坐标值基于图纸当前的坐标系单位。请确保 pt1和 pt2能构成一个有效的矩形区域。

(2) 接口调用方式

通过 POST 请求，将裁剪参数封装在 JSON 数据体中发送。

请求示例：

Windows:

vardata = {
cmd:"cut_dwg", // 指令类型
bd_pt1_x:"1000", // 起点 X
bd_pt1_y:"1200", // 起点 Y
bd_pt2_x:"1400", // 终点 X
bd_pt2_y:"1400", // 终点 Y
srcpath:"1.dwg", // 源文件路径
outname:"testcut_2.dwg"// 输出文件名
//outpath: "D:/output/"// 可选：指定输出目录
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret)=>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err)=>{
alert("网络错误");
});

Linux:

curl -X POST "//localhost:1337/mxcad/convert"\
-H "Content-Type: application/json"\
-d '{
"cmd":"cut_dwg",
"bd_pt1_x":"1000",
"bd_pt1_y":"1200",
"bd_pt2_x":"1400",
"bd_pt2_y":"1400",
"srcpath":"XXX/1.dwg",
"outname":"testcut_2.dwg",
"outpath":"XXX/"
}'

提示：此操作仅保留矩形框内的图元，框外内容将被剔除。生成的新文件将继承原文件的图层、块定义等属性。

5.6、指定范围输出 PDF

本功能支持将 DWG 图纸中指定矩形区域的内容直接打印/导出为 PDF 文件。与“全图转 PDF”不同，此功能允许用户通过坐标精确控制输出范围，并自定义输出纸张尺寸和颜色模式，非常适合制作局部大样图或特定区域的汇报图纸。

(1) 命令行直接调用

通过 cmd参数指定为 print_to_pdf，并结合坐标参数定义裁剪区域，同时设置输出 PDF 的宽高和颜色策略。

Windows:

mxcadassembly.exe{'cmd':'print_to_pdf','width':'2100','height':'2970','bd_pt1_x':'1000','bd_pt1_y':'1200','bd_pt2_x':'1400','bd_pt2_y':'1400','srcpath':'D:/Test/testprint.dwg','outname':'testprint.pdf','colorPolicy':'mono', 'outpath':'D:/'}

Linux:

./mxcadassembly'{"cmd":"print_to_pdf","width":"2100","height":"2970","bd_pt1_x":"1000","bd_pt1_y":"1200","bd_pt2_x":"1400","bd_pt2_y":"1400","srcpath":"/home/user/Test/testprint.dwg","outname":"testprint.pdf","colorPolicy":"mono","outpath":"/home/user/Test/"}'

参数说明：

注意：

1.width和 height决定了生成 PDF 页面的物理尺寸比例，请根据实际出图需求设置（如 A4: 2100x2970, A3: 2970x4200 等）。

2.坐标范围 (pt1, pt2)必须在图纸的有效绘图区域内。

(2) 接口调用方式

通过 POST 请求发送包含裁剪范围和打印参数的 JSON 数据。

请求示例：

Windows:

vardata = {
cmd:"print_to_pdf", // 指令类型
width:"2100", // 输出页面宽度
height:"2970", // 输出页面高度
bd_pt1_x:"1000", // 裁剪起点 X
bd_pt1_y:"1200", // 裁剪起点 Y
bd_pt2_x:"1400", // 裁剪终点 X
bd_pt2_y:"1400", // 裁剪终点 Y
srcpath:"1.dwg", // 源文件路径
outname:"testprint.pdf", // 输出文件名
colorPolicy:"mono", // 黑白模式
//outpath: "D:/"// 可选：指定输出目录，若不填则默认同源文件目录
};
axios({
method:"post",
url:"//localhost:1337/mxcad/convert",
data:data
}).then((ret)=>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err)=>{
alert("网络错误");
});

Linux:

curl -X POST "//localhost:1337/mxcad/convert"\
-H "Content-Type: application/json"\
-d '{
"cmd":"print_to_pdf",
"width":"2100",
"height":"2970",
"bd_pt1_x":"1000",
"bd_pt1_y":"1200",
"bd_pt2_x":"1400",
"bd_pt2_y":"1400",
"srcpath":"/XXX/1.dwg",
"outname":"testprint.pdf",
"colorPolicy":"mono",
"outpath":"/XXX/"
}'

应用场景：

•局部出图：只需打印图纸中的某个详图节点，无需手动在 CAD 中设置视口。

•批量切片：结合脚本循环调用，可将一张超大图纸按坐标网格自动切割成多张标准尺寸的 PDF。

•标准化输出：强制指定 width和 height，确保所有输出的 PDF 页面尺寸统一，便于后续装订或归档。

5.7、DWG 转 JPG (仅限 Windows系统)

本功能用于将 DWG 图纸转换为高分辨率的 JPG 图片。

重要提示：此功能仅支持 Windows 操作系统。使用前必须手动下载并部署额外的转换工具包，否则接口调用将失败。

(1) 前置准备：工具部署

在调用接口前，请确保已完成以下环境配置：

1.下载工具包：
访问地址下载 Bin_Release_tool.7z：
mxdraw3d.com/download/Bin_Release_tool.7z

2.部署路径：

–解压下载的压缩包，获取其中的 tool文件夹。

–将该 tool文件夹放入云图开发包的指定目录下：
MxDrawCloudServer\Bin\Release\tool

–最终目录结构示例：

MxDrawCloudServer/
└── Bin/
└── Release/
└── tool/ <-- 必须存在此文件夹及内部文件
├── MxWebTool.exe
└── ...

–注：如果 MxDrawCloudServer\Bin\Release目录不存在，请手动创建。

(2) 接口调用方式

部署完成后，通过 POST 请求调用 users/tools接口。参数需以特定字符串格式拼接在 param字段中。

请求示例：

vardata ={
cmd:"cadtojpg",
// 参数说明：
// file: 源DWG文件路径
// width: 输出图片宽度 (像素)，设为0则自动根据高度计算
// height: 输出图片高度 (像素)，设为0则自动根据宽度计算
// background_color: 背景颜色 (十六进制RGB)，0xFFFFFF为白色
// out: 输出JPG文件的完整路径
param:"file=D:/Test/1.dwg width=1000 height=0 background_color=0xFFFFFF out=D:/Test/test.jpg"
};
axios({
method:"post",
url:"//localhost:1337/users/tools",// 注意此处URL与其他转换接口不同
data:data
}).then((ret) =>{
console.log(ret.data);
alert(JSON.stringify(ret.data));
}).catch((err) =>{
alert("网络错误");
});

参数详解 (param字符串内)：

常见问题排查：

如果返回错误提示找不到工具或命令失败，请首先检查 MxDrawCloudServer\Bin\Release\tool目录是否正确放置了解压后的文件。

确保运行环境为 Windows，Linux 或 macOS 下此功能不可用。

路径中的斜杠建议使用正斜杠 /或双反斜杠 \\以避免转义问题。

补充说明：MXWEB 格式支持

上述所有功能（包括全图转换、格式互转、指定范围裁剪/打印）均完全支持 MXWEB格式。

操作原理：
MXWEB 是 MxCAD 的轻量化 Web 格式。在使用命令行或接口调用时，无需更改任何命令逻辑或参数结构，仅需将输入文件路径（srcpath）指向 .mxweb文件，并将输出文件名（outname）的后缀修改为对应的目标格式即可。

1. MXWEB 参与转换的通用规则

2. 示例演示

示例 A：MXWEB 转 PDF (全图)
只需将源文件后缀改为 .mxweb，输出后缀改为 .pdf。

# 命令行
mxcadassembly.exe{'srcpath':'C:/test/model.mxweb','outname':'model.pdf','width':'5000','height':'5000'}

示例 B：MXWEB 指定范围转 PDF
命令 cmd保持为 print_to_pdf，坐标逻辑不变，仅文件后缀变化。

// 接口调用
vardata ={
cmd:"print_to_pdf",
srcpath:"D:/Test/web_model.mxweb",// 输入 MXWEB
outname:"web_part.pdf",// 输出 PDF
bd_pt1_x:"1000",bd_pt1_y:"1200",
bd_pt2_x:"1400",bd_pt2_y:"1400",
width:"2100",height:"2970",
colorPolicy:"mono"
};
// ... axios 请求代码同上 ...

示例 C：DWG 转 MXWEB (作为中间格式)
同样适用格式互转逻辑。

# 命令行
mxcadassembly.exe{"srcpath":"D:\draw.dwg","outpath":"D:\","outname":"draw.mxweb"}

总结：系统底层对 .dwg、.dxf和 .mxweb进行了统一抽象处理。用户在进行任何转换或裁剪操作时，只需关注文件后缀名的变化，其余参数（如坐标、尺寸、颜色策略、命令字）均保持一致，无需额外配置。

六、跨平台注意事项

1.转换程序路径：Windows直接使用Bin/MxCAD，Linux需定位到Bin/Linux/MxCAD；

2.Linux系统必须完成转换程序的可执行权限配置，否则无法调用；

3.两种调用方式的转换参数格式跨平台通用，仅需按实际需求指定；

4.1337端口服务启动后，需确保防火墙放行该端口，避免接口调用失败。