定义用户坐标系（UCS）对象以更改(0, 0, 0) 原点的位置以及xy平面和z轴的方向。可以在三维空间中的任意位置定位和确定UCS的方向，还可以根据需要定义、保存和调用任意多个用户坐标系。坐标输入和显示是相对于当前UCS的。

要指示UCS的原点和方向，可以使用视区对象的ICONATORIGIN属性或UCSICON系统变量在UCS原点处显示UCS图标。如果UCS图标已打开（IConVISIBLE属性），并且未在原点处显示，则它将显示在UCSOG系统变量定义的WCS坐标处。

可以使用UCSTable对象的Add()方法创建新的用户坐标系。此方法需要输入四个值：原点坐标、x和y轴上的坐标以及UCS的名称。

AutoCAD®ActiveX Automation中的所有坐标都输入到世界坐标系中。使用GetUCSMatrix ()方法返回给定ucs的变换矩阵。使用此转换矩阵查找等效的WCS坐标。

要激活UCS，请使用文档对象上的ActiveUCS属性。如果对活动的UCS进行了更改，则必须将新的UCS对象重置为活动的UCS才能显示更改。要重置活动的UCS，只需使用更新的UCS对象再次调用ActiveUCS属性。

创建新的UCS，使其处于活动状态，并将点的坐标转换为当前UCS坐标

以下子例程创建新的UCS，并将其设置为图形的活动UCS。然后，它要求用户在图形中选择一个点，并返回该点的WCS和UCS坐标。

  1. using Autodesk.AutoCAD.Runtime;
  2. using Autodesk.AutoCAD.ApplicationServices;
  3. using Autodesk.AutoCAD.DatabaseServices;
  4. using Autodesk.AutoCAD.EditorInput;
  5. using Autodesk.AutoCAD.Geometry;
  7. [CommandMethod("NewUCS")]
  8. public static void NewUCS()
  9. {
  10.     //获取当前文档和数据库，然后开启事务
  11.     Document acDoc = Application.DocumentManager.MdiActiveDocument;
  12.     Database acCurDb = acDoc.Database;
  14.     using (Transaction acTrans = acCurDb.TransactionManager.StartTransaction())
  15.     {
  16.         //以读的方式打开UCS表
  17.         UcsTable acUCSTbl;
  18.         acUCSTbl = acTrans.GetObject(acCurDb.UcsTableId,
  19.                                         OpenMode.ForRead) as UcsTable;
  21.         UcsTableRecord acUCSTblRec;
  23.         //检查UCS表中是否已经存在"New_UCS"
  24.         if (acUCSTbl.Has("New_UCS") == false)
  25.         {
  26.             acUCSTblRec = new UcsTableRecord();
  27.             acUCSTblRec.Name = "New_UCS";
  29.             //开启写入权限
  30.             acUCSTbl.UpgradeOpen();
  32.             //添加UCS表记录
  33.             acUCSTbl.Add(acUCSTblRec);
  34.             acTrans.AddNewlyCreatedDBObject(acUCSTblRec, true);
  36.             acUCSTblRec.Dispose();
  37.         }
  38.         else
  39.         {
  40.             acUCSTblRec = acTrans.GetObject(acUCSTbl["New_UCS"],
  41.                                             OpenMode.ForWrite) as UcsTableRecord;
  42.         }
  44.         acUCSTblRec.Origin = new Point3d(4, 5, 3);
  45.         acUCSTblRec.XAxis = new Vector3d(1, 0, 0);
  46.         acUCSTblRec.YAxis = new Vector3d(0, 1, 0);
  48.         //打开当前视口
  49.         ViewportTableRecord acVportTblRec;
  50.         acVportTblRec = acTrans.GetObject(acDoc.Editor.ActiveViewportId,
  51.                                             OpenMode.ForWrite) as ViewportTableRecord;
  53.         //在视口的原点显示UCS图标
  54.         acVportTblRec.IconAtOrigin = true;
  55.         acVportTblRec.IconEnabled = true;
  57.         //设置当前UCS
  58.         acVportTblRec.SetUcs(acUCSTblRec.ObjectId);
  59.         acDoc.Editor.UpdateTiledViewportsFromDatabase();
  61.         //显示当前的UCS名称
  62.         UcsTableRecord acUCSTblRecActive;
  63.         acUCSTblRecActive = acTrans.GetObject(acVportTblRec.UcsName,
  64.                                                 OpenMode.ForRead) as UcsTableRecord;
  66.         Application.ShowAlertDialog("The current UCS is: " +
  67.                                     acUCSTblRecActive.Name);
  69.         PromptPointResult pPtRes;
  70.         PromptPointOptions pPtOpts = new PromptPointOptions("");
  72.         //提示用户输入点
  73.         pPtOpts.Message = "\nEnter a point: ";
  74.         pPtRes = acDoc.Editor.GetPoint(pPtOpts);
  76.         Point3d pPt3dWCS;
  77.         Point3d pPt3dUCS;
  79.         //如果输入成果，将点转换到当前UCS
  80.         if (pPtRes.Status == PromptStatus.OK)
  81.         {
  82.             pPt3dWCS = pPtRes.Value;
  83.             pPt3dUCS = pPtRes.Value;
  85.             //将点从UCS转换到WCS
  86.             Matrix3d newMatrix = new Matrix3d();
  87.             newMatrix = Matrix3d.AlignCoordinateSystem(Point3d.Origin,
  88.                                                         Vector3d.XAxis,
  89.                                                         Vector3d.YAxis,
  90.                                                         Vector3d.ZAxis,
  91.                                                         acVportTblRec.Ucs.Origin,
  92.                                                         acVportTblRec.Ucs.Xaxis,
  93.                                                         acVportTblRec.Ucs.Yaxis,
  94.                                                         acVportTblRec.Ucs.Zaxis);
  96.             pPt3dWCS = pPt3dWCS.TransformBy(newMatrix);
  98.             Application.ShowAlertDialog("The WCS coordinates are: \n" +
  99.                                         pPt3dWCS.ToString() + "\n" +
  100.                                         "The UCS coordinates are: \n" +
  101.                                         pPt3dUCS.ToString());
  102.         }
  104.         //将新对象保存到数据库
  105.         acTrans.Commit();
  106.     }
  107. }