kopia lustrzana https://github.com/vilemduha/blendercam
1412 wiersze
133 KiB
HTML
1412 wiersze
133 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.joinery — 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/joinery';</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.joinery</h1><div class="highlight"><pre>
|
|
<span></span><span class="sd">"""Fabex 'joinery.py' © 2021 Alain Pelletier</span>
|
|
|
|
<span class="sd">Functions to create various woodworking joints - mortise, finger etc.</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="p">(</span>
|
|
<span class="n">asin</span><span class="p">,</span>
|
|
<span class="n">atan2</span><span class="p">,</span>
|
|
<span class="n">degrees</span><span class="p">,</span>
|
|
<span class="n">hypot</span><span class="p">,</span>
|
|
<span class="n">pi</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
|
|
<span class="kn">from</span><span class="w"> </span><span class="nn">shapely.geometry</span><span class="w"> </span><span class="kn">import</span> <span class="p">(</span>
|
|
<span class="n">LineString</span><span class="p">,</span>
|
|
<span class="n">Point</span><span class="p">,</span>
|
|
<span class="p">)</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">.</span><span class="w"> </span><span class="kn">import</span> <span class="n">puzzle_joinery</span>
|
|
|
|
<span class="kn">from</span><span class="w"> </span><span class="nn">.utilities.shapely_utils</span><span class="w"> </span><span class="kn">import</span> <span class="n">shapely_to_curve</span>
|
|
<span class="kn">from</span><span class="w"> </span><span class="nn">.utilities.simple_utils</span><span class="w"> </span><span class="kn">import</span> <span class="p">(</span>
|
|
<span class="n">active_name</span><span class="p">,</span>
|
|
<span class="n">union</span><span class="p">,</span>
|
|
<span class="n">rotate</span><span class="p">,</span>
|
|
<span class="n">move</span><span class="p">,</span>
|
|
<span class="n">remove_doubles</span><span class="p">,</span>
|
|
<span class="n">join_multiple</span><span class="p">,</span>
|
|
<span class="n">duplicate</span><span class="p">,</span>
|
|
<span class="n">add_rectangle</span><span class="p">,</span>
|
|
<span class="n">mirror_y</span><span class="p">,</span>
|
|
<span class="n">difference</span><span class="p">,</span>
|
|
<span class="n">make_active</span><span class="p">,</span>
|
|
<span class="n">remove_multiple</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
|
|
|
|
<span class="c1"># boolean operations for curve objects</span>
|
|
|
|
|
|
<div class="viewcode-block" id="finger_amount">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.finger_amount">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">finger_amount</span><span class="p">(</span><span class="n">space</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Calculates the amount of fingers needed from the available space vs the size of the finger</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> space (float):available distance to cover</span>
|
|
<span class="sd"> size (float): size of the finger</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">finger_amt</span> <span class="o">=</span> <span class="n">space</span> <span class="o">/</span> <span class="n">size</span>
|
|
<span class="k">if</span> <span class="p">(</span><span class="n">finger_amt</span> <span class="o">%</span> <span class="mi">1</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">finger_amt</span> <span class="o">=</span> <span class="nb">round</span><span class="p">(</span><span class="n">finger_amt</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span>
|
|
<span class="k">if</span> <span class="p">(</span><span class="n">finger_amt</span> <span class="o">%</span> <span class="mi">2</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">finger_amt</span> <span class="o">=</span> <span class="nb">round</span><span class="p">(</span><span class="n">finger_amt</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span>
|
|
<span class="k">return</span> <span class="n">finger_amt</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="mortise">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.mortise">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">cx</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">cy</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">rotation</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates a mortise of length, thickness and finger_play tolerance</span>
|
|
<span class="sd"> cx and cy are the center position and rotation is the angle</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): length of the mortise</span>
|
|
<span class="sd"> thickness (float): thickness of material</span>
|
|
<span class="sd"> finger_play (float): tolerance for good fit</span>
|
|
<span class="sd"> cx (float): coordinate for x center of the finger</span>
|
|
<span class="sd"> cy (float):coordinate for y center of the finger</span>
|
|
<span class="sd"> rotation (float): angle of rotation</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="n">cx</span><span class="p">,</span> <span class="n">cy</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">rotation</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">length</span> <span class="o">+</span> <span class="n">finger_play</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">thickness</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_mortise"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="interlock_groove">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.interlock_groove">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">interlock_groove</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">cx</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">cy</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">rotation</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates an interlocking groove.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of groove</span>
|
|
<span class="sd"> thickness (float): thickness of groove</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> cx (float): center offset x</span>
|
|
<span class="sd"> cy (float): center offset y</span>
|
|
<span class="sd"> rotation (float): angle of rotation</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">transform</span><span class="o">.</span><span class="n">translate</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="p">(</span><span class="n">length</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">-</span> <span class="n">finger_play</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">))</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">transform_apply</span><span class="p">(</span><span class="n">location</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">rotation</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">scale</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">context</span><span class="o">.</span><span class="n">active_object</span><span class="o">.</span><span class="n">rotation_euler</span><span class="o">.</span><span class="n">z</span> <span class="o">=</span> <span class="n">rotation</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">transform</span><span class="o">.</span><span class="n">translate</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="p">(</span><span class="n">cx</span><span class="p">,</span> <span class="n">cy</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">))</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_groove"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="interlock_twist">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.interlock_twist">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">interlock_twist</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">cx</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">cy</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">rotation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">percentage</span><span class="o">=</span><span class="mf">0.5</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates an interlocking twist.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of groove</span>
|
|
<span class="sd"> thickness (float): thickness of groove</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> cx (float): center offset x</span>
|
|
<span class="sd"> cy (float): center offset y</span>
|
|
<span class="sd"> rotation (float): angle of rotation</span>
|
|
<span class="sd"> percentage (float): percentage amount the twist will take (between 0 and 1)</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_tmp"</span><span class="p">)</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span> <span class="o">*</span> <span class="n">percentage</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_tmp"</span><span class="p">)</span>
|
|
<span class="n">h</span> <span class="o">=</span> <span class="n">hypot</span><span class="p">(</span><span class="n">thickness</span><span class="p">,</span> <span class="n">length</span> <span class="o">*</span> <span class="n">percentage</span><span class="p">)</span>
|
|
<span class="n">oangle</span> <span class="o">=</span> <span class="n">degrees</span><span class="p">(</span><span class="n">asin</span><span class="p">(</span><span class="n">length</span> <span class="o">*</span> <span class="n">percentage</span> <span class="o">/</span> <span class="n">h</span><span class="p">))</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Sector"</span><span class="p">,</span>
|
|
<span class="n">Simple_startangle</span><span class="o">=</span><span class="mi">90</span> <span class="o">+</span> <span class="n">oangle</span><span class="p">,</span>
|
|
<span class="n">Simple_endangle</span><span class="o">=</span><span class="mi">180</span> <span class="o">-</span> <span class="n">oangle</span><span class="p">,</span>
|
|
<span class="n">Simple_radius</span><span class="o">=</span><span class="n">h</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_tmp"</span><span class="p">)</span>
|
|
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Sector"</span><span class="p">,</span>
|
|
<span class="n">Simple_startangle</span><span class="o">=</span><span class="mi">270</span> <span class="o">+</span> <span class="n">oangle</span><span class="p">,</span>
|
|
<span class="n">Simple_endangle</span><span class="o">=</span><span class="mi">360</span> <span class="o">-</span> <span class="n">oangle</span><span class="p">,</span>
|
|
<span class="n">Simple_radius</span><span class="o">=</span><span class="n">h</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_tmp"</span><span class="p">)</span>
|
|
|
|
<span class="n">union</span><span class="p">(</span><span class="s2">"_tmp"</span><span class="p">)</span>
|
|
<span class="n">rotate</span><span class="p">(</span><span class="n">rotation</span><span class="p">)</span>
|
|
<span class="n">move</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">cx</span><span class="p">,</span> <span class="n">y</span><span class="o">=</span><span class="n">cy</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_groove"</span><span class="p">)</span>
|
|
<span class="n">remove_doubles</span><span class="p">()</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="twist_line">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.twist_line">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">twist_line</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">percentage</span><span class="p">,</span> <span class="n">amount</span><span class="p">,</span> <span class="n">distance</span><span class="p">,</span> <span class="n">center</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates a multiple interlocking twist.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of groove</span>
|
|
<span class="sd"> thickness (float): thickness of groove</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> percentage (float): percentage amount the twist will take (between 0 and 1)</span>
|
|
<span class="sd"> amount (int):amount of twists generated</span>
|
|
<span class="sd"> distance (float): distance between twists</span>
|
|
<span class="sd"> center (bool): center or not from origin</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">spacing</span> <span class="o">=</span> <span class="n">distance</span> <span class="o">/</span> <span class="n">amount</span>
|
|
<span class="k">while</span> <span class="n">amount</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">position</span> <span class="o">=</span> <span class="n">spacing</span> <span class="o">*</span> <span class="n">amount</span>
|
|
<span class="n">interlock_twist</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">percentage</span><span class="o">=</span><span class="n">percentage</span><span class="p">,</span> <span class="n">cx</span><span class="o">=</span><span class="n">position</span><span class="p">)</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Twistline"</span><span class="p">,</span> <span class="n">amount</span><span class="p">,</span> <span class="n">distance</span><span class="p">,</span> <span class="n">position</span><span class="p">)</span>
|
|
<span class="n">amount</span> <span class="o">-=</span> <span class="mi">1</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_groove"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"twist_line"</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">center</span><span class="p">:</span>
|
|
<span class="n">move</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="p">(</span><span class="o">-</span><span class="n">distance</span> <span class="o">-</span> <span class="n">spacing</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="twist_separator_slot">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.twist_separator_slot">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">twist_separator_slot</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="o">=</span><span class="mf">0.00005</span><span class="p">,</span> <span class="n">percentage</span><span class="o">=</span><span class="mf">0.5</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates a slot for interlocking twist separator.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of slot</span>
|
|
<span class="sd"> thickness (float): thickness of slot</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> percentage (float): percentage amount the twist will take (between 0 and 1)</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">add_rectangle</span><span class="p">(</span><span class="n">thickness</span> <span class="o">+</span> <span class="n">finger_play</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="n">length</span><span class="p">,</span> <span class="n">center_y</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
|
|
<span class="n">move</span><span class="p">(</span><span class="n">y</span><span class="o">=</span><span class="p">((</span><span class="n">length</span> <span class="o">*</span> <span class="n">percentage</span> <span class="o">-</span> <span class="n">finger_play</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span><span class="p">))</span>
|
|
<span class="n">duplicate</span><span class="p">()</span>
|
|
<span class="n">mirror_y</span><span class="p">()</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"simple_rectangle"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_separator_slot"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="interlock_twist_separator">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.interlock_twist_separator">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">interlock_twist_separator</span><span class="p">(</span>
|
|
<span class="n">length</span><span class="p">,</span>
|
|
<span class="n">thickness</span><span class="p">,</span>
|
|
<span class="n">amount</span><span class="p">,</span>
|
|
<span class="n">spacing</span><span class="p">,</span>
|
|
<span class="n">edge_distance</span><span class="p">,</span>
|
|
<span class="n">finger_play</span><span class="o">=</span><span class="mf">0.00005</span><span class="p">,</span>
|
|
<span class="n">percentage</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
|
|
<span class="n">start</span><span class="o">=</span><span class="s2">"rounded"</span><span class="p">,</span>
|
|
<span class="n">end</span><span class="o">=</span><span class="s2">"rounded"</span><span class="p">,</span>
|
|
<span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates a interlocking twist separator.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of separator</span>
|
|
<span class="sd"> thickness (float): thickness of separator</span>
|
|
<span class="sd"> amount (int): quantity of separation grooves</span>
|
|
<span class="sd"> spacing (float): distance between slots</span>
|
|
<span class="sd"> edge_distance (float): distance of the first slots close to the edge</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> percentage (float): percentage amount the twist will take (between 0 and 1)</span>
|
|
<span class="sd"> start (string): type of start wanted (rounded, flat or other) not implemented</span>
|
|
<span class="sd"> start (string): type of end wanted (rounded, flat or other) not implemented</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">amount</span> <span class="o">-=</span> <span class="mi">1</span>
|
|
<span class="n">base_width</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">edge_distance</span> <span class="o">+</span> <span class="n">spacing</span> <span class="o">*</span> <span class="n">amount</span> <span class="o">+</span> <span class="n">thickness</span>
|
|
<span class="n">add_rectangle</span><span class="p">(</span><span class="n">base_width</span><span class="p">,</span> <span class="n">length</span> <span class="o">-</span> <span class="n">finger_play</span> <span class="o">*</span> <span class="mi">2</span><span class="p">,</span> <span class="n">center_x</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="n">twist_separator_slot</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">percentage</span><span class="p">)</span>
|
|
<span class="k">while</span> <span class="n">amount</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">duplicate</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">spacing</span><span class="p">)</span>
|
|
<span class="n">amount</span> <span class="o">-=</span> <span class="mi">1</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_separator_slot"</span><span class="p">)</span>
|
|
<span class="n">move</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">edge_distance</span> <span class="o">+</span> <span class="n">thickness</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">difference</span><span class="p">(</span><span class="s2">"_"</span><span class="p">,</span> <span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"twist_separator"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="horizontal_finger">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.horizontal_finger">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">horizontal_finger</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">amount</span><span class="p">,</span> <span class="n">center</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates an interlocking horizontal finger pair _wfa and _wfb.</span>
|
|
|
|
<span class="sd"> _wfa is centered at 0,0</span>
|
|
<span class="sd"> _wfb is _wfa offset by one length</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of mortise</span>
|
|
<span class="sd"> thickness (float): thickness of material</span>
|
|
<span class="sd"> amount (int): quantity of fingers</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> center (bool): centered of not</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="k">if</span> <span class="n">center</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">amount</span><span class="p">):</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">thickness</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_width_finger"</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">i</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">length</span><span class="p">,</span> <span class="n">thickness</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_width_finger"</span><span class="p">)</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="o">-</span><span class="n">i</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">length</span><span class="p">,</span> <span class="n">thickness</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_width_finger"</span><span class="p">)</span>
|
|
<span class="k">else</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">amount</span><span class="p">):</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">length</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">i</span> <span class="o">*</span> <span class="n">length</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_width_finger"</span><span class="p">)</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_width_finger"</span><span class="p">)</span>
|
|
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_wfa"</span><span class="p">)</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">duplicate_move</span><span class="p">(</span>
|
|
<span class="n">OBJECT_OT_duplicate</span><span class="o">=</span><span class="p">{</span><span class="s2">"linked"</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">:</span> <span class="s2">"TRANSLATION"</span><span class="p">},</span>
|
|
<span class="n">TRANSFORM_OT_translate</span><span class="o">=</span><span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)},</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_wfb"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="vertical_finger">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.vertical_finger">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">vertical_finger</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="n">amount</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates an interlocking horizontal finger pair _vfa and _vfb.</span>
|
|
|
|
<span class="sd"> _vfa is starts at 0,0</span>
|
|
<span class="sd"> _vfb is _vfa offset by one length</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of mortise</span>
|
|
<span class="sd"> thickness (float): thickness of material</span>
|
|
<span class="sd"> amount (int): quantity of fingers</span>
|
|
<span class="sd"> finger_play (float): tolerance for proper fit</span>
|
|
<span class="sd"> """</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">amount</span><span class="p">):</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">thickness</span><span class="p">,</span> <span class="n">finger_play</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">i</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">length</span> <span class="o">+</span> <span class="n">length</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="n">rotation</span><span class="o">=</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_height_finger"</span><span class="p">)</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_height_finger"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_vfa"</span><span class="p">)</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">duplicate_move</span><span class="p">(</span>
|
|
<span class="n">OBJECT_OT_duplicate</span><span class="o">=</span><span class="p">{</span><span class="s2">"linked"</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">:</span> <span class="s2">"TRANSLATION"</span><span class="p">},</span>
|
|
<span class="n">TRANSFORM_OT_translate</span><span class="o">=</span><span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="o">-</span><span class="n">length</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)},</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_vfb"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="finger_pair">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.finger_pair">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">finger_pair</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">dx</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">dy</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Creates a duplicate set of fingers.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> name (str): name of original finger</span>
|
|
<span class="sd"> dx (float): x offset</span>
|
|
<span class="sd"> dy (float): y offset</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">make_active</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
|
|
<span class="n">xpos</span> <span class="o">=</span> <span class="p">(</span><span class="n">dx</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span> <span class="o">*</span> <span class="mf">1.006</span>
|
|
<span class="n">ypos</span> <span class="o">=</span> <span class="mf">1.006</span> <span class="o">*</span> <span class="n">dy</span> <span class="o">/</span> <span class="mi">2</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">duplicate_move</span><span class="p">(</span>
|
|
<span class="n">OBJECT_OT_duplicate</span><span class="o">=</span><span class="p">{</span><span class="s2">"linked"</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">:</span> <span class="s2">"TRANSLATION"</span><span class="p">},</span>
|
|
<span class="n">TRANSFORM_OT_translate</span><span class="o">=</span><span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="p">(</span><span class="n">xpos</span><span class="p">,</span> <span class="n">ypos</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)},</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_finger_pair"</span><span class="p">)</span>
|
|
|
|
<span class="n">make_active</span><span class="p">(</span><span class="n">name</span><span class="p">)</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">duplicate_move</span><span class="p">(</span>
|
|
<span class="n">OBJECT_OT_duplicate</span><span class="o">=</span><span class="p">{</span><span class="s2">"linked"</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">:</span> <span class="s2">"TRANSLATION"</span><span class="p">},</span>
|
|
<span class="n">TRANSFORM_OT_translate</span><span class="o">=</span><span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="p">(</span><span class="o">-</span><span class="n">xpos</span><span class="p">,</span> <span class="o">-</span><span class="n">ypos</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)},</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_finger_pair"</span><span class="p">)</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_finger_pair"</span><span class="p">)</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">select_all</span><span class="p">(</span><span class="n">action</span><span class="o">=</span><span class="s2">"DESELECT"</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">bpy</span><span class="o">.</span><span class="n">context</span><span class="o">.</span><span class="n">active_object</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="create_base_plate">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.create_base_plate">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">create_base_plate</span><span class="p">(</span><span class="n">height</span><span class="p">,</span> <span class="n">width</span><span class="p">,</span> <span class="n">depth</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Creates blank plates for a box.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> height (float): height size for box</span>
|
|
<span class="sd"> width (float): width size for box</span>
|
|
<span class="sd"> depth (float): depth size for box</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">height</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">width</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">height</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_back"</span><span class="p">)</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">height</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">depth</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">height</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_side"</span><span class="p">)</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">width</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">depth</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_bottom"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="make_flex_pocket">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.make_flex_pocket">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">make_flex_pocket</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">height</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_width</span><span class="p">,</span> <span class="n">pocket_width</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""creates pockets using mortise function for kerf bending</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): Length of pocket</span>
|
|
<span class="sd"> height (float): height of pocket</span>
|
|
<span class="sd"> finger_thick (float): thickness of finger</span>
|
|
<span class="sd"> finger_width (float): width of finger</span>
|
|
<span class="sd"> pocket_width (float): width of pocket</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">dist</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="n">finger_width</span> <span class="o">/</span> <span class="mi">2</span>
|
|
<span class="k">while</span> <span class="n">dist</span> <span class="o"><</span> <span class="n">length</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">height</span> <span class="o">-</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">pocket_width</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">dist</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_flex_pocket"</span><span class="p">)</span>
|
|
<span class="n">dist</span> <span class="o">+=</span> <span class="n">finger_width</span> <span class="o">*</span> <span class="mi">2</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_flex_pocket"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"flex_pocket"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="make_variable_flex_pocket">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.make_variable_flex_pocket">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">make_variable_flex_pocket</span><span class="p">(</span><span class="n">height</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">pocket_width</span><span class="p">,</span> <span class="n">locations</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""creates pockets pocket using mortise function for kerf bending</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> height (float): height of the side</span>
|
|
<span class="sd"> finger_thick (float): thickness of the finger</span>
|
|
<span class="sd"> pocket_width (float): width of pocket</span>
|
|
<span class="sd"> locations (tuple): coordinates for pocket</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="k">for</span> <span class="n">dist</span> <span class="ow">in</span> <span class="n">locations</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">height</span> <span class="o">+</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">pocket_width</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">dist</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_flex_pocket"</span><span class="p">)</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_flex_pocket"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"flex_pocket"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="create_flex_side">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.create_flex_side">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">create_flex_side</span><span class="p">(</span><span class="n">length</span><span class="p">,</span> <span class="n">height</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">top_bottom</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""crates a flex side for mortise on curve. Assumes the base fingers were created and exist</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> length (float): length of curve</span>
|
|
<span class="sd"> height (float): height of side</span>
|
|
<span class="sd"> finger_thick (float): finger thickness or thickness of material</span>
|
|
<span class="sd"> top_bottom (bool): fingers on top and bottom if true, just on bottom if false</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="n">top_bottom</span><span class="p">:</span>
|
|
<span class="n">fingers</span> <span class="o">=</span> <span class="n">finger_pair</span><span class="p">(</span><span class="s2">"base"</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">height</span> <span class="o">-</span> <span class="n">finger_thick</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">make_active</span><span class="p">(</span><span class="s2">"base"</span><span class="p">)</span>
|
|
<span class="n">fingers</span> <span class="o">=</span> <span class="n">bpy</span><span class="o">.</span><span class="n">context</span><span class="o">.</span><span class="n">active_object</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">transform</span><span class="o">.</span><span class="n">translate</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="n">height</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">-</span> <span class="n">finger_thick</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="mf">0.0003</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">))</span>
|
|
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="n">length</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="mf">0.00025</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">length</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">height</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"no_fingers"</span><span class="p">)</span>
|
|
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">curve</span><span class="o">.</span><span class="n">simple</span><span class="p">(</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="n">length</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="mf">0.00025</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">rotation</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">Simple_Type</span><span class="o">=</span><span class="s2">"Rectangle"</span><span class="p">,</span>
|
|
<span class="n">Simple_width</span><span class="o">=</span><span class="n">length</span><span class="p">,</span>
|
|
<span class="n">Simple_length</span><span class="o">=</span><span class="n">height</span><span class="p">,</span>
|
|
<span class="n">shape</span><span class="o">=</span><span class="s2">"3D"</span><span class="p">,</span>
|
|
<span class="n">outputType</span><span class="o">=</span><span class="s2">"POLY"</span><span class="p">,</span>
|
|
<span class="n">use_cyclic_u</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="n">handleType</span><span class="o">=</span><span class="s2">"AUTO"</span><span class="p">,</span>
|
|
<span class="n">edit_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_side"</span><span class="p">)</span>
|
|
|
|
<span class="n">make_active</span><span class="p">(</span><span class="s2">"_side"</span><span class="p">)</span>
|
|
<span class="n">fingers</span><span class="o">.</span><span class="n">select_set</span><span class="p">(</span><span class="kc">True</span><span class="p">)</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">curve_boolean</span><span class="p">(</span><span class="n">boolean_type</span><span class="o">=</span><span class="s2">"DIFFERENCE"</span><span class="p">)</span>
|
|
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"side"</span><span class="p">)</span>
|
|
<span class="n">remove_multiple</span><span class="p">(</span><span class="s2">"_"</span><span class="p">)</span>
|
|
<span class="n">remove_multiple</span><span class="p">(</span><span class="s2">"base"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="angle">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.angle">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">angle</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="w"> </span><span class="sd">"""returns angle of a vector</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> a (tuple): point a x,y coordinates</span>
|
|
<span class="sd"> b (tuple): point b x,y coordinates</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="k">return</span> <span class="n">atan2</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="o">-</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">0</span><span class="p">]</span> <span class="o">-</span> <span class="n">a</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="angle_difference">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.angle_difference">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">angle_difference</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="w"> </span><span class="sd">"""returns the difference between two lines with three points</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> a (tuple): point a x,y coordinates</span>
|
|
<span class="sd"> b (tuple): point b x,y coordinates</span>
|
|
<span class="sd"> c (tuple): point c x,y coordinates</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">return</span> <span class="n">angle</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="o">-</span> <span class="n">angle</span><span class="p">(</span><span class="n">b</span><span class="p">,</span> <span class="n">c</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="fixed_finger">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.fixed_finger">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">fixed_finger</span><span class="p">(</span><span class="n">loop</span><span class="p">,</span> <span class="n">loop_length</span><span class="p">,</span> <span class="n">finger_size</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_tolerance</span><span class="p">,</span> <span class="n">base</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""distributes mortises of a fixed distance. Dynamically changes the finger tolerance with the angle differences</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> loop (list of tuples): takes in a shapely shape</span>
|
|
<span class="sd"> loop_length (float): length of loop</span>
|
|
<span class="sd"> finger_size (float): size of the mortise</span>
|
|
<span class="sd"> finger_thick (float): thickness of the material</span>
|
|
<span class="sd"> finger_tolerance (float): minimum finger tolerance</span>
|
|
<span class="sd"> base (bool): if base exists, it will join with it</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">coords</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">loop</span><span class="o">.</span><span class="n">coords</span><span class="p">)</span>
|
|
<span class="n">old_mortise_angle</span> <span class="o">=</span> <span class="mi">0</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">finger_size</span> <span class="o">/</span> <span class="mi">2</span>
|
|
<span class="n">j</span> <span class="o">=</span> <span class="mi">0</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Joinery Loop Length"</span><span class="p">,</span> <span class="nb">round</span><span class="p">(</span><span class="n">loop_length</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">),</span> <span class="s2">"mm"</span><span class="p">)</span>
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">coords</span><span class="p">):</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">p_start</span> <span class="o">=</span> <span class="n">p</span>
|
|
|
|
<span class="k">if</span> <span class="n">p</span> <span class="o">!=</span> <span class="n">p_start</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">True</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">False</span>
|
|
<span class="n">pd</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">project</span><span class="p">(</span><span class="n">Point</span><span class="p">(</span><span class="n">p</span><span class="p">))</span>
|
|
|
|
<span class="k">if</span> <span class="n">not_start</span><span class="p">:</span>
|
|
<span class="k">while</span> <span class="n">distance</span> <span class="o"><=</span> <span class="n">pd</span><span class="p">:</span>
|
|
<span class="n">mortise_angle</span> <span class="o">=</span> <span class="n">angle</span><span class="p">(</span><span class="n">oldp</span><span class="p">,</span> <span class="n">p</span><span class="p">)</span>
|
|
<span class="n">mortise_angle_difference</span> <span class="o">=</span> <span class="nb">abs</span><span class="p">(</span><span class="n">mortise_angle</span> <span class="o">-</span> <span class="n">old_mortise_angle</span><span class="p">)</span>
|
|
<span class="n">mad</span> <span class="o">=</span> <span class="mi">1</span> <span class="o">+</span> <span class="mi">6</span> <span class="o">*</span> <span class="nb">min</span><span class="p">(</span><span class="n">mortise_angle_difference</span><span class="p">,</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">4</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span>
|
|
<span class="n">pi</span> <span class="o">/</span> <span class="mi">4</span>
|
|
<span class="p">)</span> <span class="c1"># factor for tolerance for the finger</span>
|
|
|
|
<span class="k">if</span> <span class="n">base</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span><span class="n">finger_size</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_tolerance</span> <span class="o">*</span> <span class="n">mad</span><span class="p">,</span> <span class="n">distance</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">mortise_point</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">interpolate</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
<span class="n">mortise</span><span class="p">(</span>
|
|
<span class="n">finger_size</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span> <span class="o">*</span> <span class="n">mad</span><span class="p">,</span>
|
|
<span class="n">mortise_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span>
|
|
<span class="n">mortise_point</span><span class="o">.</span><span class="n">y</span><span class="p">,</span>
|
|
<span class="n">mortise_angle</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
|
|
<span class="n">j</span> <span class="o">+=</span> <span class="mi">1</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">j</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">finger_size</span> <span class="o">+</span> <span class="n">finger_size</span> <span class="o">/</span> <span class="mi">2</span>
|
|
<span class="n">old_mortise_angle</span> <span class="o">=</span> <span class="n">mortise_angle</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="k">if</span> <span class="n">base</span><span class="p">:</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"base"</span><span class="p">)</span>
|
|
<span class="n">move</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">finger_size</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_mort"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"mortise"</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="find_slope">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.find_slope">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">find_slope</span><span class="p">(</span><span class="n">p1</span><span class="p">,</span> <span class="n">p2</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""returns slope of a vector</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> p1 (tuple): point 1 x,y coordinates</span>
|
|
<span class="sd"> p2 (tuple): point 2 x,y coordinates</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">return</span> <span class="p">(</span><span class="n">p2</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">-</span> <span class="n">p1</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="o">/</span> <span class="nb">max</span><span class="p">(</span><span class="n">p2</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">-</span> <span class="n">p1</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mf">0.00001</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="slope_array">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.slope_array">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">slope_array</span><span class="p">(</span><span class="n">loop</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Returns an array of slopes from loop coordinates.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> loop (list of tuples): list of coordinates for a curve</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="n">remove_multiple</span><span class="p">(</span><span class="s2">"-"</span><span class="p">)</span>
|
|
<span class="n">coords</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">loop</span><span class="o">.</span><span class="n">coords</span><span class="p">)</span>
|
|
<span class="c1"># pnt_amount = round(length / resolution)</span>
|
|
<span class="n">sarray</span> <span class="o">=</span> <span class="p">[]</span>
|
|
<span class="n">dsarray</span> <span class="o">=</span> <span class="p">[]</span>
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">coords</span><span class="p">):</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">project</span><span class="p">(</span><span class="n">Point</span><span class="p">(</span><span class="n">p</span><span class="p">))</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">slope</span> <span class="o">=</span> <span class="n">find_slope</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">oldp</span><span class="p">)</span>
|
|
<span class="n">sarray</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">distance</span><span class="p">,</span> <span class="n">slope</span> <span class="o">*</span> <span class="o">-</span><span class="mf">0.001</span><span class="p">))</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sarray</span><span class="p">):</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">p</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">slope</span> <span class="o">=</span> <span class="n">find_slope</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">oldp</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="nb">abs</span><span class="p">(</span><span class="n">slope</span><span class="p">)</span> <span class="o">></span> <span class="mi">10</span><span class="p">:</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
<span class="n">dsarray</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">distance</span><span class="p">,</span> <span class="n">slope</span> <span class="o">*</span> <span class="o">-</span><span class="mf">0.00001</span><span class="p">))</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="n">derivative</span> <span class="o">=</span> <span class="n">LineString</span><span class="p">(</span><span class="n">sarray</span><span class="p">)</span>
|
|
<span class="n">dderivative</span> <span class="o">=</span> <span class="n">LineString</span><span class="p">(</span><span class="n">dsarray</span><span class="p">)</span>
|
|
<span class="n">shapely_to_curve</span><span class="p">(</span><span class="s2">"-derivative"</span><span class="p">,</span> <span class="n">derivative</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)</span>
|
|
<span class="n">shapely_to_curve</span><span class="p">(</span><span class="s2">"-doublederivative"</span><span class="p">,</span> <span class="n">dderivative</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">sarray</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="d_slope_array">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.d_slope_array">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">d_slope_array</span><span class="p">(</span><span class="n">loop</span><span class="p">,</span> <span class="n">resolution</span><span class="o">=</span><span class="mf">0.001</span><span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Returns a double derivative array or slope of the slope</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> loop (list of tuples): list of coordinates for a curve</span>
|
|
<span class="sd"> resolution (float): granular resolution of the array</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">length</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">length</span>
|
|
<span class="n">pnt_amount</span> <span class="o">=</span> <span class="nb">round</span><span class="p">(</span><span class="n">length</span> <span class="o">/</span> <span class="n">resolution</span><span class="p">)</span>
|
|
<span class="n">sarray</span> <span class="o">=</span> <span class="p">[]</span>
|
|
<span class="n">dsarray</span> <span class="o">=</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">pnt_amount</span><span class="p">):</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">i</span> <span class="o">*</span> <span class="n">resolution</span>
|
|
<span class="n">pt</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">interpolate</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
<span class="n">p</span> <span class="o">=</span> <span class="p">(</span><span class="n">pt</span><span class="o">.</span><span class="n">x</span><span class="p">,</span> <span class="n">pt</span><span class="o">.</span><span class="n">y</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">slope</span> <span class="o">=</span> <span class="nb">abs</span><span class="p">(</span><span class="n">angle</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">oldp</span><span class="p">))</span>
|
|
<span class="n">sarray</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">distance</span><span class="p">,</span> <span class="n">slope</span> <span class="o">*</span> <span class="o">-</span><span class="mf">0.01</span><span class="p">))</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sarray</span><span class="p">):</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">p</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">slope</span> <span class="o">=</span> <span class="n">find_slope</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">oldp</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="nb">abs</span><span class="p">(</span><span class="n">slope</span><span class="p">)</span> <span class="o">></span> <span class="mi">10</span><span class="p">:</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
<span class="n">dsarray</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">distance</span><span class="p">,</span> <span class="n">slope</span> <span class="o">*</span> <span class="o">-</span><span class="mf">0.1</span><span class="p">))</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="n">dderivative</span> <span class="o">=</span> <span class="n">LineString</span><span class="p">(</span><span class="n">dsarray</span><span class="p">)</span>
|
|
<span class="n">shapely_to_curve</span><span class="p">(</span><span class="s2">"doublederivative"</span><span class="p">,</span> <span class="n">dderivative</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">sarray</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="variable_finger">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.variable_finger">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">variable_finger</span><span class="p">(</span>
|
|
<span class="n">loop</span><span class="p">,</span>
|
|
<span class="n">loop_length</span><span class="p">,</span>
|
|
<span class="n">min_finger</span><span class="p">,</span>
|
|
<span class="n">finger_size</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span><span class="p">,</span>
|
|
<span class="n">adaptive</span><span class="p">,</span>
|
|
<span class="n">base</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="n">double_adaptive</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Distributes mortises of a fixed distance. Dynamically changes the finger tolerance with the angle differences</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> loop (list of tuples): takes in a shapely shape</span>
|
|
<span class="sd"> loop_length (float): length of loop</span>
|
|
<span class="sd"> finger_size (float): size of the mortise</span>
|
|
<span class="sd"> finger_thick (float): thickness of the material</span>
|
|
<span class="sd"> min_finger (float): minimum finger size</span>
|
|
<span class="sd"> finger_tolerance (float): minimum finger tolerance</span>
|
|
<span class="sd"> adaptive (float): angle threshold to reduce finger size</span>
|
|
<span class="sd"> base (bool): join with base if true</span>
|
|
<span class="sd"> double_adaptive (bool): uses double adaptive algorithm if true</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">coords</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">loop</span><span class="o">.</span><span class="n">coords</span><span class="p">)</span>
|
|
<span class="n">old_mortise_angle</span> <span class="o">=</span> <span class="mi">0</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">min_finger</span> <span class="o">/</span> <span class="mi">2</span>
|
|
<span class="n">finger_sz</span> <span class="o">=</span> <span class="n">min_finger</span>
|
|
<span class="n">oldfinger_sz</span> <span class="o">=</span> <span class="n">min_finger</span>
|
|
<span class="n">hpos</span> <span class="o">=</span> <span class="p">[]</span> <span class="c1"># hpos is the horizontal positions of the middle of the mortise</span>
|
|
<span class="c1"># slope_array(loop)</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Joinery Loop Length"</span><span class="p">,</span> <span class="nb">round</span><span class="p">(</span><span class="n">loop_length</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">),</span> <span class="s2">"mm"</span><span class="p">)</span>
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">coords</span><span class="p">):</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">p_start</span> <span class="o">=</span> <span class="n">p</span>
|
|
|
|
<span class="k">if</span> <span class="n">p</span> <span class="o">!=</span> <span class="n">p_start</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">True</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">False</span>
|
|
<span class="n">pd</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">project</span><span class="p">(</span><span class="n">Point</span><span class="p">(</span><span class="n">p</span><span class="p">))</span>
|
|
|
|
<span class="k">if</span> <span class="n">not_start</span><span class="p">:</span>
|
|
<span class="k">while</span> <span class="n">distance</span> <span class="o"><=</span> <span class="n">pd</span><span class="p">:</span>
|
|
<span class="n">mortise_angle</span> <span class="o">=</span> <span class="n">angle</span><span class="p">(</span><span class="n">oldp</span><span class="p">,</span> <span class="n">p</span><span class="p">)</span>
|
|
<span class="n">mortise_angle_difference</span> <span class="o">=</span> <span class="nb">abs</span><span class="p">(</span><span class="n">mortise_angle</span> <span class="o">-</span> <span class="n">old_mortise_angle</span><span class="p">)</span>
|
|
<span class="n">mad</span> <span class="o">=</span> <span class="mi">1</span> <span class="o">+</span> <span class="mi">6</span> <span class="o">*</span> <span class="nb">min</span><span class="p">(</span><span class="n">mortise_angle_difference</span><span class="p">,</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">4</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span>
|
|
<span class="n">pi</span> <span class="o">/</span> <span class="mi">4</span>
|
|
<span class="p">)</span> <span class="c1"># factor for tolerance for the finger</span>
|
|
<span class="c1"># move finger by the factor mad greater with larger angle difference</span>
|
|
<span class="n">distance</span> <span class="o">+=</span> <span class="n">mad</span> <span class="o">*</span> <span class="n">finger_tolerance</span>
|
|
<span class="n">mortise_point</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">interpolate</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">mad</span> <span class="o">></span> <span class="mi">2</span> <span class="ow">and</span> <span class="n">double_adaptive</span><span class="p">:</span>
|
|
<span class="n">hpos</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span> <span class="c1"># saves the mortise center</span>
|
|
|
|
<span class="n">hpos</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">distance</span> <span class="o">+</span> <span class="n">finger_sz</span><span class="p">)</span> <span class="c1"># saves the mortise center</span>
|
|
<span class="k">if</span> <span class="n">base</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span>
|
|
<span class="n">finger_sz</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_tolerance</span> <span class="o">*</span> <span class="n">mad</span><span class="p">,</span> <span class="n">distance</span> <span class="o">+</span> <span class="n">finger_sz</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">mortise</span><span class="p">(</span>
|
|
<span class="n">finger_sz</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span> <span class="o">*</span> <span class="n">mad</span><span class="p">,</span>
|
|
<span class="n">mortise_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span>
|
|
<span class="n">mortise_point</span><span class="o">.</span><span class="n">y</span><span class="p">,</span>
|
|
<span class="n">mortise_angle</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
|
|
<span class="c1"># put a mesh cylinder at the first coordinates to indicate start</span>
|
|
<span class="n">remove_multiple</span><span class="p">(</span><span class="s2">"start_here"</span><span class="p">)</span>
|
|
<span class="n">bpy</span><span class="o">.</span><span class="n">ops</span><span class="o">.</span><span class="n">mesh</span><span class="o">.</span><span class="n">primitive_cylinder_add</span><span class="p">(</span>
|
|
<span class="n">radius</span><span class="o">=</span><span class="n">finger_thick</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span>
|
|
<span class="n">depth</span><span class="o">=</span><span class="mf">0.025</span><span class="p">,</span>
|
|
<span class="n">enter_editmode</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
|
|
<span class="n">align</span><span class="o">=</span><span class="s2">"WORLD"</span><span class="p">,</span>
|
|
<span class="n">location</span><span class="o">=</span><span class="p">(</span><span class="n">mortise_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span> <span class="n">mortise_point</span><span class="o">.</span><span class="n">y</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span>
|
|
<span class="n">scale</span><span class="o">=</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">),</span>
|
|
<span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"start_here_mortise"</span><span class="p">)</span>
|
|
|
|
<span class="n">old_distance</span> <span class="o">=</span> <span class="n">distance</span>
|
|
<span class="n">old_mortise_point</span> <span class="o">=</span> <span class="n">mortise_point</span>
|
|
<span class="n">finger_sz</span> <span class="o">=</span> <span class="n">finger_size</span>
|
|
<span class="n">next_angle_difference</span> <span class="o">=</span> <span class="n">pi</span>
|
|
|
|
<span class="c1"># adaptive finger length start</span>
|
|
<span class="k">while</span> <span class="n">finger_sz</span> <span class="o">></span> <span class="n">min_finger</span> <span class="ow">and</span> <span class="n">next_angle_difference</span> <span class="o">></span> <span class="n">adaptive</span><span class="p">:</span>
|
|
<span class="c1"># while finger_sz > min_finger and next_angle_difference > adaptive:</span>
|
|
<span class="c1"># reduce the size of finger by a percentage... the closer to 1.0, the slower</span>
|
|
<span class="n">finger_sz</span> <span class="o">*=</span> <span class="mf">0.95</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">old_distance</span> <span class="o">+</span> <span class="mi">3</span> <span class="o">*</span> <span class="n">oldfinger_sz</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="n">finger_sz</span> <span class="o">/</span> <span class="mi">2</span>
|
|
<span class="n">mortise_point</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">interpolate</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span> <span class="c1"># get the next mortise point</span>
|
|
<span class="n">next_mortise_angle</span> <span class="o">=</span> <span class="n">angle</span><span class="p">(</span>
|
|
<span class="p">(</span><span class="n">old_mortise_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span> <span class="n">old_mortise_point</span><span class="o">.</span><span class="n">y</span><span class="p">),</span>
|
|
<span class="p">(</span><span class="n">mortise_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span> <span class="n">mortise_point</span><span class="o">.</span><span class="n">y</span><span class="p">),</span>
|
|
<span class="p">)</span> <span class="c1"># calculate next angle</span>
|
|
<span class="n">next_angle_difference</span> <span class="o">=</span> <span class="nb">abs</span><span class="p">(</span><span class="n">next_mortise_angle</span> <span class="o">-</span> <span class="n">mortise_angle</span><span class="p">)</span>
|
|
|
|
<span class="n">oldfinger_sz</span> <span class="o">=</span> <span class="n">finger_sz</span>
|
|
<span class="n">old_mortise_angle</span> <span class="o">=</span> <span class="n">mortise_angle</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
<span class="k">if</span> <span class="n">base</span><span class="p">:</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_base"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"base"</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Placeholder"</span><span class="p">)</span>
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_mort"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"variable_mortise"</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">hpos</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="single_interlock">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.single_interlock">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">single_interlock</span><span class="p">(</span>
|
|
<span class="n">finger_depth</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span><span class="p">,</span>
|
|
<span class="n">x</span><span class="p">,</span>
|
|
<span class="n">y</span><span class="p">,</span>
|
|
<span class="n">groove_angle</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="p">,</span>
|
|
<span class="n">amount</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
|
|
<span class="n">twist_percentage</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
|
|
<span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Generates a single interlock at coodinate x,y.</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> finger_depth (float): depth of finger</span>
|
|
<span class="sd"> finger_thick (float): thickness of finger</span>
|
|
<span class="sd"> finger_tolerance (float): tolerance for proper fit</span>
|
|
<span class="sd"> x (float): offset x</span>
|
|
<span class="sd"> y (float): offset y</span>
|
|
<span class="sd"> groove_angle (float): angle of rotation</span>
|
|
<span class="sd"> type (str): GROOVE, TWIST, PUZZLE are the valid choices</span>
|
|
<span class="sd"> twist_percentage: percentage of thickness for twist (not used in puzzle or groove)</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="nb">type</span> <span class="o">==</span> <span class="s2">"GROOVE"</span><span class="p">:</span>
|
|
<span class="n">interlock_groove</span><span class="p">(</span><span class="n">finger_depth</span><span class="p">,</span> <span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_tolerance</span><span class="p">,</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">,</span> <span class="n">groove_angle</span><span class="p">)</span>
|
|
<span class="k">elif</span> <span class="nb">type</span> <span class="o">==</span> <span class="s2">"TWIST"</span><span class="p">:</span>
|
|
<span class="n">interlock_twist</span><span class="p">(</span>
|
|
<span class="n">finger_depth</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span><span class="p">,</span>
|
|
<span class="n">x</span><span class="p">,</span>
|
|
<span class="n">y</span><span class="p">,</span>
|
|
<span class="n">groove_angle</span><span class="p">,</span>
|
|
<span class="n">percentage</span><span class="o">=</span><span class="n">twist_percentage</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="k">elif</span> <span class="nb">type</span> <span class="o">==</span> <span class="s2">"PUZZLE"</span><span class="p">:</span>
|
|
<span class="n">puzzle_joinery</span><span class="o">.</span><span class="n">fingers</span><span class="p">(</span><span class="n">finger_thick</span><span class="p">,</span> <span class="n">finger_tolerance</span><span class="p">)</span></div>
|
|
|
|
|
|
|
|
<div class="viewcode-block" id="distributed_interlock">
|
|
<a class="viewcode-back" href="../../autoapi/fabex/joinery/index.html#fabex.joinery.distributed_interlock">[docs]</a>
|
|
<span class="k">def</span><span class="w"> </span><span class="nf">distributed_interlock</span><span class="p">(</span>
|
|
<span class="n">loop</span><span class="p">,</span>
|
|
<span class="n">loop_length</span><span class="p">,</span>
|
|
<span class="n">finger_depth</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span><span class="p">,</span>
|
|
<span class="n">finger_amount</span><span class="p">,</span>
|
|
<span class="n">tangent</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
|
|
<span class="n">fixed_angle</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
|
|
<span class="n">start</span><span class="o">=</span><span class="mf">0.01</span><span class="p">,</span>
|
|
<span class="n">end</span><span class="o">=</span><span class="mf">0.01</span><span class="p">,</span>
|
|
<span class="n">closed</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="o">=</span><span class="s2">"GROOVE"</span><span class="p">,</span>
|
|
<span class="n">twist_percentage</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
|
|
<span class="p">):</span>
|
|
<span class="w"> </span><span class="sd">"""Distributes interlocking joints of a fixed amount.</span>
|
|
<span class="sd"> Dynamically changes the finger tolerance with the angle differences</span>
|
|
|
|
<span class="sd"> Args:</span>
|
|
<span class="sd"> loop (list of tuples): coordinates curve</span>
|
|
<span class="sd"> loop_length (float): length of the curve</span>
|
|
<span class="sd"> finger_depth (float): depth of the mortise</span>
|
|
<span class="sd"> finger_thick (float) thickness of the material</span>
|
|
<span class="sd"> finger_tolerance (float): minimum finger tolerance</span>
|
|
<span class="sd"> finger_amount (int): quantity of fingers</span>
|
|
<span class="sd"> tangent (int):</span>
|
|
<span class="sd"> fixed_angle (float): 0 will be variable, desired angle for the finger</span>
|
|
<span class="sd"> closed (bool): False:open curve - True:closed curved</span>
|
|
<span class="sd"> twist_percentage = portion of twist finger which is the stem (for twist joint only)</span>
|
|
<span class="sd"> type (str): GROOVE, TWIST, PUZZLE are the valid choices</span>
|
|
<span class="sd"> start (float): start distance from first point</span>
|
|
<span class="sd"> end (float): end distance from last point</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">coords</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">loop</span><span class="o">.</span><span class="n">coords</span><span class="p">)</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="n">closed</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="ow">not</span> <span class="n">closed</span><span class="p">:</span>
|
|
<span class="n">spacing</span> <span class="o">=</span> <span class="p">(</span><span class="n">loop_length</span> <span class="o">-</span> <span class="n">start</span> <span class="o">-</span> <span class="n">end</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="n">finger_amount</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">start</span>
|
|
<span class="n">end_distance</span> <span class="o">=</span> <span class="n">loop_length</span> <span class="o">-</span> <span class="n">end</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">spacing</span> <span class="o">=</span> <span class="n">loop_length</span> <span class="o">/</span> <span class="n">finger_amount</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="mi">0</span>
|
|
<span class="n">end_distance</span> <span class="o">=</span> <span class="n">loop_length</span>
|
|
|
|
<span class="n">j</span> <span class="o">=</span> <span class="mi">0</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Joinery Loop Length"</span><span class="p">,</span> <span class="nb">round</span><span class="p">(</span><span class="n">loop_length</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">),</span> <span class="s2">"mm"</span><span class="p">)</span>
|
|
<span class="nb">print</span><span class="p">(</span><span class="s2">"Distance Between Joints"</span><span class="p">,</span> <span class="nb">round</span><span class="p">(</span><span class="n">spacing</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">),</span> <span class="s2">"mm"</span><span class="p">)</span>
|
|
|
|
<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">coords</span><span class="p">):</span>
|
|
<span class="k">if</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">p_start</span> <span class="o">=</span> <span class="n">p</span>
|
|
|
|
<span class="k">if</span> <span class="n">p</span> <span class="o">!=</span> <span class="n">p_start</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">True</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">not_start</span> <span class="o">=</span> <span class="kc">False</span>
|
|
<span class="n">pd</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">project</span><span class="p">(</span><span class="n">Point</span><span class="p">(</span><span class="n">p</span><span class="p">))</span>
|
|
|
|
<span class="k">if</span> <span class="n">not_start</span><span class="p">:</span>
|
|
<span class="k">while</span> <span class="n">distance</span> <span class="o"><=</span> <span class="n">pd</span> <span class="ow">and</span> <span class="n">end_distance</span> <span class="o">>=</span> <span class="n">distance</span><span class="p">:</span>
|
|
<span class="k">if</span> <span class="n">fixed_angle</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
|
<span class="n">groove_angle</span> <span class="o">=</span> <span class="n">angle</span><span class="p">(</span><span class="n">oldp</span><span class="p">,</span> <span class="n">p</span><span class="p">)</span> <span class="o">+</span> <span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="n">tangent</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">groove_angle</span> <span class="o">=</span> <span class="n">fixed_angle</span>
|
|
|
|
<span class="n">groove_point</span> <span class="o">=</span> <span class="n">loop</span><span class="o">.</span><span class="n">interpolate</span><span class="p">(</span><span class="n">distance</span><span class="p">)</span>
|
|
|
|
<span class="nb">print</span><span class="p">(</span>
|
|
<span class="n">j</span><span class="p">,</span>
|
|
<span class="s2">"groove_angle"</span><span class="p">,</span>
|
|
<span class="nb">round</span><span class="p">(</span><span class="mi">180</span> <span class="o">*</span> <span class="n">groove_angle</span> <span class="o">/</span> <span class="n">pi</span><span class="p">),</span>
|
|
<span class="s2">"distance"</span><span class="p">,</span>
|
|
<span class="nb">round</span><span class="p">(</span><span class="n">distance</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">),</span>
|
|
<span class="s2">"mm"</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
<span class="n">single_interlock</span><span class="p">(</span>
|
|
<span class="n">finger_depth</span><span class="p">,</span>
|
|
<span class="n">finger_thick</span><span class="p">,</span>
|
|
<span class="n">finger_tolerance</span><span class="p">,</span>
|
|
<span class="n">groove_point</span><span class="o">.</span><span class="n">x</span><span class="p">,</span>
|
|
<span class="n">groove_point</span><span class="o">.</span><span class="n">y</span><span class="p">,</span>
|
|
<span class="n">groove_angle</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="p">,</span>
|
|
<span class="n">twist_percentage</span><span class="o">=</span><span class="n">twist_percentage</span><span class="p">,</span>
|
|
<span class="p">)</span>
|
|
|
|
<span class="n">j</span> <span class="o">+=</span> <span class="mi">1</span>
|
|
<span class="n">distance</span> <span class="o">=</span> <span class="n">j</span> <span class="o">*</span> <span class="n">spacing</span> <span class="o">+</span> <span class="n">start</span>
|
|
<span class="n">oldp</span> <span class="o">=</span> <span class="n">p</span>
|
|
|
|
<span class="n">join_multiple</span><span class="p">(</span><span class="s2">"_groove"</span><span class="p">)</span>
|
|
<span class="n">active_name</span><span class="p">(</span><span class="s2">"interlock"</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> |