前言
在网页CAD中有些相同的零件可以只建一个模型实例，其余用到的地方均为实例的引用，然后将引用组合起来形成装配体。mxcad3d提供了丰富的三维建模功能和便捷的API，接下来聊一下如何利用mxcad3d来创建小车装配体模型。
快速入门
首先我们需要学习mxcad的基本使用方法，可以通过官方的入门教程来搭建一个最基本的项目模板。
开发环境准备（对前端开发不熟悉的一定要看）安装Node.js和VS Code,然后创建最基本的mxcad开发项目、API文档使用说明。
本次教程最后完成的完整测试项目压缩包(https://gitee.com/mxcadx/mxcad_docs/tree/master/examples3D/Test3dAssemblyCar.7z) ，压缩包下载解压后需要在项目目录下打开cmd命令行，然后在命令行中执行npm install来安装依赖，然后再按照本教程中的方式来运行项目查看效果。
编写创建装配体小车的代码
1.按照上面前言中第2条中的方式，根据官方快速入门教程来创建一个名为Test3dAssemblyCar的项目，如下图：
2.编写绘制装配体小车的代码
在index.html中插入一个按钮"绘制装配体小车"， index.html的完整代码如下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>vite use mxcad</title>
</head>
<body>
<div style="height: 800px; overflow: hidden;"> <canvas id="myCanvas"></canvas></div>
<button>绘制装配体小车</button>
<script type="module" src="./src/index.ts"></script>
</body>
</html>
在src/index.ts中编写绘制装配体小车的函数，src/index.ts的完整代码如下：
import {
MdGe, Mx3dGeAxis, Mx3dGeColor, Mx3dGeCSYSR, Mx3dGeDir, Mx3dGeLocation, Mx3dGePoint, Mx3dGeTrsf, Mx3dGeVec, Mx3dMkCylinder, Mx3dMkFace, Mx3dMkPolygon, Mx3dMkPrism, MxCAD3DObject } from "mxcad"\
// 创建mxcad3d对象\
const mxcad3d = new MxCAD3DObject()\
// 初始化mxcad3d对象\
mxcad3d.create({
\
// canvas元素的css选择器字符串（示例中是id选择器），或canvas元素对象\
canvas: "#myCanvas",\
// 获取加载wasm相关文件(wasm/js/worker.js)路径位置\
locateFile: (fileName)=> new URL(`/node_modules/mxcad/dist/wasm/3d/${
fileName}`, import.meta.url).href,\
})\
// 初始化完成\
mxcad3d.on("init", ()=>{
\
console.log("初始化完成");\
});\
function drawAssemblyCar() {
\
// 轮子形状\
const pt = new Mx3dGePoint(0, 0, 0); // 中心点\
const dir = new Mx3dGeDir(0, 0, 1); // 方向\
const csysr = new Mx3dGeCSYSR(pt, dir); // 根据点和方向创建一个右手坐标系\
const wheel = new Mx3dMkCylinder(csysr, 20, 10); // 轮子(宽扁的圆柱体)\
let wheelShape = wheel.Shape(); // 获取轮子拓扑形状\
// 轴形状\
const axle = new Mx3dMkCylinder(csysr, 5, 100); // 轴(细长的圆柱体)\
const axleShape = axle.Shape(); // 获取轴拓扑形状\
wheelShape = wheelShape.cut(axleShape); // 切割掉轮子的轴孔\
// 车体形状\
const bodyPts:Mx3dGePoint\[] = \[]\
bodyPts.push(new Mx3dGePoint(0, 0, 0));\
bodyPts.push(new Mx3dGePoint(0, 50, 0));\
bodyPts.push(new Mx3dGePoint(160, 50, 0));\
bodyPts.push(new Mx3dGePoint(160, 0, 0));\
const bodyPoly = new Mx3dMkPolygon(); // 创建多段线(车体的截面轮廓)\
bodyPts.forEach((pt) => {
\
bodyPoly.Add(pt);\
});\
bodyPoly.Close(); // 闭合多段线\
const bodyWire = bodyPoly.Wire(); // 获取多段线(车体的截面轮廓)的拓扑Wire\
const bodyMkFace = new Mx3dMkFace(bodyWire); // 用Wire生成面\
const bodyFace = bodyMkFace.Face(); // 获取面\
const bodyPrism = new Mx3dMkPrism(bodyFace, new Mx3dGeVec(0, 0, 100)); // 用面生成车体实体\
let bodyShape = bodyPrism.Shape(); // 获取车体实体形状\
bodyShape.TranslateBy2Points(new Mx3dGePoint(30, 0, 0), new Mx3dGePoint(0, 0, 0)); // 移动到合适位置，方便装配\
const wheelForCut = new Mx3dMkCylinder(csysr, 25, 15); // 车体嵌入车轮的地方，用车体切掉，用于放入轮子\
// 以下是切出四个放轮子的空间\
const wheelForCutShape = wheelForCut.Shape();\
bodyShape = bodyShape.cut(wheelForCutShape);\
bodyShape = bodyShape.cut(wheelForCutShape.TranslatedByVec(new Mx3dGeVec(0, 0, 85)));\
bodyShape = bodyShape.cut(wheelForCutShape.TranslatedByVec(new Mx3dGeVec(100, 0, 0)));\
bodyShape = bodyShape.cut(wheelForCutShape.TranslatedByVec(new Mx3dGeVec(100, 0, 85)));\
const axleForCut = new Mx3dMkCylinder(csysr, 6, 100); // 车体嵌入轴的地方，用车体切掉，用于放入轴\
// 以下是切出两个放轴的空间\
const axleForCutShape = axleForCut.Shape();\
bodyShape = bodyShape.cut(axleForCutShape);\
bodyShape = bodyShape.cut(axleForCutShape.TranslatedByVec(new Mx3dGeVec(100, 0, 0)));\
// 获取文档\
const doc = mxcad3d.getDocument();\
// 车子装配体标签\
const carLabel = doc.addShapeLabel();\
// 轮子实例标签\
const wheelLabel = doc.addShapeLabel();\
// 车轴实例标签\
const axleLabel = doc.addShapeLabel();\
// 轮轴装配体实例标签\
const wheelAxleLabel = doc.addShapeLabel();\
// 车壳实例标签\
const bodyLabel = doc.addShapeLabel();\
// 轮子、轴、车体形状都添加到模型文档的标签中(同时为不同的形状设置不同的颜色)\
wheelLabel.setShape(wheelShape);\
wheelLabel.setColor(new Mx3dGeColor(MdGe.MxNameOfColor.Color\_NOC\_BLACK));\
axleLabel.setShape(axleShape);\
axleLabel.setColor(new Mx3dGeColor(MdGe.MxNameOfColor.Color\_NOC\_RED));\
bodyLabel.setShape(bodyShape);\
bodyLabel.setColor(new Mx3dGeColor(MdGe.MxNameOfColor.Color\_NOC\_BLUE2));\
// 轮轴装配体(轮轴装配体需要两个轮子、一个轴)\
wheelAxleLabel.addComponent(wheelLabel, new Mx3dGeLocation()); // 添加第一个轮子，没有位置(原位置，轮子模型创建的位置)\
const wheel\_2\_trsf = new Mx3dGeTrsf();\
wheel\_2\_trsf.SetTranslationPart(new Mx3dGeVec(0, 0, 90));\
wheelAxleLabel.addComponent(wheelLabel, new Mx3dGeLocation(wheel\_2\_trsf)); // 添加第二个轮子，有位置(向Z轴正方向移动90之后的位置)\
wheelAxleLabel.addComponent(axleLabel, new Mx3dGeLocation()); // 添加轴，没有位置(原位置，轴模型创建的位置)\
// 车子装配体(车子装配体需要两个轮轴装配体、一个车体)\
const wheelAxle\_1\_trsf = new Mx3dGeTrsf();\
wheelAxle\_1\_trsf.SetRotation(new Mx3dGeAxis(new Mx3dGePoint(0, 0, 0), new Mx3dGeDir(1, 0, 0)), Math.PI / 2);\
carLabel.addComponent(wheelAxleLabel, new Mx3dGeLocation(wheelAxle\_1\_trsf)); // 添加第一个轮轴装配体，有位置(绕X轴旋转90度之后的位置)\
let wheelAxle\_2\_trsf = new Mx3dGeTrsf();\
wheelAxle\_2\_trsf.SetTranslationPart(new Mx3dGeVec(100, 0, 0));\
wheelAxle\_2\_trsf = wheelAxle\_2\_trsf.Multiplied(wheelAxle\_1\_trsf); // 矩阵相乘，得到第二个轮轴装配体的位置，相乘后的矩阵代表先绕X轴旋转90度，然后再向X轴正方形平移100\
carLabel.addComponent(wheelAxleLabel, new Mx3dGeLocation(wheelAxle\_2\_trsf)); // 添加第二个轮轴装配体，有位置(绕X轴旋转90度，然后再向X轴正方形平移100之后的位置)\
carLabel.addComponent(bodyLabel, new Mx3dGeLocation(wheelAxle\_1\_trsf)); // 添加车体，有位置(绕X轴旋转90度之后的位置)\
// 更新新图显示模型，会将文档中的模型显示到当前视图中\
mxcad3d.update();\
}\
// 给button添加点击事件，点击后调用drawAssemblyCar函数\
// 立即执行函数\
(function addEventToButton(){
\
const btn = document.querySelector("button");\
if (btn) {
\
btn.addEventListener("click", () => {
\
drawAssemblyCar();\
});\
}\
})()
按照官方快速入门教程，新建终端，运行npx vite命令来运行项目，观察效果如下图：
