6098人阅读
海报（57）
通用话题（80）
Revit 二次开发入门（40）
一年一度的Revit产品发布时刻，我们抢先想各位介绍下Revit 2017的变化和新功能Major changes and renovations to the Revit API&API changes.NET 4.6All Revit API binaries are now built targeting .NET 4.5.2. However, Revit uses the runtime from .NET 4.6. At a minimum, add-ins will need to be set to target .NET 4.5.2, but .NET 4.6 will also work.Visual C++ Redistributable for Visual Studio 2015Revit is now built with and installs runtime libraries from the Visual C++ Redistributable for Visual Studio 2015. Specifically, version 14.0.23026.0, which corresponds to vanilla Visual Studio 2015. Third party applications which include native components may want to upgrade to the same VC runtime as there is no guarantee that Revit will install any other runtime on client machines.Automatic transaction mode obsoleteThe transaction mode:·&TransactionMode.Automaticis now obsolete and this capability will be removed in a future release. The Manual transaction mode should be used for command callbacks that make changes to the Revit model (using the Transaction APIs to start, commit and manage the needed transactions). The ReadOnly transaction mode can be used for commands that do not require to make any changes to the Revit model.Code signing of Revit AddinsTo improve the security of Revit and its addins, and help users to clearly understand the origin of 3rd&party code running within the context of Revit to avoid malicious tampering, a new code signing mechanism has been introduced. All API developers should:·&Get their addins signed with the certificate mechanism provided by Microsoft before the addins are released.·&Get the certificates installed to the Trusted Publishers store of Windows.If this is not done, one or more message dialogs will be shown during Revit startup:·&If an addin has been signed correctly, but the certificate is not installed in Trust Publisher, a dialog with detailed information of the certificate will be shown.·&If the signature of an addin is invalid, a dialog with an error message will be shown to let end users know this. ·&If an addin is unsigned, a dialog with the addin's information will be shown. In each case, the end user can choose whether they want to always trust the addin, load it once, or skip loading. Please refer to &for detailed introduction about the code signing from Microsoft. Background processes can load DB applicationsRevit uses background processes called RevitWorker to perform certain calculations and operations out-of-process. While the situations in which these RevitWorkers are used is currently limited, the RevitWorker process is capable of loading a DB application add-in (&AddIn Type=&DBApplication&&) and events set in that add-in may be triggered by activities in the RevitWorker. By default, no add-ins are loaded into RevitWorker. To have an add-in loaded into RevitWorker, add the LoadInRevitWorker flag to the .addin file:The new property:·&RevitAddInDBApplication.LoadInRevitWorker indicates whether or not a RevitWorker process will load this add-in. The default is false.Application API changesThe default constructor for·&Autodesk.Revit.ApplicationServices.Applicationhas been removed. Use of this constructor in unsupported situations could result in unexpected behavior. The correct way to obtain the handle to the Application is from the arguments passed to the associated Revit API callback being invoked, for example:·&IExternalCommand.Execute() passes ExternalCommandData which contains UIApplication. Application is accessible from UIApplication.Application·&IUpdater.Execute() passes UpdaterData which provides access to the Document. Application is accessible from Document.Application·&Events will often pass the Application or the associated Document as the sender in the event callback. The event arguments may also contain an associated Application or Document.One location where a full Application is not available is in the callbacks to IExternalApplication (OnStartup() and OnShutdown()). ControlledApplication is supplied instead. This is because Revit is not ready to perform operations with Documents while in this initialization state. If you need to start working with Documents immediately after Revit completes startup, you can subscribe to the ApplicationInitialized event.Family API changesThe following member has been deprecated and replaced:Deprecated memberNew/replacement memberFamilyPointLocation.LocationFamilyPointLocation.GetLocation()The following member has been changed:·&SpatialElementFromToCalculationPoints.isAcceptableFromPosition()Revit now transforms the input position into the SpatialElementFromToCalculationPoints objects's coordinate space before calculating the distance. Previously, the input position was used unchanged, which could lead to Revit incorrectly claiming the point was out of bounds.View API changesCategory visibility APIThe following members related to category visibility in a view have been deprecated and replaced or added:Deprecated memberNew/replacement memberView.GetVisibility(Category category)View.GetCategoryHidden(ElementId categoryId)View.SetVisibility(Category category, bool visible)View.SetCategoryHidden(ElementId categoryId, bool hide)N/AView.CanCategoryBeHidden(ElementId categoryId)Text API changesRevit text handling has been reworked, addressing long-standing issues and introducing new editing capabilities. Most of the existing API for text access has been maintained, but a few changes have been made.Text related to CustomExporter contextsDeprecated memberNew/replacement memberTextNode.TextSizeTextNode.FontHeightTextNode.IsForRightToLeftReadingNo replacementTextNode.GetFormattedTextRuns()TextNode.GetFormattedText()Note that the class FormattedTextRun has been marked obsolete. It is replaced by the new class FormattedText.Event API changesThe following member has been deprecated and replaced:Deprecated memberNew/replacement memberDocumentPrintingEventArgs.SettingsDocumentPrintingEventArgs.GetSettings()Alignment API changesThe method:·&ItemFactoryBase.NewAlignment()will now throw exceptions with more informative messages, such as &The two references are not geometrically aligned so the Alignment cannot be created.&Geometry API changesNurbSpline creation changesThe methods used to create a NurbSpline curve have been replaced. In the replacement methods, the newly created curve may be returned as a NURBSpline or a simpler curve such as line or arc. This is consistent with Revit expectations that the simplest possible representation of curve should be used in Revit elements.Deprecated memberNew/replacement memberNurbSpline.Create(IList&XYZ& controlPoints, IList&double& weights, IList&double& knots, int degree, bool closed, bool rational)NurbSpline.CreateCurve(int degree, IList&double& knots, IList&XYZ& controlPoints, IList&double& weights)Two arguments were removed:·&Rationality is now determined by the weights array.·&Closed splines are not properly supported in Revit tools hence there is no option to create them (curves will be marked open).NurbSpline.Create(IList&XYZ& controlPoints, IList&double& weights, IList&double& knots, int degree, bool closed, bool rational)NurbSpline.CreateCurve(int degree, IList&double& knots, IList&XYZ& controlPoints).This version can be used in the common case when rational = false and all the weights are 1.NurbSpline.Create(IList&XYZ& controlPoints, IList&double& weights)NurbSpline.CreateCurve(IList&XYZ& controlPoints, IList&double& weights)TessellatedShapeBuilder changesThe method Build() has changed from the prior release as follows:Deprecated memberNew/replacement memberTessellatedShapeBuilder.Build(TessellatedShapeBuilderTarget, TessellatedShapeBuilderFallback, ElementId)TessellatedShapeBuilder.Build()The results of Build are now stored in the TessellatedShapeBuilder instead of returned from Build(). Access these results through the new method:·&TessellatedShapeBuilder.GetBuildResult()The options for building are now set as options in the TessellatedShapeBuilder itself. Access these options through the new properties:·&TessellatedShapeBuilder.Target·&TessellatedShapeBuilder.Fallback·&TessellatedShapeBuilder.GraphicsStyleIdStructure API changesFoundationWall APIThe following members have been deprecated and replaced:Deprecated memberNew/replacement memberDocument.NewFoundationWall()WallFoundation.Create()WallFoundation.GetFoundationType()WallFoundation.GetTypeId()WallFoundation.SetFoundationType()WallFoundation.ChangeTypeId()Rebar API changesThe following method has been deprecated and replaced:Deprecated methodNew/replacement methodExporterIFCUtils.GetRebarGeometry(DBView* pView)Rebar.GetFullGeometryForView(const DBView* pView)The method generates full geometry for a Rebar for a specific view, before cutting is applied.The following methods have been deprecated and replaced:Deprecated methodNew/replacement methodRebar.GetCenterlineCurves(bool adjustForSelfIntersection, bool suppressHooks, bool suppressBendRadius)Rebar.GetCenterlineCurves(bool adjustForSelfIntersection, bool suppressHooks, bool suppressBendRadius, MultiplanarOption multiplanarOption, int barPositionIndex)Rebar.GetCenterlineCurves(bool adjustForSelfIntersection, bool suppressHooks, bool suppressBendRadius, MultiplanarOption multiplanarOption)&FabricSheet API changesThe following property has been deprecated and replaced:Deprecated propertyNew/replacement propertyFabricSheet.BentFabricWiresOrientationFabricSheet.BentFabricStraightWiresLocationFabricSheet.PlaceInHost behavioral changeThe behavior of the method:·&Autodesk.Revit.DB.Structure.FabricSheet.PlaceInHost()has been updated. It now properly supports move of the FabricSheet to a different structure with a modified transformation.LoadCase API changesThe following types and members have been deprecated and replaced/added:Deprecated type/memberNew/replacement type/memberLoadNatureCategory enumLoadCaseCategory enumLoadCase.Create(Document, string, ElementId, LoadNatureCategory)LoadCase.Create(Document, string, ElementId, LoadCaseCategory)N/ALoadCase.Create(Document, string, ElementId, ElementId)LoadCase.NatureCategoryLoadCase.SubcategoryIdMEP API changesDuct APIThe following duct creation methods have been deprecated and replaced by new methods. Many of the new methods offer additional parameters supporting the assignment of duct system type and reference level:Deprecated memberNew/replacement memberDocument.NewDuct(XYZ, XYZ, DuctType)Duct.Create(Document, ElementId ductSystemTypeId, ElementId ductTypeId, ElementId levelId, XYZ, XYZ)Document.NewDuct(XYZ, Connector, DuctType)Duct.Create(Document, ElementId ductTypeId, ElementId levelId, Connector, XYZ)Document.NewDuct(Connector, Connector, DuctType)Duct.Create(Document, ElementId ductTypeId, ElementId levelId, Connector, Connector)DuctFittingAndAccessoryConnectorData.CoordinationDuctFittingAndAccessoryConnectorData.GetCoordination()Pipe APIThe following members have been deprecated and replaced:Deprecated memberNew/replacement memberPipeType.ClassPipeSegment.ScheduleTypeIdPipeFittingAndAccessoryConnectorData.CoordinationPipeFittingAndAccessoryConnectorData.GetCoordination()The deprecated property returns one pipe schedule type element on the pipe type. In case that the pipe type contains multiple pipe segments and schedule types in its routing preference definition, only the first pipe schedule type is returned in the deprecated property. Instead, the correct usage is to use the new property Pipe.PipeSegment, which provides the correct pipe schedule type and other segment properties, just as Revit property palette shows.Additionally, the following new methods are available related to PipeScheduleType:·&PipeScheduleType.Create(Document, String) - Creates a new pipe schedule type with the given name. ·&PipeScheduleType.GetPipeScheduleId(Document, String) - Returns an existing pipe schedule type with the given name.MEP System APIThe following properties have been deprecated and replaced by methods:Deprecated memberNew/replacement memberMechanicalSystem.FlowMechanicalSystem.GetFlow()MechanicalSystem.StaticPressureMechancalSystem.GetStaticPressure()PipingSystem.FixtureUnitsPipingSystem.GetFixtureUnits()PipingSystem.FlowPipingSystem.GetFlow()PipingSystem.StaticPressurePipingSystem.GetStaticPressure()A new method is also added:·&PipingSystem.GetVolume()Internally, these MEP system values are now calculated asynchronously on a non-blocking evaluation framework. In order to handle asynchronous calculation results, the caller needs to define callback methods to react on background calculation results (e.g., to refresh the user interface). API developers cannot define callbacks but will still get the correct value. If no callback methods are defined (e.g., in third party applications), the calculation is automatically switched to synchronous calculation.These values have been exposed via built-in parameters in the past. They are still supported. For example, PipingSystem.get_ParameterValue(BuiltInParameter.RBS_PIPE_FLOW_PARAM) will get the correct flow value synchronously, assuming no callback is detected. The caveat is that, due to the internal support of asynchronous calculation, these parameters no longer support dynamic model update.EnergyDataSettings API changesThe following members have been deprecated and replaced:Deprecated memberNew/replacement memberEnergyDataSettings.MassZoneCoreOffsetEnergyDataSettings.CoreOffsetEnergyDataSettings.MassZoneDividePerimeterEnergyDataSettings.DividePerimeterRendering API changesThe rendering API has undergone major changes with the switch from NVIDIA mental ray to RapidRT. Several functions and enum values have been removed, as their corresponding functionality no longer exists. Removed functions·&RenderingQuality.Low·&RenderingImageExposureSettings.MidTones·&SkyBackgroundSettings.VisibilityDistance·&DaylightPortalNode·&IExportContext.OnDaylightPortalNew enum value&·&BackgroundStyle.TransparentRenderQualitySettings changesRenderingQualitySettings has been completely overhauled. All of the properties and functions have been removed and new functions have been added to be compatible with the RapidRT interface. New properties and functions:·&RenderingQualitySettings.IsValidRenderLevel·&RenderingQualitySettings.IsValidRenderTime·&RenderingQualitySettings.IsCustomQuality·&RenderingQualitySettings.LightAndMaterialAccuracyMode·&RenderingQualitySettings.RenderDuration·&RenderingQualitySettings.RenderLevel·&RenderingQualitySettings.RenderTimePlane API changesThe constructors and methods used to construct a Plane have been obsoleted and replaced, for consistency with the other exposed subclasses of Surface.Deprecated memberNew/replacement memberPlane(XYZ, XYZ, XYZ) (constructor)Plane.CreateByOriginAndBasis()Plane(XYZ, XYZ) (constructor)Plane.CreateByNormalAndOrigin()Plane()Plane.Create(Frame) or other dedicated creation functionAutodesk.Revit.Creation.Application.NewPlane(XYZ, XYZ, XYZ)Plane.CreateByOriginAndBasis()Autodesk.Revit.Creation.Application.NewPlane(XYZ, XYZ)Plane.CreateByNormalAndOrigin()Autodesk.Revit.Creation.Application.NewPlane(CurveArray)CurveLoop.GetPlane()The new method:·&Plane.CreateByThreePoints()creates a Plane object passing through three points supplied as arguments.DirectShape API changesFunctions that treat application id and application data id as mandatory GUIDs are being phased out. This affects:·&DirectShape.SetGUIDs() ·&DirectShape.CreateElement()·&DirectShape.CreateElementInstance()The DirectShape.ApplicationId and DirectShape.ApplicationDataId properties should be used instead.DirectShape.IsValidCategoryId() has been reimplemented. The new version lists categories approved for use with DirectShape. The old version listed all top-level built-in model categories.Point Cloud API changesPointCloudOverrides APIPointCloudOverrides now supports overrides for point cloud regions. Several functions related to point cloud overrides have been deprecated and replaced:Deprecated memberNew/replacement memberPointCloudOverrides.GetPointCloudOverrideSettings(ElementId)PointCloudOverrides.GetPointCloudScanOverrideSettings(ElementId)PointCloudOverrides.GetPointCloudOverrideSettings(ElementId, String scanTag, Document)PointCloudOverrides.GetPointCloudScanOverrideSettings(ElementId, String scanTag, Document)PointCloudOverrides.SetPointCloudOverrideSettings(ElementId, PointCloudOverrideSettings)PointCloudOverrides.SetPointCloudScanOverrideSettings(ElementId, PointCloudOverrideSettings)PointCloudOverrides.SetPointCloudOverrideSettings(ElementId, PointCloudOverrideSettings, String scanTag, Document)PointCloudOverrides.SetPointCloudScanOverrideSettings(ElementId, PointCloudOverrideSettings, String scanTag, Document)The following new functions support region overrides:·&PointCloudOverrides.GetPointCloudRegionOverrideSettings(ElementId)·&PointCloudOverrides.GetPointCloudRegionOverrideSettings(ElementId, String regionTag, Document)·&PointCloudOverrides.SetPointCloudRegionOverrideSettings(ElementId, PointCloudOverrideSettings)·&PointCloudOverrides.SetPointCloudRegionOverrideSettings(ElementId, PointCloudOverrideSettings, String regionTag, Document)Schedule API changesScheduleFieldThe following member has been deprecated and replaced:Deprecated memberNew/replacement memberScheduleField.HasTotalsScheduleField.DisplayTypeThe new enum:·&ScheduleFieldDisplayTypeallows the user to specify the display type for a field. In addition to a standard field, the user can choose to display a total, the maximum value, the minimum value, or both. The new method:·&ScheduleField.CanDisplayMinMax()indicates whether the field can display minimum and maximum values.UI API changeRectangle classThe Rectangle class has been moved from the namespace Autodesk.Revit.UI to the namespace Autodesk.Revit.DB, and is now found in RevitAPI.dll.&Obsolete API removalThe following API members and classes which had previously been marked Obsolete have been removed in this release. Consult the API documentation from prior releases for information on the replacements to use:Methods·&Autodesk.Revit.Creation.Application.NewPoint(XYZ)·&Autodesk.Revit.Creation.Document.NewGrid(Arc)·&Autodesk.Revit.Creation.Document.NewGrid(Line)·&Autodesk.Revit.Creation.Document.NewGrids(CurveArray)·&Autodesk.Revit.Creation.ItemFactoryBase.NewLevel(Double)·&Autodesk.Revit.Creation.ItemFactoryBase.NewTextNote(View, XYZ, XYZ, XYZ, Double, TextAlignFlags, TextNoteLeaderTypes, TextNoteLeaderStyles, XYZ, XYZ, String)·&Autodesk.Revit.Creation.ItemFactoryBase.NewTextNote(View, XYZ, XYZ, XYZ, Double, TextAlignFlags, String) ·&Autodesk.Revit.Creation.Document.NewPointLoad(Reference, XYZ, XYZ, Boolean, PointLoadType, SketchPlane)·&Autodesk.Revit.Creation.Document.NewPointLoad(XYZ, XYZ, XYZ, Boolean, PointLoadType, SketchPlane)·&Autodesk.Revit.Creation.Document.NewLineLoad(Reference, IList&XYZ&, IList&XYZ&, Boolean, Boolean, Boolean, LineLoadType, SketchPlane) Autodesk.Revit.Creation.Document.NewLineLoad(Element, IList&XYZ&, IList&XYZ&, Boolean, Boolean, Boolean, LineLoadType, SketchPlane)·&Autodesk.Revit.Creation.Document.NewLineLoad(IList&XYZ&, IList&XYZ&, IList&XYZ&, Boolean, Boolean, Boolean, LineLoadType, SketchPlane)·&Autodesk.Revit.Creation.Document.NewLineLoad(XYZ, XYZ, XYZ, XYZ, XYZ, XYZ, Boolean, Boolean, Boolean, LineLoadType, SketchPlane)·&Autodesk.Revit.Creation.Document.NewAreaLoad(Element, XYZ, Boolean, AreaLoadType) Autodesk.Revit.Creation.Document.NewAreaLoad(CurveArray, Int32[], Int32[], XYZ, XYZ, XYZ, Boolean, AreaLoadType)·&Autodesk.Revit.Creation.Document.NewAreaLoad(CurveArray, Int32[], Int32[], IList&XYZ&, Boolean, AreaLoadType) Autodesk.Revit.Creation.Document.NewAreaLoad(IList&XYZ&, XYZ, Boolean, AreaLoadType)·&Autodesk.Revit.Creation.Document.NewLoadNature(String)·&Autodesk.Revit.Creation.Document.NewLoadUsage(String)·&Autodesk.Revit.Creation.Document.NewLoadCase(String, LoadNature, Category)·&Autodesk.Revit.Creation.Document.NewLoadCombination(String, Int32, Int32, Double[], LoadCaseArray, LoadCombinationArray, LoadUsageArray)·&Autodesk.Revit.DB.ElementTransformUtils::MirrorElements(Document,ElementIdSet,Plane)·&Autodesk.Revit.DB.Grid.ExtendToAllLevels()·&Autodesk.Revit.DB.Family.HasStructuralSection()·&Autodesk.Revit.DB.FamilySymbol.HasStructuralSection()·&Autodesk.Revit.DB.TessellatedShapeBuilder.Build(TessellatedShapeBuilderTarget, TessellatedShapeBuilderFallback, ElementId)·&Autodesk.Revit.DB.ViewShapeBuilder.SetShape(DirectShape)·&Autodesk.Revit.DB.ViewShapeBuilder.SetShape(DirectShapeType)·&Autodesk.Revit.DB.ViewCropRegionShapeManager.SetCropRegionShape(CurveLoop)·&Autodesk.Revit.DB.ViewCropRegionShapeManager.SetCropRegionEmptyShape()·&Autodesk.Revit.DB.ViewCropRegionShapeManager.GetCropRegionShape()·&Autodesk.Revit.DB.Structure.ReinforcementSettings.DocumentContainsNoAreaOrPathReinforcement()·&Autodesk.Revit.DB.Structure.ReinforcementSettings.DocumentContainsNoRebar()Properties·&Autodesk.Revit.ApplicationServices.Application.IsQuiescent·&Autodesk.Revit.ApplicationServices.ControlledApplication.IsQuiescent ·&Autodesk.Revit.DB.AnnotationSymbol.Leaders·&Autodesk.Revit.DB.BoundarySegment.Document·&Autodesk.Revit.DB.BoundarySegment.Element·&Autodesk.Revit.DB.BoundarySegment.Curve·&Autodesk.Revit.DB.CustomExporter.IncludeFaces·&Autodesk.Revit.DB.Floor.StructuralUsage·&Autodesk.Revit.DB.Grid.GridType·&Autodesk.Revit.DB.Level.LevelType·&Autodesk.Revit.DB.Level.PlaneReference·&Autodesk.Revit.DB.PlanarFace.Normal·&Autodesk.Revit.DB.PlanarFace.Vector·&Autodesk.Revit.DB.ReferencePlane.Plane·&Autodesk.Revit.DB.ReferencePlane.Reference·&Autodesk.Revit.DB.RevisionSettings.RevisionAlphabet·&Autodesk.Revit.DB.TextElement.Align·&Autodesk.Revit.DB.TextElement.LineWidth·&Autodesk.Revit.DB.TextNote.Leaders·&Autodesk.Revit.DB.ViewCropRegionShapeManager.Valid·&Autodesk.Revit.DB.Structure.AreaLoad.Force·&Autodesk.Revit.DB.Structure.AreaLoad.Force1·&Autodesk.Revit.DB.Structure.AreaLoad.Force2·&Autodesk.Revit.DB.Structure.AreaLoad.Force3·&Autodesk.Revit.DB.Structure.AreaLoad.RefPoint·&Autodesk.Revit.DB.Structure.AreaLoad.NumCurves·&Autodesk.Revit.DB.Structure.AreaLoad.NumLoops·&Autodesk.Revit.DB.Structure.AreaLoad.Curve·&Autodesk.Revit.DB.Structure.LineLoad.Point·&Autodesk.Revit.DB.Structure.LineLoad.Force·&Autodesk.Revit.DB.Structure.LineLoad.Force1·&Autodesk.Revit.DB.Structure.LineLoad.Force2·&Autodesk.Revit.DB.Structure.LineLoad.UniformLoad·&Autodesk.Revit.DB.Structure.LineLoad.ProjectedLoad·&Autodesk.Revit.DB.Structure.LineLoad.Moment·&Autodesk.Revit.DB.Structure.LineLoad.Moment1·&Autodesk.Revit.DB.Structure.LineLoad.Moment2·&Autodesk.Revit.DB.Structure.PointLoad.Force·&Autodesk.Revit.DB.Structure.PointLoad.Moment·&Autodesk.Revit.DB.binationTypeIndex·&Autodesk.Revit.DB.binationStateIndex·&Autodesk.Revit.DB.Structure.LoadCombination..CombinationType·&Autodesk.Revit.DB.Structure.LoadCombination..CombinationState·&Autodesk.Revit.DB.Structure.LoadCombination..NumberOfComponents·&Autodesk.Revit.DB.Structure.LoadCombination..Factor·&Autodesk.Revit.DB.Structure.LoadCombination..CombinationCaseName·&Autodesk.Revit.DB.Structure.LoadCombination..CombinationNatureName·&Autodesk.Revit.DB.Structure.LoadCombination..NumberOfUsages·&Autodesk.Revit.DB.Structure.LoadCombination..UsageName·&Autodesk.Revit.DB.Structure.BoundaryConditions.NumCurves·&Autodesk.Revit.DB.Structure.BoundaryConditions.Curve·&Autodesk.Revit.DB.Structure.BoundaryConditions.AssociatedLoadEnumerated types·&Autodesk.Revit.DB.SlabFoundationTypeAPI additionsApplication API additionsDocument creationThe new method:·&Application.NewProjectDocument(UnitSystem)creates a new imperial or metric project document without a specified template.Family API additionsNew PromptForFamilyInstancePlacement() optionsThe new options:·&PromptForFamilyInstancePlacementOptions.SketchGalleryOptions ·&PromptForFamilyInstancePlacementOptions.FaceBasedPlacementTypeallow more programmatic control over the options available to govern the placement of a given family. The FaceBasedPlacementType option exposes the available options for placement of a face-based family, while the SketchGalleryOptions offer control over the types of sketched curves which can be used for a curve-based family.Family and FamilyInstance membersThe new property:·&Family.IsParametricidentifies whether the family contains parametric relations between some of its elements.The new method:·&Family.HasLargeSketches() determines whether the family contains sketches with a large number of elements.The new members:·&FamilyInstance.CanSplit·&FamilyInstance.Split() - This method allows to split the family instance element.provide access to the ability to split a curve-driven family instance (such as beam, column, or brace).View API additionsTemporaryViewModesThe new class:·&TemporaryViewModescarries data related to the state and properties of available temporary view modes. Access to an instance of this class is via the property:·&View.TemporaryViewModesThe class has the following methods and properties:·&TemporaryViewModes.DeactivateAllModes() - Deactivates all temporary modes that are currently active.·&TemporaryViewModes.DeactivateMode() - Deactivates the given temporary mode.·&TemporaryViewModes.GetCaption() - A text caption to use for the given mode. ·&TemporaryViewModes.IsModeActive() - Tests whether a given mode is currently active or not. ·&TemporaryViewModes.IsModeAvailable() - Tests whether a temporary view mode is currently available in the associated view.·&TemporaryViewModes.IsModeEnabled() - Tests whether a temporary view mode is currently enabled in the associated view. ·&TemporaryViewModes.IsValidState() - Tests whether the given state is valid for the associated view and the context the view is currently in.·&TemporaryViewModes.PreviewFamilyVisibility - The current state of the PreviewFamilyVisibility mode in the associated view.·&TemporaryViewModes.RevealConstraints - The current state of the RevealConstraints mode in the associated view.·&TemporaryViewModes.RevealHiddenElements - The current state of the RevealHiddenElements mode in the associated view. ·&TemporaryViewModes.WorskaringDisplay - The current state of the WorksharingDisplay mode in the associated view. Convert dependent view to independentThe new function:·&View.ConvertToIndependent()converts a dependent view to be independent. Plan view underlayThe new methods:·&ViewPlan.GetUnderlayBaseLevel()·&ViewPlan.GetUnderlayTopLevel()·&ViewPlan.SetUnderlayBaseLevel()·&ViewPlan.SetUnderlayRange()·&ViewPlan.SetUnderlayOrientation()·&ViewPlan.SetUnderlayOrientation()provide access to the underlay levels and settings for plan views.Assembly views creationThe creation of assembly views and schedules has been improved to allow the creation of an assembly view or schedule with template information. The new overloads for methods:·&AssemblyViewUtils.Create3DOrthographic()·&AssemblyViewUtils.CreateDetailSection()·&AssemblyViewUtils.CreateSingleCategorySchedule()·&AssemblyViewUtils.CreatePartList()·&AssemblyViewUtils.CreateMaterialTakeoff()offer two new arguments: ·&viewTemplateId - the id of the template from which the view is to be created.·&isAssigned - if true, the template passed in viewTemplateId will be
if false, the template information is only applied to the view.Depth CueingThe new class:·&ViewDisplayDepthCueingallows users to control the display of distant objects in section and elevation views. When depth cueing is active, objects blend into the background color (fade) with increasing distance from the viewer.The class contains the following methods and properties:·&ViewDisplayDepthCueing.EnableDepthCueing·&ViewDisplayDepthCueing.StartPercentage - Indicates where depth cueing begins. A value of 0 indicates that depth cueing begins at the front clip plane of the view.·&ViewDisplayDepthCueing.EndPercentage - Indicates where depth cueing ends. Objects further than the end plane will fade the same amount as objects at the end plane. A value of 100 indicates the far clip plane.·&ViewDisplayDepthCueing.FadeTo - Indicates the maximum amount to fade objects via depth cueing. A value of 100 indicates complete invisibility.·&ViewDisplayDepthCueing.SetStartEndPercentages()The new methods:·&DBView.GetDepthCueing()·&DBView.SetDepthCueing()allow the user to get and set the depth cueing settings for the view.Text API additionsRevit text handling has been reworked, addressing long-standing issues and introducing new editing capabilities. Text rangeThe new class:·&Autodesk.Revit.DB.TextRangeidentifies a range of text in a FormattedText via its start index, end index and/or length.Formatted textThe new methods:·&TextNote.GetFormattedText()·&TextNote.SetFormattedText()access a FormattedText object which contains the text and its associated formatting. FormattedText allows read and write access to the text and the formatting in the text note. The text in a FormattedText object is accessible at a whole or at the level of a specific TextRange (overloads exist for both levels of access):·&FormattedText.GetPlainText()·&FormattedText.SetPlainText()Most formatting can be accessed at the level of the entire text, or at the level of a specific TextRange (overloads exist for both levels of access):·&FormattedText.GetAllCapsStatus()·&FormattedText.SetAllCapsStatus()·&FormattedText.GetBoldStatus()·&FormattedText.SetBoldStatus()·&FormattedText.GetItalicStatus()·&FormattedText.SetItalicStatus()·&FormattedText.GetUnderlineStatus()·&FormattedText.SetUnderlineStatus()·&FormattedText.GetSuperscriptStatus()·&FormattedText.SetSuperscriptStatus()·&FormattedText.GetSubscriptStatus()·&FormattedText.SetSubscriptStatus()·&FormattedText.GetListType()·&FormattedText.SetListType()When checking the status of a particular range, it is possible that the formatting is applied to all text in the range, or no text in the range, or a mixture. This is reflected in the enumerated type FormatStatus.The method:·&FormattedText.AsTextRange()returns a TextRange identifying the entire formatted text.The method:·&FormattedText.Find()returns a TextRange identifying the first occurrence of the given string within the text, from a given index.TextElement additionsThe text element now has size restrictions. The new functions:·&TextElement.GetMinimumAllowedWidth() ·&TextElement.GetMaximumAllowedWidth() return the minimum and maximum permitted width for an existing, or newly created, TextElement.Text editor optionsThe new class:·&Autodesk.Revit.UI.TextEditorOptionsprovides access to settings that control Revit's Text Editor appearance and functionality.Geometry API additionsShapeImporter classThe new utility class:·&ShapeImportersupports conversion of geometry stored in external formats (such as SAT and Rhino) into a collection of Revit geometry objects. Use ShapeImporter.Convert() to generate the geometry objects (and where possible, corresponding materials and graphics styles in the associated document).Builder for 3D boundary representationsThe new builder class:·&BRepBuilderoffers the ability to construct Revit boundary representation geometry (either solids or &open sheets&) as a result of inputs of surface, edges, and boundary loops of edges. If the construction of the boundary representation is successful, the resulting geometry objects can be used directly in any other Revit tool that accepts geometry, or the BRepBuilder can directly be passed to populate a DirectShape via:·&DirectShape.SetShape(ShapeBuilder)·&DirectShape.AppendShape(ShapeBuilder)New Surface subclassesSeveral new subclasses of Surface have been introduced:·&CylindricalSurface·&ConicalSurface·&RuledSurface·&RevolvedSurface·&HermiteSurfaceThese subclasses expose creation methods and read-only properties suitable for use in constructing import geometry.FrameNew method added ·&CanDefineRevitGeometry() - Tests whether the supplied Frame object may be used to define a Revit curve or surface. In order to satisfy the requirements the Frame must be orthonormal and its origin is expected to lie within the Revit design limits.XYZ New method added ·&IsWithinLengthLimits() - Validates that the input point is within Revit design limits.Fixed Reference SweepsThe new static method:·&GeometryCreationUtilities.CreateFixedReferenceSweptGeometry()allows creation of a solid using the &fixed reference sweep& method, similar to the method defined in the STEP ISO 10303-42 standard.A typical use of this method is to create a swept solid for which a line in the cross-section of the solid remains horizontal all along the sweep. As an example, this can be used to construct railings to ensure that the top of the railing remains oriented to the horizontal steps of the stairs. In this example, the fixed reference direction would be chosen to be the upward vertical direction. See the function's description for further details.As with other GeometryCreationUtilities methods, there is a second version of CreateFixedReferenceSweptGeometry that takes a SolidOptions input, allowing the user to assign a material or graphics style to the solid.Parameter API additionsGlobal ParametersGlobal Parameters support controlling geometry constraints through special parameters defined in a project document. Global Parameters can be used for both labeling and reporting to/from dimensions, as well as setting values of instance parameters.The new class·&GlobalParametersManagerprovides the main access point to managing global parameters in project document. It offers the following members:·&AreGlobalParametersAllowed() - tests whether global parameters are allowed in a document·&GetAllGlobalParameters() - returns all global parameters in a document·&FindByName() - find a global parameter by its name·&IsUniqueName() - test uniqueness of the name of a prospective global parameters·&IsValidGlobalParameter() - test if an Id is of a valid global parameter elementThe new class: ·&GlobalParametercontains methods to control and manipulate a single global parameter. It's most important members include:·&[static] Create() - Creates a new Global Parameter in the given document. ·&GetAffectedElements() - Returns all elements of which properties are driven by this global parameter. ·&GetAffectedGlobalParameters() - Returns all other global parameters which refer to this global parameter in their formulas.·&GetLabeledDimensions() - Returns all dimension elements that are currently labeled by this global parameter. ·&CanLabelDimension() - Tests whether a dimension can be labeled by the global parameter. ·&LabelDimension() - Labels a dimension with this global parameter.·&UnlabelDimension() - Un-labels a dimension that is currently labeled by this global parameter.·&GetLabelName() - Returns the name of this parameter's label, which is used to label dimension elements. ·&SetDrivingDimension() - Set a dimension to drive the value of this parameter.·&IsValidFormula() - Tests that the given expression is a valid as formula for this parameter.·&GetFormula() - Returns the parameter's expression in form of a string.·&SetFormula() - Sets a formula expression for this parameter.·&GetValue() - Obtains the current value of the global parameter.·&SetValue() - Sets a new value of the global parameter.·&HasValidTypeForReporting() - Tests that the global parameter has data of a type that supports reporting.·&[static] IsValidDataType() - Tests whether the input Data Type is valid as a type of a global parameter.·&IsDrivenByDimension - Indicates whether this parameter is driven by a dimension or not.·&IsDrivenByFormula - Indicates whether this parameter is driven by a formula or not.·&IsReporting - Indicates whether this is a reporting global parameter or not.The new class:·&ParameterValuecontains a value of a corresponding global parameter. It is a base class for derived concrete classes, one per each type of a parameter value:·&IntegerParameterValue·&DoubleParameterValue·&StringParameterValue·&ElementIdParameterValue·&NullParameterValueAll the derived classes have only one property:·&Value - gets or sets the value as the corresponding type.New methods added the the Parameter class:·&CanBeAssociatedWithGlobalParameter() - Tests whether a parameter can be associated with the given global parameter.·&CanBeAssociatedWithGlobalParameters() - Tests whether a parameter can be associated with any global parameter.·&AssociateWithGlobalParameter() - Associates a parameter with a global parameter in the same document.·&DissociateFromGlobalParameter() - Dissociates a parameter from a global parameter.·&GetAssociatedGlobalParameter() - Returns a global parameter, if any, currently associated with a parameter.InternalDefinition.IdThe new property:·&InternalDefinition.Idreturns the id for the associated parameter. This is the id of the associated ParameterElement if the parameter is not built-in.Multiline Text parameter supportThe new enumerated value:·&ParameterType.MultilineTextwas added for creation and use of multi-line text parameters.CurveElement API additionsEnd joins and tangent constraints APIsCurveElements now support options to read elements that are joined to this element at the given end point, and to apply and lock tangent constraints.The new methods:·&CurveElement.GetAdjoinedCurveElements()·&CurveElement.IsAdjoinedCurveElement()support read of elements joined to this curve element.The new methods:·&CurveElement.SupportsTangentLocks()·&CurveElement.HasTangentJoin()·&CurveElement.HasTangentLocks()·&CurveElement.GetTangentLock()·&CurveElement.SetTangentLock()support access and modification to tangent constraints on the given curve element.Railing API additionsSeveral new methods have been added to BaseRailing:·&BaseRailing.Create() - Creates a new railing by specifying the railing path in the project document.·&BaseRailing.SetPath() - Sets the railing path.·&BaseRailing.RailingCanBeHostedByElement() - Checks whether the specified element can be used as a host for the railing.Schedule API additionsCombined ParametersSeveral methods and properties have been added to support combined parameters in schedules:·&ScheduleDefinition.InsertCombinedParameterField()·&ScheduleDefinition.IsValidCombinedParameters() - Verifies if the input is suitable for a combined parameter field.·&ScheduleField.GetCombinedParameters() - The values from a combined parameter field.·&ScheduleField.SetCombinedParameters()·&ScheduleField.IsCombinedParameterField·&ScheduleField.IsValidCombinedParameters()·&static TableCellCombinedParameterData.Create()The new enum value:·&binedParameterindicates a combined parameter field.Tag API additionsSpatialElementTag APISpatialElementTag is a base element for Autodesk.Revit.DB.Architecture.RoomTag, Autodesk.Revit.DB.AreaTag and Autodesk.Revit.DB.Mechanical.SpaceTag.The following new properties have been added:·&SpatialElementTag.IsOrphaned - Identifies if the tag is orphaned or not.·&SpatialElementTag.IsTaggingLink - Identifies if the tag has reference to an object in a linked document or not.·&SpatialElementTag.LeaderElbow - The position of the leader's elbow (middle point).·&SpatialElementTag.LeaderEnd - The position of the leader's end.·&SpatialElementTag.TagHeadPosition - The position of the tag's head.·&SpatialElementTag.TagOrientation - The orientation of the tag.RoomTag APIThe following new properties have been added to RoomTag:·&RoomTag.IsInRoom - Identifies if the tag is located in a room.·&RoomTag.TaggedLocalRoomId - The ElementId of the tagged room in the same document.·&RoomTag.TaggedRoomId - The LinkElementId of the tagged room. This property works for both rooms in the main model and rooms in linked models.UI API additionsColorSelectionDialogThe new class:·&ColorSelectionDialogprovides the option to launch the Revit Color dialog to prompt the user to select a color. The original color can be set as well as the selected color before the user changes it. The method:·&ColorSelectionDialog.Show()returns a status indicating if a color was selected and the dialog confirmed, or if the user canceled the selection.FileOpenDialog and FileSaveDialogThe new classes:·&FileOpenDialog·&FileSaveDialogallow an add-in to prompt the user with the Revit dialog used to navigate to and select an existing file path. FileOpenDialog is typically used to select a file for opening or importing. FileSaveDialog is typically used to enter a file name for saving or exporting.The behavior and appearance of this dialog matches the Revit &Open& dialog. This is a general-purpose dialog for opening any given file type, and options to configure settings like worksharing options will not be included. Use of this dialog does not actually open an existing file, but it will provide the selected file path back to the caller to take any action necessary.These dialogs inherit from:·&FileDialogwhich exposes the shared options and operations needed for prompting with either an open or a save dialog. The method:·&FileDialog.Show()returns a status indicating if a file was selected and the dialog confirmed, or if the user canceled the selection.TaskDialog API additionsThe new members:·&TaskDialog.ExtraCheckBoxText·&TaskDialog.WasExtraCheckBoxChecked()provide access to an extra checkbox shown the user in the TaskDialog. If it is set, a checkbox with the text will be shown in the task dialog. The caller can get the user setting for the checkbox by checking the return value of the WasExtraCheckBoxChecked() methodSupport for journal data in overridden commandsThe new members:·&BeforeExecutingEventArgs.UsingCommandData·&ExecutedEventArgs.GetJournalData()·&ExecutedEventArgs.SetJournalData()support the ability for the add-in to store journal data associated to an overridden command, similar to the capability offered for External Commands. &Dockable Pane API additionsThe new members:·&DockablePaneProviderData.VisibleByDefault support the ability for the add-in to control the whether or not any Dockable Panes they register should be visible by default or not. Default is to true. Structure API additionsFabricSheetThe new property:·&FabricSheet.FabricNumberreturns the reinforcement numbering value for the fabric sheet element.The new method:·&FabricSheet.GetSegmentParameterIdsAndLengths()returns the set of parameter ID and length pairs that correspond to segments of a bent fabric sheet (like A, B, C, D etc.).The new method:·&FabricSheet.SetSegmentLength()sets the length of the bent fabric sheet segment (like A, B, C, D etc.)Quantitative FabricSheet layoutThe new enum value:·&FabricSheetLayoutPattern.QuantitativeSpacingindicates a pattern containing multiple groups of wires with a specific spacing and diameter.Several new methods have been added to support this layout pattern:·&FabricSheetType.SetLayoutAsCustomPattern() - Sets the major and minor layout patterns to Custom, and specifies the FabricWireItems and overhang distances to be used.·&FabricSheetType.IsCustom() - Determines whether the type is Custom Fabric Sheet.·&FabricSheettype.GetWireItem() - Gets the wire stored in the FabricSheet at the associated index.The new class:·&Autodesk.Revit.DB.Structure.FabricWireItemrepresents a single fabric wire. It has the following methods and properties:·&FabricWireItem.Create()·&FabricWireItem.Distance - The distance to the next FabricWireItem.·&FabricWireItem.WireLength·&FabricWireItem.WireTypeLoadCase API additionsThe property:·&LoadCase.Number can now be set.The new method:·&LoadCase.isNumberUnique() allows users to check if the proposed number is unique.RebarContainerThe new members:·&RebarContainer.SetItemHiddenStatus() ·&RebarContainer.IsItemHidden()provide access to the option to hide an individual RebarContainerItem in the given view.The new property:·&RebarContainer.PresentItemsAsSubelementsidentifies if Items should be presented in schedules and tags as separate subelements.Structural Connection API additionsStructural Connection APIThe new class:·&Autodesk.Revit.DB.Structure.StructuralConnectionHandlerrepresents connections between structural elements. A StructuralConnectionHandler can connect structural walls, floors, foundations, framings, or columns.Some methods and properties include:·&StructuralConnectionHandler.Create() - Creates a new instance of a StructuralConnectionHandler, which defines the connection between the given elements. The first element given is set as the primary one.·&StructuralConnectionHandler.GetConnectedElementIds()·&StructuralConnectionHandler.IsDetailed() - Checks if the StructuralConnectionHandler has the detailed connection type.·&StructuralConnectionHandler.ApprovalTypeId·&StructuralConnectionHandler.SingleElementEndIndex - The element end index for single element connections. 0 indicates the start and 1 the end.The new class:·&Autodesk.Revit.DB.Structure.StructuralConnectionHandlerTypedefines the type of a StructuralConnectionHandler.The new class:·&Autodesk.Revit.DB.Structure.StructuralConnectionApprovalTypedefines a type element which represents a connection approval type.The new class:·&Autodesk.Revit.DB.Structure.StructuralConnectionSettingsprovides access to project-wide structural connection settings. It contains the following methods and properties:·&static StructuralConnectionSettings.GetStructuralConnectionSettings()·&StructuralConnectionSettings.IncludeWarningControls - If set to true, a yellow triangle will be displayed with StructuralConnectionElements which have associated warnings.Rebar CouplersThe new class:·&Autodesk.Revit.DB.Structure.RebarCouplerrepresents a rebar coupler element.RebarCoupler has the following methods and properties:·&static RebarCoupler.Create()·&RebarCoupler.CouplerLinkTwoBars() - Determines whether the coupler sits on two rebar or caps a single rebar.·&RebarCoupler.GetCoupledReinforcementData() - If the coupler connects two rebars, this method returns a list of two ReinforcementData. If it only connects one, there will be one ReinforcementData.·&RebarCoupler.GetPointsForPlacement() - Gets the point or points where the coupler is placed.·&RebarCoupler.GetCouplerPositionTransform() - Gets a transform representing the relative position of the coupler at index couplerPositionIndex in the set.·&RebarCoupler.GetCouplerQuantity() - Identifies the number of couplers in a set.·&RebarCoupler.CouplerMarkThe new method:·&Rebar.GetCouplerId()returns the id of the RebarCoupler applied to the rebar at the specified end.The new enum value:·&Autodesk.Revit.DB.Structure.StructuralNumberingSchemas.RebarCouplerindicates the built-in schema for numbering rebar coupler elements.The new enum:·&Autodesk.Revit.DB.Structure.RevitCouplerErrorcontains various error states for a rebar coupler.The new class:·&Autodesk.Revit.DB.Structure.RebarReinforcementDatacontains information about rebar couplers.RebarReinforcementData has the following methods:·&RebarReinforcementData.Create()·&RebarReinforcementData.GetId() - The id of the associated Rebar.·&RebarReinforcementData.SetId()·&RebarReinforcementData.GetEnd() - The end of the rebar to which a coupler is attached.Rebar end treatments The new class:·&Autodesk.Revit.DB.Structure.EndTreatmentTyperepresents an end treatment type for rebar.It has the following methods:·&static EndTreatmentType.Create(Document)·&static EndTreatmentType.Create(Document, String) - Creates a new EndTreatmentType with the given name.·&static EndTreatmentType.CreateDefaultEndTreatmentType() - Creates a new EndTreatmentType with a default name.·&EndTreatmentType.GetEndTreatment() - The value of the END_TREATMENT parameter.·&EndTreatmentType.SetEndTreatment()Several methods have been added to other classes to support end treatments:·&RebarShape.GetEndTreatmentTypeId() - The id of the end treatment type for the designated shape end.·&RebarShape.SetEndTreatmentTypeId()·&RebarShape.HasEndTreatment()·&Rebar.GetEndTreatmentTypeId()The new enum value:·&ElementGroupType.EndTreatmentTypeindicates an end treatment type.The new property:·&ReinforcementSettings.RebarShapeDefinesEndTreatmentsindicates whether end treatments are defined by the RebarShape of the Rebar element. This value can be changed if the document contains no rebars, area reinforcements, or path reinforcements.Additionally, the following methods and properties have been modified to require that the RebarShape has no end treatments:·&RebarContainer.AppendItemFromRebar()·&RebarContainer.AppendItemFromRebarShape()·&RebarContainer.AppendItemFromCurvesAndShape()·&RebarContainerItem.SetFromRebar()·&RebarContainerItem.SetFromRebarShape()·&RebarContainerItem.SetFromCurvesAndShape()·&RebarContainerItem.RebarShapeIdOther Structure API additionsNew properties have been added to ReinforcementSettings:·&ReinforcementSettings.NumberVaryingLengthRebarsIndividually - Modifies the way varying length bars are numbered (individually or as a whole).·&ReinforcementSettings.RebarVaryingLengthNumberSuffix - A unique identifier used for a bar within a variable length rebar set.·&RebarConstraintsManager.isRebarConstrainedPlacementEnabled - Enables/Disables the 'Rebar Constrained Placement' setting in the current Revit Application Session.One property has been added to Rebar:·&Rebar.DistributionType - Modifies the type of a rebar set. Rebar sets can be Uniform or VaryingLength.The new Rebar method:·&getParameterValueAtIndex(ElementId paramId, int barPositionIndex)returns the ParameterValue at the given bar index inside a rebar set.Fabrication API additionsFabricationPart - product list supportTo specify a size, some FabricationPart elements, such as purchased duct and pipe fittings, have a Product Entry field in the Properties palette. In the API these FabricationPart elements are identified as having a &product list&. The product list entries represent a catalog of available sizes for the selected part. The following new members are added to support product list FabricationPart elements:·&FabricationPart.ProductListEntry - The product list entry index of the fabrication part. A value of -1 indicates the fabrication part is not a product list. ·&FabricationPart.IsProductList()·&FabricationPart.GetProductListEntryName() ·&FabricationPart.GetProductListEntryCount()·&FabricationPart.IsProductListEntryCompatibleSize() - Checks to see if this part can be changed to the specified product list entry without altering any connected dimensions.Design to fabrication conversionThe new class:·&DesignToFabricationConvertersupports the conversion of design elements to FabricationPart elements. Use the method:·&DesignToFabricationConverter.Convert()to carry out the conversion, and use the available accessor methods to get the elements created during the conversion, and the elements which failed to convert for various reasons.FabricationPart - Stretch and fitThe new method:·&FabricationPart.StretchAndFit()supports the operation to stretch the fabrication part from the specified connector and fit to the target routing end. The routing end is indicated as a FabricationPartRouteEnd object, which can be obtained from:·&FabricationPartRouteEnd.CreateFromConnector()·&FabricationPartRouteEnd.CreateFromCenterline()Support for fabrication configuration profilesThe new method:·&FabricationConfiguration.SetConfiguration(Autodesk.Revit.DB.FabricationConfigurationInfo info, System.String profile)sets the fabrication configuration with the specified profile.The new methods:·&FabricationConfiguration.GetProfile()·&FabricationConfiguration.GetProfiles()return the profile associated with the loaded configuration or all configurations, respectively.Support for accessing fabrication configuration data abbreviations addedThe new methods:·&FabricationConfiguration.GetMaterialAbbreviation()·&FabricationConfiguration.GetSpecificationAbbreviation()·&FabricationConfiguration.GetInsulationSpecificationAbbreviation()MEP Fabrication APIThe following new members and properties have been added to the MEP fabrication and FabricationPart capabilities:The new properties:·&FabricationPart.ServiceId·&FabricationPart.ServiceName·&FabricationPart.ServiceAbbreviation·&FabricationPart.TopOfPartElevation·&FabricationPart.BottomOfPartElevation·&FabricationPart.ItemNumber·&FabricationPart.ItemCustomId·&FabricationPart.Size·&FabricationPart.Slope·&FabricationPart.OverallSize·&FabricationPart.Weight·&FabricationPart.HasInsulation·&FabricationPart.InsulationType·&FabricationPart.InsulationThickness·&FabricationPart.InsulationArea·&FabricationPart.HasLining·&FabricationPart.LiningType·&FabricationPart.LiningThickness·&FabricationPart.LiningArea·&FabricationPart.SheetMetalArea·&FabricationPart.MaterialThickness·&FabricationPart.HasDoubleWall·&FabricationPart.DoubleWallMaterial·&FabricationPart.DoubleWallMaterialThickness·&FabricationPart.DoubleWallMaterialArea·&FabricationPart.IsBoughtOut·&FabricationPart.Notes·&FabricationPart.Alias·&FabricationPart.Vendor·&FabricationPart.VendorCode·&FabricationPart.ProductName·&FabricationPart.ProductShortDescription·&FabricationPart.ProductLongDescription·&FabricationPart.ProductFinishDescription·&FabricationPart.ProductSpecificationDescription·&FabricationPart.ProductMaterialDescription·&FabricationPart.ProductSizeDescription·&FabricationPart.ProductDataRange·&FabricationPart.ProductOriginalEquipmentManufacture·&FabricationPart.ProductInstallTypeThe new methods:·&FabricationPart.RotateConnecteFabricationPart.ServiceIddPartByConnector()·&FabricationPart.RotateConnectedTap()·&FabricationPart.StretchAndFit()·&FabricationServiceButton.ContainsFabricationPartType()·&FabricationServiceButton.GetConditionDescription()·&FabricationPart.CreateHanger() - Creates a free placed hanger. ·&FabricationPart.Reposition() - Repositions the fabrication straight part to another end of the run.·&FabricationPart.PlaceFittingAsCutIn() - Places the fitting on the straight part by cut in, use the fitting's focal point as the insertion position.·&FabricationPart.CanAdjustEndLength() - Checks if the end of fabrication part can be adjusted.·&FabricationPart.AdjustEndLength() - Adjusts the length for the specified connector of the fabrication part.·&FabricationHostedInfo.GetBearerCenterline() - Gets the centerline of the bearer. This method is applicable only for bearer hangers.·&FabricationRodInfo.SetRodEndPosition() - Sets the position of the rod end.·&FabricationRodInfo.AttachToHanger() - Attaches the hanger rod to another bearer hanger.·&FabricationRodInfo.IsRodLockedWithHost() - Checks if the rod is locked with the host.·&FabricationRodInfo.SetRodLockedWithHost() - Locks the rod with the host.·&FabricationRodInfo.GetBearerExtension() - Gets the bearer extension.·&FabricationRodInfo.SetBearerExtension() - Sets the bearer extension.Electrical API additionsThe new method:·&Wire.GetMEPSystems()gets the system(s) to which the wire belongs.The new property:·&ElectricalSetting.CircuitRatingprovides access to the default circuit rating for a newly created circuit. The new property:·&ElectricalSetting.CircuitLoadCalculationMethodprovides read and write access to method Revit will use to calculate the apparent circuit load.Cable Tray APIThe new class:·&Autodesk.Revit.DB.Electrical.CableTraySettingscontains settings for cable trays.It has the following methods and properties:·&CableTraySettings.GetCableTraySettings()·&CableTraySettings.ConnectorSeparator - The cable tray connector separator string.·&CableTraySettings.FittingAnnotationSize·&CableTraySettings.RiseDropAnnotationSize·&CableTraySettings.SizeSeparator·&CableTraySettings.SizeSuffix·&CableTraySettings.UseAnnotationScaleForSingleLineFittingsThe new class:·&Autodesk.Revit.DB.Electrical.CableTraySizescontains info about the cable tray sizing options in the project. Some methods include:·&static CableTraySizes.GetCableTraySizes()·&CableTraySizes.AddSize() - Inserts a new MEPSize into the cable tray sizes. For cable trays, the nominal diameter MEPSize is used.The new class:·&Autodesk.Revit.DB.Electrical.CableTraySizeIteratorallows iterating over the CableTraySizes.Conduit APIThe new class:·&Autodesk.Revit.DB.Electrical.ConduitSettingscontains settings for conduits.It has the following methods and properties:·&ConduitSettings.GetConduitSettings()·&ConduitSettings.ConnectorSeparator - The conduit separator string.·&ConduitSettings.FittingAnnotationSize·&ConduitSettings.RiseDropAnnotationSize·&ConduitSettings.SizeSeparator·&ConduitSettings.SizeSuffix·&ConduitSettings.UseAnnotationScaleForSingleLineFittingsThe new class:·&Autodesk.Revit.DB.Electrical.ConduitSizecontains basic size information for a conduit.It contains the following methods and properties:·&ConduitSize.ConduitSize() - Constructs a ConduitSize object.·&ConduitSize.BendRadius - The minimum bend radius.·&ConduitSize.InnerDiameter·&ConduitSize.NominalDiameter·&ConduitSize.OuterDiameter·&ConduitSize.UsedInSizeLists·&ConduitSize.UsedInSizingThe new classes:·&Autodesk.Revit.DB.Electrical.ConduitSizes·&Autodesk.Revit.DB.Electrical.ConduitSizeIteratorallow traversal of the ConduitSize objects in the project.The new class:·&Autodesk.Revit.DB.Electrical.ConduitSizeSettingscontains settings information about the ConduitSize objects in the project.Some methods include:·&static ConduitSizeSettings.GetConduitSizeSettings()·&ConduitSizeSettings.AddSize() - Inserts a new ConduitSize into the conduit size settings.·&ConduitSizeSettings.CreateConduitStandardTypeFromExistingStandardType() - Creates one conduit standard type with the given name and assigns the conduit sizes from the existing standard type.Other MEP API additionsDuctSettings ClassNew properties:·&FlatOnTop - Gets/Sets the abbreviation of the Flat On Top (FOT) string·&FlatOnBottom - Gets/Sets the abbreviation of the Flat On Bottom (FOB) string·&SetUp - Gets/Sets the abbreviation of the Set Up (SP) string·&SetDown - Gets/Sets the abbreviation of the Set Down (SD) string·&Centerline - Gets/Sets the abbreviation of the Centerline (=) stringPipeSettings ClassNew properties:·&FlatOnTop - Gets/Sets the abbreviation of the Flat On Top (FOT) string·&FlatOnBottom - Gets/Sets the abbreviation of the Flat On Bottom (FOB) string·&SetUp - Gets/Sets the abbreviation of the Set Up (SP) string·&SetDown - Gets/Sets the abbreviation of the Set Down (SD) string·&Centerline - Gets/Sets the abbreviation of the Centerline (=) stringMechanicalUtils The new method:·&MechanicalUtils.BreakCurve()breaks the duct or duct placeholder into two parts at the given position.PlumbingUtilsThe new method:·&PlumbingUtils.BreakCurve()breaks the pipe or pipe placeholder into two parts at the given position.Validation for fitting and accessory pressure drop calculationsThe new calculation type:·&FittingAndAccessoryCalculationType.ValidateCurrentSettingscan be passed by Revit to servers as a member of the bitmask in PipeFittingAndAccessoryPressureDropData.CalculationType and DuctFittingAndAccessoryPressureDropData.CalculationType.ValidateCurrentSettings indicates that the server should validate the settings stored in the current entity. A server should implement this calculation type if its settings can become invalid after changes such as flow. The server should return the status of the validation in the new properties:·&PipeFittingAndAccessoryPressureDropData.IsCurrentEntityValid·&DuctFittingAndAccessoryPressureDropData.IsCurrentEntityValidIf the setting validation returns false, Revit will replace the setting with the default one, and update the fitting pressure drop accordingly.Family Connector InfoThe new class:·&MEPFamilyConnectorInfoadds the following methods:·&MEPFamilyConnectorInfo.GetAssociateFamilyParameterId() - Gets the associate family parameter id of the specified connector parameter id. ·&MEPFamilyConnectorInfo.GetConnectorParameterValue() - Gets the parameter value of the specified connector parameter id.Revit Link API additionsLink instance locationsThe new method:·&RevitLinkInstance.MoveBasePointToHostBasePoint()will move a RevitLinkInstance so that the link's base point and host project's base point are in the same location.The new method:·&RevitLinkInstance.MoveOriginToHostOrigin()moves this link instance so that the internal origin of the linked document is aligned to the internal origin of the host document.Both methods cause a one-time movement and do not set up any shared coordinates relationship.Local unload of Revit LinksThe new method:·&RevitLinkType.UnloadLocally()allows unloading a Revit link in a workshared file for the current user only. When another user opens their local model, the link will still be loaded for them. This method accepts an instance of a new interface class:·&ISaveSharedCoordinatesCallbackForUnloadLocallyThe response to the method in this interface is used to control Revit when trying to unload locally a Revit link with changes in shared coordinates.The new method:·&RevitLinkType.RevertLocalUnloadStatus()turns off a user's local link override. If the link is loaded for other users, this function will reload the link. If the link is unloaded for other users, then the link will remain unloaded, but the local unload override will be cleared.Category API additionsLine PatternsThe new functions:·&Category.GetLinePatternId()·&Category.SetLinePatternId()can be used to get or set the line pattern id associated with that category for the given graphics style type.
参考知识库
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：1024370次
积分：12868
积分：12868
排名：第780名
原创：287篇
评论：590条
(3)(1)(2)(1)(1)(3)(1)(2)(3)(1)(1)(2)(2)(4)(7)(6)(6)(3)(9)(4)(6)(8)(3)(1)(4)(4)(5)(7)(1)(7)(4)(3)(5)(4)(7)(7)(2)(6)(11)(6)(6)(14)(13)(11)(5)(7)(6)(3)(7)(4)(3)(3)(6)(2)(15)(6)(6)(14)}