Revit 2012 API 开发指南：深入解析

5星 · 超过95%的资源需积分: 17 176 浏览量更新于2024-07-25 收藏 9.82MB PDF 举报

"Revit 2012 API Developer Guide 是一本关于Revit二次开发的英文指南，被誉为目前最详尽的开发手册。本书由Autodesk公司于2011年出版，涵盖了Revit API的各个方面，旨在帮助开发者利用Revit API进行插件开发和应用程序设计。" Revit API是Autodesk Revit软件的开发接口，允许程序员通过编程来扩展和定制Revit的功能。在Revit 2012 API Developer Guide中，读者可以学习到如何与Revit的内部结构交互，创建自定义的工作流程，以及构建针对建筑信息模型（BIM）的解决方案。本书可能包含以下主要内容： 1. **基础介绍**：介绍Revit API的基本概念，包括API的架构、类库和接口，以及如何设置开发环境，为初学者提供入门指导。 2. **数据模型**：详细解释Revit中的元素类型、参数、层次结构和工作集，帮助开发者理解Revit模型的构建方式。 3. **API类和方法**：涵盖Revit API中的主要类和方法，如FamilyManager、Document、Selection等，以及如何使用它们来读取和修改Revit模型。 4. **事件处理**：讨论如何监听Revit事件并响应，例如模型更改、用户交互等，以实现动态功能。 5. **图形和视图控制**：介绍如何自定义Revit的视图、渲染和标注，以及如何创建和修改图形元素。 6. **插件开发**：提供关于如何创建和打包Revit插件的详细步骤，包括安装、调试和发布插件的指南。 7. **性能优化**：讨论在处理大量数据或执行复杂操作时，如何提高Revit API的性能和响应速度。 8. **错误处理和调试**：介绍Revit API的错误处理机制，以及如何调试Revit插件，确保其稳定运行。 9. **实例和示例代码**：书中可能包含大量实际的代码示例，以帮助开发者理解和应用所学知识。 10. **最佳实践**：分享开发Revit插件的最佳实践，包括设计模式、代码组织和版本控制策略。需要注意的是，由于该书版权属于Autodesk公司，未经许可不得复制或用于商业目的。同时，Autodesk不提供任何形式的明示或暗示保修，使用者需自行承担因获取或使用这些材料可能带来的任何损失或损害。此外，Autodesk有权随时更新和改进其产品，因此本书中的内容可能不完全反映未来的Revit版本特性。最后，Autodesk的商标如3DEC、AutoCAD等在本书中可能会被提及，它们是Autodesk公司的注册商标，在全球范围内具有法律保护。

Welcome to the Revit Platform API

Revit 2011 API User Manual

Code Region 14-7: Dividing a surface ................................................................................. 171

Code Region 14-8: Patterning a surface .............................................................................. 173

Code Region 14-9: Editing a curtain panel family ................................................................. 174

Code Region 15-1: Retrieving all Levels .............................................................................. 178

Code Region 15-2: Creating a new Level ............................................................................. 179

Code Region 15-3: Using the Grid class .............................................................................. 179

Code Region 15-4: NewGrid() ............................................................................................ 180

Code Region 15-5: Creating a grid with a line or an arc ........................................................ 181

Code Region 15-6: Displaying all supported phases .............................................................. 182

Code Region 15-7: Using design options ............................................................................. 183

Code Region 16-1: Distinguishing permanent dimensions from constraints .............................. 184

Code Region 16-2: NewDimension() ................................................................................... 189

Code Region 16-3: Duplicating a dimension with NewDimension() .......................................... 189

Code Region 16-4: NewDetailCurve() and NewModelCurve() ................................................. 190

Code Region 16-5: Creating an IndependentTag .................................................................. 191

Code Region 16-6: NewAnnotationSymbol() ........................................................................ 193

Code Region 16-7: Using addLeader() and removeLeader() ................................................... 193

Code Region 17-1: Creating a new SketchPlane ................................................................... 196

Code Region 17-2: Creating a new model curve ................................................................... 204

