rw3dm
rw3dm copied to clipboard
Rhino/OpenNURBS importer and exporter for NURBS-Python (geomdl)
RW3DM - Rhino Extensions for NURBS-Python (geomdl)
RW3DM project provides executables for exporting and importing OpenNURBS/Rhino .3DM files in JSON format. It utilizes OpenNURBS library for reading and writing .3DM files and JsonCpp for importing and exporting geomdl geometry data.
Installation and Updating RW3DM
Downloading RW3DM
You can download the precompiled Windows 64-bit binaries under Actions tab.
Compiling RW3DM
If you prefer to compile the binaries on your own, you can follow the following list as a reference:
- Clone the repository:
git clone https://github.com/orbingol/rw3dm.git
- Change to the directory of the local repository:
cd rw3dm
- Update submodules:
git submodule update --init
- Create a build directory for CMake-generated files, e.g.
mkdir build
- Enter the build directory, e.g.
cd build
- Run CMake to generate build configuration files, e.g.
cmake ..
or use CMake GUI - Compile and install
- For Windows, you will find the Visual Studio project files under
build
directory. - After opening Visual Studio, choose
Release
from the build combobox, then right click onINSTALL
and chooseRebuild
- For Linux, run
make install
inside thebuild
directory - The install directory will be
build/install
by default - You can modify the install directory using
RW3DM_INSTALL_DIR
variable while configuring the project with CMake
- Go to the install directory, e.g.
cd install
or the one you configured with CMake during step 6 - You will find the executables inside the install directory
Updating RW3DM
If you prefer to update the compiled binaries on your own, you can follow the following list as a reference:
- Pull the latest commits:
git pull --rebase
- Update submodules:
git submodule update
- Repeat steps from 5 to 9
Notes on installing and updating
For Windows
- Visual Studio 2017 or newer is required to compile OpenNURBS
- Please install C++ support on Visual Studio as it is not installed by default
- Choose Release as the build configuration inside Visual Studio before you compile the package
For Linux
- It is tested with gcc 7.3 and it should be compatible with any gcc version supporting C++17
- Please remember to install the compiler packages for your Linux distribution
Using RW3DM
Reading .3DM files
on2json
executable can be used to convert .3DM files to JSON format supported by geomdl.
The JSON files can be imported via geomdl's exchange.import_json
API call.
Writing .3DM files
json2on
executable can be used to convert JSON format supported by geomdl to .3DM files.
The JSON files can be exported via geomdl's exchange.export_json
API call.
Available arguments
Run on2json
and json2on
to see the available command-line arguments:
-
extract_curves
: Extract curves (Default is extract surfaces) -
normalize
: Normalize knot vectors and scale trim curves to [0,1] domain -
sense
: Extract surface and trim curve direction w.r.t. the face -
show_config
: Print the configuration -
silent
: Disable all printed messages -
trims
: Extract trim curves
Example: on2json MyONFile.3dm extract_curves=True
, extracts curves from MyONFile.3dm
Author
- Onur Rauf Bingol (@orbingol)
License
- RW3DM is licensed under the terms of the MIT License.
- JsonCpp is licensed under the terms of the MIT License
- OpenNURBS is licensed under the terms of the MIT license