Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yiskang/da4r-dwgexporter
Sample Revit Addin for exporting views (2D & 3D) to DWG via the Design Automation for Revit
https://github.com/yiskang/da4r-dwgexporter
addin autodesk-designautomation exporter revit revit-api sample-code
Last synced: 28 days ago
JSON representation
Sample Revit Addin for exporting views (2D & 3D) to DWG via the Design Automation for Revit
- Host: GitHub
- URL: https://github.com/yiskang/da4r-dwgexporter
- Owner: yiskang
- License: mit
- Created: 2022-10-07T08:21:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-21T08:23:32.000Z (3 months ago)
- Last Synced: 2024-10-31T02:52:11.738Z (2 months ago)
- Topics: addin, autodesk-designautomation, exporter, revit, revit-api, sample-code
- Language: C#
- Homepage:
- Size: 669 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sample - Export DWG from Revit files with Design Automation
[](http://developer.autodesk.com/)
[](https://www.autodesk.com/products/revit/overview/)
[](http://opensource.org/licenses/MIT)
## Descriptions
This sample demonstrates how to implement Revit DWG exporter using Revit API.
### Note
This project is just a code sample demonstrating the possibilities of implementing an Revit DWG exporter using Revit API, and run it on APS Design Automation API for Revit, which means we don't cover all tests on this sample. So, it would be fail in particular cases that we don't consider or we don't cover in the tests.
Therefore, please don't use it on your production applications directly. If you want to use this sample directly on your production applications, then you must use this sample at your own risk.
## Thumbnail
- Revit 3D view to 3D DWG
- Revit 2D view to 2D DWG
## APS DA Setup
### Activity via [POST activities](https://aps.autodesk.com/en/docs/design-automation/v3/reference/http/activities-POST/)
```json
{
"commandLine": [
"$(engine.path)\\\\revitcoreconsole.exe /i \"$(args[inputFile].path)\" /al \"$(appbundles[DwgExporter].path)\""
],
"parameters": {
"inputFile": {
"verb": "get",
"description": "Input Revit File",
"required": true,
"localName": "$(inputFile)"
},
"inputJson": {
"verb": "get",
"description": "input Json parameters",
"localName": "params.json"
},
"outputDwg": {
"zip": true,
"verb": "put",
"description": "Exported DWG files",
"localName": "exportedDwgs"
}
},
"id": "yoursalias.DwgExporterActivity+dev",
"engine": "Autodesk.Revit+2021",
"appbundles": [
"yoursalias.DwgExporter+dev"
],
"settings": {},
"description": "Activity of exporting DWG from RVT",
"version": 1
}
```
### Workitem via [POST workitems](https://aps.autodesk.com/en/docs/design-automation/v3/reference/http/workitems-POST/)
- Export DWG by predefined export DWG setup and given view set name
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ 'exportSettingName': 'my-dwg-export', 'viewSetName': 'CAD Export' }"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
- Export DWG by given view set name and active predefined export DWG setup
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ 'viewSetName': 'CAD Export' }"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
- Export DWG by predefined export DWG setup and specific view ids
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ 'exportSettingName': 'my-dwg-export', 'viewIds': [ '44745acb-ebea-4fb9-a091-88d28bd746c7-000ea86d', 'c3f5348f-6947-4ddf-aa1e-749882f86acc-00000138' ] }"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
- Export DWG by modifying predefined export DWG setup on the fly and specific view ids
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ exportSettingName': 'my-dwg-export', 'viewIds': [ '44745acb-ebea-4fb9-a091-88d28bd746c7-000ea86d' ], 'applyCustomSettings': true, 'customSettings': { 'solidMode': 'ACIS' }}"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
- Export DWG by creating export DWG setup on the fly and specific view ids
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ 'viewIds': [ '44745acb-ebea-4fb9-a091-88d28bd746c7-000ea86d' ], 'applyCustomSettings': true, 'customSettings': { 'useSharedCoords': true, 'targetUnit': 'millimeter' }}"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
- Export DWG using default export DWG setup for all Revit views
```json
{
"activityId": "yoursalias.DwgExporterActivity+dev",
"arguments": {
"inputFile": {
"verb": "get",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
},
"inputJson": {
"verb": "get",
"url": "data:application/json,{ 'exportAllViews': true, 'includingRenderingViews': false }"
},
"outputDwg": {
"verb": "put",
"url": "https://developer.api.autodesk.com/oss/v2/signedresources/...?region=US"
}
}
}
```
### Tips & Tricks
1. This sample was only tested with Revit 2023, if you want to use it with newer Revit versions (e.g. Revit 2024), you must recompile the source code with corresponding Revit API version.
2. This addin will find below [export DWG setups](https://knowledge.autodesk.com/support/revit/learn-explore/caas/CloudHelp/cloudhelp/2019/ENU/Revit-DocumentPresent/files/GUID-3739AD36-FBAA-41E3-AC83-6D79C3C276CD-htm.html) in the input RVT file. if nothing matched found , it will use default settings of Revit API.
- Export DWG setup with the given name in the `exportSettingName` of the `inputJson`.
- Active predefined export DWG setup.
- If there is no predefined export DWG setup found in the RVT file, it will create an export DWG setup with default configurations.
3. You can specify views to be exported by either `viewIds` or `viewSetName` of the `inputJson`.
- **viewIds**: It's a set of Revit view's [UniqueId](https://www.revitapidocs.com/2023/f9a9cb77-6913-6d41-ecf5-4398a24e8ff8.htm) retrieved by Revit API, or the `viewableID` that can be found in the response of APS Model Derivative [GET :urn/manifest](https://aps.autodesk.com/en/docs/model-derivative/v2/reference/http/manifest/urn-manifest-GET/).
- `viewSetName`: It's the Revit [ViewSheetSet](https://www.revitapidocs.com/2023/5553be2c-8ce7-cbc1-b99e-85c74bcf28d3.htm). We can create one by Revit's [Publish Settings](https://knowledge.autodesk.com/support/revit/learn-explore/caas/CloudHelp/cloudhelp/2021/ENU/Revit-Cloud/files/GUID-09FBF9E2-6ECF-447D-8FA8-12AB16495BC3-htm.html).
4. To export Revit 3D view to 3D DWG and have the elements being exported as 3d solids, the solid style of [export DWG setups](https://knowledge.autodesk.com/support/revit/learn-explore/caas/CloudHelp/cloudhelp/2019/ENU/Revit-DocumentPresent/files/GUID-3739AD36-FBAA-41E3-AC83-6D79C3C276CD-htm.html) must be `ACIS solids` (see [AKN](https://knowledge.autodesk.com/support/revit/learn-explore/caas/sfdcarticles/sfdcarticles/Revit-How-to-export-a-model-to-dwg-as-3d-solids.html)).
5. You can specify `"exportAllViews": true` in the `inputJson` to export all views within the RVT file. By default, it will exclude all views of [rendering view type](https://help.autodesk.com/view/RVT/2024/ENU/?guid=GUID-4046977A-9323-4535-9AC0-4EF9A138A5A6), which are created by Autodesk Render. If you wan to included rendered images of the rendering views, you can specify `"includingRenderingViews": true` in the `inputJson`
## Limits
- Currently, this add-in supports creating/modifying export DWG setup on the fly, but only `TargetUnit`, `UseSharedCoords` and `SolidMode` of [CustomSettings.cs](/Autodesk.ADN.Rvt2Dwg/CustomSettings.cs) are tested. Feel free to add more options by uncommenting codes at [MainApp.cs#L321](/Autodesk.ADN.Rvt2Dwg/MainApp.cs#L321).
## License
This sample is licensed under the terms of the [MIT License](http://opensource.org/licenses/MIT). Please see the [LICENSE](LICENSE) file for full details.
## Written by
Eason Kang [in/eason-kang-b4398492/](https://www.linkedin.com/in/eason-kang-b4398492), [Developer Advocacy and Support Team](http://aps.autodesk.com)