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,71 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Point
8
+ from compas.scene import GeometryObject
9
+
10
+ from .sceneobject import BlenderSceneObject
11
+
12
+
13
+ class PointObject(BlenderSceneObject, GeometryObject):
14
+ """Scene object for drawing points in Blender.
15
+
16
+ Parameters
17
+ ----------
18
+ point : :class:`compas.geometry.Point`
19
+ A COMPAS point.
20
+ **kwargs : dict, optional
21
+ Additional keyword arguments.
22
+
23
+ """
24
+
25
+ def __init__(self, point: Point, **kwargs: Any):
26
+ super().__init__(geometry=point, **kwargs)
27
+
28
+ def draw(
29
+ self,
30
+ color: Optional[Color] = None,
31
+ collection: Optional[str] = None,
32
+ radius: float = 0.01,
33
+ u: int = 16,
34
+ v: int = 16,
35
+ ) -> list[bpy.types.Object]:
36
+ """Draw the point.
37
+
38
+ Parameters
39
+ ----------
40
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
41
+ Color of the point object.
42
+ collection : str, optional
43
+ The name of the Blender scene collection containing the created object(s).
44
+ radius : float, optional
45
+ Radius of the point object.
46
+ u : int, optional
47
+ Number of faces in the "u" direction.
48
+ v : int, optional
49
+ Number of faces in the "v" direction.
50
+
51
+ Returns
52
+ -------
53
+ list[:blender:`bpy.types.Object`]
54
+
55
+ """
56
+ name = self.geometry.name
57
+ color = Color.coerce(color) or self.color
58
+
59
+ bpy.ops.mesh.primitive_uv_sphere_add(
60
+ location=self.geometry,
61
+ radius=radius,
62
+ segments=u,
63
+ ring_count=v,
64
+ )
65
+
66
+ obj = bpy.context.object
67
+ self.objects.append(obj)
68
+ self.update_object(obj, name=name, color=color, collection=collection)
69
+
70
+ self._guids = [obj]
71
+ return self.guids
@@ -0,0 +1,57 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Polygon
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class PolygonObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing polygons in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ polygon : :class:`compas.geometry.Polygon`
20
+ A COMPAS polygon.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, polygon: Polygon, **kwargs: Any):
27
+ super().__init__(geometry=polygon, **kwargs)
28
+
29
+ def draw(
30
+ self,
31
+ color: Optional[Color] = None,
32
+ collection: Optional[str] = None,
33
+ ) -> list[bpy.types.Object]:
34
+ """Draw the polygon.
35
+
36
+ Parameters
37
+ ----------
38
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
39
+ The RGB color of the polygon.
40
+ collection : str, optional
41
+ The name of the Blender scene collection containing the created object(s).
42
+
43
+ Returns
44
+ -------
45
+ list[:blender:`bpy.types.Object`]
46
+
47
+ """
48
+ name = self.geometry.name
49
+ color = Color.coerce(color) or self.color
50
+
51
+ vertices, faces = self.geometry.to_vertices_and_faces()
52
+ mesh = conversions.vertices_and_faces_to_blender_mesh(vertices, faces, name=self.geometry.name)
53
+ obj = self.create_object(mesh, name=name)
54
+ self.update_object(obj, color=color, collection=collection)
55
+
56
+ self._guids = [obj]
57
+ return self.guids
@@ -0,0 +1,57 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Polyhedron
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class PolyhedronObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing polyhedron shapes in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ polyhedron : :class:`compas.geometry.Polyhedron`
20
+ A COMPAS polyhedron.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, polyhedron: Polyhedron, **kwargs: Any):
27
+ super().__init__(geometry=polyhedron, **kwargs)
28
+
29
+ def draw(self, color: Optional[Color] = None, collection: Optional[str] = None, show_wire: bool = True) -> list[bpy.types.Object]:
30
+ """Draw the polyhedron associated with the scene object.
31
+
32
+ Parameters
33
+ ----------
34
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
35
+ The RGB color of the polyhedron.
36
+ collection : str, optional
37
+ The name of the Blender scene collection containing the created object(s).
38
+ show_wire : bool, optional
39
+ Display the wireframe of the polyhedron.
40
+
41
+ Returns
42
+ -------
43
+ list[:blender:`bpy.types.Object`]
44
+ The objects created in Blender.
45
+
46
+ """
47
+ name = self.geometry.name
48
+ color = Color.coerce(color) or self.color
49
+
50
+ vertices, faces = self.geometry.to_vertices_and_faces()
51
+ mesh = conversions.vertices_and_faces_to_blender_mesh(vertices, faces, name=self.geometry.name)
52
+
53
+ obj = self.create_object(mesh, name=name)
54
+ self.update_object(obj, color=color, collection=collection, show_wire=show_wire)
55
+
56
+ self._guids = [obj]
57
+ return self.guids
@@ -0,0 +1,54 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Polyline
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class PolylineObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing polylines in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ polyline : :class:`compas.geometry.Polyline`
20
+ A COMPAS polyline.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, polyline: Polyline, **kwargs: Any):
27
+ super().__init__(geometry=polyline, **kwargs)
28
+
29
+ def draw(self, color: Optional[Color] = None, collection: Optional[str] = None) -> list[bpy.types.Object]:
30
+ """Draw the line.
31
+
32
+ Parameters
33
+ ----------
34
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
35
+ The RGB color of the polyline.
36
+ collection : str, optional
37
+ The name of the Blender scene collection containing the created object(s).
38
+
39
+ Returns
40
+ -------
41
+ list[:blender:`bpy.types.Object`]
42
+ The objects created in Blender.
43
+
44
+ """
45
+ name = self.geometry.name
46
+ color = Color.coerce(color) or self.color
47
+
48
+ curve = conversions.polyline_to_blender_curve(self.geometry, name=name)
49
+
50
+ obj = self.create_object(curve, name=name)
51
+ self.update_object(obj, color=color, collection=collection)
52
+
53
+ self._guids = [obj]
54
+ return self.guids
@@ -0,0 +1,249 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+ from typing import Union
4
+
5
+ import bpy # type: ignore
6
+
7
+ import compas_blender
8
+ from compas.colors import Color
9
+ from compas.geometry import Transformation
10
+ from compas.scene import SceneObject
11
+ from compas_blender import conversions
12
+
13
+
14
+ class BlenderSceneObject(SceneObject):
15
+ """Base class for all Blender scene objects.
16
+
17
+ Parameters
18
+ ----------
19
+ collection : str | :blender:`bpy.types.Collection`, optional
20
+ The Blender scene collection the object(s) created by the scene object belong to.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ Attributes
25
+ ----------
26
+ objects : list[:blender:`bpy.types.Object`]
27
+ The Blender objects created by the scene object.
28
+
29
+ """
30
+
31
+ def __init__(self, **kwargs: Any):
32
+ super().__init__(**kwargs)
33
+ self.objects = []
34
+
35
+ # many of the methods below will be added to a general scene object in the future
36
+ # to make them universaly accessible they are added here for now
37
+
38
+ # =============================================================================
39
+ # Objects
40
+ # =============================================================================
41
+
42
+ def create_object(self, geometry: Union[bpy.types.Mesh, bpy.types.Curve], name: Optional[str] = None) -> bpy.types.Object:
43
+ """Add an object to the Blender scene.
44
+
45
+ Parameters
46
+ ----------
47
+ geometry : :blender:`bpy.types.Mesh` | :blender:`bpy.types.Curve`
48
+ The Blender object data.
49
+ name : str, optional
50
+ The name of the object.
51
+
52
+ Returns
53
+ -------
54
+ :blender:`bpy.types.Object`
55
+ The Blender object.
56
+
57
+ """
58
+ obj = bpy.data.objects.new(name, geometry)
59
+ self.objects.append(obj)
60
+ return obj
61
+
62
+ def update_object(
63
+ self,
64
+ obj: bpy.types.Object,
65
+ name: Optional[str] = None,
66
+ color: Optional[Color] = None,
67
+ collection: Optional[str] = None,
68
+ transformation: Optional[Transformation] = None,
69
+ show_wire: Optional[bool] = False,
70
+ ) -> None:
71
+ """Update an object in the Blender scene.
72
+
73
+ Parameters
74
+ ----------
75
+ obj : :blender:`bpy.types.Object`
76
+ The Blender object data.
77
+ name : str, optional
78
+ The name of the object.
79
+ color : :class:`compas.colors.Color`, optional
80
+ The color specification.
81
+ collection : str, optional
82
+ The collection to which the object should be added.
83
+ transformation : :class:`compas.geometry.Transformation`, optional
84
+ The transformation to apply to the object.
85
+ show_wire : bool, optional
86
+ Show the wireframe of the object.
87
+
88
+ Returns
89
+ -------
90
+ None
91
+
92
+ """
93
+ if show_wire:
94
+ obj.show_wire = True
95
+
96
+ if name:
97
+ obj.name = name
98
+
99
+ if color:
100
+ self.set_object_color(obj, color)
101
+
102
+ self.set_object_tranformation(obj, transformation)
103
+ self.add_object_to_collection(obj, collection)
104
+
105
+ def add_object_to_collection(self, obj: bpy.types.Object, name: Optional[str] = None, do_unlink: Optional[bool] = True) -> bpy.types.Collection:
106
+ """Add an object to a collection.
107
+
108
+ Parameters
109
+ ----------
110
+ obj : :blender:`bpy.types.Object`
111
+ The Blender object.
112
+ name : str, optional
113
+ The name of the collection to which the object should be added.
114
+
115
+ Returns
116
+ -------
117
+ :blender:`bpy.types.Collection`
118
+
119
+ """
120
+ if name:
121
+ collection = self.create_collection(name)
122
+ else:
123
+ collection = bpy.context.scene.collection
124
+
125
+ if do_unlink:
126
+ for c in obj.users_collection:
127
+ c.objects.unlink(obj)
128
+
129
+ collection.objects.link(obj)
130
+ return collection
131
+
132
+ def set_object_color(self, obj: bpy.types.Object, color: Color) -> None:
133
+ """Set the color of a Blender object.
134
+
135
+ Parameters
136
+ ----------
137
+ obj : :class:`bpy.types.Object`
138
+ The Blender object.
139
+ color : rgb1 | rgb255 | :class:`compas.colors.Color`
140
+ The color specification.
141
+
142
+ Returns
143
+ -------
144
+ None
145
+
146
+ """
147
+ color = Color.coerce(color) # type: ignore
148
+ if not color:
149
+ return
150
+
151
+ material = conversions.color_to_blender_material(color)
152
+ obj.color = color.rgba
153
+ if obj.data.materials:
154
+ obj.data.materials[0] = material
155
+ else:
156
+ obj.data.materials.append(material)
157
+ obj.active_material = material
158
+
159
+ def set_object_tranformation(self, obj: bpy.types.Object, transformation: Optional[Transformation] = None) -> None:
160
+ """Set the transformation of a Blender object.
161
+
162
+ Parameters
163
+ ----------
164
+ obj : :class:`bpy.types.Object`
165
+ The Blender object.
166
+ transformation : :class:`compas.geometry.Transformation`
167
+ The transformation.
168
+
169
+ Returns
170
+ -------
171
+ None
172
+
173
+ """
174
+ if transformation:
175
+ obj.transformation = transformation
176
+
177
+ obj.matrix_world = conversions.transformation_to_blender(self.worldtransformation)
178
+
179
+ # =============================================================================
180
+ # Collections
181
+ # =============================================================================
182
+
183
+ def create_collection(self, name: str) -> bpy.types.Collection:
184
+ """Create a collection with the given name.
185
+
186
+ Parameters
187
+ ----------
188
+ name : str
189
+ The name of the collection.
190
+ parent : bpy.types.Collection, optional
191
+ A parent collection.
192
+
193
+ Returns
194
+ -------
195
+ :blender:`bpy.types.Collection`
196
+
197
+ """
198
+ parts = name.split("::")
199
+ parent = bpy.context.scene.collection
200
+ collection = None
201
+ for index, name in enumerate(parts):
202
+ if index > 0:
203
+ name = f"{parent.name}::{name}"
204
+ if name not in bpy.data.collections:
205
+ collection = bpy.data.collections.new(name)
206
+ parent.children.link(collection)
207
+ else:
208
+ collection = bpy.data.collections[name]
209
+ parent = collection
210
+ return collection
211
+
212
+ def clear_collection(self, name: str, include_children: Optional[bool] = True) -> None:
213
+ """Clear the objects in a collection.
214
+
215
+ Parameters
216
+ ----------
217
+ name : str
218
+ The name of the collection to clear.
219
+ include_children : bool, optional
220
+ Clear the children collections as well.
221
+
222
+ Returns
223
+ -------
224
+ None
225
+
226
+ """
227
+ if name not in bpy.data.collections:
228
+ return
229
+ compas_blender.clear_collection(name)
230
+ if include_children:
231
+ collection = bpy.data.collections.get(name)
232
+ for child in collection.children:
233
+ self.clear_collection(child.name)
234
+
235
+ def delete_collection(self, name: str) -> None:
236
+ """Delete a collection.
237
+
238
+ Parameters
239
+ ----------
240
+ name : str
241
+ The name of the collection to delete.
242
+
243
+ Returns
244
+ -------
245
+ None
246
+
247
+ """
248
+ self.clear_collection(name)
249
+ bpy.data.collections.remove(bpy.data.collections[name])
@@ -0,0 +1,72 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Sphere
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class SphereObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing sphere shapes in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ sphere : :class:`compas.geometry.Sphere`
20
+ A COMPAS sphere.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, sphere: Sphere, **kwargs: Any):
27
+ super().__init__(geometry=sphere, **kwargs)
28
+
29
+ def draw(
30
+ self,
31
+ color: Optional[Color] = None,
32
+ collection: Optional[str] = None,
33
+ u: int = 16,
34
+ v: int = 16,
35
+ show_wire: bool = False,
36
+ shade_smooth: bool = True,
37
+ ) -> list[bpy.types.Object]:
38
+ """Draw the sphere associated with the scene object.
39
+
40
+ Parameters
41
+ ----------
42
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
43
+ The RGB color of the sphere.
44
+ collection : str, optional
45
+ The name of the Blender scene collection containing the created object(s).
46
+ u : int, optional
47
+ Number of faces in the "u" direction.
48
+ v : int, optional
49
+ Number of faces in the "v" direction.
50
+ show_wire : bool, optional
51
+ Display the wireframe of the sphere.
52
+ shade_smooth : bool, optional
53
+ Display smooth shading on the sphere.
54
+
55
+ Returns
56
+ -------
57
+ list[:blender:`bpy.types.Object`]
58
+ The objects created in Blender.
59
+ """
60
+ name = self.geometry.name
61
+ color = Color.coerce(color) or self.color
62
+
63
+ vertices, faces = self.geometry.to_vertices_and_faces(u=u, v=v)
64
+ mesh = conversions.vertices_and_faces_to_blender_mesh(vertices, faces, name=self.geometry.name)
65
+ if shade_smooth:
66
+ mesh.shade_smooth()
67
+
68
+ obj = self.create_object(mesh, name=name)
69
+ self.update_object(obj, color=color, collection=collection, show_wire=show_wire)
70
+
71
+ self._guids = [obj]
72
+ return self.guids
@@ -0,0 +1,54 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Surface
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class SurfaceObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing surfaces in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ surface : :class:`compas.geometry.Surface`
20
+ A COMPAS surface.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, surface: Surface, **kwargs: Any):
27
+ super().__init__(geometry=surface, **kwargs)
28
+
29
+ def draw(self, color: Optional[Color] = None, collection: Optional[str] = None) -> list[bpy.types.Object]:
30
+ """Draw the surface.
31
+
32
+ Parameters
33
+ ----------
34
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
35
+ The RGB color of the surface.
36
+ collection : str, optional
37
+ The name of the Blender scene collection containing the created object(s).
38
+
39
+ Returns
40
+ -------
41
+ list[:blender:`bpy.types.Object`]
42
+ The objects created in Blender.
43
+
44
+ """
45
+ name = self.geometry.name
46
+ color = Color.coerce(color) or self.color
47
+
48
+ surface = conversions.nurbssurface_to_blender_surface(self.geometry)
49
+
50
+ obj = self.create_object(surface, name=name)
51
+ self.update_object(obj, color=color, collection=collection)
52
+
53
+ self._guids = [obj]
54
+ return self.guids
@@ -0,0 +1,73 @@
1
+ from typing import Any
2
+ from typing import Optional
3
+
4
+ import bpy # type: ignore
5
+
6
+ from compas.colors import Color
7
+ from compas.geometry import Torus
8
+ from compas.scene import GeometryObject
9
+ from compas_blender import conversions
10
+
11
+ from .sceneobject import BlenderSceneObject
12
+
13
+
14
+ class TorusObject(BlenderSceneObject, GeometryObject):
15
+ """Scene object for drawing torus shapes in Blender.
16
+
17
+ Parameters
18
+ ----------
19
+ torus : :class:`compas.geometry.Torus`
20
+ A COMPAS torus.
21
+ **kwargs : dict, optional
22
+ Additional keyword arguments.
23
+
24
+ """
25
+
26
+ def __init__(self, torus: Torus, **kwargs: Any):
27
+ super().__init__(geometry=torus, **kwargs)
28
+
29
+ def draw(
30
+ self,
31
+ color: Optional[Color] = None,
32
+ collection: Optional[str] = None,
33
+ u: Optional[int] = 16,
34
+ v: Optional[int] = 16,
35
+ show_wire: bool = False,
36
+ shade_smooth: bool = True,
37
+ ) -> list[bpy.types.Object]:
38
+ """Draw the torus associated with the scene object.
39
+
40
+ Parameters
41
+ ----------
42
+ color : tuple[float, float, float] | tuple[int, int, int] | :class:`compas.colors.Color`, optional
43
+ The RGB color of the torus.
44
+ collection : str, optional
45
+ The name of the Blender scene collection containing the created object(s).
46
+ u : int, optional
47
+ Number of faces in the "u" direction.
48
+ v : int, optional
49
+ Number of faces in the "v" direction.
50
+ show_wire : bool, optional
51
+ Display the wireframe of the torus.
52
+ shade_smooth : bool, optional
53
+ Display smooth shading on the torus.
54
+
55
+ Returns
56
+ -------
57
+ list[:blender:`bpy.types.Curve`]
58
+ The objects created in Blender.
59
+
60
+ """
61
+ name = self.geometry.name
62
+ color = Color.coerce(color) or self.color
63
+
64
+ vertices, faces = self.geometry.to_vertices_and_faces(u=u, v=v)
65
+ mesh = conversions.vertices_and_faces_to_blender_mesh(vertices, faces, name=self.geometry.name)
66
+ if shade_smooth:
67
+ mesh.shade_smooth()
68
+
69
+ obj = self.create_object(mesh, name=name)
70
+ self.update_object(obj, color=color, collection=collection, show_wire=show_wire)
71
+
72
+ self._guids = [obj]
73
+ return self.guids