COMPAS 2.1.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- compas/__init__.py +274 -0
- compas/__main__.py +31 -0
- compas/_iotools.py +80 -0
- compas/_os.py +746 -0
- compas/colors/__init__.py +14 -0
- compas/colors/cmcrameri/acton.txt +256 -0
- compas/colors/cmcrameri/actonS.txt +100 -0
- compas/colors/cmcrameri/bam.txt +256 -0
- compas/colors/cmcrameri/bamO.txt +256 -0
- compas/colors/cmcrameri/bamako.txt +256 -0
- compas/colors/cmcrameri/bamakoS.txt +100 -0
- compas/colors/cmcrameri/batlow.txt +256 -0
- compas/colors/cmcrameri/batlowK.txt +256 -0
- compas/colors/cmcrameri/batlowS.txt +100 -0
- compas/colors/cmcrameri/batlowW.txt +256 -0
- compas/colors/cmcrameri/berlin.txt +256 -0
- compas/colors/cmcrameri/bilbao.txt +256 -0
- compas/colors/cmcrameri/bilbaoS.txt +100 -0
- compas/colors/cmcrameri/broc.txt +256 -0
- compas/colors/cmcrameri/brocO.txt +256 -0
- compas/colors/cmcrameri/buda.txt +256 -0
- compas/colors/cmcrameri/budaS.txt +100 -0
- compas/colors/cmcrameri/bukavu.txt +256 -0
- compas/colors/cmcrameri/cork.txt +256 -0
- compas/colors/cmcrameri/corkO.txt +256 -0
- compas/colors/cmcrameri/davos.txt +256 -0
- compas/colors/cmcrameri/davosS.txt +100 -0
- compas/colors/cmcrameri/devon.txt +256 -0
- compas/colors/cmcrameri/devonS.txt +100 -0
- compas/colors/cmcrameri/fes.txt +256 -0
- compas/colors/cmcrameri/grayC.txt +256 -0
- compas/colors/cmcrameri/grayCS.txt +100 -0
- compas/colors/cmcrameri/hawaii.txt +256 -0
- compas/colors/cmcrameri/hawaiiS.txt +100 -0
- compas/colors/cmcrameri/imola.txt +256 -0
- compas/colors/cmcrameri/imolaS.txt +100 -0
- compas/colors/cmcrameri/lajolla.txt +256 -0
- compas/colors/cmcrameri/lajollaS.txt +100 -0
- compas/colors/cmcrameri/lapaz.txt +256 -0
- compas/colors/cmcrameri/lapazS.txt +100 -0
- compas/colors/cmcrameri/lisbon.txt +256 -0
- compas/colors/cmcrameri/nuuk.txt +256 -0
- compas/colors/cmcrameri/nuukS.txt +100 -0
- compas/colors/cmcrameri/oleron.txt +256 -0
- compas/colors/cmcrameri/oslo.txt +256 -0
- compas/colors/cmcrameri/osloS.txt +100 -0
- compas/colors/cmcrameri/roma.txt +256 -0
- compas/colors/cmcrameri/romaO.txt +256 -0
- compas/colors/cmcrameri/tofino.txt +256 -0
- compas/colors/cmcrameri/tokyo.txt +256 -0
- compas/colors/cmcrameri/tokyoS.txt +100 -0
- compas/colors/cmcrameri/turku.txt +256 -0
- compas/colors/cmcrameri/turkuS.txt +100 -0
- compas/colors/cmcrameri/vanimo.txt +256 -0
- compas/colors/cmcrameri/vik.txt +256 -0
- compas/colors/cmcrameri/vikO.txt +256 -0
- compas/colors/color.py +1118 -0
- compas/colors/colordict.py +103 -0
- compas/colors/colormap.py +306 -0
- compas/colors/html_colors.py +149 -0
- compas/colors/mpl_colormap.py +1064 -0
- compas/data/__init__.py +31 -0
- compas/data/coercion.py +71 -0
- compas/data/conftest.py +10 -0
- compas/data/data.py +342 -0
- compas/data/encoders.py +240 -0
- compas/data/exceptions.py +2 -0
- compas/data/json.py +240 -0
- compas/data/samples/boxes.obj +250 -0
- compas/data/samples/butt_model.obj +2829 -0
- compas/data/samples/cone.stl +0 -0
- compas/data/samples/cube.off +16 -0
- compas/data/samples/cube_ascii.stl +56114 -0
- compas/data/samples/cube_binary.stl +0 -0
- compas/data/samples/cube_binary_2.stl +0 -0
- compas/data/samples/doosabin.json +1 -0
- compas/data/samples/faces.obj +63 -0
- compas/data/samples/faces_big.obj +9663 -0
- compas/data/samples/faces_reversed.obj +63 -0
- compas/data/samples/fink.obj +135 -0
- compas/data/samples/grid_irregular.obj +303 -0
- compas/data/samples/hypar.obj +148 -0
- compas/data/samples/lines.json +1 -0
- compas/data/samples/lines.obj +282 -0
- compas/data/samples/lines_big.obj +40322 -0
- compas/data/samples/lines_bigger.obj +161282 -0
- compas/data/samples/lines_noleaves.obj +422 -0
- compas/data/samples/mesh.obj +874 -0
- compas/data/samples/mesh_100_faces.json +1893 -0
- compas/data/samples/mesh_110_faces.json +2081 -0
- compas/data/samples/open_edges.obj +424 -0
- compas/data/samples/point.json +1 -0
- compas/data/samples/quadmesh.obj +183 -0
- compas/data/samples/quadmesh_planar.obj +181 -0
- compas/data/samples/saddle.obj +314 -0
- compas/data/samples/spline.obj +72 -0
- compas/data/samples/tubemesh.json +1 -0
- compas/data/samples/tubemesh.obj +378 -0
- compas/data/samples/tubemesh.off +374 -0
- compas/data/samples/tubemesh.ply +551 -0
- compas/data/schema.py +137 -0
- compas/data/validators.py +243 -0
- compas/datastructures/__init__.py +75 -0
- compas/datastructures/_mutablemapping.py +148 -0
- compas/datastructures/assembly/__init__.py +0 -0
- compas/datastructures/assembly/assembly.py +234 -0
- compas/datastructures/assembly/exceptions.py +6 -0
- compas/datastructures/assembly/part.py +228 -0
- compas/datastructures/attributes.py +85 -0
- compas/datastructures/cell_network/__init__.py +0 -0
- compas/datastructures/cell_network/cell_network.py +4190 -0
- compas/datastructures/datastructure.py +309 -0
- compas/datastructures/graph/__init__.py +0 -0
- compas/datastructures/graph/duality.py +197 -0
- compas/datastructures/graph/graph.py +2478 -0
- compas/datastructures/graph/operations/__init__.py +0 -0
- compas/datastructures/graph/operations/join.py +124 -0
- compas/datastructures/graph/operations/split.py +63 -0
- compas/datastructures/graph/planarity.py +292 -0
- compas/datastructures/graph/smoothing.py +59 -0
- compas/datastructures/mesh/__init__.py +0 -0
- compas/datastructures/mesh/conway.py +553 -0
- compas/datastructures/mesh/duality.py +104 -0
- compas/datastructures/mesh/mesh.py +5103 -0
- compas/datastructures/mesh/operations/__init__.py +0 -0
- compas/datastructures/mesh/operations/collapse.py +350 -0
- compas/datastructures/mesh/operations/extrude.py +0 -0
- compas/datastructures/mesh/operations/insert.py +120 -0
- compas/datastructures/mesh/operations/merge.py +83 -0
- compas/datastructures/mesh/operations/split.py +263 -0
- compas/datastructures/mesh/operations/substitute.py +37 -0
- compas/datastructures/mesh/operations/swap.py +62 -0
- compas/datastructures/mesh/operations/weld.py +107 -0
- compas/datastructures/mesh/remesh.py +234 -0
- compas/datastructures/mesh/slice.py +170 -0
- compas/datastructures/mesh/smoothing.py +187 -0
- compas/datastructures/mesh/subdivision.py +754 -0
- compas/datastructures/tree/__init__.py +0 -0
- compas/datastructures/tree/tree.py +504 -0
- compas/datastructures/volmesh/__init__.py +0 -0
- compas/datastructures/volmesh/volmesh.py +4203 -0
- compas/files/__init__.py +27 -0
- compas/files/_xml/__init__.py +0 -0
- compas/files/_xml/xml_cli.py +213 -0
- compas/files/_xml/xml_cpython.py +32 -0
- compas/files/_xml/xml_pre_38.py +58 -0
- compas/files/_xml/xml_shared.py +40 -0
- compas/files/gltf/__init__.py +0 -0
- compas/files/gltf/constants.py +59 -0
- compas/files/gltf/data_classes.py +657 -0
- compas/files/gltf/extensions.py +317 -0
- compas/files/gltf/gltf.py +92 -0
- compas/files/gltf/gltf_children.py +64 -0
- compas/files/gltf/gltf_content.py +615 -0
- compas/files/gltf/gltf_exporter.py +465 -0
- compas/files/gltf/gltf_mesh.py +273 -0
- compas/files/gltf/gltf_node.py +348 -0
- compas/files/gltf/gltf_parser.py +115 -0
- compas/files/gltf/gltf_reader.py +310 -0
- compas/files/gltf/gltf_scene.py +125 -0
- compas/files/gltf/helpers.py +59 -0
- compas/files/obj.py +680 -0
- compas/files/off.py +296 -0
- compas/files/ply.py +697 -0
- compas/files/stl.py +436 -0
- compas/files/xml.py +328 -0
- compas/geometry/__init__.py +772 -0
- compas/geometry/_core/__init__.py +0 -0
- compas/geometry/_core/_algebra.py +2826 -0
- compas/geometry/_core/angles.py +408 -0
- compas/geometry/_core/centroids.py +573 -0
- compas/geometry/_core/distance.py +895 -0
- compas/geometry/_core/normals.py +149 -0
- compas/geometry/_core/nurbs.py +367 -0
- compas/geometry/_core/predicates_2.py +582 -0
- compas/geometry/_core/predicates_3.py +1111 -0
- compas/geometry/_core/quaternions.py +196 -0
- compas/geometry/_core/size.py +204 -0
- compas/geometry/_core/tangent.py +56 -0
- compas/geometry/_core/transformations.py +1121 -0
- compas/geometry/_core/transformations_numpy.py +279 -0
- compas/geometry/bbox.py +145 -0
- compas/geometry/bbox_numpy.py +306 -0
- compas/geometry/bestfit.py +77 -0
- compas/geometry/bestfit_numpy.py +259 -0
- compas/geometry/booleans.py +297 -0
- compas/geometry/booleans_shapely.py +147 -0
- compas/geometry/brep/__init__.py +112 -0
- compas/geometry/brep/brep.py +1131 -0
- compas/geometry/brep/edge.py +302 -0
- compas/geometry/brep/errors.py +22 -0
- compas/geometry/brep/face.py +329 -0
- compas/geometry/brep/loop.py +87 -0
- compas/geometry/brep/trim.py +46 -0
- compas/geometry/brep/vertex.py +46 -0
- compas/geometry/contours.py +32 -0
- compas/geometry/curves/__init__.py +0 -0
- compas/geometry/curves/arc.py +429 -0
- compas/geometry/curves/bezier.py +345 -0
- compas/geometry/curves/circle.py +500 -0
- compas/geometry/curves/conic.py +16 -0
- compas/geometry/curves/curve.py +614 -0
- compas/geometry/curves/ellipse.py +408 -0
- compas/geometry/curves/hyperbola.py +336 -0
- compas/geometry/curves/line.py +431 -0
- compas/geometry/curves/nurbs.py +412 -0
- compas/geometry/curves/parabola.py +256 -0
- compas/geometry/curves/polyline.py +724 -0
- compas/geometry/frame.py +769 -0
- compas/geometry/geometry.py +296 -0
- compas/geometry/hull.py +146 -0
- compas/geometry/hull_numpy.py +82 -0
- compas/geometry/icp_numpy.py +104 -0
- compas/geometry/interpolation_barycentric.py +38 -0
- compas/geometry/interpolation_coons.py +102 -0
- compas/geometry/interpolation_tweening.py +87 -0
- compas/geometry/intersection.py +121 -0
- compas/geometry/intersections.py +1105 -0
- compas/geometry/kdtree.py +153 -0
- compas/geometry/offset.py +208 -0
- compas/geometry/pca_numpy.py +87 -0
- compas/geometry/plane.py +657 -0
- compas/geometry/point.py +664 -0
- compas/geometry/pointcloud.py +409 -0
- compas/geometry/polygon.py +473 -0
- compas/geometry/polyhedron.py +650 -0
- compas/geometry/projection.py +155 -0
- compas/geometry/quadmesh_planarize.py +30 -0
- compas/geometry/quadmesh_planarize_none.py +114 -0
- compas/geometry/quaternion.py +544 -0
- compas/geometry/reflection.py +102 -0
- compas/geometry/rotation.py +354 -0
- compas/geometry/scale.py +100 -0
- compas/geometry/shapes/__init__.py +0 -0
- compas/geometry/shapes/box.py +747 -0
- compas/geometry/shapes/capsule.py +472 -0
- compas/geometry/shapes/cone.py +309 -0
- compas/geometry/shapes/cylinder.py +355 -0
- compas/geometry/shapes/shape.py +300 -0
- compas/geometry/shapes/sphere.py +362 -0
- compas/geometry/shapes/torus.py +294 -0
- compas/geometry/shear.py +115 -0
- compas/geometry/surfaces/__init__.py +0 -0
- compas/geometry/surfaces/conical.py +166 -0
- compas/geometry/surfaces/cylindrical.py +251 -0
- compas/geometry/surfaces/extrusion.py +0 -0
- compas/geometry/surfaces/nurbs.py +380 -0
- compas/geometry/surfaces/planar.py +223 -0
- compas/geometry/surfaces/revolution.py +0 -0
- compas/geometry/surfaces/spherical.py +259 -0
- compas/geometry/surfaces/surface.py +689 -0
- compas/geometry/surfaces/toroidal.py +198 -0
- compas/geometry/transformation.py +554 -0
- compas/geometry/translation.py +104 -0
- compas/geometry/triangulation_delaunay.py +102 -0
- compas/geometry/triangulation_earclip.py +300 -0
- compas/geometry/trimesh_curvature.py +113 -0
- compas/geometry/trimesh_descent_numpy.py +26 -0
- compas/geometry/trimesh_geodistance.py +35 -0
- compas/geometry/trimesh_gradient_numpy.py +74 -0
- compas/geometry/trimesh_isolines.py +41 -0
- compas/geometry/trimesh_matrices.py +31 -0
- compas/geometry/trimesh_matrices_numpy.py +191 -0
- compas/geometry/trimesh_parametrisation.py +55 -0
- compas/geometry/trimesh_pull_points_numpy.py +216 -0
- compas/geometry/trimesh_remeshing.py +97 -0
- compas/geometry/trimesh_samplepoints_numpy.py +108 -0
- compas/geometry/trimesh_slicing.py +28 -0
- compas/geometry/trimesh_smoothing_numpy.py +34 -0
- compas/geometry/vector.py +889 -0
- compas/itertools.py +441 -0
- compas/linalg.py +634 -0
- compas/matrices.py +314 -0
- compas/plugins.py +488 -0
- compas/rpc/__init__.py +20 -0
- compas/rpc/__main__.py +77 -0
- compas/rpc/dispatcher.py +181 -0
- compas/rpc/errors.py +11 -0
- compas/rpc/proxy.py +437 -0
- compas/rpc/server.py +79 -0
- compas/rpc/services/__init__.py +0 -0
- compas/rpc/services/default.py +87 -0
- compas/rpc/services/watcher.py +43 -0
- compas/scene/__init__.py +56 -0
- compas/scene/assemblyobject.py +3 -0
- compas/scene/context.py +154 -0
- compas/scene/descriptors/__init__.py +0 -0
- compas/scene/descriptors/attribute.py +30 -0
- compas/scene/descriptors/color.py +91 -0
- compas/scene/descriptors/colordict.py +101 -0
- compas/scene/descriptors/protocol.py +12 -0
- compas/scene/exceptions.py +7 -0
- compas/scene/geometryobject.py +58 -0
- compas/scene/graphobject.py +173 -0
- compas/scene/meshobject.py +238 -0
- compas/scene/scene.py +144 -0
- compas/scene/sceneobject.py +253 -0
- compas/scene/volmeshobject.py +252 -0
- compas/tolerance.py +879 -0
- compas/topology/__init__.py +45 -0
- compas/topology/combinatorics.py +108 -0
- compas/topology/connectivity.py +129 -0
- compas/topology/orientation.py +204 -0
- compas/topology/traversal.py +567 -0
- compas/utilities/__init__.py +25 -0
- compas/utilities/azync.py +155 -0
- compas/utilities/datetime.py +40 -0
- compas/utilities/decorators.py +136 -0
- compas/utilities/remote.py +54 -0
- compas/utilities/ssh.py +169 -0
- compas-2.1.1.dist-info/AUTHORS.md +42 -0
- compas-2.1.1.dist-info/LICENSE +21 -0
- compas-2.1.1.dist-info/METADATA +132 -0
- compas-2.1.1.dist-info/RECORD +468 -0
- compas-2.1.1.dist-info/WHEEL +5 -0
- compas-2.1.1.dist-info/entry_points.txt +2 -0
- compas-2.1.1.dist-info/top_level.txt +4 -0
- compas_blender/__init__.py +250 -0
- compas_blender/collections.py +130 -0
- compas_blender/conversions/__init__.py +48 -0
- compas_blender/conversions/breps.py +0 -0
- compas_blender/conversions/colors.py +23 -0
- compas_blender/conversions/curves.py +125 -0
- compas_blender/conversions/geometry.py +161 -0
- compas_blender/conversions/meshes.py +148 -0
- compas_blender/conversions/surfaces.py +48 -0
- compas_blender/conversions/transformations.py +46 -0
- compas_blender/data.py +30 -0
- compas_blender/geometry/__init__.py +14 -0
- compas_blender/geometry/booleans.py +100 -0
- compas_blender/install.py +338 -0
- compas_blender/objects.py +326 -0
- compas_blender/print_python_path.py +18 -0
- compas_blender/scene/__init__.py +116 -0
- compas_blender/scene/boxobject.py +64 -0
- compas_blender/scene/capsuleobject.py +73 -0
- compas_blender/scene/circleobject.py +53 -0
- compas_blender/scene/coneobject.py +70 -0
- compas_blender/scene/curveobject.py +58 -0
- compas_blender/scene/cylinderobject.py +70 -0
- compas_blender/scene/frameobject.py +105 -0
- compas_blender/scene/graphobject.py +257 -0
- compas_blender/scene/lineobject.py +60 -0
- compas_blender/scene/meshobject.py +508 -0
- compas_blender/scene/planeobject.py +81 -0
- compas_blender/scene/pointcloudobject.py +67 -0
- compas_blender/scene/pointobject.py +71 -0
- compas_blender/scene/polygonobject.py +57 -0
- compas_blender/scene/polyhedronobject.py +57 -0
- compas_blender/scene/polylineobject.py +54 -0
- compas_blender/scene/sceneobject.py +249 -0
- compas_blender/scene/sphereobject.py +72 -0
- compas_blender/scene/surfaceobject.py +54 -0
- compas_blender/scene/torusobject.py +73 -0
- compas_blender/scene/vectorobject.py +69 -0
- compas_blender/scene/volmeshobject.py +475 -0
- compas_blender/utilities/__init__.py +38 -0
- compas_blender/utilities/drawing.py +768 -0
- compas_ghpython/__init__.py +124 -0
- compas_ghpython/components/Compas_FromJson/code.py +18 -0
- compas_ghpython/components/Compas_Info/code.py +15 -0
- compas_ghpython/components/Compas_RpcCall/code.py +31 -0
- compas_ghpython/components/Compas_ToJson/code.py +19 -0
- compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
- compas_ghpython/components/__init__.py +99 -0
- compas_ghpython/install.py +29 -0
- compas_ghpython/scene/__init__.py +115 -0
- compas_ghpython/scene/boxobject.py +40 -0
- compas_ghpython/scene/brepobject.py +40 -0
- compas_ghpython/scene/capsuleobject.py +41 -0
- compas_ghpython/scene/circleobject.py +40 -0
- compas_ghpython/scene/coneobject.py +40 -0
- compas_ghpython/scene/curveobject.py +42 -0
- compas_ghpython/scene/cylinderobject.py +38 -0
- compas_ghpython/scene/ellipseobject.py +40 -0
- compas_ghpython/scene/frameobject.py +67 -0
- compas_ghpython/scene/graphobject.py +77 -0
- compas_ghpython/scene/lineobject.py +39 -0
- compas_ghpython/scene/meshobject.py +137 -0
- compas_ghpython/scene/planeobject.py +61 -0
- compas_ghpython/scene/pointobject.py +38 -0
- compas_ghpython/scene/polygonobject.py +48 -0
- compas_ghpython/scene/polyhedronobject.py +48 -0
- compas_ghpython/scene/polylineobject.py +39 -0
- compas_ghpython/scene/sceneobject.py +12 -0
- compas_ghpython/scene/sphereobject.py +39 -0
- compas_ghpython/scene/surfaceobject.py +42 -0
- compas_ghpython/scene/torusobject.py +39 -0
- compas_ghpython/scene/vectorobject.py +51 -0
- compas_ghpython/scene/volmeshobject.py +154 -0
- compas_ghpython/sets.py +83 -0
- compas_ghpython/timer.py +36 -0
- compas_ghpython/uninstall.py +31 -0
- compas_ghpython/utilities/__init__.py +33 -0
- compas_ghpython/utilities/drawing.py +457 -0
- compas_rhino/__init__.py +607 -0
- compas_rhino/conduits/__init__.py +16 -0
- compas_rhino/conduits/base.py +121 -0
- compas_rhino/conduits/faces.py +91 -0
- compas_rhino/conduits/labels.py +102 -0
- compas_rhino/conduits/lines.py +109 -0
- compas_rhino/conduits/points.py +111 -0
- compas_rhino/conversions/__init__.py +168 -0
- compas_rhino/conversions/breps.py +122 -0
- compas_rhino/conversions/curves.py +453 -0
- compas_rhino/conversions/docobjects.py +0 -0
- compas_rhino/conversions/exceptions.py +7 -0
- compas_rhino/conversions/extrusions.py +80 -0
- compas_rhino/conversions/geometry.py +187 -0
- compas_rhino/conversions/meshes.py +281 -0
- compas_rhino/conversions/shapes.py +291 -0
- compas_rhino/conversions/surfaces.py +355 -0
- compas_rhino/conversions/transformations.py +45 -0
- compas_rhino/geometry/__init__.py +44 -0
- compas_rhino/geometry/booleans.py +118 -0
- compas_rhino/geometry/brep/__init__.py +40 -0
- compas_rhino/geometry/brep/brep.py +554 -0
- compas_rhino/geometry/brep/builder.py +184 -0
- compas_rhino/geometry/brep/edge.py +202 -0
- compas_rhino/geometry/brep/face.py +285 -0
- compas_rhino/geometry/brep/loop.py +129 -0
- compas_rhino/geometry/brep/trim.py +99 -0
- compas_rhino/geometry/brep/vertex.py +76 -0
- compas_rhino/geometry/curves/__init__.py +43 -0
- compas_rhino/geometry/curves/curve.py +382 -0
- compas_rhino/geometry/curves/nurbs.py +298 -0
- compas_rhino/geometry/surfaces/__init__.py +50 -0
- compas_rhino/geometry/surfaces/nurbs.py +370 -0
- compas_rhino/geometry/surfaces/surface.py +407 -0
- compas_rhino/geometry/trimesh_curvature.py +344 -0
- compas_rhino/geometry/trimesh_slicing.py +65 -0
- compas_rhino/install.py +382 -0
- compas_rhino/install_plugin.py +169 -0
- compas_rhino/install_with_pip.py +20 -0
- compas_rhino/layers.py +347 -0
- compas_rhino/objects.py +1141 -0
- compas_rhino/print_python_path.py +18 -0
- compas_rhino/scene/__init__.py +123 -0
- compas_rhino/scene/boxobject.py +44 -0
- compas_rhino/scene/brepobject.py +41 -0
- compas_rhino/scene/capsuleobject.py +45 -0
- compas_rhino/scene/circleobject.py +43 -0
- compas_rhino/scene/coneobject.py +43 -0
- compas_rhino/scene/curveobject.py +43 -0
- compas_rhino/scene/cylinderobject.py +43 -0
- compas_rhino/scene/ellipseobject.py +44 -0
- compas_rhino/scene/frameobject.py +99 -0
- compas_rhino/scene/graphobject.py +364 -0
- compas_rhino/scene/helpers.py +33 -0
- compas_rhino/scene/lineobject.py +43 -0
- compas_rhino/scene/meshobject.py +673 -0
- compas_rhino/scene/planeobject.py +71 -0
- compas_rhino/scene/pointobject.py +43 -0
- compas_rhino/scene/polygonobject.py +45 -0
- compas_rhino/scene/polyhedronobject.py +45 -0
- compas_rhino/scene/polylineobject.py +43 -0
- compas_rhino/scene/sceneobject.py +123 -0
- compas_rhino/scene/sphereobject.py +43 -0
- compas_rhino/scene/surfaceobject.py +42 -0
- compas_rhino/scene/torusobject.py +43 -0
- compas_rhino/scene/vectorobject.py +49 -0
- compas_rhino/scene/volmeshobject.py +518 -0
- compas_rhino/ui.py +114 -0
- compas_rhino/uninstall.py +243 -0
- compas_rhino/uninstall_plugin.py +91 -0
- compas_rhino/utilities/__init__.py +37 -0
- compas_rhino/utilities/constructors.py +71 -0
- compas_rhino/utilities/drawing.py +1081 -0
|
@@ -0,0 +1,768 @@
|
|
|
1
|
+
from typing import Dict
|
|
2
|
+
from typing import List
|
|
3
|
+
from typing import Text
|
|
4
|
+
from typing import Tuple
|
|
5
|
+
from typing import Union
|
|
6
|
+
|
|
7
|
+
import bpy # type: ignore
|
|
8
|
+
|
|
9
|
+
from compas.geometry import centroid_points
|
|
10
|
+
from compas.geometry import distance_point_point
|
|
11
|
+
from compas.geometry import subtract_vectors
|
|
12
|
+
from compas_blender.collections import create_collection
|
|
13
|
+
|
|
14
|
+
RGBColor = Union[Tuple[int, int, int], Tuple[float, float, float]]
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def _link_object(obj, collection=None, layer=None):
|
|
18
|
+
if not collection:
|
|
19
|
+
collection = bpy.context.collection
|
|
20
|
+
if not isinstance(collection, bpy.types.Collection):
|
|
21
|
+
collection = create_collection(collection)
|
|
22
|
+
# if not layer:
|
|
23
|
+
# layer = bpy.context.view_layer
|
|
24
|
+
# layer_collection = layer.active_layer_collection.collection
|
|
25
|
+
for c in obj.users_collection:
|
|
26
|
+
c.objects.unlink(obj)
|
|
27
|
+
collection.objects.link(obj)
|
|
28
|
+
# layer_collection.objects.link(obj)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def _link_objects(objects, collection=None, layer=None):
|
|
32
|
+
if not collection:
|
|
33
|
+
collection = bpy.context.collection
|
|
34
|
+
if not isinstance(collection, bpy.types.Collection):
|
|
35
|
+
collection = create_collection(collection)
|
|
36
|
+
# if not layer:
|
|
37
|
+
# layer = bpy.context.view_layer
|
|
38
|
+
# layer_collection = layer.active_layer_collection.collection
|
|
39
|
+
|
|
40
|
+
for o in objects:
|
|
41
|
+
for c in o.users_collection:
|
|
42
|
+
c.objects.unlink(o)
|
|
43
|
+
collection.objects.link(o)
|
|
44
|
+
# layer_collection.objects.link(o)
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
def _create_material(rgb, alpha=1.0):
|
|
48
|
+
rgba = list(rgb) + [alpha]
|
|
49
|
+
name = "-".join(["{0:.2f}".format(i) for i in rgba])
|
|
50
|
+
material = bpy.data.materials.get(name) or bpy.data.materials.new(name)
|
|
51
|
+
material.diffuse_color = rgba
|
|
52
|
+
return material
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
def _set_object_color(obj, rgb, alpha=1.0):
|
|
56
|
+
rgba = list(rgb) + [alpha]
|
|
57
|
+
material = _create_material(rgb, alpha)
|
|
58
|
+
obj.color = rgba
|
|
59
|
+
if obj.data.materials:
|
|
60
|
+
obj.data.materials[0] = material
|
|
61
|
+
else:
|
|
62
|
+
obj.data.materials.append(material)
|
|
63
|
+
obj.active_material = material
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
# ==============================================================================
|
|
67
|
+
# Annotations
|
|
68
|
+
# ==============================================================================
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def draw_texts(
|
|
72
|
+
texts: List[Dict],
|
|
73
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
74
|
+
color: Tuple[float, float, float] = (1.0, 1.0, 1.0),
|
|
75
|
+
) -> List[bpy.types.Object]:
|
|
76
|
+
"""Draw text objects.
|
|
77
|
+
|
|
78
|
+
Parameters
|
|
79
|
+
----------
|
|
80
|
+
texts : list[dict]
|
|
81
|
+
A list of dicts describing the text objects.
|
|
82
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
83
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
84
|
+
color : tuple[int, int, int] or tuple[float, float, float], optional
|
|
85
|
+
The text color.
|
|
86
|
+
|
|
87
|
+
Returns
|
|
88
|
+
-------
|
|
89
|
+
list[:blender:`bpy.types.Object`]
|
|
90
|
+
|
|
91
|
+
"""
|
|
92
|
+
bpy.ops.object.text_add()
|
|
93
|
+
empty = bpy.context.object
|
|
94
|
+
_link_object(empty, collection)
|
|
95
|
+
objects = [0] * len(texts)
|
|
96
|
+
for index, data in enumerate(texts):
|
|
97
|
+
obj = empty.copy()
|
|
98
|
+
obj.data = empty.data.copy()
|
|
99
|
+
_set_object_color(obj, data.get("color", color))
|
|
100
|
+
obj.location = data["pos"]
|
|
101
|
+
obj.data.body = data["text"]
|
|
102
|
+
obj.scale *= data.get("size", 1)
|
|
103
|
+
obj.name = data.get("name", "text")
|
|
104
|
+
objects[index] = obj
|
|
105
|
+
_link_objects(objects, collection)
|
|
106
|
+
empty.hide_set(True)
|
|
107
|
+
return objects
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
# ==============================================================================
|
|
111
|
+
# Primitives
|
|
112
|
+
# ==============================================================================
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
# replace this by a custom point shader
|
|
116
|
+
# https://docs.blender.org/api/current/gpu.html#custom-shader-for-dotted-3d-line
|
|
117
|
+
# https://docs.blender.org/api/current/gpu.html#triangle-with-custom-shader
|
|
118
|
+
def draw_points(points: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
119
|
+
"""Draw point objects.
|
|
120
|
+
|
|
121
|
+
Parameters
|
|
122
|
+
----------
|
|
123
|
+
points : list[dict]
|
|
124
|
+
A list of dicts describing the points.
|
|
125
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
126
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
127
|
+
|
|
128
|
+
Returns
|
|
129
|
+
-------
|
|
130
|
+
list[:blender:`bpy.types.Object`]
|
|
131
|
+
|
|
132
|
+
"""
|
|
133
|
+
P = len(points)
|
|
134
|
+
N = len(str(P))
|
|
135
|
+
add_point = bpy.ops.mesh.primitive_uv_sphere_add
|
|
136
|
+
objects = [0] * P
|
|
137
|
+
for index, point in enumerate(points):
|
|
138
|
+
xyz = point["pos"]
|
|
139
|
+
radius = point.get("radius", 1.0)
|
|
140
|
+
name = point.get("name", f"P.{index:0{N}d}")
|
|
141
|
+
color = list(point.get("color", [1.0, 1.0, 1.0]))
|
|
142
|
+
add_point(location=xyz, radius=radius, segments=10, ring_count=10)
|
|
143
|
+
obj = bpy.context.object
|
|
144
|
+
obj.name = name
|
|
145
|
+
# values = [True] * len(obj.data.polygons)
|
|
146
|
+
# obj.data.polygons.foreach_set("use_smooth", values)
|
|
147
|
+
_set_object_color(obj, color)
|
|
148
|
+
objects[index] = obj
|
|
149
|
+
_link_objects(objects, collection)
|
|
150
|
+
return objects
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
# replace this by a custom pointcloud shader
|
|
154
|
+
# https://docs.blender.org/api/current/gpu.html#custom-shader-for-dotted-3d-line
|
|
155
|
+
# https://docs.blender.org/api/current/gpu.html#triangle-with-custom-shader
|
|
156
|
+
def draw_pointcloud(points: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> bpy.types.Object:
|
|
157
|
+
"""Draw point objects as a single cloud.
|
|
158
|
+
|
|
159
|
+
Parameters
|
|
160
|
+
----------
|
|
161
|
+
points : list[dict]
|
|
162
|
+
A list of dicts describing the points of the pointcloud.
|
|
163
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
164
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
165
|
+
|
|
166
|
+
Returns
|
|
167
|
+
-------
|
|
168
|
+
list[:blender:`bpy.types.Object`]
|
|
169
|
+
|
|
170
|
+
"""
|
|
171
|
+
P = len(points)
|
|
172
|
+
N = len(str(P))
|
|
173
|
+
bpy.ops.mesh.primitive_uv_sphere_add(location=[0, 0, 0], radius=1.0, segments=10, ring_count=10)
|
|
174
|
+
empty = bpy.context.object
|
|
175
|
+
_link_object(empty, collection)
|
|
176
|
+
_set_object_color(empty, [1.0, 1.0, 1.0])
|
|
177
|
+
objects = [0] * P
|
|
178
|
+
for index, data in enumerate(points):
|
|
179
|
+
obj = empty.copy()
|
|
180
|
+
obj.location = data["pos"]
|
|
181
|
+
obj.scale *= data.get("radius", 1.0)
|
|
182
|
+
obj.name = data.get("name", f"P.{index:0{N}d}")
|
|
183
|
+
# obj.data.polygons.foreach_set("use_smooth", [True] * len(obj.data.polygons))
|
|
184
|
+
objects[index] = obj
|
|
185
|
+
_link_objects(objects, collection)
|
|
186
|
+
empty.hide_set(True)
|
|
187
|
+
return objects
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
# replace this by a custom line shader
|
|
191
|
+
# https://docs.blender.org/api/current/gpu.html#custom-shader-for-dotted-3d-line
|
|
192
|
+
# https://docs.blender.org/api/current/gpu.html#triangle-with-custom-shader
|
|
193
|
+
def draw_lines(
|
|
194
|
+
lines: List[Dict],
|
|
195
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
196
|
+
centroid: bool = True,
|
|
197
|
+
) -> List[bpy.types.Object]:
|
|
198
|
+
"""Draw line objects.
|
|
199
|
+
|
|
200
|
+
Parameters
|
|
201
|
+
----------
|
|
202
|
+
lines : list[dict]
|
|
203
|
+
A list of dicts describing the lines.
|
|
204
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
205
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
206
|
+
centroid : bool, optional
|
|
207
|
+
If True, use the centroids of the lines as the relative base for their coordinates,
|
|
208
|
+
instead of the origin of the world coordinates system.
|
|
209
|
+
|
|
210
|
+
Returns
|
|
211
|
+
-------
|
|
212
|
+
list[:blender:`bpy.types.Object`]
|
|
213
|
+
|
|
214
|
+
"""
|
|
215
|
+
L = len(lines)
|
|
216
|
+
N = len(str(L))
|
|
217
|
+
objects = [0] * L
|
|
218
|
+
for index, data in enumerate(lines):
|
|
219
|
+
sp = data["start"]
|
|
220
|
+
ep = data["end"]
|
|
221
|
+
origin = centroid_points([sp, ep]) if centroid else [0, 0, 0]
|
|
222
|
+
name = data.get("name", f"L.{index:0{N}d}")
|
|
223
|
+
curve = bpy.data.curves.new(name, type="CURVE")
|
|
224
|
+
curve.dimensions = "3D"
|
|
225
|
+
spline = curve.splines.new("POLY")
|
|
226
|
+
spline.points.add(1)
|
|
227
|
+
spline.points[0].co = subtract_vectors(sp, origin) + [1.0]
|
|
228
|
+
spline.points[1].co = subtract_vectors(ep, origin) + [1.0]
|
|
229
|
+
spline.order_u = 1
|
|
230
|
+
obj = bpy.data.objects.new(name, curve)
|
|
231
|
+
obj.location = origin
|
|
232
|
+
# obj.data.fill_mode = 'FULL'
|
|
233
|
+
# obj.data.bevel_depth = data.get('width', 0.05)
|
|
234
|
+
# obj.data.bevel_resolution = 0
|
|
235
|
+
# obj.data.resolution_u = 20
|
|
236
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
237
|
+
_set_object_color(obj, rgb)
|
|
238
|
+
objects[index] = obj
|
|
239
|
+
_link_objects(objects, collection)
|
|
240
|
+
return objects
|
|
241
|
+
|
|
242
|
+
|
|
243
|
+
# replace this by a custom polyline shader
|
|
244
|
+
# https://docs.blender.org/api/current/gpu.html#custom-shader-for-dotted-3d-line
|
|
245
|
+
# https://docs.blender.org/api/current/gpu.html#triangle-with-custom-shader
|
|
246
|
+
def draw_polylines(
|
|
247
|
+
polylines: List[Dict],
|
|
248
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
249
|
+
centroid: bool = True,
|
|
250
|
+
) -> List[bpy.types.Object]:
|
|
251
|
+
"""Draw polyline objects.
|
|
252
|
+
|
|
253
|
+
Parameters
|
|
254
|
+
----------
|
|
255
|
+
polylines : list[dict]
|
|
256
|
+
A list of dicts describing the polylines.
|
|
257
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
258
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
259
|
+
centroid : bool, optional
|
|
260
|
+
If True, use the centroids of the polylines as the relative base for their coordinates,
|
|
261
|
+
instead of the origin of the world coordinates system.
|
|
262
|
+
|
|
263
|
+
Returns
|
|
264
|
+
-------
|
|
265
|
+
list[:blender:`bpy.types.Object`]
|
|
266
|
+
|
|
267
|
+
"""
|
|
268
|
+
P = len(polylines)
|
|
269
|
+
N = len(str(P))
|
|
270
|
+
objects = [0] * P
|
|
271
|
+
for index, data in enumerate(polylines):
|
|
272
|
+
points = data["points"]
|
|
273
|
+
origin = centroid_points(points) if centroid else [0, 0, 0]
|
|
274
|
+
name = data.get("name", f"POLY.{index:0{N}d}")
|
|
275
|
+
curve = bpy.data.curves.new(name, type="CURVE")
|
|
276
|
+
curve.dimensions = "3D"
|
|
277
|
+
spline = curve.splines.new("POLY")
|
|
278
|
+
spline.points.add(len(points) - 1)
|
|
279
|
+
for i, point in enumerate(points):
|
|
280
|
+
spline.points[i].co = subtract_vectors(point, origin) + [1.0]
|
|
281
|
+
spline.order_u = 1
|
|
282
|
+
obj = bpy.data.objects.new(name, curve)
|
|
283
|
+
obj.location = origin
|
|
284
|
+
# obj.data.fill_mode = 'FULL'
|
|
285
|
+
# obj.data.bevel_depth = data.get('width', 0.05)
|
|
286
|
+
# obj.data.bevel_resolution = 0
|
|
287
|
+
# obj.data.resolution_u = 20
|
|
288
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
289
|
+
_set_object_color(obj, rgb)
|
|
290
|
+
objects[index] = obj
|
|
291
|
+
_link_objects(objects, collection)
|
|
292
|
+
return objects
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
def draw_polygons(
|
|
296
|
+
polygons: List[Dict],
|
|
297
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
298
|
+
centroid: bool = True,
|
|
299
|
+
) -> List[bpy.types.Object]:
|
|
300
|
+
"""Draw polyline objects.
|
|
301
|
+
|
|
302
|
+
Parameters
|
|
303
|
+
----------
|
|
304
|
+
polygons : list[dict]
|
|
305
|
+
A list of dicts describing the polygons.
|
|
306
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
307
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
308
|
+
centroid : bool, optional
|
|
309
|
+
If True, use the centroids of the polygons as the relative base for their coordinates,
|
|
310
|
+
instead of the origin of the world coordinates system.
|
|
311
|
+
|
|
312
|
+
Returns
|
|
313
|
+
-------
|
|
314
|
+
list[:blender:`bpy.types.Object`]
|
|
315
|
+
|
|
316
|
+
"""
|
|
317
|
+
raise NotImplementedError
|
|
318
|
+
|
|
319
|
+
|
|
320
|
+
def draw_faces(faces: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
321
|
+
"""Draw polygonal faces.
|
|
322
|
+
|
|
323
|
+
Parameters
|
|
324
|
+
----------
|
|
325
|
+
faces : list[dict]
|
|
326
|
+
A list of dicts describing the faces.
|
|
327
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
328
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
329
|
+
|
|
330
|
+
Returns
|
|
331
|
+
-------
|
|
332
|
+
list[:blender:`bpy.types.Object`]
|
|
333
|
+
|
|
334
|
+
"""
|
|
335
|
+
F = len(faces)
|
|
336
|
+
N = len(str(F))
|
|
337
|
+
objects = [0] * F
|
|
338
|
+
for index, face in enumerate(faces):
|
|
339
|
+
points = face["points"]
|
|
340
|
+
indices = [list(range(len(points)))]
|
|
341
|
+
name = face.get("name", f"FACE.{index:0{N}d}")
|
|
342
|
+
color = face.get("color", [1.0, 1.0, 1.0])
|
|
343
|
+
obj = draw_mesh(
|
|
344
|
+
name=name,
|
|
345
|
+
vertices=points,
|
|
346
|
+
faces=indices,
|
|
347
|
+
color=color,
|
|
348
|
+
collection=collection,
|
|
349
|
+
)
|
|
350
|
+
objects[index] = obj
|
|
351
|
+
return objects
|
|
352
|
+
|
|
353
|
+
|
|
354
|
+
def draw_circles(circles: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
355
|
+
"""Draw circle objects as mesh primitives.
|
|
356
|
+
|
|
357
|
+
Parameters
|
|
358
|
+
----------
|
|
359
|
+
circles : list[dict]
|
|
360
|
+
A list of dicts describing the circles.
|
|
361
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
362
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
363
|
+
|
|
364
|
+
Returns
|
|
365
|
+
-------
|
|
366
|
+
list[:blender:`bpy.types.Object`]
|
|
367
|
+
|
|
368
|
+
"""
|
|
369
|
+
from math import acos
|
|
370
|
+
from math import atan2
|
|
371
|
+
|
|
372
|
+
bpy.ops.mesh.primitive_circle_add()
|
|
373
|
+
empty = bpy.context.object
|
|
374
|
+
_link_object(empty, collection)
|
|
375
|
+
objects = [0] * len(circles)
|
|
376
|
+
for index, data in enumerate(circles):
|
|
377
|
+
obj = empty.copy()
|
|
378
|
+
obj.name = data.get("name", "circle")
|
|
379
|
+
radius = data.get("radius", 1.0)
|
|
380
|
+
point, normal = data.get("plane", ((0.0, 0.0, 0.0), (0.0, 0.0, 1.0)))
|
|
381
|
+
obj.rotation_euler[1] = acos(normal[2])
|
|
382
|
+
obj.rotation_euler[2] = atan2(normal[1], normal[0])
|
|
383
|
+
obj.location = point
|
|
384
|
+
obj.scale = (radius, radius, 1.0)
|
|
385
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
386
|
+
_set_object_color(obj, rgb)
|
|
387
|
+
objects[index] = obj
|
|
388
|
+
_link_objects(objects, collection)
|
|
389
|
+
empty.hide_set(True)
|
|
390
|
+
return objects
|
|
391
|
+
|
|
392
|
+
|
|
393
|
+
def draw_planes(planes: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
394
|
+
"""Draw plane objects as mesh primitives.
|
|
395
|
+
|
|
396
|
+
Parameters
|
|
397
|
+
----------
|
|
398
|
+
planes : list[dict]
|
|
399
|
+
A list of dicts describing the planes.
|
|
400
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
401
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
402
|
+
|
|
403
|
+
Returns
|
|
404
|
+
-------
|
|
405
|
+
list[:blender:`bpy.types.Object`]
|
|
406
|
+
|
|
407
|
+
"""
|
|
408
|
+
from math import acos
|
|
409
|
+
from math import atan2
|
|
410
|
+
|
|
411
|
+
bpy.ops.mesh.primitive_plane_add()
|
|
412
|
+
empty = bpy.context.object
|
|
413
|
+
_link_object(empty, collection)
|
|
414
|
+
objects = [0] * len(planes)
|
|
415
|
+
for index, data in enumerate(planes):
|
|
416
|
+
obj = empty.copy()
|
|
417
|
+
obj.name = data.get("name", "plane")
|
|
418
|
+
point, normal = data.get("plane", ((0.0, 0.0, 0.0), (0.0, 0.0, 1.0)))
|
|
419
|
+
obj.rotation_euler[1] = acos(normal[2])
|
|
420
|
+
obj.rotation_euler[2] = atan2(normal[1], normal[0])
|
|
421
|
+
obj.location = point
|
|
422
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
423
|
+
_set_object_color(obj, rgb)
|
|
424
|
+
objects[index] = obj
|
|
425
|
+
_link_objects(objects, collection)
|
|
426
|
+
empty.hide_set(True)
|
|
427
|
+
return objects
|
|
428
|
+
|
|
429
|
+
|
|
430
|
+
# ==============================================================================
|
|
431
|
+
# Shapes
|
|
432
|
+
# ==============================================================================
|
|
433
|
+
|
|
434
|
+
|
|
435
|
+
def draw_cylinders(
|
|
436
|
+
cylinders: List[Dict],
|
|
437
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
438
|
+
uv: int = 10,
|
|
439
|
+
) -> List[bpy.types.Object]:
|
|
440
|
+
"""Draw cylinder objects as mesh primitives.
|
|
441
|
+
|
|
442
|
+
Parameters
|
|
443
|
+
----------
|
|
444
|
+
cylinders : list[dict]
|
|
445
|
+
A list of dicts describing the cylinders.
|
|
446
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
447
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
448
|
+
|
|
449
|
+
Returns
|
|
450
|
+
-------
|
|
451
|
+
list[:blender:`bpy.types.Object`]
|
|
452
|
+
|
|
453
|
+
"""
|
|
454
|
+
from math import acos
|
|
455
|
+
from math import atan2
|
|
456
|
+
|
|
457
|
+
bpy.ops.mesh.primitive_cylinder_add(location=[0, 0, 0], radius=1, depth=1, vertices=uv)
|
|
458
|
+
empty = bpy.context.object
|
|
459
|
+
_link_object(empty, collection)
|
|
460
|
+
objects = [0] * len(cylinders)
|
|
461
|
+
for index, data in enumerate(cylinders):
|
|
462
|
+
sp = data["start"]
|
|
463
|
+
ep = data["end"]
|
|
464
|
+
mp = centroid_points([sp, ep])
|
|
465
|
+
radius = data.get("radius", 1.0)
|
|
466
|
+
length = distance_point_point(sp, ep)
|
|
467
|
+
obj = empty.copy()
|
|
468
|
+
obj.name = data.get("name", "cylinder")
|
|
469
|
+
obj.rotation_euler[1] = acos((ep[2] - sp[2]) / length)
|
|
470
|
+
obj.rotation_euler[2] = atan2(ep[1] - sp[1], ep[0] - sp[0])
|
|
471
|
+
obj.location = mp
|
|
472
|
+
obj.scale = (radius, radius, length)
|
|
473
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
474
|
+
_set_object_color(obj, rgb)
|
|
475
|
+
objects[index] = obj
|
|
476
|
+
_link_objects(objects, collection)
|
|
477
|
+
empty.hide_set(True)
|
|
478
|
+
return objects
|
|
479
|
+
|
|
480
|
+
|
|
481
|
+
# these objects are all linked.
|
|
482
|
+
# therefore they cannot have different colors
|
|
483
|
+
# also, if the linked mesh data block is changed, it will affect all objects
|
|
484
|
+
def draw_spheres(
|
|
485
|
+
spheres: List[Dict],
|
|
486
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
487
|
+
uv: int = 10,
|
|
488
|
+
) -> List[bpy.types.Object]:
|
|
489
|
+
"""Draw sphere objects as mesh primitives.
|
|
490
|
+
|
|
491
|
+
Parameters
|
|
492
|
+
----------
|
|
493
|
+
spheres : list[dict]
|
|
494
|
+
A list of dicts describing the spheres.
|
|
495
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
496
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
497
|
+
|
|
498
|
+
Returns
|
|
499
|
+
-------
|
|
500
|
+
list[:blender:`bpy.types.Object`]
|
|
501
|
+
|
|
502
|
+
"""
|
|
503
|
+
bpy.ops.mesh.primitive_uv_sphere_add(location=[0, 0, 0], radius=1.0, segments=uv, ring_count=uv)
|
|
504
|
+
empty = bpy.context.object
|
|
505
|
+
_link_object(empty, collection)
|
|
506
|
+
objects = [0] * len(spheres)
|
|
507
|
+
for index, data in enumerate(spheres):
|
|
508
|
+
obj = empty.copy()
|
|
509
|
+
obj.location = data["pos"]
|
|
510
|
+
obj.scale *= data.get("radius", 1.0)
|
|
511
|
+
obj.name = data.get("name", "sphere")
|
|
512
|
+
# values = [True] * len(obj.data.polygons)
|
|
513
|
+
# obj.data.polygons.foreach_set("use_smooth", values)
|
|
514
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
515
|
+
_set_object_color(obj, rgb)
|
|
516
|
+
objects[index] = obj
|
|
517
|
+
_link_objects(objects, collection)
|
|
518
|
+
empty.hide_set(True)
|
|
519
|
+
return objects
|
|
520
|
+
|
|
521
|
+
|
|
522
|
+
def draw_cubes(cubes: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
523
|
+
"""Draw cube objects as mesh primitives.
|
|
524
|
+
|
|
525
|
+
Parameters
|
|
526
|
+
----------
|
|
527
|
+
cubes : list[dict]
|
|
528
|
+
A list of dicts describing the cubes.
|
|
529
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
530
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
531
|
+
|
|
532
|
+
Returns
|
|
533
|
+
-------
|
|
534
|
+
list[:blender:`bpy.types.Object`]
|
|
535
|
+
|
|
536
|
+
"""
|
|
537
|
+
bpy.ops.mesh.primitive_cube_add(size=1, location=[0, 0, 0])
|
|
538
|
+
empty = bpy.context.object
|
|
539
|
+
_link_object(empty, collection)
|
|
540
|
+
objects = [0] * len(cubes)
|
|
541
|
+
for index, data in enumerate(cubes):
|
|
542
|
+
obj = empty.copy()
|
|
543
|
+
obj.location = data["pos"]
|
|
544
|
+
obj.scale *= data.get("size", 1)
|
|
545
|
+
obj.name = data.get("name", "cube")
|
|
546
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
547
|
+
_set_object_color(obj, rgb)
|
|
548
|
+
objects[index] = obj
|
|
549
|
+
_link_objects(objects, collection)
|
|
550
|
+
empty.hide_set(True)
|
|
551
|
+
return objects
|
|
552
|
+
|
|
553
|
+
|
|
554
|
+
# replace this by a custom polyline shader
|
|
555
|
+
# https://docs.blender.org/api/current/gpu.html#custom-shader-for-dotted-3d-line
|
|
556
|
+
# https://docs.blender.org/api/current/gpu.html#triangle-with-custom-shader
|
|
557
|
+
def draw_pipes(
|
|
558
|
+
pipes: List[Dict],
|
|
559
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
560
|
+
centroid: bool = True,
|
|
561
|
+
smooth: bool = True,
|
|
562
|
+
) -> List[bpy.types.Object]:
|
|
563
|
+
"""Draw polyline objects.
|
|
564
|
+
|
|
565
|
+
Parameters
|
|
566
|
+
----------
|
|
567
|
+
pipes : list[dict]
|
|
568
|
+
A list of dicts describing the pipes.
|
|
569
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
570
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
571
|
+
centroid : bool, optional
|
|
572
|
+
If True, use the centroids of the pipes as the relative base for their coordinates,
|
|
573
|
+
instead of the origin of the world coordinates system.
|
|
574
|
+
smooth : bool, optional
|
|
575
|
+
If True, use a NURBS curve instead of a polyline.
|
|
576
|
+
|
|
577
|
+
Returns
|
|
578
|
+
-------
|
|
579
|
+
list[:blender:`bpy.types.Object`]
|
|
580
|
+
|
|
581
|
+
"""
|
|
582
|
+
P = len(pipes)
|
|
583
|
+
N = len(str(P))
|
|
584
|
+
objects = [0] * P
|
|
585
|
+
for index, data in enumerate(pipes):
|
|
586
|
+
points = data["points"]
|
|
587
|
+
origin = centroid_points(points) if centroid else [0, 0, 0]
|
|
588
|
+
name = data.get("name", f"POLY.{index:0{N}d}")
|
|
589
|
+
curve = bpy.data.curves.new(name, type="CURVE")
|
|
590
|
+
curve.dimensions = "3D"
|
|
591
|
+
curve.fill_mode = "FULL"
|
|
592
|
+
curve.bevel_depth = data.get("width", 0.05)
|
|
593
|
+
curve.bevel_resolution = 0
|
|
594
|
+
curve.resolution_u = 20
|
|
595
|
+
curve.use_fill_caps = True
|
|
596
|
+
if smooth:
|
|
597
|
+
spline = curve.splines.new("NURBS")
|
|
598
|
+
else:
|
|
599
|
+
spline = curve.splines.new("POLY")
|
|
600
|
+
spline.points.add(len(points) - 1)
|
|
601
|
+
for i, point in enumerate(points):
|
|
602
|
+
spline.points[i].co = subtract_vectors(point, origin) + [1.0]
|
|
603
|
+
spline.order_u = 1
|
|
604
|
+
obj = bpy.data.objects.new(name, curve)
|
|
605
|
+
obj.location = origin
|
|
606
|
+
rgb = data.get("color", [1.0, 1.0, 1.0])
|
|
607
|
+
_set_object_color(obj, rgb)
|
|
608
|
+
objects[index] = obj
|
|
609
|
+
_link_objects(objects, collection)
|
|
610
|
+
return objects
|
|
611
|
+
|
|
612
|
+
|
|
613
|
+
# ==============================================================================
|
|
614
|
+
# Data Structures
|
|
615
|
+
# ==============================================================================
|
|
616
|
+
|
|
617
|
+
|
|
618
|
+
def draw_mesh(
|
|
619
|
+
vertices: List[List[float]],
|
|
620
|
+
faces: List[List[int]],
|
|
621
|
+
name: str = "mesh",
|
|
622
|
+
color: Tuple[float, float, float] = (1.0, 1.0, 1.0),
|
|
623
|
+
centroid: bool = True,
|
|
624
|
+
collection: Union[Text, bpy.types.Collection] = None,
|
|
625
|
+
**kwargs,
|
|
626
|
+
) -> bpy.types.Object:
|
|
627
|
+
"""Draw a mesh object.
|
|
628
|
+
|
|
629
|
+
Parameters
|
|
630
|
+
----------
|
|
631
|
+
vertices : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
632
|
+
The vertices of the mesh.
|
|
633
|
+
faces : list[list[int]]
|
|
634
|
+
The faces of the mesh.
|
|
635
|
+
color : tuple[float, float, float], optional
|
|
636
|
+
The color of the mesh.
|
|
637
|
+
centroid : bool, optional
|
|
638
|
+
If True, use the centroid of the mesh as the relative base for the vertex coordinates,
|
|
639
|
+
instead of the origin of the world coordinates system.
|
|
640
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
641
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
642
|
+
|
|
643
|
+
Returns
|
|
644
|
+
-------
|
|
645
|
+
list[:blender:`bpy.types.Object`]
|
|
646
|
+
|
|
647
|
+
"""
|
|
648
|
+
mp = centroid_points(vertices) if centroid else [0, 0, 0]
|
|
649
|
+
vertices = [subtract_vectors(vertex, mp) for vertex in vertices]
|
|
650
|
+
mesh = bpy.data.meshes.new(name)
|
|
651
|
+
mesh.from_pydata(vertices, [], faces)
|
|
652
|
+
mesh.update(calc_edges=True)
|
|
653
|
+
obj = bpy.data.objects.new(name, mesh)
|
|
654
|
+
obj.show_wire = True
|
|
655
|
+
obj.location = mp
|
|
656
|
+
_set_object_color(obj, color)
|
|
657
|
+
_link_objects([obj], collection=collection)
|
|
658
|
+
return obj
|
|
659
|
+
|
|
660
|
+
|
|
661
|
+
# ==============================================================================
|
|
662
|
+
# Curves and Surfaces
|
|
663
|
+
# ==============================================================================
|
|
664
|
+
|
|
665
|
+
|
|
666
|
+
def draw_curves(curves: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
667
|
+
"""Draw curve objects.
|
|
668
|
+
|
|
669
|
+
Parameters
|
|
670
|
+
----------
|
|
671
|
+
curves : list[dict]
|
|
672
|
+
A list of dicts describing the curves.
|
|
673
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
674
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
675
|
+
|
|
676
|
+
Returns
|
|
677
|
+
-------
|
|
678
|
+
list[:blender:`bpy.types.Object`]
|
|
679
|
+
|
|
680
|
+
"""
|
|
681
|
+
P = len(curves)
|
|
682
|
+
N = len(str(P))
|
|
683
|
+
objects = [None] * P
|
|
684
|
+
for index, props in enumerate(curves):
|
|
685
|
+
origin = [0, 0, 0]
|
|
686
|
+
curve = props["curve"]
|
|
687
|
+
name = props.get("name", f"CURVE.{index:0{N}d}")
|
|
688
|
+
rgb = props.get("color", [1.0, 1.0, 1.0])
|
|
689
|
+
# create a curve data block
|
|
690
|
+
bcurve = bpy.data.curves.new(name, type="CURVE")
|
|
691
|
+
bcurve.dimensions = "3D"
|
|
692
|
+
# add a spline segment to the data block
|
|
693
|
+
spline = bcurve.splines.new("NURBS")
|
|
694
|
+
spline.points.add(len(curve.points) - 1)
|
|
695
|
+
for i, (point, weight) in enumerate(zip(curve.points, curve.weights)):
|
|
696
|
+
spline.points[i].co = [point[0], point[1], point[2], weight]
|
|
697
|
+
spline.points[i].weight = weight
|
|
698
|
+
spline.order_u = curve.order
|
|
699
|
+
spline.use_cyclic_u = curve.is_periodic
|
|
700
|
+
spline.use_endpoint_u = True
|
|
701
|
+
# create a scene object from the data block
|
|
702
|
+
obj = bpy.data.objects.new(name, bcurve)
|
|
703
|
+
obj.location = origin
|
|
704
|
+
_set_object_color(obj, rgb)
|
|
705
|
+
objects[index] = obj
|
|
706
|
+
_link_objects(objects, collection)
|
|
707
|
+
return objects
|
|
708
|
+
|
|
709
|
+
|
|
710
|
+
def draw_surfaces(surfaces: List[Dict], collection: Union[Text, bpy.types.Collection] = None) -> List[bpy.types.Object]:
|
|
711
|
+
"""Draw surface objects.
|
|
712
|
+
|
|
713
|
+
Parameters
|
|
714
|
+
----------
|
|
715
|
+
surfaces : list[dict]
|
|
716
|
+
A list of dicts describing the surfaces.
|
|
717
|
+
collection : str | :blender:`bpy.types.Collection`, optional
|
|
718
|
+
The Blender scene collection that should contain the objects created by this function.
|
|
719
|
+
|
|
720
|
+
Returns
|
|
721
|
+
-------
|
|
722
|
+
list[:blender:`bpy.types.Object`]
|
|
723
|
+
|
|
724
|
+
"""
|
|
725
|
+
P = len(surfaces)
|
|
726
|
+
N = len(str(P))
|
|
727
|
+
objects = [None] * P
|
|
728
|
+
for index, props in enumerate(surfaces):
|
|
729
|
+
origin = [0, 0, 0]
|
|
730
|
+
surface = props["surface"]
|
|
731
|
+
name = props.get("name", f"SURFACE.{index:0{N}d}")
|
|
732
|
+
rgb = props.get("color", [1.0, 1.0, 1.0])
|
|
733
|
+
# create a surface data block
|
|
734
|
+
surfdata = bpy.data.curves.new(name, type="SURFACE")
|
|
735
|
+
surfdata.dimensions = "3D"
|
|
736
|
+
surfdata.resolution_u = 32
|
|
737
|
+
surfdata.resolution_v = 32
|
|
738
|
+
# add the U(V) splines
|
|
739
|
+
for points, weights in zip(surface.points, surface.weights):
|
|
740
|
+
spline = surfdata.splines.new("NURBS")
|
|
741
|
+
spline.points.add(len(points) - 1)
|
|
742
|
+
for i, (point, weight) in enumerate(zip(points, weights)):
|
|
743
|
+
spline.points[i].co = [point[0], point[1], point[2], 1.0]
|
|
744
|
+
spline.points[i].weight = weight
|
|
745
|
+
spline.use_endpoint_u = True
|
|
746
|
+
spline.use_endpoint_v = True
|
|
747
|
+
spline.order_u = surface.u_degree + 1
|
|
748
|
+
spline.order_v = surface.v_degree + 1
|
|
749
|
+
# create a scene object from the data block
|
|
750
|
+
obj = bpy.data.objects.new(name, surfdata)
|
|
751
|
+
obj.location = origin
|
|
752
|
+
# colors and stuff
|
|
753
|
+
_set_object_color(obj, rgb)
|
|
754
|
+
objects[index] = obj
|
|
755
|
+
_link_objects(objects, collection)
|
|
756
|
+
for obj in objects:
|
|
757
|
+
# select the control points
|
|
758
|
+
for s in obj.data.splines: # type: ignore
|
|
759
|
+
for p in s.points:
|
|
760
|
+
p.select = True
|
|
761
|
+
# switch to edit mode
|
|
762
|
+
# connect the spline points with segments
|
|
763
|
+
bpy.context.view_layer.objects.active = obj
|
|
764
|
+
bpy.ops.object.mode_set(mode="EDIT")
|
|
765
|
+
bpy.ops.curve.make_segment()
|
|
766
|
+
bpy.ops.object.mode_set(mode="OBJECT")
|
|
767
|
+
bpy.ops.object.select_all(action="DESELECT")
|
|
768
|
+
return objects
|