What's New in the Revit Sundial API?

Another entry in the category of "Imagine if you will..." (meaning you can't really kick the tires in a hosted preview) are the enhancements in the Revit Sundial API. By request from a developer, here's what's new...

Major API additions

ComponentRepeater

New Methods

• ComponetRepeater.CanElementBeRepeated - Determines whether an element can be repeated using the RepeatElements method. 
• ComponentRepeater.RemoveRepeaters - Removes component repeaters from the document, but leaves the individual repeated components in their respective locations and hosted on their original hosts.

Dimension API improvements

Dimension class

The following new members have been added to support adjustment of the text location and corresponding leaders of a given single dimension:

• Dimension.Origin  - returns the origin of the dimension (the middle point of the dimension line that makes up the dimension).
• Dimension.LeaderEndPosition - a read/write property representing the position of the dimension's leader end point.
• Dimension.TextPosition - a read/write property representing the position of the dimension text's drag point.
• Dimenson.IsTextPositionAdjustable() - indicates if this dimension is supported to get and set TextPosition/LeaderPosition.
• Dimension.ResetTextPosition() - resets the text position of the dimension to the initial position determined by its type and parameters.

DimensionSegment

The following new members have been added to support adjustment of the text location and corresponding leaders of a given dimension segment in a multi-segment dimension:

• DimensionSegment.LeaderEndPosition - a read/write property representing the position of the dimension segment's leader end point.
• DimensionSegment.TextPosition - a read/write property representing the position of the dimension segment's text's drag point.
• DimensionSegment.IsTextPositionAdjustable() - indicates if this dimension segment is supported to set/get TextPosition/LeaderPosition
• DimensionSegment.ResetTextPosition() - resets the text position of the segment to the initial position determined by its type and parameters.

DWFExportOptions

New  Property 

• ExportTexture - sets the option to export textures in 3D DWF files (default true)

PanelScheduleView

New Methods

• PanelScheduleView.GetCellsBySlotNumber () – Returns a range of cells for the given slot number
• PanelScheduleView.CanMoveSlotTo()   - Verifies if can circuits in the source slot to the specific slot.
• PanelScheduleView.MoveSlotTo() - Move the circuits in the source slot to the specific slot.

View3D

New methods:

• View3D.CanResetCameraTarget() - Checks whether the camera target can be reset for this view.
• View3D.ResetCameraTarget() - Resets the camera target to the center of the field of view. 
• View3D.CanToggleBetweenPerspectiveAndIsometric() - Checks whether the view can toggle between Perspective and isometric.
• View3D.ToggleToPerspective() - Toggles the view to perspective.
• View3D.ToggleToIsometric() - Toggles the view to isometric.

Minor API additions

BaseExportOptions

New Property:

• BaseExportOptions.PreserveCoincidentLines - Allows export to preserve coincident lines

ElectricalSetting

New Enum:

• ElectricalSetting.CircuitSequence - Gets and sets the circuit sequence numbering schema

Workset

The new static method:

• Workset.Create()

creates a new Workset.

WorksetTable

New static methods:

• WorksetTable.RenameWorkset() - Renames the Workset.
• WorksetTable.IsWorksetNameUnique() - Checks if the given Workset name is unique in the document.

The new method:

• WorksetTable.SetActiveWorksetId()

sets the active Workset.

Application

The new property:

• Application.BackgroundColor

allows read and write of the background color to use for model views in this session.

ScheduleDefinition 

New Properties:

• ScheduleDefinition.ShowTitle – Indicates if the title will be displayed in the schedule.
• ScheduleDefinition.ShowHeaders - Indicates if the headers will be displayed in the schedule.

Thin lines options

A utility class ThinLinesOptions is added that contains the setting related to the Thin Lines options which affects the display in the UI.

The static property:

• ThinLinesOptions.AreThinLinesEnabled 

defines if the 'Thin Lines' setting is on or off in this session.

Let us know what you think!

Anthony

Comments

[Michael Coffey]

I wouldn't classify Workset.Create as minor! Thats a great improvement we've needed. We also need to be able to create scope boxes, ceilings, and view templates please. Thanks!