Code Region 17-3: Getting a specific Curve from a ModelCurve ............................................. 205

Code Region 18-1: Determining the View class type ............................................................. 211

Code Region 18-2: Determining the View type ..................................................................... 211

Code Region 18-3: Counting elements in the active view....................................................... 213

Code Region 18-4: NewView3D() ....................................................................................... 218

Code Region 18-5: Creating a 3D view ................................................................................ 218

Code Region 18-6: Showing the Section Box ....................................................................... 218

Code Region 18-7: Hiding the Section Box .......................................................................... 219

Code Region 18-8: NewViewPlan() ..................................................................................... 220

Code Region 18-9: Creating a floor plan and ceiling plan ....................................................... 220

Code Region 18-10: NewViewSection() ............................................................................... 221

Code Region 18-11: AddView() .......................................................................................... 223

Code Region 18-12: Creating a sheet view .......................................................................... 223

Code Region 19-1: Downcasting using RTTI......................................................................... 226

Code Region 19-2: Determining material type ..................................................................... 228

Code Region 19-3: Getting a material parameter ................................................................. 229

Code Region 19-4: Setting the fill pattern ........................................................................... 231

Code Region 19-5: Getting a material by name .................................................................... 232

Code Region 19-6: Duplicating a material............................................................................ 232

Welcome to the Revit Platform API

Revit 2011 API User Manual

Code Region 19-7: Adding a new Material ........................................................................... 233

Code Region 19-8: Removing a material ............................................................................. 233

Code Region 19-9: Getting an element material from a parameter ......................................... 235

Code Region 19-10: Getting window materials walkthrough ................................................... 240

Code Region 20-1: Creating Geometry.Options .................................................................... 242

Code Region 20-2: Retrieving faces and edges ..................................................................... 243

Code Region 20-3: Getting curves from an instance ............................................................. 244

Code Region 20-4: Getting solid information from an instance ............................................... 245

Code Region 20-5: Drawing the geometry of a mass ............................................................ 246

Code Region 20-6: Getting a solid from a GeometryObject .................................................... 247

Code Region 20-7: Transformation example ........................................................................ 248

Code Region 20-8: Using the Reflection property ................................................................. 249

Code Region 20-9: Rotating BoundingBoxXYZ ...................................................................... 256

Code Region 20-10: Getting solids and curves from a beam .................................................. 258

Code Region 21-1: Retrieving the ProjectLocation object ....................................................... 262

Code Region 21-2: Creating a project location ..................................................................... 264

Code Region 21-3: Deleting a project location ..................................................................... 264

Code Region 22-1: Parameter definition file example ............................................................ 266

Code Region 22-2: Shared Parameter FAMILYTYPE example .................................................. 267

Code Region 22-3: Creating a shared parameter file ............................................................. 269

Code Region 22-4: Getting the definition file from an external parameter file .......................... 269

Code Region 22-5: Traversing parameter entries ................................................................. 270

Code Region 22-6: Changing parameter definition group owner ............................................. 270

Code Region 22-7: Adding type parameter definitions using a shared parameter file ................ 272

Code Region 22-8: Adding instance parameter definitions using a shared parameter file ........... 274

Code Region 22-9: Extensible Storage ................................................................................ 276

Code Region 23-1: Using transactions ................................................................................ 279

Code Region 23-2: Combining multiple transactions into a TransactionGroup ........................... 280

Code Region 23-3: Transaction populating Geometry and AnalyticalModel properties ................ 283

Code Region 24-1: Registering Application.DocumentOpened ................................................ 287

Code Region 24-2: Canceling an Event ............................................................................... 288

Code Region 25-1: Example of implementing IUpdater ......................................................... 290

Code Region 26-1: Defining and registering a failure ............................................................ 298

Code Region 26-2: Posting a failure .................................................................................... 300

Code Region 26-3: Handling failures from IFailuresPreprocessor ............................................ 304

Code Region 26-4: Handling the FailuresProcessing Event ..................................................... 305

Code Region 26-5: IFailuresProcessor ................................................................................. 306

