kopia lustrzana https://github.com/vilemduha/blendercam
709 wiersze
56 KiB
HTML
709 wiersze
56 KiB
HTML
|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html lang="en" data-content_root="../../" >
|
|
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>fabex.parametric — Fabex 1.0.65 documentation</title>
|
|
|
|
|
|
|
|
<script data-cfasync="false">
|
|
document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
|
|
document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
|
|
</script>
|
|
|
|
<!-- Loaded before other Sphinx assets -->
|
|
<link href="../../_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
|
|
<link href="../../_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
|
|
<link href="../../_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
|
|
|
|
|
|
<link href="../../_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
|
|
<link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
|
|
<link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
|
|
<link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
|
|
|
|
<link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=8f2a1f02" />
|
|
<link rel="stylesheet" type="text/css" href="../../_static/styles/sphinx-book-theme.css?v=eba8b062" />
|
|
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css?v=4ae1632d" />
|
|
|
|
<!-- Pre-loaded scripts that we'll load fully later -->
|
|
<link rel="preload" as="script" href="../../_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
|
|
<link rel="preload" as="script" href="../../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
|
|
<script src="../../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
|
|
|
|
<script src="../../_static/documentation_options.js?v=38568b08"></script>
|
|
<script src="../../_static/doctools.js?v=9bcbadda"></script>
|
|
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
|
|
<script src="../../_static/scripts/sphinx-book-theme.js?v=887ef09a"></script>
|
|
<script>DOCUMENTATION_OPTIONS.pagename = '_modules/fabex/parametric';</script>
|
|
<link rel="index" title="Index" href="../../genindex.html" />
|
|
<link rel="search" title="Search" href="../../search.html" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<meta name="docsearch:language" content="en"/>
|
|
</head>
|
|
|
|
|
|
<body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
|
|
|
|
|
|
|
|
<div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
|
|
|
|
<div id="pst-scroll-pixel-helper"></div>
|
|
|
|
<button type="button" class="btn rounded-pill" id="pst-back-to-top">
|
|
<i class="fa-solid fa-arrow-up"></i>Back to top</button>
|
|
|
|
|
|
<input type="checkbox"
|
|
class="sidebar-toggle"
|
|
id="pst-primary-sidebar-checkbox"/>
|
|
<label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
|
|
|
|
<input type="checkbox"
|
|
class="sidebar-toggle"
|
|
id="pst-secondary-sidebar-checkbox"/>
|
|
<label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
|
|
|
|
<div class="search-button__wrapper">
|
|
<div class="search-button__overlay"></div>
|
|
<div class="search-button__search-container">
|
|
<form class="bd-search d-flex align-items-center"
|
|
action="../../search.html"
|
|
method="get">
|
|
<i class="fa-solid fa-magnifying-glass"></i>
|
|
<input type="search"
|
|
class="form-control"
|
|
name="q"
|
|
id="search-input"
|
|
placeholder="Search..."
|
|
aria-label="Search..."
|
|
autocomplete="off"
|
|
autocorrect="off"
|
|
autocapitalize="off"
|
|
spellcheck="false"/>
|
|
<span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
|
|
</form></div>
|
|
</div>
|
|
|
|
<div class="pst-async-banner-revealer d-none">
|
|
<aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
|
|
</div>
|
|
|
|
|
|
<header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
|
|
</header>
|
|
|
|
|
|
<div class="bd-container">
|
|
<div class="bd-container__inner bd-page-width">
|
|
|
|
|
|
|
|
|
|
|
|
<div class="bd-sidebar-primary bd-sidebar">
|
|
|
|
|
|
|
|
<div class="sidebar-header-items sidebar-primary__section">
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
<div class="sidebar-primary-items__start sidebar-primary__section">
|
|
<div class="sidebar-primary-item">
|
|
|
|
|
|
|
|
|
|
|
|
<a class="navbar-brand logo" href="../../index.html">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<img src="../../_static/Fabex_logo_square.png" class="logo__image only-light" alt="Fabex 1.0.65 documentation - Home"/>
|
|
<script>document.write(`<img src="../../_static/Fabex_logo_square.png" class="logo__image only-dark" alt="Fabex 1.0.65 documentation - Home"/>`);</script>
|
|
|
|
|
|
</a></div>
|
|
<div class="sidebar-primary-item"><ul class="navbar-icon-links"
|
|
aria-label="Icon Links">
|
|
<li class="nav-item">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a href="https://github.com/pppalain/blendercam" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-square-github fa-lg" aria-hidden="true"></i>
|
|
<span class="sr-only">GitHub</span></a>
|
|
</li>
|
|
<li class="nav-item">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a href="https://riot.im/app/#/room/#blendercam:matrix.org" title="Matrix" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-solid fa-comments fa-lg" aria-hidden="true"></i>
|
|
<span class="sr-only">Matrix</span></a>
|
|
</li>
|
|
</ul></div>
|
|
<div class="sidebar-primary-item">
|
|
|
|
<script>
|
|
document.write(`
|
|
<button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
|
|
<i class="fa-solid fa-magnifying-glass"></i>
|
|
<span class="search-button__default-text">Search</span>
|
|
<span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
|
|
</button>
|
|
`);
|
|
</script></div>
|
|
<div class="sidebar-primary-item"><nav class="bd-links bd-docs-nav" aria-label="Main">
|
|
<div class="bd-toc-item navbar-nav active">
|
|
<ul class="nav bd-sidenav">
|
|
<li class="toctree-l1 has-children"><a class="reference internal" href="../../users.html">User Guide</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../install.html">Installation</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../starting.html">Getting Started</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../interface.html">User Interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../tools.html">Tools</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../strategies.html">Strategies</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../examplechain.html">Example Chain Workflow</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../faq.html">FAQ</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../glossary.html">Glossary</a></li>
|
|
</ul>
|
|
</details></li>
|
|
<li class="toctree-l1 has-children"><a class="reference internal" href="../../developers.html">Developer Guide</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../overview.html">Code Overview</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../style.html">Style Guide</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../testing.html">Test Suite</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../../workflows.html">Workflows & Actions</a></li>
|
|
</ul>
|
|
</details></li>
|
|
<li class="toctree-l1 has-children"><a class="reference internal" href="../../autoapi/index.html">API Reference</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l2 has-children"><a class="reference internal" href="../../autoapi/fabex/index.html">fabex</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/bas_relief/index.html">fabex.bas_relief</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/bridges/index.html">fabex.bridges</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/cam_chunk/index.html">fabex.cam_chunk</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/collision/index.html">fabex.collision</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/constants/index.html">fabex.constants</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/engine/index.html">fabex.engine</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/exception/index.html">fabex.exception</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/gcode_import_parser/index.html">fabex.gcode_import_parser</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/gcode_path/index.html">fabex.gcode_path</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/involute_gear/index.html">fabex.involute_gear</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/joinery/index.html">fabex.joinery</a></li>
|
|
<li class="toctree-l3 has-children"><a class="reference internal" href="../../autoapi/fabex/operators/index.html">fabex.operators</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/async_op/index.html">fabex.operators.async_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/bas_relief_ops/index.html">fabex.operators.bas_relief_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/bridges_op/index.html">fabex.operators.bridges_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/chain_ops/index.html">fabex.operators.chain_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/curve_create_ops/index.html">fabex.operators.curve_create_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/curve_equation_ops/index.html">fabex.operators.curve_equation_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/curve_tools_ops/index.html">fabex.operators.curve_tools_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/gcode_import_op/index.html">fabex.operators.gcode_import_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/operation_ops/index.html">fabex.operators.operation_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/orient_op/index.html">fabex.operators.orient_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/pack_op/index.html">fabex.operators.pack_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/path_ops/index.html">fabex.operators.path_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/position_op/index.html">fabex.operators.position_op</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/preset_ops/index.html">fabex.operators.preset_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/simulation_ops/index.html">fabex.operators.simulation_ops</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/operators/slice_op/index.html">fabex.operators.slice_op</a></li>
|
|
</ul>
|
|
</details></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/pack/index.html">fabex.pack</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/parametric/index.html">fabex.parametric</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/pattern/index.html">fabex.pattern</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/preferences/index.html">fabex.preferences</a></li>
|
|
<li class="toctree-l3 has-children"><a class="reference internal" href="../../autoapi/fabex/properties/index.html">fabex.properties</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/chain_props/index.html">fabex.properties.chain_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/info_props/index.html">fabex.properties.info_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/interface_props/index.html">fabex.properties.interface_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/machine_props/index.html">fabex.properties.machine_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/material_props/index.html">fabex.properties.material_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/movement_props/index.html">fabex.properties.movement_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/operation_props/index.html">fabex.properties.operation_props</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/properties/optimisation_props/index.html">fabex.properties.optimisation_props</a></li>
|
|
</ul>
|
|
</details></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/puzzle_joinery/index.html">fabex.puzzle_joinery</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/simulation/index.html">fabex.simulation</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/slice/index.html">fabex.slice</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/strategy/index.html">fabex.strategy</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/testing/index.html">fabex.testing</a></li>
|
|
<li class="toctree-l3 has-children"><a class="reference internal" href="../../autoapi/fabex/utilities/index.html">fabex.utilities</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/addon_utils/index.html">fabex.utilities.addon_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/async_utils/index.html">fabex.utilities.async_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/bounds_utils/index.html">fabex.utilities.bounds_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/chunk_utils/index.html">fabex.utilities.chunk_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/compare_utils/index.html">fabex.utilities.compare_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/dict_utils/index.html">fabex.utilities.dict_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/geom_utils/index.html">fabex.utilities.geom_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/image_utils/index.html">fabex.utilities.image_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/index_utils/index.html">fabex.utilities.index_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/loop_utils/index.html">fabex.utilities.loop_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/machine_utils/index.html">fabex.utilities.machine_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/material_utils/index.html">fabex.utilities.material_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/numba_utils/index.html">fabex.utilities.numba_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/ocl_utils/index.html">fabex.utilities.ocl_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/operation_utils/index.html">fabex.utilities.operation_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/orient_utils/index.html">fabex.utilities.orient_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/shapely_utils/index.html">fabex.utilities.shapely_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/simple_utils/index.html">fabex.utilities.simple_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/strategy_utils/index.html">fabex.utilities.strategy_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/thread_utils/index.html">fabex.utilities.thread_utils</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../../autoapi/fabex/utilities/version_utils/index.html">fabex.utilities.version_utils</a></li>
|
|
</ul>
|
|
</details></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/version/index.html">fabex.version</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../../autoapi/fabex/voronoi/index.html">fabex.voronoi</a></li>
|
|
</ul>
|
|
</details></li>
|
|
</ul>
|
|
</details></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</nav></div>
|
|
</div>
|
|
|
|
|
|
<div class="sidebar-primary-items__end sidebar-primary__section">
|
|
</div>
|
|
|
|
<div id="rtd-footer-container"></div>
|
|
|
|
|
|
</div>
|
|
|
|
<main id="main-content" class="bd-main" role="main">
|
|
|
|
|
|
|
|
<div class="sbt-scroll-pixel-helper"></div>
|
|
|
|
<div class="bd-content">
|
|
<div class="bd-article-container">
|
|
|
|
<div class="bd-header-article d-print-none">
|
|
<div class="header-article-items header-article__inner">
|
|
|
|
<div class="header-article-items__start">
|
|
|
|
<div class="header-article-item"><button class="sidebar-toggle primary-toggle btn btn-sm" title="Toggle primary sidebar" data-bs-placement="bottom" data-bs-toggle="tooltip">
|
|
<span class="fa-solid fa-bars"></span>
|
|
</button></div>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="header-article-items__end">
|
|
|
|
<div class="header-article-item">
|
|
|
|
<div class="article-header-buttons">
|
|
|
|
|
|
|
|
<button onclick="toggleFullScreen()"
|
|
class="btn btn-sm btn-fullscreen-button"
|
|
title="Fullscreen mode"
|
|
data-bs-placement="bottom" data-bs-toggle="tooltip"
|
|
>
|
|
|
|
|
|
<span class="btn__icon-container">
|
|
<i class="fas fa-expand"></i>
|
|
</span>
|
|
|
|
</button>
|
|
|
|
|
|
|
|
<script>
|
|
document.write(`
|
|
<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
|
|
<i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
|
|
<i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
|
|
<i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
|
|
</button>
|
|
`);
|
|
</script>
|
|
|
|
|
|
<script>
|
|
document.write(`
|
|
<button class="btn btn-sm pst-navbar-icon search-button search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
|
|
<i class="fa-solid fa-magnifying-glass fa-lg"></i>
|
|
</button>
|
|
`);
|
|
</script>
|
|
|
|
</div></div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div id="jb-print-docs-body" class="onlyprint">
|
|
<h1></h1>
|
|
<!-- Table of contents -->
|
|
<div id="print-main-content">
|
|
<div id="jb-print-toc">
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div id="searchbox"></div>
|
|
<article class="bd-article">
|
|
|
|
<h1>Source code for fabex.parametric</h1><div class="highlight"><pre>
|
|
<span></span><span class="sd">"""Fabex 'parametric.py' © 2019 Devon (Gorialis) R</span>
|
|
|
|
<span class="sd">MIT License</span>
|
|
|
|
<span class="sd">Permission is hereby granted, free of charge, to any person obtaining a copy</span>
|
|
<span class="sd">of this software and associated documentation files (the "Software"), to deal</span>
|
|
<span class="sd">in the Software without restriction, including without limitation the rights</span>
|
|
<span class="sd">to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
|
|
<span class="sd">copies of the Software, and to permit persons to whom the Software is</span>
|
|
<span class="sd">furnished to do so, subject to the following conditions:</span>
|
|
|
|
<span class="sd">The above copyright notice and this permission notice shall be included in all</span>
|
|
<span class="sd">copies or substantial portions of the Software.</span>
|
|
|
|
<span class="sd">THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
|
|
<span class="sd">IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
|
|
<span class="sd">FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
|
|
<span class="sd">AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
|
|
<span class="sd">LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
|
|
<span class="sd">OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE</span>
|
|
|
|
<span class="sd">Summary:</span>
|
|
<span class="sd">Create a Blender curve from a 3D parametric function.</span>
|
|
<span class="sd">This allows for a 3D plot to be made of the function, which can be converted into a mesh.</span>
|
|
|
|
<span class="sd">I have documented the inner workings here, but if you're not interested and just want to</span>
|
|
<span class="sd">suit this to your own function, scroll down to the bottom and edit the `f(t)` function and</span>
|
|
<span class="sd">the iteration count to your liking.</span>
|
|
|
|
<span class="sd">This code has been checked to work on Blender 2.92.</span>
|
|
<span class="sd">"""</span>
|
|
|
|
<span class="kn">from</span><span class="w"> </span><span class="nn">math</span><span class="w"> </span><span class="kn">import</span> <span class="nb">pow</span>
|
|
|
|
<span class="kn">import</span><span class="w"> </span><span class="nn">bpy</span>
|
|
<span class="kn">from</span><span class="w"> </span><span class="nn">mathutils</span><span class="w"> </span><span class="kn">import</span> <span class="n">Vector</span>
|
|
|
|
|
|
<div class="viewcode-block" id="derive_bezier_handles">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/parametric/index.html#fabex.parametric.derive_bezier_handles">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">derive_bezier_handles</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">,</span> <span class="n">c</span><span class="p">,</span> <span class="n">d</span><span class="p">,</span> <span class="n">tb</span><span class="p">,</span> <span class="n">tc</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""</span>
|
|
<span class="sd"> Derives bezier handles by using the start and end of the curve with 2 intermediate</span>
|
|
<span class="sd"> points to use for interpolation.</span>
|
|
|
|
<span class="sd"> :param a:</span>
|
|
<span class="sd"> The start point.</span>
|
|
<span class="sd"> :param b:</span>
|
|
<span class="sd"> The first mid-point, located at `tb` on the bezier segment, where 0 < `tb` < 1.</span>
|
|
<span class="sd"> :param c:</span>
|
|
<span class="sd"> The second mid-point, located at `tc` on the bezier segment, where 0 < `tc` < 1.</span>
|
|
<span class="sd"> :param d:</span>
|
|
<span class="sd"> The end point.</span>
|
|
<span class="sd"> :param tb:</span>
|
|
<span class="sd"> The position of the first point in the bezier segment.</span>
|
|
<span class="sd"> :param tc:</span>
|
|
<span class="sd"> The position of the second point in the bezier segment.</span>
|
|
<span class="sd"> :return:</span>
|
|
<span class="sd"> A tuple of the two intermediate handles, that is, the right handle of the start point</span>
|
|
<span class="sd"> and the left handle of the end point.</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="c1"># Calculate matrix coefficients</span>
|
|
<span class="n">matrix_a</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="nb">pow</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tb</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span> <span class="o">*</span> <span class="n">tb</span>
|
|
<span class="n">matrix_b</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tb</span><span class="p">)</span> <span class="o">*</span> <span class="nb">pow</span><span class="p">(</span><span class="n">tb</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">matrix_c</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="nb">pow</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tc</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span> <span class="o">*</span> <span class="n">tc</span>
|
|
<span class="n">matrix_d</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tc</span><span class="p">)</span> <span class="o">*</span> <span class="nb">pow</span><span class="p">(</span><span class="n">tc</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Calculate the matrix determinant</span>
|
|
<span class="n">matrix_determinant</span> <span class="o">=</span> <span class="mi">1</span> <span class="o">/</span> <span class="p">((</span><span class="n">matrix_a</span> <span class="o">*</span> <span class="n">matrix_d</span><span class="p">)</span> <span class="o">-</span> <span class="p">(</span><span class="n">matrix_b</span> <span class="o">*</span> <span class="n">matrix_c</span><span class="p">))</span>
|
|
|
|
<span class="c1"># Calculate the components of the target position vector</span>
|
|
<span class="n">final_b</span> <span class="o">=</span> <span class="n">b</span> <span class="o">-</span> <span class="p">(</span><span class="nb">pow</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tb</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="n">a</span><span class="p">)</span> <span class="o">-</span> <span class="p">(</span><span class="nb">pow</span><span class="p">(</span><span class="n">tb</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="n">d</span><span class="p">)</span>
|
|
<span class="n">final_c</span> <span class="o">=</span> <span class="n">c</span> <span class="o">-</span> <span class="p">(</span><span class="nb">pow</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">tc</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="n">a</span><span class="p">)</span> <span class="o">-</span> <span class="p">(</span><span class="nb">pow</span><span class="p">(</span><span class="n">tc</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="n">d</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Multiply the inversed matrix with the position vector to get the handle points</span>
|
|
<span class="n">bezier_b</span> <span class="o">=</span> <span class="n">matrix_determinant</span> <span class="o">*</span> <span class="p">((</span><span class="n">matrix_d</span> <span class="o">*</span> <span class="n">final_b</span><span class="p">)</span> <span class="o">+</span> <span class="p">(</span><span class="o">-</span><span class="n">matrix_b</span> <span class="o">*</span> <span class="n">final_c</span><span class="p">))</span>
|
|
<span class="n">bezier_c</span> <span class="o">=</span> <span class="n">matrix_determinant</span> <span class="o">*</span> <span class="p">((</span><span class="o">-</span><span class="n">matrix_c</span> <span class="o">*</span> <span class="n">final_b</span><span class="p">)</span> <span class="o">+</span> <span class="p">(</span><span class="n">matrix_a</span> <span class="o">*</span> <span class="n">final_c</span><span class="p">))</span>
|
|
|
|
<span class="c1"># Return the handle points</span>
|
|
<span class="k">return</span> <span class="n">bezier_b</span><span class="p">,</span> <span class="n">bezier_c</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="create_parametric_curve">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/parametric/index.html#fabex.parametric.create_parametric_curve">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">create_parametric_curve</span><span class="p">(</span>
|
|
<span class="n">function</span><span class="p">,</span>
|
|
<span class="o">*</span><span class="n">args</span><span class="p">,</span>
|
|
<span class="nb">min</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="mf">0.0</span><span class="p">,</span>
|
|
<span class="nb">max</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="mf">1.0</span><span class="p">,</span>
|
|
<span class="n">use_cubic</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">iterations</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">8</span><span class="p">,</span>
|
|
<span class="n">resolution_u</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">10</span><span class="p">,</span>
|
|
<span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
|
|
<span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""</span>
|
|
<span class="sd"> Creates a Blender bezier curve object from a parametric function.</span>
|
|
<span class="sd"> This "plots" the function in 3D space from `min <= t <= max`.</span>
|
|
|
|
<span class="sd"> :param function:</span>
|
|
<span class="sd"> The function to plot as a Blender curve.</span>
|
|
|
|
<span class="sd"> This function should take in a float value of `t` and return a 3-item tuple or list</span>
|
|
<span class="sd"> of the X, Y and Z coordinates at that point:</span>
|
|
<span class="sd"> `function(t) -> (x, y, z)`</span>
|
|
|
|
<span class="sd"> `t` is plotted according to `min <= t <= max`, but if `use_cubic` is enabled, this function</span>
|
|
<span class="sd"> needs to be able to take values less than `min` and greater than `max`.</span>
|
|
<span class="sd"> :param *args:</span>
|
|
<span class="sd"> Additional positional arguments to be passed to the plotting function.</span>
|
|
<span class="sd"> These are not required.</span>
|
|
<span class="sd"> :param use_cubic:</span>
|
|
<span class="sd"> Whether or not to calculate the cubic bezier handles as to create smoother splines.</span>
|
|
<span class="sd"> Turning this off reduces calculation time and memory usage, but produces more jagged</span>
|
|
<span class="sd"> splines with sharp edges.</span>
|
|
<span class="sd"> :param iterations:</span>
|
|
<span class="sd"> The 'subdivisions' of the parametric to plot.</span>
|
|
<span class="sd"> Setting this higher produces more accurate curves but increases calculation time and</span>
|
|
<span class="sd"> memory usage.</span>
|
|
<span class="sd"> :param resolution_u:</span>
|
|
<span class="sd"> The preview surface resolution in the U direction of the bezier curve.</span>
|
|
<span class="sd"> Setting this to a higher value produces smoother curves in rendering, and increases the</span>
|
|
<span class="sd"> number of vertices the curve will get if converted into a mesh (e.g. for edge looping)</span>
|
|
<span class="sd"> :param **kwargs:</span>
|
|
<span class="sd"> Additional keyword arguments to be passed to the plotting function.</span>
|
|
<span class="sd"> These are not required.</span>
|
|
<span class="sd"> :return:</span>
|
|
<span class="sd"> The new Blender object.</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="c1"># Create the Curve to populate with points.</span>
|
|
<span class="n">curve</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">curves</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="s2">"Parametric"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="s2">"CURVE"</span><span class="p">)</span>
|
|
<span class="n">curve</span><span class="o">.</span><span class="n">dimensions</span> <span class="o">=</span> <span class="s2">"3D"</span>
|
|
<span class="n">curve</span><span class="o">.</span><span class="n">resolution_u</span> <span class="o">=</span> <span class="mi">30</span>
|
|
|
|
<span class="c1"># Add a new spline and give it the appropriate amount of points</span>
|
|
<span class="n">spline</span> <span class="o">=</span> <span class="n">curve</span><span class="o">.</span><span class="n">splines</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="s2">"BEZIER"</span><span class="p">)</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">iterations</span><span class="p">)</span>
|
|
|
|
<span class="k">if</span> <span class="n">use_cubic</span> <span class="ow">and</span> <span class="n">iterations</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">points</span> <span class="o">=</span> <span class="p">[</span>
|
|
<span class="n">function</span><span class="p">(((</span><span class="n">i</span> <span class="o">-</span> <span class="mi">3</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">iterations</span><span class="p">))</span> <span class="o">*</span> <span class="p">(</span><span class="nb">max</span> <span class="o">-</span> <span class="nb">min</span><span class="p">)</span> <span class="o">+</span> <span class="nb">min</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
|
|
<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">((</span><span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="n">iterations</span> <span class="o">+</span> <span class="mi">2</span><span class="p">))</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span>
|
|
<span class="p">]</span>
|
|
|
|
<span class="c1"># Convert intermediate points into handles</span>
|
|
<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">iterations</span> <span class="o">+</span> <span class="mi">2</span><span class="p">):</span>
|
|
<span class="n">a</span> <span class="o">=</span> <span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)]</span>
|
|
<span class="n">b</span> <span class="o">=</span> <span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span><span class="p">]</span>
|
|
<span class="n">c</span> <span class="o">=</span> <span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)</span> <span class="o">+</span> <span class="mi">2</span><span class="p">]</span>
|
|
<span class="n">d</span> <span class="o">=</span> <span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)</span> <span class="o">+</span> <span class="mi">3</span><span class="p">]</span>
|
|
|
|
<span class="n">bezier_bx</span><span class="p">,</span> <span class="n">bezier_cx</span> <span class="o">=</span> <span class="n">derive_bezier_handles</span><span class="p">(</span><span class="n">a</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">b</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">c</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">d</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mi">1</span> <span class="o">/</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">2</span> <span class="o">/</span> <span class="mi">3</span><span class="p">)</span>
|
|
<span class="n">bezier_by</span><span class="p">,</span> <span class="n">bezier_cy</span> <span class="o">=</span> <span class="n">derive_bezier_handles</span><span class="p">(</span><span class="n">a</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">b</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">c</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">d</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="mi">1</span> <span class="o">/</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">2</span> <span class="o">/</span> <span class="mi">3</span><span class="p">)</span>
|
|
<span class="n">bezier_bz</span><span class="p">,</span> <span class="n">bezier_cz</span> <span class="o">=</span> <span class="n">derive_bezier_handles</span><span class="p">(</span><span class="n">a</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">b</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">c</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">d</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="mi">1</span> <span class="o">/</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">2</span> <span class="o">/</span> <span class="mi">3</span><span class="p">)</span>
|
|
|
|
<span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">bezier_bx</span><span class="p">,</span> <span class="n">bezier_by</span><span class="p">,</span> <span class="n">bezier_bz</span><span class="p">)</span>
|
|
<span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="n">i</span><span class="p">)</span> <span class="o">+</span> <span class="mi">2</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">bezier_cx</span><span class="p">,</span> <span class="n">bezier_cy</span><span class="p">,</span> <span class="n">bezier_cz</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Set point coordinates and handles</span>
|
|
<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">iterations</span> <span class="o">+</span> <span class="mi">1</span><span class="p">):</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">co</span> <span class="o">=</span> <span class="n">points</span><span class="p">[</span><span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)]</span>
|
|
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_left_type</span> <span class="o">=</span> <span class="s2">"FREE"</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_left</span> <span class="o">=</span> <span class="n">Vector</span><span class="p">(</span><span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">))</span> <span class="o">-</span> <span class="mi">1</span><span class="p">])</span>
|
|
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_right_type</span> <span class="o">=</span> <span class="s2">"FREE"</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_right</span> <span class="o">=</span> <span class="n">Vector</span><span class="p">(</span><span class="n">points</span><span class="p">[(</span><span class="mi">3</span> <span class="o">*</span> <span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">))</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
|
|
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">points</span> <span class="o">=</span> <span class="p">[</span><span class="n">function</span><span class="p">(</span><span class="n">i</span> <span class="o">/</span> <span class="n">iterations</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">iterations</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)]</span>
|
|
|
|
<span class="c1"># Set point coordinates, disable handles</span>
|
|
<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">iterations</span> <span class="o">+</span> <span class="mi">1</span><span class="p">):</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">co</span> <span class="o">=</span> <span class="n">points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_left_type</span> <span class="o">=</span> <span class="s2">"VECTOR"</span>
|
|
<span class="n">spline</span><span class="o">.</span><span class="n">bezier_points</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">handle_right_type</span> <span class="o">=</span> <span class="s2">"VECTOR"</span>
|
|
|
|
<span class="c1"># Create the Blender object and link it to the scene</span>
|
|
<span class="n">curve_object</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="s2">"Parametric"</span><span class="p">,</span> <span class="n">curve</span><span class="p">)</span>
|
|
<span class="n">context</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">context</span>
|
|
<span class="n">scene</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="n">scene</span>
|
|
<span class="n">link_object</span> <span class="o">=</span> <span class="n">scene</span><span class="o">.</span><span class="n">collection</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">link</span>
|
|
<span class="n">link_object</span><span class="p">(</span><span class="n">curve_object</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Return the new object</span>
|
|
<span class="k">return</span> <span class="n">curve_object</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="make_edge_loops">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/parametric/index.html#fabex.parametric.make_edge_loops">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">make_edge_loops</span><span class="p">(</span><span class="o">*</span><span class="n">objects</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""</span>
|
|
<span class="sd"> Turns a set of Curve objects into meshes, creates vertex groups,</span>
|
|
<span class="sd"> and merges them into a set of edge loops.</span>
|
|
|
|
<span class="sd"> :param *objects:</span>
|
|
<span class="sd"> Positional arguments for each object to be converted and merged.</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">context</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">context</span>
|
|
<span class="n">scene</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="n">scene</span>
|
|
|
|
<span class="n">mesh_objects</span> <span class="o">=</span> <span class="p">[]</span>
|
|
<span class="n">vertex_groups</span> <span class="o">=</span> <span class="p">[]</span>
|
|
|
|
<span class="c1"># Convert all curves to meshes</span>
|
|
<span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">objects</span><span class="p">:</span>
|
|
<span class="c1"># Unlink old object</span>
|
|
<span class="n">unlink_object</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Convert curve to a mesh</span>
|
|
<span class="k">if</span> <span class="n">bpy</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">version</span> <span class="o">>=</span> <span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">80</span><span class="p">):</span>
|
|
<span class="n">new_mesh</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">to_mesh</span><span class="p">()</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">new_mesh</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">to_mesh</span><span class="p">(</span><span class="n">scene</span><span class="p">,</span> <span class="kc">False</span><span class="p">,</span> <span class="s2">"PREVIEW"</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Store name and matrix, then fully delete the old object</span>
|
|
<span class="n">name</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">name</span>
|
|
<span class="n">matrix</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">matrix_world</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Attach the new mesh to a new object with the old name</span>
|
|
<span class="n">new_object</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">new_mesh</span><span class="p">)</span>
|
|
<span class="n">new_object</span><span class="o">.</span><span class="n">matrix_world</span> <span class="o">=</span> <span class="n">matrix</span>
|
|
|
|
<span class="c1"># Make a new vertex group from all vertices on this mesh</span>
|
|
<span class="n">vertex_group</span> <span class="o">=</span> <span class="n">new_object</span><span class="o">.</span><span class="n">vertex_groups</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
|
|
<span class="n">vertex_group</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">new_mesh</span><span class="o">.</span><span class="n">vertices</span><span class="p">)),</span> <span class="mf">1.0</span><span class="p">,</span> <span class="s2">"ADD"</span><span class="p">)</span>
|
|
|
|
<span class="n">vertex_groups</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">vertex_group</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Link our new object</span>
|
|
<span class="n">link_object</span><span class="p">(</span><span class="n">new_object</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Add it to our list</span>
|
|
<span class="n">mesh_objects</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">new_object</span><span class="p">)</span>
|
|
|
|
<span class="c1"># Make a new context</span>
|
|
<span class="n">ctx</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
|
|
|
|
<span class="c1"># Select our objects in the context</span>
|
|
<span class="n">ctx</span><span class="p">[</span><span class="s2">"active_object"</span><span class="p">]</span> <span class="o">=</span> <span class="n">mesh_objects</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
|
|
<span class="n">ctx</span><span class="p">[</span><span class="s2">"selected_objects"</span><span class="p">]</span> <span class="o">=</span> <span class="n">mesh_objects</span>
|
|
<span class="k">if</span> <span class="n">bpy</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">version</span> <span class="o">>=</span> <span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">80</span><span class="p">):</span>
|
|
<span class="n">ctx</span><span class="p">[</span><span class="s2">"selected_editable_objects"</span><span class="p">]</span> <span class="o">=</span> <span class="n">mesh_objects</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">ctx</span><span class="p">[</span><span class="s2">"selected_editable_bases"</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">scene</span><span class="o">.</span><span class="n">object_bases</span><span class="p">[</span><span class="n">o</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> <span class="k">for</span> <span class="n">o</span> <span class="ow">in</span> <span class="n">mesh_objects</span><span class="p">]</span>
|
|
|
|
<span class="c1"># Join them together</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">object</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">ctx</span><span class="p">)</span></div>
|
|
|
|
</pre></div>
|
|
|
|
</article>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<footer class="prev-next-footer d-print-none">
|
|
|
|
<div class="prev-next-area">
|
|
</div>
|
|
</footer>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
<footer class="bd-footer-content">
|
|
|
|
<div class="bd-footer-content__inner container">
|
|
|
|
<div class="footer-item">
|
|
|
|
<p class="component-author">
|
|
By Vilem Novak, Alain Pelletier & Contributors
|
|
</p>
|
|
|
|
</div>
|
|
|
|
<div class="footer-item">
|
|
|
|
|
|
<p class="copyright">
|
|
|
|
© Copyright 2025.
|
|
<br/>
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
<div class="footer-item">
|
|
|
|
</div>
|
|
|
|
<div class="footer-item">
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</footer>
|
|
|
|
|
|
</main>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Scripts loaded after <body> so the DOM is not blocked -->
|
|
<script src="../../_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
|
|
<script src="../../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
|
|
|
|
<footer class="bd-footer">
|
|
</footer>
|
|
</body>
|
|
</html> |