API 增強功能

瞭解 API 的增強功能。

2025.2 版新增功能

已在下列功能區域對 API 進行更新：

• 在鐵路超高曲線的鐵路超高臨界樁號下，加入新的可用性質。
  • CANTCriticalStation::CantJerk。取得鐵路超高臨界樁號的「鐵路超高加加速度」設定。
  • CANTCriticalStation::CantRatio。取得鐵路超高臨界樁號的「鐵路超高比」設定。

  若要取得更多資訊，請參閱〈「鐵路超高表格編輯器」對話方塊〉。

• 在 RailCANTInfo 結構下，加入新的可用性質。
  • RailCANTInfo.LateralAcceleration
  • RailCANTInfo.CantGradient
  • RailCANTInfo.CurveRadius
  • RailCANTInfo.EquilibriumCant
  • RailCANTInfo.EquilibriumCantGradient
  • RailCANTInfo.EquilibriumCantVerticalSpeed
  • RailCANTInfo.CantDeficiency
  • RailCANTInfo.CantDeficiencyGradient
  • RailCANTInfo.CantDeficiencyVerticalSpeed
  • RailCANTInfo.CantRatio
  • RailCANTInfo.CantJerk
  • RailCANTInfo.VerticalSpeed
  • RailCANTInfo.DesignSpeed
• 改善了 RailCANTInfo 結構的效能。
• 為類別 ProfileViewBandItem 更新性質：
  • ProfileViewBandItem.Alingment2Id：設定縱斷面視圖中鐵路超高資料區帶的次級定線。
  • ProfileViewBandItem.MaxDistance：設定縱斷面視圖中鐵路超高資料區帶的最大偏移距離。

  若要取得區帶性質的更多資訊，請參閱〈「區帶」頁籤 (「縱斷面視圖性質」對話方塊)〉。

• 為類別 ProfileViewBandSetItem 更新性質：
  • ProfileViewBandSetItem::GetHorizontalGeometryPointsOptions().取得水平幾何點選項資訊。
  • ProfileViewBandSetItem::SetHorizontalGeometryPointsOptions.設定水平幾何點選項。

  若要取得區帶中幾何點的更多資訊，請參閱〈「區帶中要標示的幾何點」對話方塊〉。

• 重力管的更新。
  • 加入 API 類別 CrossingPipeProfileLabel。
  • 加入 ObjectIDCollection 方法：
    • CrossingPipeProfileLabel.Create(ObjectId profileViewPartId, ObjectId profileViewId, ObjectId labelStyleId);
    • CrossingPipeProfileLabel.Create(ObjectId profileViewPartId, ObjectId profileViewId);
    • GetAvailableLabelIds(ObjectId profileViewPartId, ObjectId profileViewId);}}

2025.1 版新增功能

已在下列功能區域對 API 進行更新：

• 加入 PressurePart.SwapPartSize，以置換壓力管、配件和附屬設備的零件大小。
• 為類別 CANTCriticalStation 加入新性質：
  • CANTCriticalStation.DesignSpeed取得鐵路超高曲線之鐵路超高臨界樁號的設計速度。
  • CANTCriticalStation.CurveRadius：取得鐵路超高曲線之鐵路超高臨界樁號的曲線半徑。
  • CANTCriticalStation.EquilibriumCantGradient：取得鐵路超高曲線之鐵路超高臨界樁號的鐵路超高梯度。
  • CANTCriticalStation.CantDeficiencyGradient：取得鐵路超高曲線之鐵路超高臨界樁號的不足量梯度。
  • CANTCriticalStation.EquilibriumCantVerticalSpeed：取得鐵路超高曲線之鐵路超高臨界樁號的平衡垂直速度。
  • CANTCriticalStation.CantDeficiencyVerticalSpeed：取得鐵路超高曲線之鐵路超高臨界樁號的不足量垂直速度。
• 為類別 ProfileViewBandItem 加入新性質：
  • ProfileViewBandItem.Alingment2Id：設定縱斷面視圖中水平幾何圖形區帶的次級定線。
  • ProfileViewBandItem.MaxDistance：設定縱斷面視圖中水平幾何圖形區帶的最大偏移距離。

  若要取得水平幾何圖形區帶性質的更多資訊，請參閱〈「區帶」頁籤 (「縱斷面視圖性質」對話方塊)〉。

• 加入以下 ProfileView 方法的範例程式碼：
  • ProfileView.Create(ObjectId, Point3d)
  • ProfileView.Create(ObjectId, Point3d, SplitProfileViewCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, StackedProfileViewsCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, StackedProfileViewsCreationOptions, SplitProfileViewCreationOptions)
  • ProfileView.Create(CivilDocument, String, ObjectId, ObjectId, Point3d)
  • ProfileView.Create(CivilDocument, String, String, String, Point3d)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, ObjectId)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, ObjectId, SplitProfileViewCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, SplitProfileViewCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, ObjectId, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, ObjectId, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)

  若要取得 ProfileView 方法的更多資訊，請參閱〈ProfileView 方法〉。

2025 版新增功能

已在下列功能區域對 API 進行更新：

• 支援 .NET 8.0 Framework。
• 加入對地形詳細等級功能的 .NET API 支援。若要取得更多資訊，請參閱〈修改地形詳細等級〉。
  • Surface.IsLevelOfDetailEnabled。取得並設定地形詳細等級狀態。
  • SettingsSurface.Defaults.LevelOfDetail。取得地形詳細等級性質的預設設定。

如需更多資訊，請參閱〈Autodesk Civil 3D API 中的新功能〉。