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,273 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
import itertools
|
|
6
|
+
|
|
7
|
+
from compas.files.gltf.constants import VERTEX_COUNT_BY_MODE
|
|
8
|
+
from compas.files.gltf.data_classes import PrimitiveData
|
|
9
|
+
from compas.files.gltf.helpers import get_mode
|
|
10
|
+
from compas.files.gltf.helpers import get_unweighted_primitive_vertices
|
|
11
|
+
from compas.files.gltf.helpers import get_weighted_mesh_vertices
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class GLTFMesh(object):
|
|
15
|
+
"""Object containing mesh data in a format compatible with the glTF standard.
|
|
16
|
+
|
|
17
|
+
Attributes
|
|
18
|
+
----------
|
|
19
|
+
mesh_name : str
|
|
20
|
+
String of the name of the mesh.
|
|
21
|
+
weights : list
|
|
22
|
+
List containing the weights to be applied to morph targets.
|
|
23
|
+
primitive_data_list : list
|
|
24
|
+
List of objects defining the geometry and material of the mesh.
|
|
25
|
+
extras : object
|
|
26
|
+
extensions : object
|
|
27
|
+
context : GLTFContent
|
|
28
|
+
GLTF context in which the mesh exists.
|
|
29
|
+
key : int
|
|
30
|
+
Key of the mesh used in :attr:`compas.files.GLTFMesh.context.meshes`.
|
|
31
|
+
vertices : list
|
|
32
|
+
List of xyz-tuples representing the points of the mesh.
|
|
33
|
+
faces : list
|
|
34
|
+
List of tuples referencing the indices of :attr:`compas.files.GLTFMesh.vertices`
|
|
35
|
+
representing faces of the mesh.
|
|
36
|
+
|
|
37
|
+
"""
|
|
38
|
+
|
|
39
|
+
def __init__(
|
|
40
|
+
self,
|
|
41
|
+
primitive_data_list,
|
|
42
|
+
context,
|
|
43
|
+
mesh_name=None,
|
|
44
|
+
weights=None,
|
|
45
|
+
extras=None,
|
|
46
|
+
extensions=None,
|
|
47
|
+
):
|
|
48
|
+
self.mesh_name = mesh_name
|
|
49
|
+
self.weights = weights
|
|
50
|
+
self.primitive_data_list = primitive_data_list
|
|
51
|
+
self.extras = extras
|
|
52
|
+
self.extensions = extensions
|
|
53
|
+
|
|
54
|
+
self._key = None
|
|
55
|
+
self.context = context
|
|
56
|
+
self._set_key()
|
|
57
|
+
|
|
58
|
+
def _set_key(self):
|
|
59
|
+
key = len(self.context.meshes)
|
|
60
|
+
while key in self.context.meshes:
|
|
61
|
+
key += 1
|
|
62
|
+
self.context.meshes[key] = self
|
|
63
|
+
self._key = key
|
|
64
|
+
|
|
65
|
+
@property
|
|
66
|
+
def key(self):
|
|
67
|
+
return self._key
|
|
68
|
+
|
|
69
|
+
@property
|
|
70
|
+
def vertices(self):
|
|
71
|
+
if not self.weights:
|
|
72
|
+
return get_unweighted_primitive_vertices(self.primitive_data_list)
|
|
73
|
+
return get_weighted_mesh_vertices(self, self.weights)
|
|
74
|
+
|
|
75
|
+
@property
|
|
76
|
+
def faces(self):
|
|
77
|
+
faces = []
|
|
78
|
+
shift = 0
|
|
79
|
+
for primitive_data in self.primitive_data_list:
|
|
80
|
+
shifted_indices = self.shift_indices(primitive_data.indices, shift)
|
|
81
|
+
group_size = VERTEX_COUNT_BY_MODE[primitive_data.mode]
|
|
82
|
+
grouped_indices = self.group_indices(shifted_indices, group_size)
|
|
83
|
+
faces.extend(grouped_indices)
|
|
84
|
+
shift += len(primitive_data.attributes["POSITION"])
|
|
85
|
+
return faces
|
|
86
|
+
|
|
87
|
+
def shift_indices(self, indices, shift):
|
|
88
|
+
"""Given a list of indices, returns a list of indices, all shifted by ``shift``.
|
|
89
|
+
|
|
90
|
+
Parameters
|
|
91
|
+
----------
|
|
92
|
+
indices : list
|
|
93
|
+
shift : int
|
|
94
|
+
|
|
95
|
+
Returns
|
|
96
|
+
-------
|
|
97
|
+
list
|
|
98
|
+
|
|
99
|
+
"""
|
|
100
|
+
return [index + shift for index in indices]
|
|
101
|
+
|
|
102
|
+
def group_indices(self, indices, group_size):
|
|
103
|
+
"""Returns a list of the elements of ``indices`` grouped into tuples of size ``group_size``.
|
|
104
|
+
|
|
105
|
+
Parameters
|
|
106
|
+
----------
|
|
107
|
+
indices : list
|
|
108
|
+
group_size : int
|
|
109
|
+
|
|
110
|
+
Returns
|
|
111
|
+
-------
|
|
112
|
+
list
|
|
113
|
+
|
|
114
|
+
"""
|
|
115
|
+
it = [iter(indices)] * group_size
|
|
116
|
+
return list(zip(*it))
|
|
117
|
+
|
|
118
|
+
@classmethod
|
|
119
|
+
def validate_faces(cls, faces):
|
|
120
|
+
"""Raises an exception if not all faces in ``faces`` are defining either all triangles, lines
|
|
121
|
+
or points.
|
|
122
|
+
|
|
123
|
+
Parameters
|
|
124
|
+
----------
|
|
125
|
+
faces : list
|
|
126
|
+
|
|
127
|
+
Returns
|
|
128
|
+
-------
|
|
129
|
+
|
|
130
|
+
"""
|
|
131
|
+
if not faces:
|
|
132
|
+
return
|
|
133
|
+
if len(faces[0]) > 3:
|
|
134
|
+
raise Exception("Invalid mesh. Expected mesh composed of points, lines xor triangles.")
|
|
135
|
+
for face in faces:
|
|
136
|
+
if len(face) != len(faces[0]):
|
|
137
|
+
# This restriction could be removed by splitting into multiple primitives.
|
|
138
|
+
raise NotImplementedError("Invalid mesh. Expected mesh composed of points, lines xor triangles.")
|
|
139
|
+
|
|
140
|
+
@classmethod
|
|
141
|
+
def validate_vertices(cls, vertices):
|
|
142
|
+
"""Raise an exception if there are either too many vertices, or the vertices do not
|
|
143
|
+
represent points in 3-space.
|
|
144
|
+
|
|
145
|
+
Parameters
|
|
146
|
+
----------
|
|
147
|
+
vertices : list
|
|
148
|
+
|
|
149
|
+
Returns
|
|
150
|
+
-------
|
|
151
|
+
|
|
152
|
+
"""
|
|
153
|
+
if len(vertices) > 4294967295:
|
|
154
|
+
# This restriction could be removed by splitting into multiple primitives.
|
|
155
|
+
raise Exception("Invalid mesh. Too many vertices.")
|
|
156
|
+
positions = list(vertices.values()) if isinstance(vertices, dict) else vertices
|
|
157
|
+
for position in positions:
|
|
158
|
+
if len(position) != 3:
|
|
159
|
+
raise Exception("Invalid mesh. Vertices are expected to be points in 3-space.")
|
|
160
|
+
|
|
161
|
+
@classmethod
|
|
162
|
+
def from_vertices_and_faces(cls, context, vertices, faces, mesh_name=None, extras=None):
|
|
163
|
+
"""Construct a :class:`compas.files.GLTFMesh` object from lists of vertices and faces.
|
|
164
|
+
Vertices can be given as either a list of xyz-tuples or -lists, in which case
|
|
165
|
+
the faces reference vertices by index, or vertices can be given as a dictionary of
|
|
166
|
+
key-value pairs where the values are xyz-tuples or -lists and the faces reference the keys.
|
|
167
|
+
|
|
168
|
+
Parameters
|
|
169
|
+
----------
|
|
170
|
+
context : :class:`compas.files.GLTFContent`
|
|
171
|
+
vertices : Union[list, dict]
|
|
172
|
+
faces : list
|
|
173
|
+
mesh_name : str
|
|
174
|
+
extras : object
|
|
175
|
+
|
|
176
|
+
Returns
|
|
177
|
+
-------
|
|
178
|
+
:class:`compas.files.GLTFMesh`
|
|
179
|
+
|
|
180
|
+
"""
|
|
181
|
+
cls.validate_faces(faces)
|
|
182
|
+
cls.validate_vertices(vertices)
|
|
183
|
+
mode = get_mode(faces)
|
|
184
|
+
if isinstance(vertices, dict):
|
|
185
|
+
index_by_key = {}
|
|
186
|
+
positions = []
|
|
187
|
+
for key, position in vertices.items():
|
|
188
|
+
positions.append(position)
|
|
189
|
+
index_by_key[key] = len(positions) - 1
|
|
190
|
+
face_list = [index_by_key[key] for key in itertools.chain(*faces)]
|
|
191
|
+
else:
|
|
192
|
+
positions = vertices
|
|
193
|
+
face_list = list(itertools.chain(*faces))
|
|
194
|
+
|
|
195
|
+
primitive = PrimitiveData({"POSITION": positions}, face_list, None, mode, None, None)
|
|
196
|
+
|
|
197
|
+
return cls([primitive], context, mesh_name=mesh_name, extras=extras)
|
|
198
|
+
|
|
199
|
+
@classmethod
|
|
200
|
+
def from_mesh(cls, context, mesh):
|
|
201
|
+
"""Construct a :class:`compas.files.GLTFMesh` object from a compas mesh.
|
|
202
|
+
|
|
203
|
+
Parameters
|
|
204
|
+
----------
|
|
205
|
+
context : :class:`compas.files.GLTFContent`
|
|
206
|
+
mesh : :class:`compas.datastructures.Mesh`
|
|
207
|
+
|
|
208
|
+
Returns
|
|
209
|
+
-------
|
|
210
|
+
:class:`compas.files.GLTFMesh`
|
|
211
|
+
"""
|
|
212
|
+
vertices, faces = mesh.to_vertices_and_faces()
|
|
213
|
+
texture_coordinates = mesh.vertices_attribute("texture_coordinate")
|
|
214
|
+
vertex_normals = mesh.vertices_attribute("vertex_normal")
|
|
215
|
+
vertex_colors = mesh.vertices_attribute("vertex_color")
|
|
216
|
+
|
|
217
|
+
mesh_data = cls.from_vertices_and_faces(context, vertices, faces)
|
|
218
|
+
pd = mesh_data.primitive_data_list[0]
|
|
219
|
+
if texture_coordinates[0] is not None:
|
|
220
|
+
pd.attributes["TEXCOORD_0"] = texture_coordinates
|
|
221
|
+
if vertex_normals[0] is not None:
|
|
222
|
+
pd.attributes["NORMAL"] = vertex_normals
|
|
223
|
+
if vertex_colors[0] is not None:
|
|
224
|
+
pd.attributes["COLOR_0"] = vertex_colors
|
|
225
|
+
return mesh_data
|
|
226
|
+
|
|
227
|
+
def to_data(self, primitives):
|
|
228
|
+
"""Returns a JSONable dictionary object in accordance with glTF specifications.
|
|
229
|
+
|
|
230
|
+
Parameters
|
|
231
|
+
----------
|
|
232
|
+
primitives : list
|
|
233
|
+
|
|
234
|
+
Returns
|
|
235
|
+
-------
|
|
236
|
+
dict
|
|
237
|
+
"""
|
|
238
|
+
mesh_dict = {"primitives": primitives}
|
|
239
|
+
if self.mesh_name is not None:
|
|
240
|
+
mesh_dict["name"] = self.mesh_name
|
|
241
|
+
if self.weights is not None:
|
|
242
|
+
mesh_dict["weights"] = self.weights
|
|
243
|
+
if self.extras is not None:
|
|
244
|
+
mesh_dict["extras"] = self.extras
|
|
245
|
+
if self.extensions is not None:
|
|
246
|
+
mesh_dict["extensions"] = self.extensions
|
|
247
|
+
return mesh_dict
|
|
248
|
+
|
|
249
|
+
@classmethod
|
|
250
|
+
def from_data(cls, mesh, context, primitive_data_list):
|
|
251
|
+
"""Creates a :class:`compas.files.GLTFMesh` from a glTF node dictionary
|
|
252
|
+
and inserts it in the provided context.
|
|
253
|
+
|
|
254
|
+
Parameters
|
|
255
|
+
----------
|
|
256
|
+
mesh : dict
|
|
257
|
+
context : :class:`compas.files.GLTFContent`
|
|
258
|
+
primitive_data_list : list
|
|
259
|
+
|
|
260
|
+
Returns
|
|
261
|
+
-------
|
|
262
|
+
:class:`compas.files.GLTFMesh`
|
|
263
|
+
"""
|
|
264
|
+
if mesh is None:
|
|
265
|
+
return None
|
|
266
|
+
return cls(
|
|
267
|
+
primitive_data_list=primitive_data_list,
|
|
268
|
+
context=context,
|
|
269
|
+
mesh_name=mesh.get("name"),
|
|
270
|
+
weights=mesh.get("weights"),
|
|
271
|
+
extras=mesh.get("extras"),
|
|
272
|
+
extensions=mesh.get("extensions"),
|
|
273
|
+
)
|
|
@@ -0,0 +1,348 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import fabs
|
|
6
|
+
|
|
7
|
+
from compas.files.gltf.gltf_children import GLTFChildren
|
|
8
|
+
from compas.files.gltf.helpers import get_matrix_from_col_major_list
|
|
9
|
+
from compas.files.gltf.helpers import matrix_to_col_major_order
|
|
10
|
+
from compas.geometry import identity_matrix
|
|
11
|
+
from compas.geometry import matrix_from_quaternion
|
|
12
|
+
from compas.geometry import matrix_from_scale_factors
|
|
13
|
+
from compas.geometry import matrix_from_translation
|
|
14
|
+
from compas.geometry import multiply_matrices
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class GLTFNode(object):
|
|
18
|
+
"""Object representing the COMPAS consumable part of a glTF node.
|
|
19
|
+
|
|
20
|
+
Attributes
|
|
21
|
+
----------
|
|
22
|
+
name : str
|
|
23
|
+
Name of the node.
|
|
24
|
+
children : GLTFChildren
|
|
25
|
+
Validated list of keys referencing :attr:`compas.files.GLTFNode.context.nodes`.
|
|
26
|
+
matrix : list of lists
|
|
27
|
+
Matrix representing the displacement from node's parent to the node.
|
|
28
|
+
Default value is the identity matrix.
|
|
29
|
+
Cannot be set when any of translation, rotation or scale is set.
|
|
30
|
+
translation : list[float]
|
|
31
|
+
xyz-coordinates of the translation displacement of the node.
|
|
32
|
+
Cannot be set when :attr:`compas.files.GLTFNode.matrix` is set.
|
|
33
|
+
rotation : list[float]
|
|
34
|
+
Unit quaternion representing the rotational displacement of the node.
|
|
35
|
+
Cannot be set when :attr:`compas.files.GLTFNode.matrix` is set.
|
|
36
|
+
scale : list[float]
|
|
37
|
+
List of length 3 representing the scaling displacement of the node.
|
|
38
|
+
Cannot be set when :attr:`compas.files.GLTFNode.matrix` is set.
|
|
39
|
+
mesh_key : int
|
|
40
|
+
Key of the mesh within :attr:`compas.files.GLTFNode.context.meshes`.
|
|
41
|
+
weights : list[float]
|
|
42
|
+
Weights used for computing morph targets in the attached mesh.
|
|
43
|
+
position : tuple
|
|
44
|
+
xyz-coordinates of the node, calculated from the matrix and tree structure.
|
|
45
|
+
transform : list of lists
|
|
46
|
+
Matrix representing the displacement from the root node to the node.
|
|
47
|
+
key : int
|
|
48
|
+
Key of the node used in :attr:`compas.files.GLTFNode.context.nodes`.
|
|
49
|
+
camera : int
|
|
50
|
+
Key of the camera in :attr:`compas.files.GLTFNode.context.cameras`.
|
|
51
|
+
skin : int
|
|
52
|
+
Key of the skin in :attr:`compas.files.GLTFNode.context.skins`.
|
|
53
|
+
extras : object
|
|
54
|
+
Application-specific data.
|
|
55
|
+
extensions : object
|
|
56
|
+
context : GLTFContent
|
|
57
|
+
GLTF context in which the node exists.
|
|
58
|
+
mesh_data : GLTFMesh
|
|
59
|
+
GLTFMesh used by this node.
|
|
60
|
+
vertices : list
|
|
61
|
+
List of xyz-coordinates of the points of the mesh used by this node.
|
|
62
|
+
faces : list
|
|
63
|
+
List of tuples of indices of the vertices of the faces of the mesh used by this node.
|
|
64
|
+
|
|
65
|
+
"""
|
|
66
|
+
|
|
67
|
+
def __init__(self, context, name=None, extras=None, extensions=None):
|
|
68
|
+
self.name = name
|
|
69
|
+
self._children = GLTFChildren(context, [])
|
|
70
|
+
self._matrix = None
|
|
71
|
+
self._translation = None
|
|
72
|
+
self._rotation = None
|
|
73
|
+
self._scale = None
|
|
74
|
+
self._mesh_key = None
|
|
75
|
+
self.weights = None
|
|
76
|
+
|
|
77
|
+
self.position = None
|
|
78
|
+
self.transform = None
|
|
79
|
+
self._key = None
|
|
80
|
+
|
|
81
|
+
self._camera = None
|
|
82
|
+
self._skin = None
|
|
83
|
+
self.extras = extras
|
|
84
|
+
self.extensions = extensions
|
|
85
|
+
|
|
86
|
+
self.context = context
|
|
87
|
+
self._set_key()
|
|
88
|
+
|
|
89
|
+
def _set_key(self):
|
|
90
|
+
key = len(self.context.nodes)
|
|
91
|
+
while key in self.context.nodes:
|
|
92
|
+
key += 1
|
|
93
|
+
self.context.nodes[key] = self
|
|
94
|
+
self._key = key
|
|
95
|
+
|
|
96
|
+
@property
|
|
97
|
+
def key(self):
|
|
98
|
+
return self._key
|
|
99
|
+
|
|
100
|
+
@property
|
|
101
|
+
def children(self):
|
|
102
|
+
return self._children
|
|
103
|
+
|
|
104
|
+
@children.setter
|
|
105
|
+
def children(self, value):
|
|
106
|
+
self._children = GLTFChildren(self.context, value or [])
|
|
107
|
+
|
|
108
|
+
@property
|
|
109
|
+
def mesh_key(self):
|
|
110
|
+
return self._mesh_key
|
|
111
|
+
|
|
112
|
+
@mesh_key.setter
|
|
113
|
+
def mesh_key(self, value):
|
|
114
|
+
if value is not None and value not in self.context.meshes:
|
|
115
|
+
raise Exception("Cannot find mesh {}".format(value))
|
|
116
|
+
self._mesh_key = value
|
|
117
|
+
|
|
118
|
+
@property
|
|
119
|
+
def camera(self):
|
|
120
|
+
return self._camera
|
|
121
|
+
|
|
122
|
+
@camera.setter
|
|
123
|
+
def camera(self, value):
|
|
124
|
+
if value is not None and value not in self.context.cameras:
|
|
125
|
+
raise Exception("Cannot find camera {}".format(value))
|
|
126
|
+
self._camera = value
|
|
127
|
+
|
|
128
|
+
@property
|
|
129
|
+
def skin(self):
|
|
130
|
+
return self._skin
|
|
131
|
+
|
|
132
|
+
@skin.setter
|
|
133
|
+
def skin(self, value):
|
|
134
|
+
if value is not None and value not in self.context.skin:
|
|
135
|
+
raise Exception("Cannot find skin {}".format(value))
|
|
136
|
+
self._skin = value
|
|
137
|
+
|
|
138
|
+
@property
|
|
139
|
+
def translation(self):
|
|
140
|
+
return self._translation
|
|
141
|
+
|
|
142
|
+
@translation.setter
|
|
143
|
+
def translation(self, value):
|
|
144
|
+
if value is None:
|
|
145
|
+
self._translation = value
|
|
146
|
+
return
|
|
147
|
+
if self._matrix:
|
|
148
|
+
raise Exception("Cannot set translation when matrix is set.")
|
|
149
|
+
if not isinstance(value, list) or len(value) != 3:
|
|
150
|
+
raise Exception("Invalid translation. Translations are expected to be of the form [x, y, z].")
|
|
151
|
+
self._translation = value
|
|
152
|
+
|
|
153
|
+
@property
|
|
154
|
+
def rotation(self):
|
|
155
|
+
return self._rotation
|
|
156
|
+
|
|
157
|
+
@rotation.setter
|
|
158
|
+
def rotation(self, value):
|
|
159
|
+
if value is None:
|
|
160
|
+
self._rotation = value
|
|
161
|
+
return
|
|
162
|
+
if self._matrix:
|
|
163
|
+
raise Exception("Cannot set rotation when matrix is set.")
|
|
164
|
+
if not isinstance(value, list) or len(value) != 4 or fabs(sum([q**2 for q in value]) - 1) > 1e-03:
|
|
165
|
+
raise Exception("Invalid rotation. Rotations are expected to be given as " "unit quaternions of the form [q1, q2, q3, q4]")
|
|
166
|
+
self._rotation = value
|
|
167
|
+
|
|
168
|
+
@property
|
|
169
|
+
def scale(self):
|
|
170
|
+
return self._scale
|
|
171
|
+
|
|
172
|
+
@scale.setter
|
|
173
|
+
def scale(self, value):
|
|
174
|
+
if value is None:
|
|
175
|
+
self._scale = value
|
|
176
|
+
return
|
|
177
|
+
if self._matrix:
|
|
178
|
+
raise Exception("Cannot set scale when matrix is set.")
|
|
179
|
+
if not isinstance(value, list) or len(value) != 3:
|
|
180
|
+
raise Exception("Invalid scale. Scales are expected to be of the form [s1, s2, s3]")
|
|
181
|
+
self._scale = value
|
|
182
|
+
|
|
183
|
+
@property
|
|
184
|
+
def matrix(self):
|
|
185
|
+
if not (self.translation or self.rotation or self.scale or self._matrix):
|
|
186
|
+
return identity_matrix(4)
|
|
187
|
+
return self._matrix
|
|
188
|
+
|
|
189
|
+
@matrix.setter
|
|
190
|
+
def matrix(self, value):
|
|
191
|
+
if value is None:
|
|
192
|
+
self._matrix = value
|
|
193
|
+
return
|
|
194
|
+
if self.translation or self.rotation or self.scale:
|
|
195
|
+
raise Exception("Cannot set matrix when translation, rotation or scale is set.")
|
|
196
|
+
if not isinstance(value, list) or not value or not value[0] or not isinstance(value[0], list):
|
|
197
|
+
raise Exception("Invalid matrix. A list of lists is expected.")
|
|
198
|
+
if len(value) != 4 or len(value[0]) != 4:
|
|
199
|
+
raise Exception("Invalid matrix. A 4x4 matrix is expected.")
|
|
200
|
+
if value[3] != [0, 0, 0, 1]:
|
|
201
|
+
raise Exception(
|
|
202
|
+
"Invalid matrix. A matrix without shear or skew is expected. It must be of " "the form TRS, where T is a translation, R is a rotation and S is a scaling."
|
|
203
|
+
)
|
|
204
|
+
self._matrix = value
|
|
205
|
+
|
|
206
|
+
@property
|
|
207
|
+
def mesh_data(self):
|
|
208
|
+
return self.context.meshes.get(self.mesh_key)
|
|
209
|
+
|
|
210
|
+
@property
|
|
211
|
+
def vertices(self):
|
|
212
|
+
return self.context.get_node_vertices(self)
|
|
213
|
+
|
|
214
|
+
@property
|
|
215
|
+
def faces(self):
|
|
216
|
+
return self.context.get_node_faces(self)
|
|
217
|
+
|
|
218
|
+
def get_matrix_from_trs(self):
|
|
219
|
+
"""If the node's displacement from the origin is given by its translation, rotation and
|
|
220
|
+
scale attributes, this method returns the matrix given by the composition of these
|
|
221
|
+
attributes.
|
|
222
|
+
|
|
223
|
+
Returns
|
|
224
|
+
-------
|
|
225
|
+
|
|
226
|
+
"""
|
|
227
|
+
matrix = identity_matrix(4)
|
|
228
|
+
if self.translation:
|
|
229
|
+
translation = matrix_from_translation(self.translation)
|
|
230
|
+
matrix = multiply_matrices(matrix, translation)
|
|
231
|
+
if self.rotation:
|
|
232
|
+
rotation = matrix_from_quaternion(self.rotation)
|
|
233
|
+
matrix = multiply_matrices(matrix, rotation)
|
|
234
|
+
if self.scale:
|
|
235
|
+
scale = matrix_from_scale_factors(self.scale)
|
|
236
|
+
matrix = multiply_matrices(matrix, scale)
|
|
237
|
+
return matrix
|
|
238
|
+
|
|
239
|
+
def add_child(self, child_name=None, child_extras=None):
|
|
240
|
+
"""Creates a :class:`compas.files.GLTFNode` with name `child_name` (default `None`) and extras `child_extras`
|
|
241
|
+
(default `None`), and adds this node to the children of this node.
|
|
242
|
+
|
|
243
|
+
Parameters
|
|
244
|
+
----------
|
|
245
|
+
child_name : str
|
|
246
|
+
child_extras : object
|
|
247
|
+
|
|
248
|
+
Returns
|
|
249
|
+
-------
|
|
250
|
+
:class:`compas.files.GLTFNode`
|
|
251
|
+
"""
|
|
252
|
+
return self.context.add_child_to_node(self, child_name, child_extras)
|
|
253
|
+
|
|
254
|
+
def add_mesh(self, mesh):
|
|
255
|
+
"""Adds an existing mesh to this node if `mesh` is a valid mesh key, or creates and adds a
|
|
256
|
+
mesh to this node and its context.
|
|
257
|
+
|
|
258
|
+
Parameters
|
|
259
|
+
----------
|
|
260
|
+
mesh : Union[int, Mesh]
|
|
261
|
+
|
|
262
|
+
Returns
|
|
263
|
+
-------
|
|
264
|
+
|
|
265
|
+
"""
|
|
266
|
+
return self.context.add_mesh_to_node(self, mesh)
|
|
267
|
+
|
|
268
|
+
def to_data(
|
|
269
|
+
self,
|
|
270
|
+
node_index_by_key,
|
|
271
|
+
mesh_index_by_key,
|
|
272
|
+
camera_index_by_key,
|
|
273
|
+
skin_index_by_key,
|
|
274
|
+
):
|
|
275
|
+
"""Returns a JSONable dictionary object in accordance with glTF specifications.
|
|
276
|
+
|
|
277
|
+
Parameters
|
|
278
|
+
----------
|
|
279
|
+
node_index_by_key : dict
|
|
280
|
+
mesh_index_by_key : dict
|
|
281
|
+
camera_index_by_key : dict
|
|
282
|
+
skin_index_by_key : dict
|
|
283
|
+
|
|
284
|
+
Returns
|
|
285
|
+
-------
|
|
286
|
+
dict
|
|
287
|
+
"""
|
|
288
|
+
node_dict = {}
|
|
289
|
+
if self.name is not None:
|
|
290
|
+
node_dict["name"] = self.name
|
|
291
|
+
if self.children:
|
|
292
|
+
node_dict["children"] = [node_index_by_key[key] for key in self.children]
|
|
293
|
+
if self.matrix and self.matrix != identity_matrix(4):
|
|
294
|
+
node_dict["matrix"] = matrix_to_col_major_order(self.matrix)
|
|
295
|
+
else:
|
|
296
|
+
if self.translation:
|
|
297
|
+
node_dict["translation"] = self.translation
|
|
298
|
+
if self.rotation:
|
|
299
|
+
node_dict["rotation"] = self.rotation
|
|
300
|
+
if self.scale:
|
|
301
|
+
node_dict["scale"] = self.scale
|
|
302
|
+
if self.mesh_key is not None:
|
|
303
|
+
node_dict["mesh"] = mesh_index_by_key[self.mesh_key]
|
|
304
|
+
if self._camera is not None:
|
|
305
|
+
node_dict["camera"] = camera_index_by_key[self._camera]
|
|
306
|
+
if self._skin is not None:
|
|
307
|
+
node_dict["skin"] = skin_index_by_key[self._skin]
|
|
308
|
+
if self.extras:
|
|
309
|
+
node_dict["extras"] = self.extras
|
|
310
|
+
if self.extensions is not None:
|
|
311
|
+
node_dict["extensions"] = self.extensions
|
|
312
|
+
return node_dict
|
|
313
|
+
|
|
314
|
+
@classmethod
|
|
315
|
+
def from_data(cls, node, context):
|
|
316
|
+
"""Creates a :class:`compas.files.GLTFNode` from a glTF node dictionary
|
|
317
|
+
and inserts it in the provided context.
|
|
318
|
+
|
|
319
|
+
Parameters
|
|
320
|
+
----------
|
|
321
|
+
node : dict
|
|
322
|
+
context : :class:`compas.files.GLTFContent`
|
|
323
|
+
|
|
324
|
+
Returns
|
|
325
|
+
-------
|
|
326
|
+
:class:`compas.files.GLTFNode`
|
|
327
|
+
"""
|
|
328
|
+
if node is None:
|
|
329
|
+
return None
|
|
330
|
+
gltf_node = cls(
|
|
331
|
+
context=context,
|
|
332
|
+
name=node.get("name"),
|
|
333
|
+
extras=node.get("extras"),
|
|
334
|
+
extensions=node.get("extensions"),
|
|
335
|
+
)
|
|
336
|
+
# Accessing protected attribute to bypass validation:
|
|
337
|
+
# Nodes may reference children that haven't yet been added to the GLTFContent
|
|
338
|
+
gltf_node.children._values = node.get("children", [])
|
|
339
|
+
|
|
340
|
+
gltf_node.translation = node.get("translation")
|
|
341
|
+
gltf_node.rotation = node.get("rotation")
|
|
342
|
+
gltf_node.scale = node.get("scale")
|
|
343
|
+
gltf_node.matrix = get_matrix_from_col_major_list(node["matrix"]) if "matrix" in node else None
|
|
344
|
+
gltf_node.weights = node.get("weights")
|
|
345
|
+
gltf_node.mesh_key = node.get("mesh")
|
|
346
|
+
gltf_node.camera = node.get("camera")
|
|
347
|
+
gltf_node.skin = node.get("skin")
|
|
348
|
+
return gltf_node
|