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.
Files changed (468) hide show
  1. compas/__init__.py +274 -0
  2. compas/__main__.py +31 -0
  3. compas/_iotools.py +80 -0
  4. compas/_os.py +746 -0
  5. compas/colors/__init__.py +14 -0
  6. compas/colors/cmcrameri/acton.txt +256 -0
  7. compas/colors/cmcrameri/actonS.txt +100 -0
  8. compas/colors/cmcrameri/bam.txt +256 -0
  9. compas/colors/cmcrameri/bamO.txt +256 -0
  10. compas/colors/cmcrameri/bamako.txt +256 -0
  11. compas/colors/cmcrameri/bamakoS.txt +100 -0
  12. compas/colors/cmcrameri/batlow.txt +256 -0
  13. compas/colors/cmcrameri/batlowK.txt +256 -0
  14. compas/colors/cmcrameri/batlowS.txt +100 -0
  15. compas/colors/cmcrameri/batlowW.txt +256 -0
  16. compas/colors/cmcrameri/berlin.txt +256 -0
  17. compas/colors/cmcrameri/bilbao.txt +256 -0
  18. compas/colors/cmcrameri/bilbaoS.txt +100 -0
  19. compas/colors/cmcrameri/broc.txt +256 -0
  20. compas/colors/cmcrameri/brocO.txt +256 -0
  21. compas/colors/cmcrameri/buda.txt +256 -0
  22. compas/colors/cmcrameri/budaS.txt +100 -0
  23. compas/colors/cmcrameri/bukavu.txt +256 -0
  24. compas/colors/cmcrameri/cork.txt +256 -0
  25. compas/colors/cmcrameri/corkO.txt +256 -0
  26. compas/colors/cmcrameri/davos.txt +256 -0
  27. compas/colors/cmcrameri/davosS.txt +100 -0
  28. compas/colors/cmcrameri/devon.txt +256 -0
  29. compas/colors/cmcrameri/devonS.txt +100 -0
  30. compas/colors/cmcrameri/fes.txt +256 -0
  31. compas/colors/cmcrameri/grayC.txt +256 -0
  32. compas/colors/cmcrameri/grayCS.txt +100 -0
  33. compas/colors/cmcrameri/hawaii.txt +256 -0
  34. compas/colors/cmcrameri/hawaiiS.txt +100 -0
  35. compas/colors/cmcrameri/imola.txt +256 -0
  36. compas/colors/cmcrameri/imolaS.txt +100 -0
  37. compas/colors/cmcrameri/lajolla.txt +256 -0
  38. compas/colors/cmcrameri/lajollaS.txt +100 -0
  39. compas/colors/cmcrameri/lapaz.txt +256 -0
  40. compas/colors/cmcrameri/lapazS.txt +100 -0
  41. compas/colors/cmcrameri/lisbon.txt +256 -0
  42. compas/colors/cmcrameri/nuuk.txt +256 -0
  43. compas/colors/cmcrameri/nuukS.txt +100 -0
  44. compas/colors/cmcrameri/oleron.txt +256 -0
  45. compas/colors/cmcrameri/oslo.txt +256 -0
  46. compas/colors/cmcrameri/osloS.txt +100 -0
  47. compas/colors/cmcrameri/roma.txt +256 -0
  48. compas/colors/cmcrameri/romaO.txt +256 -0
  49. compas/colors/cmcrameri/tofino.txt +256 -0
  50. compas/colors/cmcrameri/tokyo.txt +256 -0
  51. compas/colors/cmcrameri/tokyoS.txt +100 -0
  52. compas/colors/cmcrameri/turku.txt +256 -0
  53. compas/colors/cmcrameri/turkuS.txt +100 -0
  54. compas/colors/cmcrameri/vanimo.txt +256 -0
  55. compas/colors/cmcrameri/vik.txt +256 -0
  56. compas/colors/cmcrameri/vikO.txt +256 -0
  57. compas/colors/color.py +1118 -0
  58. compas/colors/colordict.py +103 -0
  59. compas/colors/colormap.py +306 -0
  60. compas/colors/html_colors.py +149 -0
  61. compas/colors/mpl_colormap.py +1064 -0
  62. compas/data/__init__.py +31 -0
  63. compas/data/coercion.py +71 -0
  64. compas/data/conftest.py +10 -0
  65. compas/data/data.py +342 -0
  66. compas/data/encoders.py +240 -0
  67. compas/data/exceptions.py +2 -0
  68. compas/data/json.py +240 -0
  69. compas/data/samples/boxes.obj +250 -0
  70. compas/data/samples/butt_model.obj +2829 -0
  71. compas/data/samples/cone.stl +0 -0
  72. compas/data/samples/cube.off +16 -0
  73. compas/data/samples/cube_ascii.stl +56114 -0
  74. compas/data/samples/cube_binary.stl +0 -0
  75. compas/data/samples/cube_binary_2.stl +0 -0
  76. compas/data/samples/doosabin.json +1 -0
  77. compas/data/samples/faces.obj +63 -0
  78. compas/data/samples/faces_big.obj +9663 -0
  79. compas/data/samples/faces_reversed.obj +63 -0
  80. compas/data/samples/fink.obj +135 -0
  81. compas/data/samples/grid_irregular.obj +303 -0
  82. compas/data/samples/hypar.obj +148 -0
  83. compas/data/samples/lines.json +1 -0
  84. compas/data/samples/lines.obj +282 -0
  85. compas/data/samples/lines_big.obj +40322 -0
  86. compas/data/samples/lines_bigger.obj +161282 -0
  87. compas/data/samples/lines_noleaves.obj +422 -0
  88. compas/data/samples/mesh.obj +874 -0
  89. compas/data/samples/mesh_100_faces.json +1893 -0
  90. compas/data/samples/mesh_110_faces.json +2081 -0
  91. compas/data/samples/open_edges.obj +424 -0
  92. compas/data/samples/point.json +1 -0
  93. compas/data/samples/quadmesh.obj +183 -0
  94. compas/data/samples/quadmesh_planar.obj +181 -0
  95. compas/data/samples/saddle.obj +314 -0
  96. compas/data/samples/spline.obj +72 -0
  97. compas/data/samples/tubemesh.json +1 -0
  98. compas/data/samples/tubemesh.obj +378 -0
  99. compas/data/samples/tubemesh.off +374 -0
  100. compas/data/samples/tubemesh.ply +551 -0
  101. compas/data/schema.py +137 -0
  102. compas/data/validators.py +243 -0
  103. compas/datastructures/__init__.py +75 -0
  104. compas/datastructures/_mutablemapping.py +148 -0
  105. compas/datastructures/assembly/__init__.py +0 -0
  106. compas/datastructures/assembly/assembly.py +234 -0
  107. compas/datastructures/assembly/exceptions.py +6 -0
  108. compas/datastructures/assembly/part.py +228 -0
  109. compas/datastructures/attributes.py +85 -0
  110. compas/datastructures/cell_network/__init__.py +0 -0
  111. compas/datastructures/cell_network/cell_network.py +4190 -0
  112. compas/datastructures/datastructure.py +309 -0
  113. compas/datastructures/graph/__init__.py +0 -0
  114. compas/datastructures/graph/duality.py +197 -0
  115. compas/datastructures/graph/graph.py +2478 -0
  116. compas/datastructures/graph/operations/__init__.py +0 -0
  117. compas/datastructures/graph/operations/join.py +124 -0
  118. compas/datastructures/graph/operations/split.py +63 -0
  119. compas/datastructures/graph/planarity.py +292 -0
  120. compas/datastructures/graph/smoothing.py +59 -0
  121. compas/datastructures/mesh/__init__.py +0 -0
  122. compas/datastructures/mesh/conway.py +553 -0
  123. compas/datastructures/mesh/duality.py +104 -0
  124. compas/datastructures/mesh/mesh.py +5103 -0
  125. compas/datastructures/mesh/operations/__init__.py +0 -0
  126. compas/datastructures/mesh/operations/collapse.py +350 -0
  127. compas/datastructures/mesh/operations/extrude.py +0 -0
  128. compas/datastructures/mesh/operations/insert.py +120 -0
  129. compas/datastructures/mesh/operations/merge.py +83 -0
  130. compas/datastructures/mesh/operations/split.py +263 -0
  131. compas/datastructures/mesh/operations/substitute.py +37 -0
  132. compas/datastructures/mesh/operations/swap.py +62 -0
  133. compas/datastructures/mesh/operations/weld.py +107 -0
  134. compas/datastructures/mesh/remesh.py +234 -0
  135. compas/datastructures/mesh/slice.py +170 -0
  136. compas/datastructures/mesh/smoothing.py +187 -0
  137. compas/datastructures/mesh/subdivision.py +754 -0
  138. compas/datastructures/tree/__init__.py +0 -0
  139. compas/datastructures/tree/tree.py +504 -0
  140. compas/datastructures/volmesh/__init__.py +0 -0
  141. compas/datastructures/volmesh/volmesh.py +4203 -0
  142. compas/files/__init__.py +27 -0
  143. compas/files/_xml/__init__.py +0 -0
  144. compas/files/_xml/xml_cli.py +213 -0
  145. compas/files/_xml/xml_cpython.py +32 -0
  146. compas/files/_xml/xml_pre_38.py +58 -0
  147. compas/files/_xml/xml_shared.py +40 -0
  148. compas/files/gltf/__init__.py +0 -0
  149. compas/files/gltf/constants.py +59 -0
  150. compas/files/gltf/data_classes.py +657 -0
  151. compas/files/gltf/extensions.py +317 -0
  152. compas/files/gltf/gltf.py +92 -0
  153. compas/files/gltf/gltf_children.py +64 -0
  154. compas/files/gltf/gltf_content.py +615 -0
  155. compas/files/gltf/gltf_exporter.py +465 -0
  156. compas/files/gltf/gltf_mesh.py +273 -0
  157. compas/files/gltf/gltf_node.py +348 -0
  158. compas/files/gltf/gltf_parser.py +115 -0
  159. compas/files/gltf/gltf_reader.py +310 -0
  160. compas/files/gltf/gltf_scene.py +125 -0
  161. compas/files/gltf/helpers.py +59 -0
  162. compas/files/obj.py +680 -0
  163. compas/files/off.py +296 -0
  164. compas/files/ply.py +697 -0
  165. compas/files/stl.py +436 -0
  166. compas/files/xml.py +328 -0
  167. compas/geometry/__init__.py +772 -0
  168. compas/geometry/_core/__init__.py +0 -0
  169. compas/geometry/_core/_algebra.py +2826 -0
  170. compas/geometry/_core/angles.py +408 -0
  171. compas/geometry/_core/centroids.py +573 -0
  172. compas/geometry/_core/distance.py +895 -0
  173. compas/geometry/_core/normals.py +149 -0
  174. compas/geometry/_core/nurbs.py +367 -0
  175. compas/geometry/_core/predicates_2.py +582 -0
  176. compas/geometry/_core/predicates_3.py +1111 -0
  177. compas/geometry/_core/quaternions.py +196 -0
  178. compas/geometry/_core/size.py +204 -0
  179. compas/geometry/_core/tangent.py +56 -0
  180. compas/geometry/_core/transformations.py +1121 -0
  181. compas/geometry/_core/transformations_numpy.py +279 -0
  182. compas/geometry/bbox.py +145 -0
  183. compas/geometry/bbox_numpy.py +306 -0
  184. compas/geometry/bestfit.py +77 -0
  185. compas/geometry/bestfit_numpy.py +259 -0
  186. compas/geometry/booleans.py +297 -0
  187. compas/geometry/booleans_shapely.py +147 -0
  188. compas/geometry/brep/__init__.py +112 -0
  189. compas/geometry/brep/brep.py +1131 -0
  190. compas/geometry/brep/edge.py +302 -0
  191. compas/geometry/brep/errors.py +22 -0
  192. compas/geometry/brep/face.py +329 -0
  193. compas/geometry/brep/loop.py +87 -0
  194. compas/geometry/brep/trim.py +46 -0
  195. compas/geometry/brep/vertex.py +46 -0
  196. compas/geometry/contours.py +32 -0
  197. compas/geometry/curves/__init__.py +0 -0
  198. compas/geometry/curves/arc.py +429 -0
  199. compas/geometry/curves/bezier.py +345 -0
  200. compas/geometry/curves/circle.py +500 -0
  201. compas/geometry/curves/conic.py +16 -0
  202. compas/geometry/curves/curve.py +614 -0
  203. compas/geometry/curves/ellipse.py +408 -0
  204. compas/geometry/curves/hyperbola.py +336 -0
  205. compas/geometry/curves/line.py +431 -0
  206. compas/geometry/curves/nurbs.py +412 -0
  207. compas/geometry/curves/parabola.py +256 -0
  208. compas/geometry/curves/polyline.py +724 -0
  209. compas/geometry/frame.py +769 -0
  210. compas/geometry/geometry.py +296 -0
  211. compas/geometry/hull.py +146 -0
  212. compas/geometry/hull_numpy.py +82 -0
  213. compas/geometry/icp_numpy.py +104 -0
  214. compas/geometry/interpolation_barycentric.py +38 -0
  215. compas/geometry/interpolation_coons.py +102 -0
  216. compas/geometry/interpolation_tweening.py +87 -0
  217. compas/geometry/intersection.py +121 -0
  218. compas/geometry/intersections.py +1105 -0
  219. compas/geometry/kdtree.py +153 -0
  220. compas/geometry/offset.py +208 -0
  221. compas/geometry/pca_numpy.py +87 -0
  222. compas/geometry/plane.py +657 -0
  223. compas/geometry/point.py +664 -0
  224. compas/geometry/pointcloud.py +409 -0
  225. compas/geometry/polygon.py +473 -0
  226. compas/geometry/polyhedron.py +650 -0
  227. compas/geometry/projection.py +155 -0
  228. compas/geometry/quadmesh_planarize.py +30 -0
  229. compas/geometry/quadmesh_planarize_none.py +114 -0
  230. compas/geometry/quaternion.py +544 -0
  231. compas/geometry/reflection.py +102 -0
  232. compas/geometry/rotation.py +354 -0
  233. compas/geometry/scale.py +100 -0
  234. compas/geometry/shapes/__init__.py +0 -0
  235. compas/geometry/shapes/box.py +747 -0
  236. compas/geometry/shapes/capsule.py +472 -0
  237. compas/geometry/shapes/cone.py +309 -0
  238. compas/geometry/shapes/cylinder.py +355 -0
  239. compas/geometry/shapes/shape.py +300 -0
  240. compas/geometry/shapes/sphere.py +362 -0
  241. compas/geometry/shapes/torus.py +294 -0
  242. compas/geometry/shear.py +115 -0
  243. compas/geometry/surfaces/__init__.py +0 -0
  244. compas/geometry/surfaces/conical.py +166 -0
  245. compas/geometry/surfaces/cylindrical.py +251 -0
  246. compas/geometry/surfaces/extrusion.py +0 -0
  247. compas/geometry/surfaces/nurbs.py +380 -0
  248. compas/geometry/surfaces/planar.py +223 -0
  249. compas/geometry/surfaces/revolution.py +0 -0
  250. compas/geometry/surfaces/spherical.py +259 -0
  251. compas/geometry/surfaces/surface.py +689 -0
  252. compas/geometry/surfaces/toroidal.py +198 -0
  253. compas/geometry/transformation.py +554 -0
  254. compas/geometry/translation.py +104 -0
  255. compas/geometry/triangulation_delaunay.py +102 -0
  256. compas/geometry/triangulation_earclip.py +300 -0
  257. compas/geometry/trimesh_curvature.py +113 -0
  258. compas/geometry/trimesh_descent_numpy.py +26 -0
  259. compas/geometry/trimesh_geodistance.py +35 -0
  260. compas/geometry/trimesh_gradient_numpy.py +74 -0
  261. compas/geometry/trimesh_isolines.py +41 -0
  262. compas/geometry/trimesh_matrices.py +31 -0
  263. compas/geometry/trimesh_matrices_numpy.py +191 -0
  264. compas/geometry/trimesh_parametrisation.py +55 -0
  265. compas/geometry/trimesh_pull_points_numpy.py +216 -0
  266. compas/geometry/trimesh_remeshing.py +97 -0
  267. compas/geometry/trimesh_samplepoints_numpy.py +108 -0
  268. compas/geometry/trimesh_slicing.py +28 -0
  269. compas/geometry/trimesh_smoothing_numpy.py +34 -0
  270. compas/geometry/vector.py +889 -0
  271. compas/itertools.py +441 -0
  272. compas/linalg.py +634 -0
  273. compas/matrices.py +314 -0
  274. compas/plugins.py +488 -0
  275. compas/rpc/__init__.py +20 -0
  276. compas/rpc/__main__.py +77 -0
  277. compas/rpc/dispatcher.py +181 -0
  278. compas/rpc/errors.py +11 -0
  279. compas/rpc/proxy.py +437 -0
  280. compas/rpc/server.py +79 -0
  281. compas/rpc/services/__init__.py +0 -0
  282. compas/rpc/services/default.py +87 -0
  283. compas/rpc/services/watcher.py +43 -0
  284. compas/scene/__init__.py +56 -0
  285. compas/scene/assemblyobject.py +3 -0
  286. compas/scene/context.py +154 -0
  287. compas/scene/descriptors/__init__.py +0 -0
  288. compas/scene/descriptors/attribute.py +30 -0
  289. compas/scene/descriptors/color.py +91 -0
  290. compas/scene/descriptors/colordict.py +101 -0
  291. compas/scene/descriptors/protocol.py +12 -0
  292. compas/scene/exceptions.py +7 -0
  293. compas/scene/geometryobject.py +58 -0
  294. compas/scene/graphobject.py +173 -0
  295. compas/scene/meshobject.py +238 -0
  296. compas/scene/scene.py +144 -0
  297. compas/scene/sceneobject.py +253 -0
  298. compas/scene/volmeshobject.py +252 -0
  299. compas/tolerance.py +879 -0
  300. compas/topology/__init__.py +45 -0
  301. compas/topology/combinatorics.py +108 -0
  302. compas/topology/connectivity.py +129 -0
  303. compas/topology/orientation.py +204 -0
  304. compas/topology/traversal.py +567 -0
  305. compas/utilities/__init__.py +25 -0
  306. compas/utilities/azync.py +155 -0
  307. compas/utilities/datetime.py +40 -0
  308. compas/utilities/decorators.py +136 -0
  309. compas/utilities/remote.py +54 -0
  310. compas/utilities/ssh.py +169 -0
  311. compas-2.1.1.dist-info/AUTHORS.md +42 -0
  312. compas-2.1.1.dist-info/LICENSE +21 -0
  313. compas-2.1.1.dist-info/METADATA +132 -0
  314. compas-2.1.1.dist-info/RECORD +468 -0
  315. compas-2.1.1.dist-info/WHEEL +5 -0
  316. compas-2.1.1.dist-info/entry_points.txt +2 -0
  317. compas-2.1.1.dist-info/top_level.txt +4 -0
  318. compas_blender/__init__.py +250 -0
  319. compas_blender/collections.py +130 -0
  320. compas_blender/conversions/__init__.py +48 -0
  321. compas_blender/conversions/breps.py +0 -0
  322. compas_blender/conversions/colors.py +23 -0
  323. compas_blender/conversions/curves.py +125 -0
  324. compas_blender/conversions/geometry.py +161 -0
  325. compas_blender/conversions/meshes.py +148 -0
  326. compas_blender/conversions/surfaces.py +48 -0
  327. compas_blender/conversions/transformations.py +46 -0
  328. compas_blender/data.py +30 -0
  329. compas_blender/geometry/__init__.py +14 -0
  330. compas_blender/geometry/booleans.py +100 -0
  331. compas_blender/install.py +338 -0
  332. compas_blender/objects.py +326 -0
  333. compas_blender/print_python_path.py +18 -0
  334. compas_blender/scene/__init__.py +116 -0
  335. compas_blender/scene/boxobject.py +64 -0
  336. compas_blender/scene/capsuleobject.py +73 -0
  337. compas_blender/scene/circleobject.py +53 -0
  338. compas_blender/scene/coneobject.py +70 -0
  339. compas_blender/scene/curveobject.py +58 -0
  340. compas_blender/scene/cylinderobject.py +70 -0
  341. compas_blender/scene/frameobject.py +105 -0
  342. compas_blender/scene/graphobject.py +257 -0
  343. compas_blender/scene/lineobject.py +60 -0
  344. compas_blender/scene/meshobject.py +508 -0
  345. compas_blender/scene/planeobject.py +81 -0
  346. compas_blender/scene/pointcloudobject.py +67 -0
  347. compas_blender/scene/pointobject.py +71 -0
  348. compas_blender/scene/polygonobject.py +57 -0
  349. compas_blender/scene/polyhedronobject.py +57 -0
  350. compas_blender/scene/polylineobject.py +54 -0
  351. compas_blender/scene/sceneobject.py +249 -0
  352. compas_blender/scene/sphereobject.py +72 -0
  353. compas_blender/scene/surfaceobject.py +54 -0
  354. compas_blender/scene/torusobject.py +73 -0
  355. compas_blender/scene/vectorobject.py +69 -0
  356. compas_blender/scene/volmeshobject.py +475 -0
  357. compas_blender/utilities/__init__.py +38 -0
  358. compas_blender/utilities/drawing.py +768 -0
  359. compas_ghpython/__init__.py +124 -0
  360. compas_ghpython/components/Compas_FromJson/code.py +18 -0
  361. compas_ghpython/components/Compas_Info/code.py +15 -0
  362. compas_ghpython/components/Compas_RpcCall/code.py +31 -0
  363. compas_ghpython/components/Compas_ToJson/code.py +19 -0
  364. compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
  365. compas_ghpython/components/__init__.py +99 -0
  366. compas_ghpython/install.py +29 -0
  367. compas_ghpython/scene/__init__.py +115 -0
  368. compas_ghpython/scene/boxobject.py +40 -0
  369. compas_ghpython/scene/brepobject.py +40 -0
  370. compas_ghpython/scene/capsuleobject.py +41 -0
  371. compas_ghpython/scene/circleobject.py +40 -0
  372. compas_ghpython/scene/coneobject.py +40 -0
  373. compas_ghpython/scene/curveobject.py +42 -0
  374. compas_ghpython/scene/cylinderobject.py +38 -0
  375. compas_ghpython/scene/ellipseobject.py +40 -0
  376. compas_ghpython/scene/frameobject.py +67 -0
  377. compas_ghpython/scene/graphobject.py +77 -0
  378. compas_ghpython/scene/lineobject.py +39 -0
  379. compas_ghpython/scene/meshobject.py +137 -0
  380. compas_ghpython/scene/planeobject.py +61 -0
  381. compas_ghpython/scene/pointobject.py +38 -0
  382. compas_ghpython/scene/polygonobject.py +48 -0
  383. compas_ghpython/scene/polyhedronobject.py +48 -0
  384. compas_ghpython/scene/polylineobject.py +39 -0
  385. compas_ghpython/scene/sceneobject.py +12 -0
  386. compas_ghpython/scene/sphereobject.py +39 -0
  387. compas_ghpython/scene/surfaceobject.py +42 -0
  388. compas_ghpython/scene/torusobject.py +39 -0
  389. compas_ghpython/scene/vectorobject.py +51 -0
  390. compas_ghpython/scene/volmeshobject.py +154 -0
  391. compas_ghpython/sets.py +83 -0
  392. compas_ghpython/timer.py +36 -0
  393. compas_ghpython/uninstall.py +31 -0
  394. compas_ghpython/utilities/__init__.py +33 -0
  395. compas_ghpython/utilities/drawing.py +457 -0
  396. compas_rhino/__init__.py +607 -0
  397. compas_rhino/conduits/__init__.py +16 -0
  398. compas_rhino/conduits/base.py +121 -0
  399. compas_rhino/conduits/faces.py +91 -0
  400. compas_rhino/conduits/labels.py +102 -0
  401. compas_rhino/conduits/lines.py +109 -0
  402. compas_rhino/conduits/points.py +111 -0
  403. compas_rhino/conversions/__init__.py +168 -0
  404. compas_rhino/conversions/breps.py +122 -0
  405. compas_rhino/conversions/curves.py +453 -0
  406. compas_rhino/conversions/docobjects.py +0 -0
  407. compas_rhino/conversions/exceptions.py +7 -0
  408. compas_rhino/conversions/extrusions.py +80 -0
  409. compas_rhino/conversions/geometry.py +187 -0
  410. compas_rhino/conversions/meshes.py +281 -0
  411. compas_rhino/conversions/shapes.py +291 -0
  412. compas_rhino/conversions/surfaces.py +355 -0
  413. compas_rhino/conversions/transformations.py +45 -0
  414. compas_rhino/geometry/__init__.py +44 -0
  415. compas_rhino/geometry/booleans.py +118 -0
  416. compas_rhino/geometry/brep/__init__.py +40 -0
  417. compas_rhino/geometry/brep/brep.py +554 -0
  418. compas_rhino/geometry/brep/builder.py +184 -0
  419. compas_rhino/geometry/brep/edge.py +202 -0
  420. compas_rhino/geometry/brep/face.py +285 -0
  421. compas_rhino/geometry/brep/loop.py +129 -0
  422. compas_rhino/geometry/brep/trim.py +99 -0
  423. compas_rhino/geometry/brep/vertex.py +76 -0
  424. compas_rhino/geometry/curves/__init__.py +43 -0
  425. compas_rhino/geometry/curves/curve.py +382 -0
  426. compas_rhino/geometry/curves/nurbs.py +298 -0
  427. compas_rhino/geometry/surfaces/__init__.py +50 -0
  428. compas_rhino/geometry/surfaces/nurbs.py +370 -0
  429. compas_rhino/geometry/surfaces/surface.py +407 -0
  430. compas_rhino/geometry/trimesh_curvature.py +344 -0
  431. compas_rhino/geometry/trimesh_slicing.py +65 -0
  432. compas_rhino/install.py +382 -0
  433. compas_rhino/install_plugin.py +169 -0
  434. compas_rhino/install_with_pip.py +20 -0
  435. compas_rhino/layers.py +347 -0
  436. compas_rhino/objects.py +1141 -0
  437. compas_rhino/print_python_path.py +18 -0
  438. compas_rhino/scene/__init__.py +123 -0
  439. compas_rhino/scene/boxobject.py +44 -0
  440. compas_rhino/scene/brepobject.py +41 -0
  441. compas_rhino/scene/capsuleobject.py +45 -0
  442. compas_rhino/scene/circleobject.py +43 -0
  443. compas_rhino/scene/coneobject.py +43 -0
  444. compas_rhino/scene/curveobject.py +43 -0
  445. compas_rhino/scene/cylinderobject.py +43 -0
  446. compas_rhino/scene/ellipseobject.py +44 -0
  447. compas_rhino/scene/frameobject.py +99 -0
  448. compas_rhino/scene/graphobject.py +364 -0
  449. compas_rhino/scene/helpers.py +33 -0
  450. compas_rhino/scene/lineobject.py +43 -0
  451. compas_rhino/scene/meshobject.py +673 -0
  452. compas_rhino/scene/planeobject.py +71 -0
  453. compas_rhino/scene/pointobject.py +43 -0
  454. compas_rhino/scene/polygonobject.py +45 -0
  455. compas_rhino/scene/polyhedronobject.py +45 -0
  456. compas_rhino/scene/polylineobject.py +43 -0
  457. compas_rhino/scene/sceneobject.py +123 -0
  458. compas_rhino/scene/sphereobject.py +43 -0
  459. compas_rhino/scene/surfaceobject.py +42 -0
  460. compas_rhino/scene/torusobject.py +43 -0
  461. compas_rhino/scene/vectorobject.py +49 -0
  462. compas_rhino/scene/volmeshobject.py +518 -0
  463. compas_rhino/ui.py +114 -0
  464. compas_rhino/uninstall.py +243 -0
  465. compas_rhino/uninstall_plugin.py +91 -0
  466. compas_rhino/utilities/__init__.py +37 -0
  467. compas_rhino/utilities/constructors.py +71 -0
  468. 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