From 3d7dfa0eaa2226d6ea4e4ef876ff0221d68ecc7a Mon Sep 17 00:00:00 2001
From: Ubiratan Santos Freitas <santos@cirp.de>
Date: Thu, 12 Jan 2023 10:27:24 +0100
Subject: [PATCH] Add Blender lattice Add-on
---
Lattesh/.gitignore | 64 ++
Lattesh/LICENSE.txt | 674 +++++++++++++++++++
Lattesh/README.md | 99 +++
Lattesh/__init__.py | 177 +++++
Lattesh/cells/hex.cell | 21 +
Lattesh/cells/type_2.cell | 16 +
Lattesh/cells/type_3.cell | 18 +
Lattesh/cells/type_4.cell | 55 ++
Lattesh/cells/type_5.cell | 57 ++
Lattesh/cells/type_6.cell | 51 ++
Lattesh/cells/type_8.cell | 109 ++++
Lattesh/cells/type_9.cell | 31 +
Lattesh/cells/type_91.cell | 33 +
Lattesh/doc/side_panel.png | Bin 0 -> 61902 bytes
Lattesh/operators.py | 1271 ++++++++++++++++++++++++++++++++++++
Lattesh/ui.py | 126 ++++
16 files changed, 2802 insertions(+)
create mode 100644 Lattesh/.gitignore
create mode 100644 Lattesh/LICENSE.txt
create mode 100644 Lattesh/README.md
create mode 100644 Lattesh/__init__.py
create mode 100644 Lattesh/cells/hex.cell
create mode 100644 Lattesh/cells/type_2.cell
create mode 100644 Lattesh/cells/type_3.cell
create mode 100644 Lattesh/cells/type_4.cell
create mode 100644 Lattesh/cells/type_5.cell
create mode 100644 Lattesh/cells/type_6.cell
create mode 100644 Lattesh/cells/type_8.cell
create mode 100644 Lattesh/cells/type_9.cell
create mode 100644 Lattesh/cells/type_91.cell
create mode 100644 Lattesh/doc/side_panel.png
create mode 100644 Lattesh/operators.py
create mode 100644 Lattesh/ui.py
diff --git a/Lattesh/.gitignore b/Lattesh/.gitignore
new file mode 100644
index 0000000..a8abd06
--- /dev/null
+++ b/Lattesh/.gitignore
@@ -0,0 +1,64 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+# Usually these files are written by a python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Translations
+*.mo
+*.pot
+
+# PyBuilder
+target/
+
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+
+# Rope project settings
+.ropeproject
diff --git a/Lattesh/LICENSE.txt b/Lattesh/LICENSE.txt
new file mode 100644
index 0000000..f288702
--- /dev/null
+++ b/Lattesh/LICENSE.txt
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ <program> Copyright (C) <year> <name of author>
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.
diff --git a/Lattesh/README.md b/Lattesh/README.md
new file mode 100644
index 0000000..f28de14
--- /dev/null
+++ b/Lattesh/README.md
@@ -0,0 +1,99 @@
+# Lattesh
+## A Blender Add-on for mesh-based lattice processing
+
+The *Lattesh* Add-on contains a set of tools for the creation and manipulation
+of lattices in [Blender](https://www.blender.org). There are software tools
+with good support for lattices, but those are proprietary and expensive.
+This Add-on provides a basic alternative.
+
+The Add-on is programed in Python. It is designed to process rectangular lattices
+of cells composed of strait cylindrical struts.
+### Lattices
+
+The design was focused on speed and ease of lattice processing. This was achieved
+by representing lattices as skeletons, were struts are just edges connecting two
+vertices. A watertight mesh giving the lattice a volume is only created as a last
+step in the lattice processing.
+
+Internally, lattices are represented in the Add-on as (degeneraded) meshes with only
+vertices and edges. The standard mesh object from Blender is used. The generated
+lattices can be manipulated using common Blender tools, but lacking faces and
+having an unsusual topology make this editing limited.
+
+### Features
+
+The main features of the add-on are lattice creation, volume filling, and final
+mesh generation. In creating a lattice, the user can choose the grid dimensions,
+that is, the number of cells in each direction, the cell size and the cell type.
+All these parameters are available in the add-on’s graphic interface. A lattice
+is then generated in the form of a rectangular regular grid of cubic cells of
+the chosen cell type.
+
+New cell types can be easily added via a cell definition file, where the cell
+geometry is described in a text-based file format.
+
+More complex lattices can be generated using volume filling. In this feature,
+a watertight mesh representing the desired form of the lattice is taken as input.
+The add-on then fills this volume with a lattice of the chosen cell geometry.
+
+Finally, a 3D print-ready lattice can be obtained by giving a thickness to a
+lattice skeleton. In this feature, each edge in the input lattice skeleton
+will generate a cylindrical strut with a user-defined radius. Strut unions
+in vertices are geometrically correct and correspond to geometrical boolean
+unions of the cylindrical struts. The generated mesh is watertight and care
+was taken to avoid redundant faces and vertices, leading to a smaller mesh size.
+The resulting mesh is significantly smaller than what can be obtained by an
+algorithm like marching cubes.
+
+The geometrical boolean operations are computed using the
+Open CASCADE Technology library, an open source geometrical library.
+These operations are computationally expensive, so the Add-on uses the
+regularity of the lattices to reuse the result of these operations on similar
+vertices. This leads to very efficient computation on regular lattices.
+The boolean operations are also notoriously unreliable. The Add-on then detects
+when these fail and takes measures to correct them when needed.
+
+### User interface
+
+The Add-on provides a graphical user interface in the form of a panel in the
+side bar of the 3D Viewport. The panel is depicted below.
+
+
+
+The top part contains the parameters for regular lattice generation. The
+parameters are:
+ - **Cell size**: the length defining the individual cells.
+ - **Cell type**: the cell type defines the topology of the individual cells.
+ - **Number of cells**: lattice grid dimensions, that is, how many cells will
+ be on the *x*, *y*, and *z* directions.
+
+Clicking on the **Create Mesh Lattice** will create a rectangular lattice with
+these parameters.
+
+If a mesh object is selected, clicking on **Fill Mesh Lattice** will create a
+regular lattice of *cell size* and *cell type* that fills the selected object.
+
+If a lattice is selected (or any mesh object), an **Opencascade fill** menu is
+available. Upon clicking on **Lattice Volume (OCC)**, the lattice will be given
+a volume, where for each edge in the original object a cylindrical strut will
+be created. The strut radius is available as an input parameter.
+
+This operation will take only some seconds for very regular lattices, but a large
+irregular lattice can take several hours to process. In this case, the add-on prints
+messages on the terminal relating the progress.
+
+### Installation
+
+The Add-on is installed as usual in Blender via the *Preferences* menu. However,
+the python distribution in Blender needs extra packages. These are:
+ - NumPy
+ - SciPy
+ - [PythonOCC](https://github.com/tpaviot/pythonocc)
+
+While the former two can be easily installed via `pip`, the latter needs either
+building from source other installing with *conda*. See the installation intructions
+in *PythonOCC*. If the *conda* route is used, Blender will need to access the *conda*
+python environment. This can be achieved by creating a *conda* environment with
+the required packages and copying it to the place where Blender keeps its python
+distribution, after moving or deleting the original folder. The *conda* python
+ version (major and minor) must match the one shipped with Blender.
\ No newline at end of file
diff --git a/Lattesh/__init__.py b/Lattesh/__init__.py
new file mode 100644
index 0000000..e1a0717
--- /dev/null
+++ b/Lattesh/__init__.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2023 Ubiratan S. Freitas
+
+
+# This file is part of Lattesh.
+#
+# Lattesh is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your option)
+# any later version.
+#
+# Lattesh is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+# more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# Lattice Tools. If not, see <https://www.gnu.org/licenses/>.
+
+
+bl_info = {
+ "name": "Lattice Tools",
+ "author": "Ubiratan S. Freitas",
+ "blender": (2, 80, 0),
+ "description": "Tools for generating lattice structures",
+ "category": "Add Mesh",
+}
+
+
+
+
+
+
+if "bpy" in locals():
+ import importlib
+ importlib.reload(operators)
+ importlib.reload(ui)
+else:
+ import bpy
+ from bpy.types import PropertyGroup
+ from bpy.props import (
+ BoolProperty,
+ FloatProperty,
+ EnumProperty,
+ IntVectorProperty,
+ PointerProperty,
+ )
+
+ from . import (
+ operators,
+ ui,
+ )
+
+
+cell_items = operators.cell_items
+
+class SceneProperties(PropertyGroup):
+ r_ratio: FloatProperty(
+ name="R_ratio",
+ description="Ratio of actual radius to metaball radius",
+ default=0.8,
+ min=0.01,
+ max=0.99,
+ )
+
+ radius: FloatProperty(
+ name="Radius",
+ description="Actual radius of resulting mesh",
+ default=0.5,
+ min=1.0e-6,
+ max=20.0,
+ unit='LENGTH',
+ )
+
+ cellsize: FloatProperty(
+ name="Cell size",
+ description="Cell size",
+ default=10,
+ min=1.0e-2,
+ unit='LENGTH',
+ )
+
+ nelems: IntVectorProperty(
+ name="Nr. cells",
+ description="Number of cells in each direction",
+ default=(5, 5, 3),
+ min=1,
+ size=3,
+ )
+
+ celltype: EnumProperty(
+ items=cell_items,
+ name="Cell type",
+ description="Cell type",
+ default=cell_items[0][0],
+ )
+
+ connect_boundary: BoolProperty(
+ name="Connect Boundary",
+ description="Connect Boundary",
+ default=False,
+ )
+
+ charac_length: FloatProperty(
+ name="Caracteristic length",
+ description="Caracteristic length",
+ default=10,
+ min=1.0e-2,
+ unit='LENGTH',
+ )
+
+ lin_deflect: FloatProperty(
+ name="Linear deflection",
+ description="Maximum linear deflection for tesselation",
+ default=0.1,
+ min=1.0e-6,
+ max=2.0,
+ unit='LENGTH',
+ )
+
+ ang_deflect: FloatProperty(
+ name="Angular deflection",
+ description="Maximum angular deflection for tesselation",
+ default=1.5707963267948966, # 90 degrees in radians
+ min=1.0e-3,
+ max=2.0943951023931953, # 120 degrees in radians
+ subtype='ANGLE',
+ unit='ROTATION',
+ )
+
+
+
+
+classes = [
+ SceneProperties,
+ ui.VIEW3D_PT_lattices_generate,
+ ui.VIEW3D_PT_lattice_metaball,
+ ui.VIEW3D_PT_lattice_OCC,
+ operators.ObjectOCCLattice,
+ operators.ObjectMetaLattice,
+ operators.ObjectCreateMeshLattice,
+ operators.ObjectFillMeshLattice,
+]
+
+if operators.have_scipy:
+ classes.append(operators.ObjectFillVoronoiLattice)
+
+
+def menu_func(self, context):
+ for cl in classes:
+ if cl is not SceneProperties:
+ self.layout.operator(cl.bl_idname)
+
+
+
+
+def register():
+ for cls in classes:
+ bpy.utils.register_class(cls)
+ bpy.types.Scene.lattice_mesh = PointerProperty(type=SceneProperties)
+ bpy.types.VIEW3D_MT_object.append(menu_func)
+
+
+
+
+def unregister():
+ for cls in classes:
+ bpy.utils.unregister_class(cls)
+ del bpy.types.Scene.lattice_mesh
+ bpy.types.VIEW3D_MT_object.remove(menu_func)
+
+if __name__ == "__main__":
+ register()
+
+
+
diff --git a/Lattesh/cells/hex.cell b/Lattesh/cells/hex.cell
new file mode 100644
index 0000000..1f8dbdc
--- /dev/null
+++ b/Lattesh/cells/hex.cell
@@ -0,0 +1,21 @@
+HEX
+0.0, 0.0, 0.0
+1.0, 0.0, 0.0
+0.0, 1.0, 0.0
+1.0, 1.0, 0.0
+0.0, 0.0, 1.0
+1.0, 0.0, 1.0
+0.0, 1.0, 1.0
+1.0, 1.0, 1.0
+0, 1
+2, 3
+4, 5
+6, 7
+0, 2
+1, 3
+4, 6
+5, 7
+0, 4
+1, 5
+2, 6
+3, 7
diff --git a/Lattesh/cells/type_2.cell b/Lattesh/cells/type_2.cell
new file mode 100644
index 0000000..c3a4fac
--- /dev/null
+++ b/Lattesh/cells/type_2.cell
@@ -0,0 +1,16 @@
+TYPE_2
+0.5, 0.5, 0.5
+0, 0.5, 0
+0, 0.5, 1
+1, 0.5, 0
+1, 0.5, 1
+0.5, 0, 0.5
+0.5, 1, 0.5
+0, 1
+0, 2
+0, 3
+0, 4
+1, 5
+4, 5
+2, 6
+3, 6
diff --git a/Lattesh/cells/type_3.cell b/Lattesh/cells/type_3.cell
new file mode 100644
index 0000000..ee2fb52
--- /dev/null
+++ b/Lattesh/cells/type_3.cell
@@ -0,0 +1,18 @@
+TYPE_3
+0.5, 0.5, 0.5
+0.0, 0.0, 0.0
+1.0, 0.0, 0.0
+0.0, 1.0, 0.0
+1.0, 1.0, 0.0
+0.0, 0.0, 1.0
+1.0, 0.0, 1.0
+0.0, 1.0, 1.0
+1.0, 1.0, 1.0
+0, 1
+0, 2
+0, 3
+0, 4
+0, 5
+0, 6
+0, 7
+0, 8
diff --git a/Lattesh/cells/type_4.cell b/Lattesh/cells/type_4.cell
new file mode 100644
index 0000000..21f2ddb
--- /dev/null
+++ b/Lattesh/cells/type_4.cell
@@ -0,0 +1,55 @@
+TYPE_4
+0, 1, 1
+1, 0.5, 0.5
+1, 0, 0
+1, 0, 1
+0.5, 0.5, 1
+0, 0, 1
+0.25, 0.75, 0.75
+0.5, 0, 0.5
+0.25, 0.25, 0.25
+0.5, 0.5, 0
+0.75, 0.25, 0.25
+0, 0, 0
+0.75, 0.75, 0.25
+1, 1, 1
+0.25, 0.75, 0.25
+0.25, 0.25, 0.75
+0, 0.5, 0.5
+0.75, 0.25, 0.75
+0.75, 0.75, 0.75
+1, 1, 0
+0, 1, 0
+0.5, 1, 0.5
+8, 11
+8, 9
+10, 1
+12, 1
+14, 20
+14, 9
+15, 16
+17, 3
+17, 4
+18, 13
+18, 4
+6, 16
+8, 7
+8, 16
+10, 2
+10, 9
+10, 7
+12, 19
+12, 9
+12, 21
+14, 21
+14, 16
+15, 5
+15, 4
+15, 7
+17, 7
+17, 1
+18, 21
+18, 1
+6, 0
+6, 4
+6, 21
diff --git a/Lattesh/cells/type_5.cell b/Lattesh/cells/type_5.cell
new file mode 100644
index 0000000..c61e8e2
--- /dev/null
+++ b/Lattesh/cells/type_5.cell
@@ -0,0 +1,57 @@
+TYPE_5
+0.5, 1, 1
+0.5, 1, 0
+1, 0.75, 0
+1, 0.25, 0
+0.5, 0.5, 1
+0, 0.75, 1
+0, 0.25, 1
+1, 0.25, 1
+1, 0.75, 1
+0.5, 0, 1
+0.6686271292106067, 0.75, 0.5
+0.6686271292106067, 0.25, 0.5
+0.75, 0.5, 0.5
+0, 0.75, 0
+0.3313728707893933, 0.75, 0.5
+0.25, 0.5, 0.5
+0, 0.25, 0
+0.3313728707893933, 0.25, 0.5
+0.5, 0, 0
+0.5, 0.5, 0
+8, 10
+8, 12
+7, 11
+7, 12
+13, 14
+13, 15
+16, 17
+16, 15
+18, 17
+18, 11
+0, 14
+0, 10
+19, 10
+19, 14
+19, 12
+4, 11
+4, 17
+4, 15
+2, 10
+2, 12
+3, 11
+3, 12
+5, 14
+5, 15
+6, 17
+6, 15
+9, 17
+9, 11
+1, 14
+1, 10
+19, 11
+19, 17
+19, 15
+4, 10
+4, 14
+4, 12
diff --git a/Lattesh/cells/type_6.cell b/Lattesh/cells/type_6.cell
new file mode 100644
index 0000000..b3f5190
--- /dev/null
+++ b/Lattesh/cells/type_6.cell
@@ -0,0 +1,51 @@
+TYPE_6
+1.0,1.0,0.0
+0.0,1.0,1.0
+0.0,1.0,0.0
+1.0,0.0,0.0
+1.0,0.5,0.5
+0.0,0.0,1.0
+1.0,0.0,1.0
+0.0,0.0,0.0
+1.0,1.0,1.0
+0.5,0.0,0.5
+0.5,0.5,0.0
+0.5,0.5,1.0
+0.5,1.0,0.5
+0.0,0.5,0.5
+9,6
+12,2
+13,2
+10,0
+11,1
+7,9
+7,10
+6,11
+8,12
+5,13
+9,3
+4,0
+4,8
+12,0
+13,7
+10,2
+11,8
+9,4
+9,13
+9,10
+9,11
+10,4
+10,13
+10,12
+13,12
+12,4
+12,11
+13,11
+4,11
+6,4
+1,12
+1,13
+5,9
+3,4
+3,10
+5,11
diff --git a/Lattesh/cells/type_8.cell b/Lattesh/cells/type_8.cell
new file mode 100644
index 0000000..f95b06d
--- /dev/null
+++ b/Lattesh/cells/type_8.cell
@@ -0,0 +1,109 @@
+TYPE_8
+0.125, 1.0, 1.0
+0.875, 1.0, 1.0
+0.5, 1.0, 1.0
+1.0, 0.5, 0.0
+1.0, 0.0, 0.125
+1.0, 0.0, 0.875
+1.0, 0.25897457599639895, 0.5
+1.0, 0.0, 0.5
+1.0, 0.125, 0.0
+0.0, 0.7410254001617431, 0.5
+1.0, 0.125, 1.0
+1.0, 0.7410254001617431, 0.5
+1.0, 0.875, 1.0
+0.0, 0.25897457599639895, 0.5
+0.5, 1.0, 0.7410254001617431
+0.25897457599639895, 0.5, 1.0
+0.125, 0.0, 1.0
+0.7410254001617431, 0.5, 1.0
+0.875, 0.0, 1.0
+0.0, 0.125, 1.0
+0.25897457599639895, 0.5, 0.0
+0.125, 0.0, 0.0
+0.7410254001617431, 0.5, 0.0
+0.875, 0.0, 0.0
+0.5, 0.0, 0.25897457599639895
+0.0, 0.0, 0.125
+0.5, 0.0, 0.7410254001617431
+0.0, 0.0, 0.875
+0.0, 0.0, 0.5
+0.0, 0.125, 0.0
+0.0, 0.875, 0.0
+1.0, 1.0, 0.125
+1.0, 1.0, 0.875
+0.125, 1.0, 0.0
+0.5, 1.0, 0.0
+0.0, 1.0, 0.125
+0.0, 1.0, 0.875
+0.0, 1.0, 0.5
+0.5, 1.0, 0.25897457599639895
+0.0, 0.875, 1.0
+1.0, 0.875, 0.0
+0.875, 1.0, 0.0
+0.5, 0.0, 0.0
+0.5, 0.0, 1.0
+1.0, 1.0, 0.5
+0.0, 0.5, 0.0
+0.0, 0.5, 1.0
+1.0, 0.5, 1.0
+20, 21
+20, 33
+22, 3
+22, 23
+22, 41
+42, 23
+15, 16
+15, 0
+17, 18
+17, 1
+43, 18
+24, 25
+24, 4
+26, 27
+26, 5
+38, 34
+38, 35
+38, 31
+14, 2
+14, 36
+14, 32
+44, 32
+13, 28
+13, 29
+13, 19
+9, 37
+9, 30
+9, 39
+45, 30
+46, 39
+6, 7
+6, 8
+6, 10
+11, 40
+11, 12
+47, 12
+21, 42
+16, 43
+31, 44
+29, 45
+19, 46
+10, 47
+20, 45
+34, 41
+15, 46
+17, 47
+2, 1
+24, 42
+26, 43
+28, 27
+7, 5
+37, 36
+11, 44
+3, 40
+33, 34
+0, 2
+25, 28
+4, 7
+35, 37
+8, 3
\ No newline at end of file
diff --git a/Lattesh/cells/type_9.cell b/Lattesh/cells/type_9.cell
new file mode 100644
index 0000000..2090b58
--- /dev/null
+++ b/Lattesh/cells/type_9.cell
@@ -0,0 +1,31 @@
+TYPE_9
+1.0,0.5,0.5
+0.5,0.5,1.0
+0.5,0.0,0.5
+0.0,0.5,0.5
+0.75,0.25,0.5
+0.5,0.5,0.0
+0.5,1.0,0.5
+0.25,0.25,0.5
+0.75,0.75,0.5
+0.25,0.75,0.5
+7,3
+8,0
+5,4
+9,3
+1,4
+2,7
+6,8
+6,9
+7,4
+7,9
+5,8
+1,7
+1,9
+4,0
+8,4
+8,9
+5,7
+5,9
+1,8
+2,4
diff --git a/Lattesh/cells/type_91.cell b/Lattesh/cells/type_91.cell
new file mode 100644
index 0000000..e1aee30
--- /dev/null
+++ b/Lattesh/cells/type_91.cell
@@ -0,0 +1,33 @@
+TYPE_91
+1, 1, 0.5
+0, 1, 0.5
+1, 0.5, 0.5
+1, 0, 0.5
+0.5, 0.5, 1
+0.5, 0, 0.5
+0.25, 0.25, 0.5
+0, 0.5, 0.5
+0.75, 0.25, 0.5
+0.25, 0.75, 0.5
+0.5, 0.5, 0
+0.75, 0.75, 0.5
+0.5, 1, 0.5
+0, 0, 0.5
+5, 7
+12, 2
+6, 8
+6, 9
+10, 8
+10, 11
+4, 6
+4, 9
+13, 1
+3, 0
+5, 2
+12, 7
+11, 8
+11, 9
+10, 6
+10, 9
+4, 8
+4, 11
diff --git a/Lattesh/doc/side_panel.png b/Lattesh/doc/side_panel.png
new file mode 100644
index 0000000000000000000000000000000000000000..529b5349e154a92c4d2f5581b5881e12488e3a30
GIT binary patch
literal 61902
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
literal 0
HcmV?d00001
diff --git a/Lattesh/operators.py b/Lattesh/operators.py
new file mode 100644
index 0000000..8b6db3e
--- /dev/null
+++ b/Lattesh/operators.py
@@ -0,0 +1,1271 @@
+# -*- coding: utf-8 -*-
+# Copyright 2023 Ubiratan S. Freitas
+
+
+# This file is part of Lattesh.
+#
+# Lattesh is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your option)
+# any later version.
+#
+# Lattesh is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+# more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# Lattice Tools. If not, see <https://www.gnu.org/licenses/>.
+
+
+
+import bpy, bmesh
+from mathutils import Vector, Quaternion, Matrix
+from mathutils.bvhtree import BVHTree
+import numpy as np
+import math
+import os
+
+try:
+ from scipy.spatial import Voronoi, Delaunay
+ have_scipy = True
+except ModuleNotFoundError:
+ have_scipy = False
+
+
+
+
+
+# Opencascade imports
+try:
+ from OCC.Core.BRep import BRep_Tool
+ from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeSphere, BRepPrimAPI_MakeCylinder
+ from OCC.Core.BRepAlgoAPI import BRepAlgoAPI_Fuse
+ from OCC.Core.BRepBuilderAPI import BRepBuilderAPI_Transform
+ from OCC.Core.BRepMesh import BRepMesh_IncrementalMesh
+ from OCC.Core.TopExp import TopExp_Explorer
+ from OCC.Core.TopoDS import topods_Face
+ from OCC.Core.TopTools import TopTools_ListOfShape
+ from OCC.Core.BRepAdaptor import BRepAdaptor_Surface
+ from OCC.Core.GeomAbs import GeomAbs_Plane
+ from OCC.Core.TopAbs import TopAbs_FACE
+ from OCC.Core.TopLoc import TopLoc_Location
+ from OCC.Core.gp import gp_Pnt, gp_Trsf, gp_Ax2, gp_Ax1, gp_Dir
+ have_occ = True
+except ModuleNotFoundError:
+ have_occ = False
+
+
+
+
+
+
+
+class Cell:
+ def __init__(self, verts=None, edges=None):
+ if verts is None:
+ self.verts = np.zeros((0,3), dtype=np.float32)
+ self.nverts = 0
+ else:
+ self.verts = verts
+ self.nverts = verts.shape[0]
+ if edges is None:
+ self.edges = np.zeros((0,2), dtype=np.int32)
+ self.nedges = 0
+ else:
+ self.edges = edges
+ self.nedges = edges.shape[0]
+
+ self.check()
+
+ def check(self):
+ if self.nverts == 0:
+ return
+ if len(self.verts.shape) != 2 or self.verts.shape[1] != 3:
+ raise ValueError("verts should be an N x 3 array")
+
+ if len(self.edges.shape) != 2 or self.edges.shape[1] != 2:
+ raise ValueError("edges should be an M x 2 array")
+
+ if self.verts.min() < 0.0 or self.verts.max() > 1.0:
+ raise ValueError("All vertices' coordinates must be in [0.0, 1.0]")
+
+ if self.edges.min() < 0 or self.edges.max() > self.nverts:
+ raise ValueError("Edge(s) referencing inexistent vertex")
+
+ if set(range(self.nverts)) != set(self.edges.flat):
+ raise ValueError("Each vertex must be part of an edge")
+
+ def from_file(self, fname):
+ name = ''
+ verts = []
+ edges = []
+ with open(fname) as f:
+ for line in f:
+ stripped = line.strip()
+ if len(stripped) > 0 and stripped[0] != '#':
+ if len(name) == 0:
+ name = stripped
+ else:
+ sp = stripped.split(',')
+ if len(sp) == 3:
+ verts.append(list(map(float, sp)))
+ elif len(sp) == 2:
+ edges.append(list(map(int, sp)))
+ self.verts = np.array(verts, dtype=np.float32)
+ self.nverts = len(verts)
+ self.edges = np.array(edges, dtype=np.int32)
+ self.nedges = len(edges)
+ self.check()
+ self.name = name
+
+
+cell_files = ['hex.cell',
+ 'type_2.cell',
+ 'type_3.cell',
+ 'type_4.cell',
+ 'type_5.cell',
+ 'type_6.cell',
+ 'type_8.cell',
+ 'type_9.cell',
+ 'type_91.cell',
+ ]
+
+fpath = os.path.dirname(os.path.abspath(__file__))
+
+filepath = os.path.join(fpath, 'cells')
+Cells = {}
+cell_items = []
+for k, cf in enumerate(cell_files):
+ c = Cell()
+ c.from_file(os.path.join(filepath, cf))
+ Cells[c.name] = c
+ cell_items.append((c.name, c.name, c.name, k))
+
+def triangulate_verts(bm, max_len):
+ """Makes a Delaunay triangulation of selected vertices, delete edges longer than max_len"""
+ verts = [v for v in bm.verts if v.select]
+ vnp = np.zeros((len(verts),3), dtype=np.float32)
+ for k, v in enumerate(verts):
+ vnp[k,:] = np.array(v.co, dtype=np.float32)
+ tri = Delaunay(vnp)
+ eds_s = set()
+ for r in tri.simplices:
+ for k in range(3):
+ a = r[k]
+ b = r[k + 1]
+ if a < b:
+ eds_s.add((a, b))
+ else:
+ eds_s.add((b, a))
+ for e in eds_s:
+ if (verts[e[0]].co - verts[e[1]].co).length < max_len:
+ new_edge = bm.edges.new((verts[e[0]], verts[e[1]]))
+ new_edge.select = True
+
+
+def make_npvoronoi(carac_length, dims, corner):
+ """Makes a Voronoi lattice"""
+
+ carac3 = carac_length ** 3
+ padding = 2
+
+ dims = dims + (2 * padding * carac_length)
+
+ npoints = math.ceil(dims.prod() / carac3)
+
+ npoints = max(npoints, 30) # create at least this amount of points
+
+ print('voronoi npoints:', npoints)
+
+ p = np.random.random((npoints,3))
+ p = p * dims.reshape((1,3)) + (corner.reshape((1,3)) - padding * carac_length)
+
+
+ vor = Voronoi(p)
+
+ verts = vor.vertices
+
+ # mark voronoi vertices outside extended bounding box
+ lowerlims = corner.reshape((1,3)) - padding * carac_length
+ upperlims = lowerlims + dims
+ vertok = np.logical_and(np.all(verts > lowerlims, axis=1), np.all(verts < upperlims, axis=1))
+
+ # new vertices
+ new_verts = verts[vertok,:].copy()
+
+ # build a table translating old indexes to new_verts
+ okidx = np.zeros((len(verts),), dtype=np.int32)
+ okidx[np.logical_not(vertok)] = -1
+ newidx = okidx.cumsum() + np.arange(len(verts), dtype=np.int32)
+
+ eds_s = set()
+
+ for r in vor.ridge_vertices:
+ if not -1 in r:
+ for k in range(len(r) - 1):
+ a = r[k]
+ b = r[k + 1]
+ if vertok[a] and vertok[b]:
+ na = newidx[a]
+ nb = newidx[b]
+ if na < nb:
+ eds_s.add((na,nb))
+ else:
+ eds_s.add((nb,na))
+
+ edges = np.array([list(x) for x in eds_s], dtype=np.int32)
+ return new_verts, edges
+
+
+
+def make_nplattice(cell, cell_size, nelems, corner):
+ """Constructs a lattice grid"""
+ ncells = nelems.prod()
+ verts = np.zeros((ncells * cell.nverts, 3), dtype=np.float32)
+ edges = np.zeros((ncells * cell.nedges, 2), dtype=np.int32)
+ cellcorner = np.zeros((1,3), dtype=np.float32)
+ edgespos = np.ones((1,2), dtype=np.int32)
+
+ # Generate a lattice with copied cells of unit size
+ for i in range(nelems[0]):
+ for j in range(nelems[1]):
+ for k in range(nelems[2]):
+ cellcorner[0, 0] = i
+ cellcorner[0, 1] = j
+ cellcorner[0, 2] = k
+ baseidx = i + (j * nelems[0]) + (nelems[0] * nelems[1] * k)
+ vertpos = baseidx * cell.nverts
+ cellidx = baseidx * cell.nedges
+ verts[vertpos : (vertpos + cell.nverts), :] = cellcorner + cell.verts
+ edges[cellidx: (cellidx + cell.nedges), :] = cell.edges + edgespos * vertpos
+
+ # Scale the whole lattice and translate it to corner
+ verts = verts * cell_size + corner
+
+ return verts, edges
+
+def nplattice2meshdata(v, e):
+ verts = [tuple(v[i,:]) for i in range(v.shape[0]) ]
+ edges = [tuple(e[i,:]) for i in range(e.shape[0]) ]
+ return verts, edges
+
+def make_meshlattice(name, verts, edges, cellsize):
+ mesh = bpy.data.meshes.new(name+'Mesh')
+ mesh.from_pydata(verts, edges, [])
+
+ bm = bmesh.new()
+
+ bm.from_mesh(mesh)
+ bmesh.ops.remove_doubles(bm, verts=bm.verts[:], dist=1.0e-3*cellsize)
+ return bm, mesh
+
+
+def vor_intersect(vor, obj, depsgraph):
+ """Clips a Voronoi 3D lattice to object
+ """
+
+ tree = BVHTree.FromObject(obj, depsgraph)
+ disttol = 5.0e-5
+ analized_edges = set()
+ for rg, rv in enumerate(vor.ridge_vertices):
+ intersec = 0
+ for k in range(len(rv) - 1):
+ v0 = min((rv[k], rv[k + 1]))
+ v1 = max((rv[k], rv[k + 1]))
+ if v1 < 0 or (v0, v1) in analized_edges:
+ continue
+ p0 = vor.vertices[v0]
+ p1 = vor.vertices[v1]
+ d = p1 - p0
+ dis = np.linalg.norm(d)
+ loc, n, idx, hdis = tree.ray_cast(p0, d, dis)
+ if hdis is not None:
+ loc2, n2, idx2, hdis2 = tree.ray_cast(p1, -d, dis)
+ if (loc - loc2).length > disttol / 2.0:
+ double_edges.add(e)
+ elif hdis > disttol and abs(dis - hdis) > disttol:
+ r = hdis/dis
+ cedges.append((e, r))
+
+
+
+def intersect(bm, obj, depsgraph):
+ """Clips mesh lattice to object
+
+ Returns a mesh where all vertices and edges are inside or on the surface
+ of object. Edges that intercept the object are clipped.
+ """
+ tree = BVHTree.FromObject(obj, depsgraph)
+ outside = set()
+ inside = set()
+ valencies = set()
+ surfverts = set()
+ cedges = []
+ disttol = 5.0e-5
+ double_edges = set()
+
+ # Find the edges that cross object
+ for e in bm.edges:
+ p0 = e.verts[0].co
+ p1 = e.verts[1].co
+ d = p1 - p0
+ dis = d.length
+ loc, n, idx, hdis = tree.ray_cast(p0, d, dis)
+ if hdis is not None:
+ # check for multiple crossings
+ loc2, n2, idx2, hdis2 = tree.ray_cast(p1, -d, dis)
+ if loc2 and (loc - loc2).length > disttol / 2.0:
+ double_edges.add(e)
+ elif hdis > disttol and abs(dis - hdis) > disttol:
+ r = hdis/dis
+ cedges.append((e, r))
+
+ print('edges', len(cedges))
+ print('double edges', len(double_edges))
+
+ # Delete double crossing edges
+ if double_edges:
+ bmesh.ops.delete(bm, geom=list(double_edges), context='EDGES')
+
+
+ dper = dict()
+ for k in cedges:
+ dper[k[0]] = k[1]
+
+ tmp = np.array(list(dper.values()))
+ print('min dist', tmp.min(), 'max dist', tmp.max())
+
+ # Split the found edges on crossing point
+ bmesh.ops.bisect_edges(bm, edges=[ e[0] for e in cedges ], cuts=1, edge_percents=dper)['geom_split']
+
+ # Find the vertices that are on the surface and identify their outside and inside edges based on
+ # surface normal
+ for v in bm.verts:
+ loc, n, idx, hdis = tree.find_nearest(v.co, 1.1*disttol)
+ if loc is not None:
+ surfverts.add(v)
+ valencies.add(len(v.link_edges))
+ for ed in v.link_edges:
+ p1 = ed.other_vert(v)
+ u_v = p1.co - v.co
+ u_v = u_v / u_v.length * 0.2
+ pn = v.co + u_v
+ an1 = n.angle(p1.co - v.co)
+ loc2, n2, idx, hdis = tree.find_nearest(p1.co, 1.1* ed.calc_length())
+ if hdis and hdis > 0:
+ an2 = n2.angle((p1.co - loc2))
+ else:
+ an2 = math.pi
+ if hdis and hdis > disttol and (an1 < math.pi / 2 + 1e-3 or an2 < math.pi / 2 + 1e-3) :
+ outside.add(ed)
+ else:
+ inside.add(ed)
+
+ print('Found', len(surfverts), 'surfverts')
+
+ print('Valencies:', valencies)
+
+ print('inside', len(inside), 'outside', len(outside))
+
+ invalid_out = set([v for v in outside if not v.is_valid])
+ outside = outside - invalid_out
+
+ invalid_in = set([v for v in inside if not v.is_valid])
+ inside = inside - invalid_in
+
+ print('inv out', len(invalid_out), 'inv in', len(invalid_in), 'in out', len(inside.intersection(outside)))
+
+ # Delete the outside edges from on-the-surface vertices
+ bmesh.ops.delete(bm, geom=list(outside), context='EDGES')
+
+ # Remove invalid surfverts
+ invalid = set([v for v in surfverts if not v.is_valid])
+ print('Found {} invalid surfverts'.format(len(invalid)))
+ surfverts = surfverts - invalid
+
+ # Find all vertices linked to the ones on the surface
+ to_process = surfverts.copy()
+ processed = set()
+ while to_process:
+ v = to_process.pop()
+ for e in v.link_edges:
+ other_v = e.other_vert(v)
+ if other_v not in processed:
+ to_process.add(other_v)
+ processed.add(v)
+
+ # Delete gemometry not linked to surface vertices
+ to_delete = set(bm.verts) - processed
+ print(len(to_delete), 'to be deleted and', len(processed), 'internal vertices found')
+
+ if len(to_delete) < len(bm.verts):
+ # do not delete all vertices
+ bmesh.ops.delete(bm, geom=list(to_delete), context='VERTS')
+
+
+ # Leave only surface vertices selected
+ bm.select_mode = {'VERT'}
+
+ for v in bm.verts:
+ v.select = False
+
+ for v in surfverts:
+ v.select = True
+
+ bm.select_flush_mode()
+
+def test_ring(na, nb):
+ twopi = 2 * math.pi
+ ra = np.random.rand(na).cumsum()
+ rb = np.random.rand(nb).cumsum()
+ tha = ra / ra[-1] * twopi - math.pi
+ thb = rb / rb[-1] * twopi - math.pi
+ verts = np.zeros((na + nb, 3), dtype=np.float32)
+ verts[:na,:] = np.stack((np.cos(tha), np.sin(tha), np.zeros(na)), axis=1)
+ verts[na:,:] = np.stack((np.cos(thb), np.sin(thb), np.ones(nb)*2), axis=1)
+ faces, masq = ring_connect_faces(tha, thb)
+ faces[np.logical_not(masq)] += na
+ faces = list(faces)
+ bottom = list(range(na))
+ bottom.reverse()
+ top = list(range(na,na+nb))
+ faces += [bottom, top]
+ mesh = bpy.data.meshes.new('RingMesh')
+ mesh.from_pydata(verts, [], faces)
+ newobj = bpy.data.objects.new('Ring', mesh)
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+
+
+
+def angle_dist(a, b):
+ d = abs(b-a)
+ return min(d, 2 * math.pi - d)
+
+def ring_connect3d(ringa, ringb):
+ na, nb = len(ringa), len(ringb)
+ distab = np.zeros((na, nb))
+ ran_a = np.arange(na)
+ ran_b = np.arange(nb)
+ rankab = np.zeros((na, nb), dtype=np.int32)
+ rankba = np.zeros((nb, na), dtype=np.int32)
+ for k in range(na):
+ distab[k, :] = np.linalg.norm(ringb - ringa[k, :], axis=1)
+ for k in range(na):
+ rankab[k, distab[k, :].argsort()] = ran_b
+ for k in range(nb):
+ rankba[k, distab[:, k].argsort()] = ran_a
+ idx = distab.argmin()
+ posa, posb = np.unravel_index(idx, distab.shape)
+ nposa = (posa + 1) % na
+ nposb = (posb + 1) % nb
+ faces = np.zeros((na + nb, 3), dtype=np.int32)
+
+ ntris = 0
+ ntrisa = 0
+ ntrisb = 0
+ while ntrisa < na and ntrisb < nb:
+ rnb = rankba[nposb, posa]
+ rna = rankab[nposa, posb]
+ if rnb < rna:
+ make_b = True
+ elif rna < rnb:
+ make_b = False
+ elif distab[posa, nposb] <= distab[nposa, posb]:
+ #if distab[posa, nposb] <= distab[nposa, posb]:
+ make_b = True
+ else:
+ make_b = False
+
+ if make_b:
+ faces[ntris, :] = [posa, nposb + na, posb + na]
+ posb = nposb
+ nposb = (posb + 1) % nb
+ ntrisb += 1
+ else:
+ faces[ntris, :] = [posa, nposa , posb + na]
+ posa = nposa
+ nposa = (posa + 1) % na
+ ntrisa += 1
+ ntris += 1
+ while ntrisa < na:
+ faces[ntris, :] = [posa, nposa , posb + na]
+ posa = nposa
+ nposa = (posa + 1) % na
+ ntrisa += 1
+ ntris += 1
+ while ntrisb < nb:
+ faces[ntris, :] = [posa, nposb + na, posb + na]
+ posb = nposb
+ nposb = (posb + 1) % nb
+ ntrisb += 1
+ ntris += 1
+ return faces
+
+def ring_connect_faces(ang_a, ang_b):
+ twopi = 2 * math.pi
+ na = len(ang_a)
+ nb = len(ang_b)
+ faces = np.zeros((na+nb, 3), dtype=np.int32)
+ face_masq = np.zeros(faces.shape, dtype=bool)
+ saidx = ang_a.argsort()
+ sbidx = ang_b.argsort()
+ sa = ang_a[saidx]
+ sb = ang_b[sbidx]
+
+ posa = 0
+ nposa = 1
+ dists = np.zeros((nb,2), dtype=ang_b.dtype)
+ dists[:,0] = np.abs(sb - sa[0])
+ dists[:,1] = twopi - dists[:,0]
+ posb = dists.min(axis=1).argmin()
+ nposb = (posb + 1) % nb
+ ntris = 0
+ ntrisa = 0
+ ntrisb = 0
+
+ while ntrisa < na and ntrisb < nb:
+ dista = angle_dist(sa[posa], sb[nposb])
+ distb = angle_dist(sb[posb], sa[nposa])
+ if dista <= distb:
+ faces[ntris,:] = [saidx[posa], sbidx[nposb], sbidx[posb]]
+ face_masq[ntris,:] = [True, False, False]
+ posb = (posb + 1) % nb
+ nposb = (posb + 1) % nb
+ ntrisb += 1
+ else:
+ faces[ntris,:] = [saidx[posa], saidx[nposa], sbidx[posb]]
+ face_masq[ntris,:] = [True, True, False]
+ posa = (posa + 1) % na
+ nposa = (posa + 1) % na
+ ntrisa += 1
+ ntris += 1
+ while ntrisa < na:
+ faces[ntris,:] = [saidx[posa], saidx[nposa], sbidx[posb]]
+ face_masq[ntris,:] = [True, True, False]
+ posa = (posa + 1) % na
+ nposa = (posa + 1) % na
+ ntrisa += 1
+ ntris += 1
+ while ntrisb < nb:
+ faces[ntris,:] = [saidx[posa], sbidx[nposb], sbidx[posb]]
+ face_masq[ntris,:] = [True, False, False]
+ posb = (posb + 1) % nb
+ nposb = (posb + 1) % nb
+ ntrisb += 1
+ ntris += 1
+
+ return faces, face_masq
+
+vecz = np.array([0, 0, 1], dtype=np.float32)
+eye = np.eye(3)
+inv_eye = eye.copy()
+inv_eye[1,1] = -1.0
+inv_eye[2,2] = -1.0
+twopi = math.pi * 2
+min_crossnorm = 1e-3
+
+def make_rotmatrix(x):
+ """Make a rotation matrix that transform the given unity vector to the z axis"""
+ c_angle = x @ vecz
+ raxis = np.cross(x, vecz)
+ if np.linalg.norm(raxis) < min_crossnorm:
+ if c_angle > 0.0:
+ rotmat = eye
+ elif c_angle < 0.0:
+ rotmat = inv_eye
+ else:
+ rotmat = np.array(Matrix.Rotation(math.acos(c_angle), 3, raxis))
+ return rotmat
+
+
+def aux_show_node():
+ nodes = [[1, 0, 0],
+ [0, 1, 0],
+ [0, 0, 1],
+ [0, 0.7071067811865475, 0.7071067811865475]
+ ]
+ nodes = np.array(nodes)
+ verts, tris, nsides, shape = occ_compute_node(nodes)
+
+ print('Nverts:', len(verts), 'ntris:', len(tris))
+ print('Tris:')
+ print(tris)
+ name = 'OCC Node'
+ mesh = bpy.data.meshes.new(name+'Mesh')
+ mesh.from_pydata(verts, [], list(tris))
+ newobj = bpy.data.objects.new(name, mesh)
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+
+def boolean_union(shape_a, shape_b):
+ lo1 = TopTools_ListOfShape()
+ lo1.Append(shape_a)
+ lo2 = TopTools_ListOfShape()
+ lo2.Append(shape_b)
+
+ op = BRepAlgoAPI_Fuse()
+ op.SetArguments(lo1)
+ op.SetTools(lo2)
+
+ op.SetCheckInverted(False)
+ #op.SetFuzzyValue(r/50)
+ #op.SetUseOBB(True)
+ op.Build()
+ return op.Shape()
+
+
+def occ_compute_node(ev, r=0.5, mesh_pars=(0.1, False, math.radians(60), False), shuffle=False):
+ node_origin = gp_Ax2(gp_Pnt(0, 0, 0), gp_Dir(0, 0, 1))
+ shape = BRepPrimAPI_MakeSphere(node_origin, r).Shape()
+ vecz = np.array([0.0, 0.0, 1.0])
+ rotate = gp_Trsf()
+ nedges = len(ev)
+ rotmats = np.zeros((2, 3, nedges))
+ if shuffle:
+ seq = np.random.permutation(nedges)
+ else:
+ seq = list(range(nedges))
+
+ for k in seq:
+ v = ev[k, :]
+ c_angle = v @ vecz
+ raxis = np.cross(vecz, v)
+ if np.linalg.norm(raxis) < min_crossnorm:
+ if c_angle > 0.0:
+ rotdir = gp_Dir(0.0, 0.0, 1.0)
+ elif c_angle < 0.0:
+ rotdir = gp_Dir(1.0, 0.0, 0.0)
+ else:
+ rotdir = gp_Dir(*raxis)
+
+ rotate.SetRotation(gp_Ax1(node_origin.Location(), rotdir), math.acos(c_angle))
+ for row in range(2):
+ for col in range(3):
+ rotmats[row, col, k] = rotate.Value(col + 1, row + 1)
+ try:
+ if nedges == 1:
+ cyl = BRepPrimAPI_MakeCylinder(node_origin, r, 1.1 * r).Shape()
+ cyl1 = BRepBuilderAPI_Transform(cyl, rotate, True).Shape()
+ shape = boolean_union(shape, cyl1)
+ else:
+ c_angles = ev @ v
+ s_arg = c_angles.argsort()
+ minangle = math.acos(c_angles[s_arg[-2]])
+ cyl_len = max(1.1 * r, 1.1 * r /math.tan(minangle/2))
+ cyl = BRepPrimAPI_MakeCylinder(node_origin, r, cyl_len ).Shape()
+ cyl1 = BRepBuilderAPI_Transform(cyl, rotate, True).Shape()
+ #op = BRepAlgoAPI_Fuse(shape, cyl1)
+ newshape = boolean_union(shape, cyl1)
+ while newshape is None:
+ ang_change = + np.random.randn() / 20
+ print(f'Boolean fuse failed. Trying angle change of {math.degrees(ang_change):.2f} degrees')
+ rotate.SetRotation(gp_Ax1(node_origin.Location(), rotdir), math.acos(c_angle) + ang_change)
+ cyl1 = BRepBuilderAPI_Transform(cyl, rotate, True).Shape()
+ newshape = boolean_union(shape, cyl1)
+ shape = newshape
+ except:
+ print('Error in OCC. Type of shape:', type(shape))
+ print(shape)
+ print(f'k: {k}')
+ print(ev)
+ raise
+
+ #
+ # Mesh the shape
+ #
+ BRepMesh_IncrementalMesh(shape, *mesh_pars)
+
+ bt = BRep_Tool()
+ ex = TopExp_Explorer(shape, TopAbs_FACE)
+ verts = []
+ uniq_verts = []
+ vertsd = {}
+ plane_verts = []
+ tris = []
+ plane_ind = []
+ ind_tri = np.array([2, 0, 1], dtype=np.int32)
+ while ex.More():
+ face = topods_Face(ex.Current())
+ location = TopLoc_Location()
+ facing = (bt.Triangulation(face, location))
+ if facing is not None:
+ tab = facing.Nodes()
+ tri = facing.Triangles()
+ local_index = []
+ for k in range(1, tab.Length() + 1):
+ pnt = tab.Value(k)
+ point = list(pnt.Coord())
+ dpoint = tuple((np.array(point) * 100).round().astype(np.int32))
+ verts.append(point)
+ if dpoint not in vertsd:
+ vertsd[dpoint] = len(uniq_verts)
+ uniq_verts.append(point)
+ local_index.append(vertsd[dpoint])
+
+ surf = BRepAdaptor_Surface(face, True)
+ surf_type = surf.GetType()
+ local_index = np.array(local_index)
+ if surf_type == GeomAbs_Plane:
+ face_plane = surf.Plane()
+ face_normal = np.array(list(face_plane.Axis().Direction().Coord()))
+ c_angles = ev @ face_normal
+ idx = c_angles.argmax()
+ if idx in plane_ind:
+ fidx = plane_ind.index(idx)
+ plane_verts[fidx] = np.unique(np.concatenate((plane_verts[fidx], local_index )))
+ else:
+ plane_ind.append(idx)
+ plane_verts.append(local_index)
+ else:
+ for i in range(1, facing.NbTriangles()+1):
+ trian = tri.Value(i)
+ np_tri = np.array(list(trian.Get()), dtype=np.int32)
+ np_tri = np.array(local_index[np_tri - 1])
+ if (np_tri - np_tri[ind_tri]).prod() != 0 :
+ tris.append(np_tri)
+ ex.Next()
+
+ uniq_verts = np.array(uniq_verts)
+ tris = np.array(tris, dtype=np.int32)
+ ed_verts = []
+ if plane_verts:
+ nsides = len(plane_verts[0])
+ all_planeverts = set()
+ for pl in plane_verts:
+ all_planeverts.update(pl)
+ plane_tris = set()
+ plane_ind = np.array(plane_ind)
+ edverts = []
+ for k in plane_ind.argsort():
+ pl = plane_verts[k]
+ plset = set(pl)
+ edvert = set()
+ for k in range(len(tris)):
+ for x in tris[k]:
+ if x in plset:
+ plane_tris.add(k)
+ edvert.update(set(tris[k]) - all_planeverts)
+ break
+ edverts.append(list(edvert))
+ verts = np.array(verts)
+ # Remove tris that contain a vertex in plane_verts (using set operations)
+ tris = tris[list(set(range(len(tris))) - plane_tris), :]
+
+ nverts = len(uniq_verts)
+ edge_verts = set()
+ non_planeedge_verts = set(range(nverts)) -all_planeverts
+
+ # Look for tris with the same verts
+ repeated_tris = set()
+ tri_dict = {}
+ verts_to_check = set()
+ for k, tr in enumerate(tris):
+ tr_b = tr.copy()
+ tr_b.sort()
+ key = tuple(tr_b)
+ plist = tri_dict.setdefault(key, [])
+ plist.append(k)
+ if len(plist) > 1:
+ repeated_tris.update(plist)
+ verts_to_check.update(key)
+ if repeated_tris:
+ tris = tris[list(set(range(len(tris))) - repeated_tris), :]
+ verts_to_remove = verts_to_check - set(tris.ravel())
+ non_planeedge_verts -= verts_to_remove
+ print(f'Found {len(repeated_tris)} repeated tris and removed {len(verts_to_remove)} verts.')
+
+ for x in edverts:
+ non_planeedge_verts -= set(x)
+ edge_verts.update(x)
+ edge_verts = np.array(list(edge_verts), dtype=np.int32)
+ non_planeedge_verts = np.array(list(non_planeedge_verts), dtype=np.int32)
+ vert_order = np.concatenate((edge_verts, non_planeedge_verts))
+ uniq_verts = uniq_verts[vert_order, :]
+ vert_ind = -np.ones(nverts, dtype=np.int32)
+ vert_ind[vert_order] = np.arange(len(vert_order), dtype=np.int32)
+ tris = vert_ind[tris]
+ for x in edverts:
+ ed_verts.append(vert_ind[x])
+ else:
+ nsides = 0
+
+
+# print('Total vertices')
+# print(len(verts))
+# print('Unique verts')
+# print(len(uniq_verts))
+# print('Plane faces found:', len(plane_verts))
+# print('Plane nb verts:', plane_nb_verts.min(), 'to', plane_nb_verts.max())
+# print('Non plane verts:', len(uniq_verts) - plane_nb_verts.sum())
+# print('Nb of tris:', len(tris))
+
+ return uniq_verts, tris, nsides, ed_verts, shape
+
+
+
+def createMesh(target, r=0.5, lin_deflect=0.1, ang_deflect=math.radians(60.)):
+ """Gives a volume to each edge in target using cylinders of radius r and nsides sides"""
+ min_angle = math.radians(30)
+ min_length = r / math.tan(min_angle / 2.0)
+ quantization = 100
+ tmesh = target.data
+ name = target.name + "Cyl"
+ nverts = len(tmesh.vertices)
+ nedges = len(tmesh.edges)
+
+ verts = np.empty(nverts * 3, dtype=np.float32)
+ edges = np.empty(nedges * 2, dtype=np.int32)
+
+ tmesh.vertices.foreach_get('co', verts)
+ tmesh.edges.foreach_get('vertices', edges)
+
+ verts.shape = (nverts,3)
+ edges.shape = (nedges,2)
+
+ vec_edges = verts[edges[:,1],:] - verts[edges[:,0],:]
+ edge_len = np.linalg.norm(vec_edges, axis=1, keepdims=True)
+ vec_edges /= edge_len
+
+
+ # Quantize edge orientations
+ qedges = (vec_edges * quantization).astype(np.int32)
+
+ dqedges = {}
+ for k in range(nedges):
+ qv = tuple(qedges[k,:])
+ dqedges.setdefault(qv,[]).append(k)
+
+ edge_t = np.zeros(nedges, dtype=np.int32)
+ edge_types = []
+ for k, t in enumerate(dqedges.keys()):
+ edge_types.append(t)
+ edge_t[dqedges[t]] = k
+
+
+ mesh = bpy.data.meshes.new(name+'Mesh')
+
+ print(f'{nedges} total edges, {len(dqedges)} quantized orientations, {min_length:.2f}, minimal edge length.')
+
+
+ # Generate all possible edge orientations, including reverse
+ tempset = set()
+ for k in dqedges.keys():
+ tempset.add(k)
+ bw = -np.array(list(k))
+ tempset.add(tuple(bw))
+
+ dvecs = {}
+ listdir = list(tempset)
+ for k, v in enumerate(listdir):
+ dvecs[v] = k
+
+ # Record all edges and their directions w.r.t. each node (vertex)
+ # nodes is a list containing, for every vertex, a list of pairs [ind, dir],
+ # where ind is the index of an edge that is connected with the vertex and
+ # dir is true if the edge starts in this vertex and false otherwise
+ nodes = [None] * nverts
+ for k in range(nedges):
+ v0, v1 = edges[k,0], edges[k,1]
+ t = (k, True)
+ if nodes[v0] is None:
+ nodes[v0] = [t]
+ else:
+ nodes[v0].append(t)
+ t = (k, False)
+ if nodes[v1] is None:
+ nodes[v1] = [t]
+ else:
+ nodes[v1].append(t)
+
+ # Classify all nodes based on their (discretized) edge orientations
+ node_types = {}
+ single_nodes = set()
+ discarded_edges = set()
+ short_edges = set()
+ for k in range(nverts):
+ if nodes[k] is None:
+ # Ignore isolated vertices
+ continue
+ if len(nodes[k]) == 1:
+ single_nodes.add(k)
+ if edge_len[nodes[k][0][0]] < min_length:
+ # Discard single nodes with small edge length
+ discarded_edges.add(nodes[k][0])
+ continue
+ cand_edges = []
+ cand_dir = []
+ for kk, eddir in nodes[k]:
+ if kk in discarded_edges:
+ continue
+ if edge_len[kk] < min_length:
+ if len(nodes[edges[kk, int(eddir)]]) == 1:
+ # Discard single nodes with small edge length
+ discarded_edges.add(kk)
+ continue
+ else:
+ # Mark short edges between non single nodes
+ short_edges.add(kk)
+ cand_edges.append(kk)
+ cand_dir.append(eddir)
+ if len(cand_edges) == 0:
+ continue
+ node_edges = np.array(cand_edges, dtype=np.int32) # list of edge indeces
+ edge_dir = np.array(cand_dir, dtype=np.int32)
+ edge_vec = qedges[node_edges, :].copy()
+ edge_vec[np.flatnonzero(np.logical_not(edge_dir)),:] *= -1 # flip the edge vector so that all point away from vertex
+ dir_keya = np.array([dvecs[tuple(x)] for x in edge_vec]) # retrieve the index of each quantitized vector in listdir
+ sd = dir_keya.argsort()
+ dir_key = tuple(dir_keya[sd])
+ node_types.setdefault(dir_key, []).append(k)
+ temp = np.stack((node_edges, edge_dir.astype(np.int32)), axis=1)
+ nodes[k] = temp[sd,:] # sort the node's list of edges according to edge position in dict's keys
+
+ print(nverts, 'total vertices,', len(node_types), 'distinct nodes,', len(single_nodes), 'single nodes,', len(discarded_edges), 'discarded edges and', len(short_edges), 'short edges.')
+
+
+
+ total_verts = 0
+ total_faces = 0
+ processed_nodes = []
+ occ_nsides = None
+ nr_nodetypes = len(node_types)
+ for k, (nt, nodelist) in enumerate(node_types.items()):
+ if nr_nodetypes > 100:
+ if k % 10 == 0:
+ print(f'Processing node {k} of {nr_nodetypes}', end='\r')
+ # Reconstruct edge vectors based on quantitized vectors
+ ev = np.array([listdir[d] for d in nt], dtype=np.float32) / quantization
+
+ # Compute node geomery with Opencascade
+ try:
+ retry_count = 0
+ node_verts, node_faces, node_nsides, node_edverts, shape = occ_compute_node(ev, r, mesh_pars=(lin_deflect, False, ang_deflect, False))
+ while len(node_edverts) != len(nt) and retry_count < 20:
+ retry_count += 1
+ print(f'Wrong number of edge verts in processed node {k} with {len(nt)} edges and {len(node_edverts)} found edges. Retry nb. {retry_count}.', end='\r')
+ node_verts, node_faces, node_nsides, node_edverts, shape = occ_compute_node(ev, r, mesh_pars=(lin_deflect, False, ang_deflect, False), shuffle=True)
+ if retry_count > 0:
+ print()
+ except:
+ print(f'OCC error in node {k}. Node list:')
+ print(nodelist)
+ raise
+ if occ_nsides is None:
+ occ_nsides = node_nsides
+ processed_nodes.append((node_verts, node_faces, node_edverts, nt, nodelist, ))
+ total_verts += len(node_verts) * len(nodelist)
+ total_faces += len(node_faces) * len(nodelist)
+
+ nsides = occ_nsides
+ print('Nsides:', nsides)
+ newverts = np.empty((total_verts, 3), dtype=np.float32)
+ newfaces = np.empty((total_faces, 3), dtype=np.int32)
+
+ vert_count = 0
+ face_count = 0
+ edgefaces = np.zeros((nedges, 2), dtype=np.int32)
+ ed_nd = np.zeros((nedges, 2, 2), dtype=np.int32)
+ for k, (node_verts, node_faces, node_edverts, nt, nodelist) in enumerate(processed_nodes):
+ valency = len(node_edverts)
+ verts_per_node = len(node_verts)
+ faces_per_node = len(node_faces)
+ ed_pos = np.arange(valency, dtype=np.int32)
+ if valency:
+ for n in nodelist:
+ # Translate the vertices of each node type to the actual position of the nodes and
+ # insert them in newverts
+ if verts_per_node:
+ newverts[vert_count:vert_count + verts_per_node, :] = node_verts + verts[n,:]
+ # Insert the node type faces in newfaces for each of the node instances
+ if faces_per_node:
+ newfaces[face_count:face_count + faces_per_node, :] = node_faces + vert_count
+ edgefaces[nodes[n][:,0], 1 - nodes[n][:,1]] = vert_count
+ ed_nd[nodes[n][:,0],0, 1 - nodes[n][:,1]] = k
+ ed_nd[nodes[n][:,0],1, 1 - nodes[n][:,1]] = ed_pos
+ vert_count += verts_per_node
+ face_count += faces_per_node
+ else:
+ print('Edgeless node found. Node list:', nodelist)
+
+ ed_nd_dict = {}
+ for k in range(nedges):
+ if k in discarded_edges:
+ continue
+ node_a = tuple(ed_nd[k, :, 0])
+ node_b = tuple(ed_nd[k, :, 1])
+ edkey = tuple(sorted([node_a, node_b]))
+ edir = int(node_a == edkey[0])
+ ed_nd_dict.setdefault(edkey, []).append([k, edir])
+
+ print('Edge node types:', len(ed_nd_dict))
+
+ ed_nd_faces = {}
+ ed_nd_nfaces = 0
+ for ed_ty in ed_nd_dict.keys():
+ (na, fa), (nb, fb) = ed_ty
+ node_verts, node_faces, node_edverts, nt, nodelist = processed_nodes[na]
+ ed_dir = np.array(listdir[nt[fa]], dtype=np.float32) / quantization
+ nedidxa = node_edverts[fa]
+ nva = node_verts[nedidxa, :]
+ node_verts, node_faces, node_edverts, nt, nodelist = processed_nodes[nb]
+ nedidxb = node_edverts[fb]
+ nvb = node_verts[nedidxb, :]
+ rotmat = make_rotmatrix(ed_dir)
+ rotmat = rotmat.T[:,:2].copy()
+ proj_verts = nva @ rotmat
+ ang_a = np.arctan2(proj_verts[:,1], proj_verts[:,0])
+ proj_verts = nvb @ rotmat
+ ang_b = np.arctan2(proj_verts[:,1], proj_verts[:,0])
+ ed_fa, face_masq = ring_connect_faces(ang_a, ang_b)
+ other_masq = np.logical_not(face_masq)
+ ed_fanew = np.zeros(ed_fa.shape, dtype=np.int32)
+ ed_fanew[face_masq] = nedidxa[ed_fa[face_masq]]
+ ed_fanew[other_masq] = nedidxb[ed_fa[other_masq]]
+ ed_nd_faces[ed_ty] = [ed_fanew, face_masq]
+ ed_nd_nfaces += len(ed_nd_dict[ed_ty]) * len(ed_fa)
+
+ newfaces.resize((total_faces + ed_nd_nfaces, 3))
+ print('Nb. of edge node faces:', ed_nd_nfaces)
+
+
+ processed_faces = 0
+ for ed_ty in ed_nd_dict.keys():
+ edfaces, face_masq = ed_nd_faces[ed_ty]
+ other_facemasq = np.logical_not(face_masq)
+ ed_nfaces = len(edfaces)
+ faceoffsets = np.zeros(edfaces.shape, dtype=np.int32)
+ for edidx, edir in ed_nd_dict[ed_ty]:
+ faceoffsets[face_masq] = edgefaces[edidx, 1-edir]
+ faceoffsets[other_facemasq] = edgefaces[edidx, edir]
+ newfaces[total_faces + processed_faces : total_faces + processed_faces + ed_nfaces,:] = edfaces + faceoffsets
+ processed_faces += ed_nfaces
+
+
+
+ mesh.from_pydata(newverts, [], list(newfaces))
+ newobj = bpy.data.objects.new(name, mesh)
+
+ # Place the lattice at the same position and attitude of original object
+ newobj.matrix_world = target.matrix_world.copy()
+
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+
+
+def createMetaball(target, r=0.5, p=0.9):
+ if target.type != 'MESH':
+ return
+
+ name = target.name + "Rod"
+ print("Creating", name)
+
+ metaball = bpy.data.metaballs.new(name+'Meta')
+ obj = bpy.data.objects.new(name, metaball)
+ bpy.context.scene.collection.objects.link(obj)
+ stiffness = 10.0
+
+ # clip p
+ p = min(p, 0.99);
+ p = max(p, 0.01)
+
+ # Compute the threashold so that mesh radius is
+ # exacltly r
+ metaball.threshold = (1 - p ** 2) ** 3 * stiffness
+
+ radius = r / p
+
+ vec_x = Vector((1.0, 0.0, 0.0))
+
+ for v in target.data.vertices:
+ location = v.co.copy()
+
+ element = metaball.elements.new()
+ element.co = location
+ element.radius = radius
+ element.stiffness = stiffness
+
+ for e in target.data.edges:
+ v0 = target.data.vertices[e.vertices[0]].co
+ v1 = target.data.vertices[e.vertices[1]].co
+ edge = v1 - v0
+ edge_len = edge.length
+
+ if edge_len > r:
+ edge_middle = (v1 + v0) / 2.0
+ element = metaball.elements.new()
+ element.co = edge_middle
+ element.radius = radius
+ element.stiffness = stiffness
+
+ if edge_len > 2 * r:
+ element.type = 'CAPSULE'
+ element.size_x = (edge_len - 2 * r) / 2.0
+ angle = edge.angle(vec_x)
+ if abs(angle) > 1e-3:
+ axis = edge.cross(vec_x).normalized()
+ rot = Quaternion(axis, -angle).normalized()
+ element.rotation = (rot.w, rot.x, rot.y, rot.z)
+
+
+ # Place the lattice at the same position and attitude of original object
+ obj.matrix_world = target.matrix_world.copy()
+
+ return obj
+
+
+class ObjectMetaLattice(bpy.types.Operator):
+ """Metaball Lattice"""
+ bl_idname = "object.metalattice"
+ bl_label = "Meta Lattice"
+ bl_options = {'REGISTER', 'UNDO'}
+
+ @classmethod
+ def poll(cls, context):
+ return context.active_object is not None and context.active_object.type == 'MESH'
+
+
+ def execute(self, context):
+ lattice_mesh = context.scene.lattice_mesh
+ createMetaball(context.active_object, lattice_mesh.radius, lattice_mesh.r_ratio)
+ return {'FINISHED'}
+
+
+class ObjectOCCLattice(bpy.types.Operator):
+ """Metaball Lattice"""
+ bl_idname = "object.occlattice"
+ bl_label = "Lattice Volume (OCC)"
+ bl_options = {'REGISTER', 'UNDO'}
+
+ @classmethod
+ def poll(cls, context):
+ return have_occ and context.active_object is not None and context.active_object.type == 'MESH'
+
+
+ def execute(self, context):
+ lattice_mesh = context.scene.lattice_mesh
+ createMesh(context.active_object, lattice_mesh.radius, lattice_mesh.lin_deflect, lattice_mesh.ang_deflect)
+ return {'FINISHED'}
+
+
+
+class ObjectCreateMeshLattice(bpy.types.Operator):
+ """Create Mesh Lattice"""
+ bl_idname = "object.create_meshlattice"
+ bl_label = "Create Mesh Lattice"
+ bl_options = {'REGISTER', 'UNDO'}
+
+
+
+ @classmethod
+ def poll(cls, context):
+ return context.mode == 'OBJECT'
+
+
+ def execute(self, context):
+ lattice_mesh = context.scene.lattice_mesh
+ name = "Lattice"
+ nelems = np.array(lattice_mesh.nelems)
+ corner = np.array(context.scene.cursor.location).reshape((1,3))
+ v, e = make_nplattice(Cells[lattice_mesh.celltype], lattice_mesh.cellsize, nelems, corner)
+ verts, edges = nplattice2meshdata(v, e)
+ bm, mesh = make_meshlattice(name, verts, edges, lattice_mesh.cellsize)
+ bm.to_mesh(mesh)
+ bm.free()
+
+ newobj = bpy.data.objects.new(name, mesh)
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+ return {'FINISHED'}
+
+
+class ObjectFillMeshLattice(bpy.types.Operator):
+ """Fill Mesh Lattice"""
+ bl_idname = "object.fill_meshlattice"
+ bl_label = "Fill Mesh Lattice"
+ bl_options = {'REGISTER', 'UNDO'}
+
+ @classmethod
+ def poll(cls, context):
+ return context.active_object is not None and context.active_object.type == 'MESH'
+
+
+ def execute(self, context):
+ obj = context.active_object
+ name = obj.name + "Lattice"
+ bb = np.array([[x for x in y] for y in obj.bound_box], dtype=np.float32)
+ minp = bb.min(axis=0)
+ maxp = bb.max(axis=0)
+ dims = maxp - minp
+ lattice_mesh = context.scene.lattice_mesh
+ nelems = np.ceil((dims + lattice_mesh.cellsize)/ lattice_mesh.cellsize).astype(np.int32)
+ griddims = nelems.astype(np.float32) * lattice_mesh.cellsize
+ corner = ((maxp + minp) / 2.0) - (griddims /2.0)
+ corner = corner.reshape((1,3))
+
+ v, e = make_nplattice(Cells[lattice_mesh.celltype], lattice_mesh.cellsize, nelems, corner)
+ verts, edges = nplattice2meshdata(v, e)
+ bm, mesh = make_meshlattice(name, verts, edges, lattice_mesh.cellsize)
+ depsgraph = context.evaluated_depsgraph_get()
+ intersect(bm, obj, depsgraph)
+ bm.to_mesh(mesh)
+ bm.free()
+
+ newobj = bpy.data.objects.new(name, mesh)
+ newobj.matrix_world = obj.matrix_world.copy()
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+ return {'FINISHED'}
+
+
+class ObjectFillVoronoiLattice(bpy.types.Operator):
+ """Fill Voronoi Lattice"""
+ bl_idname = "object.fill_voronoilattice"
+ bl_label = "Fill Voronoi Lattice"
+ bl_options = {'REGISTER', 'UNDO'}
+
+ @classmethod
+ def poll(cls, context):
+ return have_scipy and context.active_object is not None and context.active_object.type == 'MESH'
+
+ def execute(self, context):
+ obj = context.active_object
+ name = obj.name + "Voronoi"
+ bb = np.array([[x for x in y] for y in obj.bound_box], dtype=np.float32)
+ minp = bb.min(axis=0)
+ maxp = bb.max(axis=0)
+ dims = maxp - minp
+ corner = minp
+ corner = corner.reshape((1,3))
+
+ lattice_mesh = context.scene.lattice_mesh
+ v, e = make_npvoronoi(lattice_mesh.charac_length, dims, corner)
+ verts, edges = nplattice2meshdata(v, e)
+ bm, mesh = make_meshlattice(name, verts, edges, lattice_mesh.charac_length)
+ depsgraph = context.evaluated_depsgraph_get()
+ intersect(bm, obj, depsgraph)
+ bm.to_mesh(mesh)
+ bm.free()
+
+ newobj = bpy.data.objects.new(name, mesh)
+ newobj.matrix_world = obj.matrix_world.copy()
+
+ # Link object to scene
+ bpy.context.scene.collection.objects.link(newobj)
+
+ return {'FINISHED'}
+
+
+
+
diff --git a/Lattesh/ui.py b/Lattesh/ui.py
new file mode 100644
index 0000000..9674022
--- /dev/null
+++ b/Lattesh/ui.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+# Copyright 2023 Ubiratan S. Freitas
+
+
+# This file is part of Lattesh.
+#
+# Lattesh is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your option)
+# any later version.
+#
+# Lattesh is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+# more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# Lattice Tools. If not, see <https://www.gnu.org/licenses/>.
+
+
+from bpy.types import Panel
+
+
+from .operators import have_scipy, have_occ
+
+
+# Test functions for polling
+def is_mode_object(context):
+ return context.mode == 'OBJECT'
+
+def is_active_object_mesh(context):
+ return context.active_object is not None and context.active_object.type == 'MESH'
+
+
+
+
+
+
+
+
+
+class View3DLatticePanel:
+ bl_category = "Lattices"
+ bl_space_type = 'VIEW_3D'
+ bl_region_type = 'UI'
+
+
+
+class VIEW3D_PT_lattices_generate(View3DLatticePanel, Panel):
+ bl_label = "Generate lattices"
+ bl_idname = "VIEW3D_PT_lattices_generate"
+
+ def draw(self, context):
+ layout = self.layout
+
+ lattice_mesh = context.scene.lattice_mesh
+
+ layout.label(text="Regular cells")
+ row = layout.row(align=True)
+ row.label(text="Cell size")
+ row.prop(lattice_mesh, "cellsize", text="")
+ row = layout.row(align=True)
+ row.label(text="Cell type")
+ row.prop(lattice_mesh, "celltype", text="")
+ row = layout.row(align=True)
+ row.label(text="Number of cells")
+ row.prop(lattice_mesh, "nelems", text="")
+ layout.operator("object.create_meshlattice")
+ layout.operator("object.fill_meshlattice")
+
+ layout.label(text="Random lattice")
+ row = layout.row(align=True)
+ row.label(text="Characteristic length")
+ row.prop(lattice_mesh, "charac_length", text="")
+ layout.operator("object.fill_voronoilattice")
+
+
+class VIEW3D_PT_lattice_OCC(View3DLatticePanel, Panel):
+ bl_label = "Opencascade fill"
+ bl_idname = "VIEW3D_PT_lattice_OCC"
+
+ @classmethod
+ def poll(cls, context):
+ return have_occ and is_mode_object(context) and is_active_object_mesh(context)
+
+ def draw(self, context):
+ lattice_mesh = context.scene.lattice_mesh
+
+ layout = self.layout
+ row = layout.row(align=True)
+ row.label(text="Strut radius")
+ row.prop(lattice_mesh, "radius", text="")
+ row = layout.row(align=True)
+ row.label(text="Linear deflection")
+ row.prop(lattice_mesh, "lin_deflect", text="")
+ row = layout.row(align=True)
+ row.label(text="Angular deflection")
+ row.prop(lattice_mesh, "ang_deflect", text="")
+
+ layout.operator("object.occlattice")
+
+
+class VIEW3D_PT_lattice_metaball(View3DLatticePanel, Panel):
+ bl_label = "Metaball fill"
+ bl_idname = "VIEW3D_PT_lattice_metaball"
+ bl_options = {"DEFAULT_CLOSED"}
+
+ @classmethod
+ def poll(cls, context):
+ return is_mode_object(context) and is_active_object_mesh(context)
+
+ def draw(self, context):
+ lattice_mesh = context.scene.lattice_mesh
+
+ layout = self.layout
+ row = layout.row(align=True)
+ row.label(text="Strut radius")
+ row.prop(lattice_mesh, "radius", text="")
+ row = layout.row(align=True)
+ row.label(text="Radius ratio")
+ row.prop(lattice_mesh, "r_ratio", text="")
+
+ layout.operator("object.metalattice")
+
+
+
\ No newline at end of file
--
GitLab