Skip to content

Repository files navigation


monocle

A view extension for Dynamo.

GitHub release (latest by date) Maintenance GitHub license

If you appreciate the work put into this free package, please vote in support of it on Dynamo's package manager.

Disclaimer

This tool is not affiliated with Autodesk and was written and provided in a personal capacity by the author. This tool is provided "as is" without warranty of any kind, express or implied. Use at your own risk. By using this open-source tool, you acknowledge that the developers and contributors are not liable for any damages, losses, or issues that may arise from its use. You are responsible for ensuring compliance with all applicable laws and regulations. Remember, open-source software relies on community contributions, so functionality and security might vary. Always review, understand, and, if necessary, modify the code to suit your specific needs.

LICENSE

This code is licensed primarily under BSD 3-Clause with a Commons Clause License attached to that.

Current Version

The canonical project contains configurations for Dynamo 2.0 through 2.19 (net48), Dynamo 3.0 through 3.6 (net8.0-windows), Dynamo 3.7 (net10.0-windows), and Dynamo 4.0 through 4.2 (net10.0-windows). The Windows CI build matrix covers 2.19, 3.6, 3.7, 4.1, and 4.2. These are build targets; Dynamo/Revit host smoke tests are still required for each supported host version. The loader uses the exact major/minor build when available and falls back to the nearest older minor build within the same major version when it is not.

Build and Validation

Build on Windows with the .NET 8 and .NET 10 SDKs, the .NET Framework 4.8 targeting pack, and MSBuild. Restore and build a configuration with:

msbuild src/Monocle/Monocle.sln /p:Configuration="Release 4.1" /p:Platform="Any CPU" /p:EnableDeploymentCopy=false /t:Restore,Build

The pure regression checks can run independently of Dynamo:

dotnet run --project tests/Monocle.RegressionTests/Monocle.RegressionTests.csproj --configuration Release

The canonical project does not stage build output into deploy unless explicitly requested. For intentional local packaging, pass /p:EnableDeploymentCopy=true to the MSBuild command. The Revit DynamoPackages.dll reference is optional and defaults to the Revit 2022 install location; set /p:DynamoPackagesPath="C:\path\to\DynamoPackages.dll" when it is installed elsewhere. The separate Monocle-net8.csproj is retained as a legacy Dynamo 3.0 package project; its post-build copy is disabled by default and can be enabled with /p:EnableLegacyPostBuildCopy=true /p:LegacyDynamoPackagePath="C:\path\to\MonocleViewExtension.dll".

Known Issues

  • When installing from the package manager for the first time, you may need to restart Dynamo.

Contributors

This package is primarily managed by the author of http://designtechunraveled.com, and by People Like You™.

Updates

Since there is not currently an update notification process on Dynamo's package manager, I post notifications for updates on twitter.

Additionally, updates come through in the extension menu now!

Help improve Monocle

If you're interested in contributing to Monocle, just submit a pull request or a feature request .

If submitting a pull request, keep in mind the monocle style guide below.

monocle style guide

style guide

Installation

Monocle is available through Dynamo's built-in package manager. This provides the simplest installation for most users. If you are interested in manual install, there are some fabulous resources out there describing how to build your own Dynamo package.

Thank you!

forthebadge

forthebadge

About

This is the repository for the Monocle View Extension for Dynamo

Resources

Stars

55 stars

Watchers

6 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages