Claire Kuang
cd30370654
* adds reference point transform to publish * only send reference point if not identity * first pass at adding reference point transform to publish * fixes transform matrix * fixes autocad to system matrix conversion * fixes text transforms * removes bboxs * removes to internal reference point (send only for now) * fix nullability * adds instance handling * adds converter settings to civil * refactors instance unpacker and polyline to speckle conversion * fixes blocks and some polyline receive conversions * removes transform on root * feat(autocad): adds event tracking for change of ucs/wcs settings (#1164) * feat: track ucs changes and invalidate cache * chore: redundant qualifier * fixes polyline conversions time to cry * fix(autocad): fixes polyline2d conversion with non-standard normals (#1169) * fix: polyline2d like polyline * refactor: coordinate system extension * refactor: extension for pt3d to ocs * renames reference point methods * moves logic to reference point converter * Update AutocadPolycurveToHostConverter.cs (#1175) --------- Co-authored-by: Björn Steinhagen <88777268+bjoernsteinhagen@users.noreply.github.com> Co-authored-by: Oğuzhan Koral <45078678+oguzhankoral@users.noreply.github.com> Co-authored-by: bimgeek <mucahitbgoker@gmail.com> Co-authored-by: Mucahit Bilal GOKER <51519350+bimgeek@users.noreply.github.com>
Speckle | Sharp | Connectors
Speckle is the first AEC data hub that connects with your favorite AEC tools. Speckle exists to overcome the challenges of working in a fragmented industry where communication, creative workflows, and the exchange of data are often hindered by siloed software and processes. It is here to make the industry better.
.NET Desktop UI, Connectors, and Converters
Repo structure
This repo is the home of our next-generation Speckle .NET projects:
- Desktop UI
DUI3: our next generation Desktop User Interface for all connectors.
- Speckle Connectors
Autocad Connector: for Autodesk AutoCAD and Civil3D 2022+Rhino Connector: for McNeel Rhino 7+Revit Connector: for Autodesk Revit 2022+Tekla Connector: for Trimble Tekla 2024
- Speckle Converters
Autocad Converter: for Autodesk AutoCAD 2022+Civil3d Converter: for Autodesk Civil3D 2022+Rhino Converter: for McNeel Rhino 7+Revit Converter: for Autodesk Revit 2023+Tekla Converter: for Trimble Tekla 2024
- SDK
SDK: Autofac module, connector utilities, and dependency injection.
Other repos
Make sure to also check and ⭐️ these other Speckle next generation repositories:
speckle-sharp-sdk: our csharp SDK for next gen connectors and developmentspeckle-sketchup: Sketchup connectorspeckle-powerbi: PowerBi connector- and more connectors & tooling!
Developing and Debugging
Developing
It is recommended that you use Jetbrains Rider (version 2024.3 or greater) or Visual Studio 2022 (version 17.13 or greater) The project requires version 8.0.4xx of the .NET SDK. You can download the latest version from https://dotnet.microsoft.com/en-us/download/dotnet/8.0
From there you can open the main Speckle.Connectors.sln solution and build the project
For good development experience and environment setup, you the commands are avaible needed.
Formatting
We're using CSharpier to format our code. You can install Csharpier in a few ways:
- Install CSharpier as a local tool and reformat from CLI
dotnet tool install csharpier dotnet csharpier - Install CSharpier as a global tool and reformat from CLI
dotnet tool install csharpier -g dotnet csharpier - Install the CSharpier extension for Visual Studio or Rider.
For best DX, we recommend turning on CSharpier'sreformat on savesetting if you've installed it in your IDE.
Clean Locks
We're using npm package locks to store exact and versioned dependency trees. Occasionally you will need to clean your local package-lock files, eg when switching between Speckle.Connectors.sln and Local.sln.
Run this command in CLI to delete all package.lock.json files before a restore:
.\build.ps1 clean-locks
Deep Clean
To make sure your local environment is ready for a clean build, run this command to delete all bin and obj directories and restore all projects:
.\build.ps1 deep-clean
Deep Clean Local
This is for users of the Local.sln solution:
To make sure your local environment is ready for a clean build, run this command to delete all bin and obj directories and restore all projects:
.\build.ps1 deep-clean-local
Local development with SDK changes
If you'd like to make changes to the speckle-sharp-sdk side-by-side with changes to this repo's projects, use **Local.sln**.
This solution includes the Core and Objects projects from the speckle-sharp-sdk repo, and uses a new Configuration to create a build directory alongside Debug and Release.
Warning
Using
Local.slnwill modify all your package locks. Don't check these in! Revert with theclean-lockscommand or use the regular solution to revert once your changes are made.
Switching to SLNX
SLNX was introduced with .NET 9 (in May 2024), Visual Studio 17.13 and Rider 2024.3. The older SLNs being used remain for now but will be removed when .NET 10 is introduced to the repo. SLNXs specific to certain host apps are being generated from the main SLN to allow for faster developmenet.
https://devblogs.microsoft.com/dotnet/introducing-slnx-support-dotnet-cli/
https://devblogs.microsoft.com/visualstudio/new-simpler-solution-file-format/
Security and Licensing
Security
For any security vulnerabilities or concerns, please contact us directly at security[at]speckle.systems.
License
Unless otherwise described, the code in this repository is licensed under the Apache-2.0 License. Please note that some modules, extensions or code herein might be otherwise licensed. This is indicated either in the root of the containing folder under a different license file, or in the respective file's header. If you have any questions, don't hesitate to get in touch with us via email.