Code Region 27-1: Creating Analysis Results ....................................................................... 309

Welcome to the Revit Platform API

Revit 2011 API User Manual

Code Region 27-2: Setting analysis display style for view ...................................................... 310

Code Region 28-1: Creating a room .................................................................................... 313

Code Region 28-2: Creating and inserting a room into a plan circuit ....................................... 313

Code Region 28-3: Setting room bounding .......................................................................... 317

Code Region 28-4: Using a transaction to update room boundary ........................................... 319

Code Region 28-5: Getting a room from the family instance .................................................. 323

Code Region 28-6: Getting a room's dimensions .................................................................. 324

Code Region 28-7: Using the EnergyDataSettings class......................................................... 325

Code Region 29-1: Distinguishing between column, beam and brace ...................................... 326

Code Region 29-2: Using BuiltInCategory.OST_StructuralFraming .......................................... 327

Code Region 29-3: NewAreaReinforcement() ....................................................................... 328

Code Region 29-4:NewPathReinforcement() ........................................................................ 329

Code Region 29-5: Downcasting Face to PlanarFace ............................................................. 329

Code Region 29-6: Getting Normal and Origin ..................................................................... 329

Code Region 29-7: Creating a truss over two columns .......................................................... 330

Code Region 29-8: Creating rebar with a specific layout ........................................................ 332

Code Region 29-9: Getting boundary condition type and geometry ......................................... 334

Code Region 29-10: Getting a reference to analytical curve ................................................... 337

Code Region 29-11: Getting the location for a structural footing ............................................ 337

Code Region 29-12: Getting the curve for a structural column ............................................... 338

Code Region 29-13: Getting the curves for a structural wall .................................................. 339

Code Region 29-14: NewLoadCombination() ........................................................................ 346

Code Region 30-1: Creating a new Pipe .............................................................................. 348

Code Region 30-2: Changing pipe diameter ......................................................................... 349

Code Region 30-3: Adding a duct between two connectors .................................................... 349

Code Region 30-4: Creating a new mechanical system .......................................................... 352

Code Region 30-5: Determine what is attached to a connector .............................................. 353

Code Region 30-6: Adding a pipe connector ........................................................................ 355

Code Region 30-7: Revit.ini ExternalCommands Section ....................................................... 362

Code Region 3-27: Displaying Revit-style TaskDialog ............................................................ 363

Code Region 30-8: Revit.ini ExternalApplications section ....................................................... 365

Code Region 30-9: Hello World in VB.NET ........................................................................... 369

Code Region 30-10: Creating a .addin manifest file for an external command .......................... 370

Code Region 30-11: TaskDialog ......................................................................................... 371

Welcome to the Revit Platform API

Revit 2011 API User Manual

1 Welcome to the Revit Platform API

All Revit-based products are Parametric Building Information Modeling (BIM) tools. These tools are

similar to Computer-Aided Design (CAD) programs but are used to build 3D models as well as 2D

drawings. In Revit, you place real-world elements like columns and walls into the model. Once the

model is built, you can create model views such as sections and callouts. Views are generated from

the 3D physical model; consequently, changes made in one view automatically propagate through

all views. This virtually eliminates the need to update multiple drawings and details when you make

changes to the model.

1.1 Introduction to the Revit Platform API

The Revit .NET API allows you to program with any .NET compliant language including Visual

Basic.NET, C#, and C++/CLI.

Revit Architecture 2012, Revit Structure 2012, and Revit MEP 2012 all contain the Revit Platform

API so that you can integrate your applications into Revit. The three APIs are very similar and are

jointly referred to as the Revit Platform API. Before using the API, learn to use Revit and its

features so that you can better understand the relevant areas related to your programming.

Learning Revit can help you:

Maintain consistency with the Revit UI and commands.

Design your add-in application seamlessly.

Master API classes and class members efficiently and effectively.

If you are not familiar with Revit or BIM, learn more in the Revit product center at

http://www.autodesk.com/revit.

1.2 What Can You Do with the Revit Platform API?

You can use the Revit Platform API to:

 Gain access to model graphical data.

 Gain access to model parameter data.

 Create, edit, and delete model elements like floors, walls, columns, and more.

 Create add-ins to automate repetitive tasks.

 Integrate applications into Revit-based vertical products. Examples include linking an

external relational database to Revit or sending model data to an analysis application.

 Perform analysis of all sorts using BIM.

 Automatically create project documentation.

1.3 Requirements

To go through the user manual, you need the following:

1. A working understanding of Revit Architecture 2012, Revit Structure 2012, or Revit MEP

2012.

2. Familiarity with a Common Language Specification compliant language like C# or VB.NET.

3. Microsoft Visual Studio 2010, or Microsoft Visual Studio 2010 Express Edition. Alternatively,

you can use the built-in Visual Studio Tools for Applications (VSTA) development

environment in Revit. You must install VSTA from the Revit DVD separately from the Revit

product installation. Microsoft has not yet announced when Visual Studio Tools for

Welcome to the Revit Platform API

Revit 2011 API User Manual

Applications (VSTA) for .NET 4.0 will be available. VSTA is the technology used for Revit

macros. In the interim, run PrepareRevitForVSTA.bat before starting Revit to debug Revit

macros. This script can be found in the Revit Program folder. Because this script will disable

.NET 4.0 addins, run RestoreRevitFromVSTA.bat to restore Revit's default .NET 4.0 setting.

For more information on writing applications using VSTA, see the section "Creating Macros

with Revit VSTA" in the Revit 2012 User's Guide.

4. Microsoft .NET Framework 4.0.

5. The Revit Software Developer‘s Kit (SDK) which you can download from the Autodesk

Developer Network (ADN) or the Revit installation CD/DVD

(<DVD_Drive>:\Utilities\Common\Software Development Kit).

1.4 Install and Learn the Revit-Based Product

The examples in this document use Microsoft Visual Studio 2010 for the Integrated Development

Environment (IDE).

If you are a Revit novice, go through the tutorials which are accessible from the Revit Help menu.

If possible, take a training class from your local Autodesk reseller to help you quickly get up to

speed.

Regardless of your experience level, you can join one of the many discussion groups dedicated to

Revit and the Revit Platform API. The following resource links are a good starting point.

www.autodesk.com/revitbuilding

www.autodesk.com/revitstructure

www.autodesk.com/revitsystems

www.autodesk.com/bim

www.revitcity.com

www.augi.com

http://thebuildingcoder.typepad.com/

http://discussion.autodesk.com

Select = Autodesk Revit Architecture

Then Select = Autodesk Revit API

http://forums.augi.com/forumdisplay.php?f=93

http://discussion.autodesk.com/index2.jspa?categoryID=27

http://discussion.autodesk.com/index2.jspa?categoryID=104

http://discussion.autodesk.com/index2.jspa?categoryID=114

1.5 Installation

The Revit Platform API is installed with Revit Architecture, Revit Structure, and Revit MEP. Any

.NET based application will reference the RevitAPI.dll and the RevitAPIUI.dll located in the Revit

Program directory. The RevitAPI.dll contains methods used to access Revit‘s application,

documents, elements and parameters at the database level. The RevitAPIUI.dll contains the

interfaces related to manipulation and customization of the Revit user interface.

1.6 Supported Programming Languages

The Revit Platform API is fully accessible by any language compatible with the Microsoft .NET

Framework 4.0, such as Visual Basic .NET or Visual C#.

剩余432页未读，继续阅读

saibanxian

粉丝: 0
资源: 1

Revit 2012 API 开发指南：深入解析

revit_2013_api_developer_guide.pdf

Revit开发API帮助文档

Revit 2011 API Developer Guide

revit 2012 api developer guide

revit_2014_api_developer_guide.pdf

revit_2013_api_developer_guide.rar_Autodesk Revit_REVIT_bim_revi

Revit 2012 API 开发者指南

Revit 2012 API 开发者指南PDF

Revit 2018 API 文档说明书

Revit 2020 API 文档说明书

最新资源