Here is another bunch of issues addressed in the Revit API discussion forum and elsewhere in the past day or two:
As you may have noticed, I published The Building Coder entire source text and complete index on GitHub last week.
If you look now at the right hand side bar or the navigation bar at the bottom, you will see the two new entries index and source that take you straight there.
I hope you find the complete index and full source text access useful!
We have often dealt here with topics around edit and continue, debug without restart and 'live development'.
This note is just to point out another contribution to that series, a StackOverflow question on Revit API load command – auto reload, in case you are interested in this too.
This is a very common need, brought up again by Dirk Neethling in the thread on drawing a curve in ActiveUIDocument.Document using IList<XYZ>:
Question: I'm trying to draw a contiguous curve in an ActiveUIDocument.Document, using a List of XYZ objects.
Most examples draw a curve in a FamilyDocument, and I could not adapt it for an ActiveUIDocument.Document.
Is it necessary to create a plane for such a curve?
Answer: Yes, it is.
You can create a model curve or a detail curve, and both reside on a sketch plane.
If you care about efficiency, you might care to reuse the sketch planes as much as possible.
Note that some existing samples create a new sketch plane for each individual curve, which is not a nice thing to do.
The Building Coder provides a number of samples, e.g.:
A Creator model curve helper class is also included in The Building Coder samples,
in the module Creator.cs.
Furthermore, the CmdDetailCurves sample command shows how to create detail lines, in the
module CmdDetailCurves.cs.
The GitHub repository master branch is always up to date, and previous versions of the Revit API are supported by different releases.
As you should probably know if you are reading this, detail lines can only be created and viewed in a plan view.
Also, it is useful to know that the view graphics and visibility settings enable you to control the model line appearance, e.g. colour and line type.
Here is another common need, to determine the distance from family instance to the floor or elevation below, raised by Kailash Kute:
Question: I want to calculate the elevation (distance) of a selected family instance with respect to the Floor or Level below it.
How to get the floor or level which is below the selected family instance?
How to get the elevation of the instance with respect to that level?
Later:
The help text on finding geometry by ray projection (Revit 2014 Czech, Revit 2015 English) provides part of the answer, but is valid only if there is a Floor below the family instance.
If I only have a Level below it, the ray passing through does not return any distance (proximity).
Now my question gets filtered down to: How to find Intersection with Level?
Answer: If all you need is the distance between the family instance and the level, I see a possibility for a MUCH easier approach:
Ask the family instance for its bounding box and determine its bottom Z coordinate Z1.
Determine the elevation Z0 of the level.
The distance you seek is Z1 - Z0.
Response: A little bit of work around with points got from bounding box and done.
Wow, really a MUCH easier approach.
Eirik Aasved Holst yesterday brought up and solved the question that regularly comes up on how to delete PrintSetup and ViewSheetSettings:
Question: TL;DR: Is there a way of deleting a specific PrintSetup and ViewSheetSetting programmatically if I know its name?
Long version:
I'm writing a function that can print a large set of sheets in various paper sizes to separate/combined PDFs.
To be able to apply the PrintSetup, it needs to be set in an "in-session" state and saved using SaveAs() (to my knowledge).
But after saving an "in-session"-PrintSetup to a new PrintSetup, I cannot find a way of deleting said new PrintSetup.
After the PrintManager has printed the sheets, I'm stuck with lots of temporary PrintSetups. The same goes for ViewSheetSettings.
try
{
pMgr.PrintSetup.Delete();
pMgr.ViewSheetSetting.Delete();
}
catch (Exception ex)
{
//Shows 'The print setup cannot be deleted'
TaskDialog.Show("REVIT", ex.Message);
}
So the problem is: I'm not able to apply the PrintSetup and ViewSheetSettings unless I'm using them "in-session" and saving them using SaveAs, and I'm not able to delete the PrintSetup and ViewSheetSettings afterwards.
Has anyone experienced similar issues, or found a way to solve it?
Answer: This discussion on setting the ViewSheetSetting.InSession.Views property makes one brief mention of deleting a print setting, afaik can tell.
This other one on PrinterManager PrintSetup not applying settings appears to suggest a similar approach.
Response: These links unfortunately do not help much.
It would be nice if it was possible to loop through the saved PrintSetup's, or at least get a PrintSetup if you knew it's name, so that you can delete it.
In the thread on PrinterManager PrintSetup not applying settings, the user aricke mentions:
Note that once you have done the SaveAs, you can then delete the newly saved PrintSetup.
I cannot seem to get that to work; even the following code raises an exception:
pSetup.SaveAs("tmp");
pSetup.Delete();
Solution: I finally managed to create a CleanUp-method that works. If others are interested, here it goes:
private void CleanUp( Document doc ) { var pMgr = doc.PrintManager; using( var trans = new Transaction( doc ) ) { trans.Start( "CleanUp" ); CleanUpTemporaryViewSheets( doc, pMgr ); CleanUpTemporaryPrintSettings( doc, pMgr ); trans.Commit(); } } private void CleanUpTemporaryPrintSettings( Document doc, PrintManager pMgr ) { var printSetup = pMgr.PrintSetup; foreach( var printSettingsToDelete in ( from element in new FilteredElementCollector( doc ) .OfClass( typeof( PrintSetting ) ) .ToElements() where element.Name.Contains( _tmpName ) && element.IsValidObject select element as PrintSetting ) .ToList() .Distinct( new EqualElementId() ) ) { printSetup.CurrentPrintSetting = pMgr.PrintSetup.InSession; printSetup.CurrentPrintSetting = printSettingsToDelete as PrintSetting; pMgr.PrintSetup.Delete(); } } private void CleanUpTemporaryViewSheets( Document doc, PrintManager pMgr ) { var viewSheetSettings = pMgr.ViewSheetSetting; foreach( var viewSheetSetToDelete in ( from element in new FilteredElementCollector( doc ) .OfClass( typeof( ViewSheetSet ) ) .ToElements() where element.Name.Contains( _tmpName ) && element.IsValidObject select element as ViewSheetSet ) .ToList() .Distinct( new EqualElementId() ) ) { viewSheetSettings.CurrentViewSheetSet = pMgr.ViewSheetSetting.InSession; viewSheetSettings.CurrentViewSheetSet = viewSheetSetToDelete as ViewSheetSet; pMgr.ViewSheetSetting.Delete(); } }
Many thanks to Eirik for discovering and sharing this solution!