changelog for v4.7.0

Signed-off-by: Brian S. Stephan <bss@incorporeal.org>

.gitignore

@@ -1,3 +1,4 @@
 build/
+*.stl
 
 *.sw*

CHANGELOG.md

@@ -0,0 +1,211 @@
+# CHANGELOG
+
+Included is a summary of changes to the project, by version. Details can be found in the commit history.
+
+## v4.7.0
+
+### Features
+
+* Inner wall pieces where the horizontal stripes jut through the horizontal stripe windows have been added, these look
+  decent and avoid the outer wall feeling extremely flimsy. This piece uses a "longish" front/back piece which isn't
+  retained as a separate piece, because the latter is not meant to be printed itself.
+* I somehow went this whole time without creating a simple Sega 2P layout panel and decorative plate; those have been
+  added.
+* Prototype (still literally a bit rough) braces for the corners and middle have been added. These pieces cover up the
+  seams of the frame, and add some visual depth and distinction, but are not for everyone. YMMV.
+* A new "superplate" of the "directional arc + W" plus "sega 2P nine" layouts combined has been added, this is a piece I
+  ended up not using in a build, but it functions as well as any of the plates, so why not.
+
+### Improvements
+
+* Visible round edges have been made more round.
+* The single-24mm-button decorative disc has been shrunk a bit, since (IMO) it stood out a bit too much relative to the
+  button.
+* The "longish" extended side has been made a bit simpler to construct.
+* The side piece construction has been reworked, making it a bit simpler to construct and reducing the build complexity,
+  though preview mode still complains about 2-manifold errors.
+* The assembly documentation has been cleaned up, with more pieces explained a bit better as well.
+* Dustwashers got some small updates to shrink the size of the disc to the normal JLF dustwasher size, and to fit the
+  shaft a bit tighter without obstructing the lever's ability to... be a lever.
+
+### Miscellaneous
+
+* The build has been improved to error when there are issues in the .scad files, to keep me from making bad packages.
+* The back pieces are aligned properly in the all together demo.
+* Updates to the docs on my preferred printing settings.
+* README updates following the previous releases' reorganizations.
+* Objects README update to add attribution to TheTrain.
+
+## v4.6.0
+
+### Features
+
+* All frame pieces were updated to have flush edges, a la the "extended" sides, rather than the seam between the
+  front/back and the sides being at a 45 degree angle on some pieces, with the latter meaning that we were maintaining
+  two (complicated) duplicates of the same pieces because both 45 degree and 90 degree angles were necessary. This does
+  not affect the look of the build much, but simplifies the print and the maintenance of the project.
+* A slightly-extended flat side piece was added, to add just a bit of length to the overall build.
+
+### Improvements
+
+* One more slash has been added to the frame pieces, just for more interesting visuals.
+* The rectangle plates' positioning was tweaked slightly.
+
+### Fixes
+
+* The frame solid was very slightly shorter than it should have been as the corners relied on cylinders. The core solid
+  is now at its proper dimensions.
+
+## v4.5.0
+
+### Features
+
+* Many components for the Buildable Stick System - Arcade Edition --- pieces to create a control enclosure for the Qanba
+  2009 base! These pieces live in `extras/bss-ae/` but do use some parts from the base project; check that subdir's
+  README.
+* Created a Sega 2P 11 button layout, basically following the curve of the fourth column and adding a fifth, plus one
+  extra button
+* More decorative plates, this time square ones for an NES-styled project.
+
+### Improvements
+
+* Button layout positions for Sega 2P and directional arc layouts have been parameterized.
+* The decorative plates for the directional arc + W and Sega 2P 9 layout have been split into two files, since there was
+  no reason to keep them as one with multiple pieces anymore.
+* Tweaks to the horizontal stripes in order to get them to print better.
+* Renamed "Sega 2P plus one" to Sega 2P 9, following the pattern of the 11 layout.
+
+### Miscellaneous
+
+* Renaming of extended side pieces to fit the front/back idiom.
+* Cleanups to the demos.
+
+## v4.4.3
+
+### Features
+
+* Windowed frame wall pieces were made for the "clean" front/back walls that line up with the extended sides.
+
+### Improvements
+
+* The inner wall piece has been thickened, bringing its surface closer to the end of the outer wall windowed frame
+  pieces, making the window less deep and the inner wall easier to see.
+* The inner wall piece has been shrunken on the Z in order to leave some material on the outer wall and thus improve the
+  friction fit and clamp of the outer wall piece, which was too weakened by the unsupported top and bottom otherwise.
+
+### Miscellaneous
+
+* Documentation updates, especially around the printing of parts.
+* Corrected the names of some pieces that were accidentally duplicated from the file they were copied from rather than
+  what they were, or otherwise didn't match the standard pattern (such as it is).
+
+## v4.4.2
+
+### Bugfixes
+
+* Fix a regression with the small button screw-in space cutting into the frame wall supports. The screw-in space is
+  potentially more important for some nuts than the thickness of the frame wall supports, so the latter have been
+  thinned slightly.
+
+## v4.4.1
+
+### Features
+
+* A new lever + Sega 2P 6 button panel has been added. The overhang version hadn't been updated in forever, but the
+  inset panel moved stuff around in a way that allowed a couple aux buttons to fit in, so those have been added to the
+  overhang panel as well.
+* A horizontal stripe frame windowed piece has been added. YMMV may vary a bit on this vs. an empty window --- you can
+  see less of the inner object with the stripes, but it's a bit more stable.
+
+### Improvements
+
+* The frame wall slashes have been made a bit more reusable.
+* The area around button holes for screw-ins has been tweaked to be a bit smaller for 30mm buttons and a bit larger for
+  24mm buttons.
+
+### Miscellaneous
+
+* A bottom overhang panel was positioned incorrectly in the demo file; this has been fixed.
+* Added a demo of the one-panel overhang lever + 6 button stick.
+
+## v4.4.0
+
+### Features
+
+* New "windowed" frame box walls have been added, which allow for seeing through the outer wall to something else, such
+  as an inner wall of a different color, or for people who like showing off their wiring, nothing.
+* An attempt at a two-panel "shiokenstar" layout has been added.
+* The "plates" decorative plate for my favorite layout was altered since I wasn't using it anyway.
+
+### Improvements
+
+* The frame routing hole, in either the whole frames or the interconnect, is a semicircle on one side, making it easier
+  to wire (and rewire) a completed arcade stick, and it also makes button layouts that span the connection point more
+  possible.
+* Less of the inner wall is cut out for e.g. Neutrik and aux buttons now, removing the possibility for inset panels to
+  allow for a tiny bit of light to seep the cracks and giving panels a bit more support.
+* The piece-based frame walls now meet at 45 degree angles at the corners, which makes for fewer print anomalies to
+  catch your hand or clothing on. These 45 degree angles are not used for the TE1-style extended panels, which still
+  meet at 90 degree angles.
+* All of the core arcade stick parts, and extras, have been reorganized and renamed into subdirectories that make their
+  purpose more obvious. This also makes it clearer what you're looking at when looking at the project file structure.
+  Documentation was updated throughout for this change.
+
+### Miscellaneous
+
+* A stand for showing off inset-based sticks has been added to extras. This may get more love in a future release.
+* The blown up demo now uses frame pieces, as these are quickly becoming the standard build.
+* Cleanups to CONTRIBUTING.md
+* Demos have been given their own place in the repository.
+* The Makefile has been altered to use a Python script to build the files, due to the complexity of reorganizing the
+  project into subdirectories.
+* An abandoned floating stand has been moved into the attic --- it barely works right.
+
+## v4.3.x
+
+This finally removed the posts added to the panels introduced in v4.0.
+
+## v4.2.x
+
+This added TE1-like bevels to the repository, which look pretty neat.
+
+## v4.1.0
+
+Having improved the internals in v4.0.0, this broke out the frame into modular pieces, making them easier and more
+reliable to print, with only a trivial effect on the overall stability of the stick. This also made the bottom panels
+identical to the top, easing reuse.
+
+## v4.0.x
+
+This was an experiment that didn't survive scrutiny to add more posts to the frames and panels, in order to improve the
+friction fit, but it really just make the whole thing more obnoxious to work with. However, this redesign also came with
+some key improvements to the construction of the stick, which has made the subsequent releases easier to work with.
+
+## v3.3.x
+
+Largely a cleanup, this improved the component reuse and added more complete licensing information to the project.
+
+## v3.2.x
+
+This improved the frame height to accommodate more levers in inset panels, along with some cleanup.
+
+## v3.1.x
+
+This added panels for more layouts with more buttons, establishing my go-to of a lever, a directional arc with an extra
+button in a W-as-in-WASD position, and a Sega 2P-inspired 9-button action button layout.
+
+## v3.0.x
+
+I think the project really took shape at this point, as it resized the panels and frames to accommodate a two-panel
+layout for nice, long sticks.
+
+## v2.0.x
+
+This added the overhang plates to the mix, while still sticking to the three-panel design. It also started adding
+dustwashers and decorative plates, which improved the aesthetics of the project.
+
+## v1.0.x
+
+This was a simple three-panel stick that was somewhat ridiculously long, but worked, and built a lot of the foundation
+for the project. Its start as being inspired by the Open Stick really showed at this point, but things were coming
+together.

CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# Contributing Guidelines
+
+The Buildable Stick System is made available under the GPLv3 (or later) license. Contributions are welcome via pull
+requests. This document outlines the process to get your contribution accepted.
+
+## Sign Offs/Custody of Contributions
+
+I do not request the copyright of contributions be assigned to me or to the project, and I require no provision that I
+be allowed to relicense your contributions. My personal oath is to maintain inbound=outbound in my open source projects,
+and the expectation is authors are responsible for their contributions.
+
+I am following the [Developer Certificate of Origin (DCO)](https://developercertificate.org/), reproduced below. The DCO
+is a way for contributors to certify that they wrote or otherwise have the right to license their code contributions to
+the project. Contributors must sign-off that they adhere to these requirements by adding a `Signed-off-by` line to their
+commit message, and/or, for frequent contributors, by signing off on their entry in `MAINTAINERS.md`.
+
+```
+Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+    have the right to submit it under the open source license
+    indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+    of my knowledge, is covered under an appropriate open source
+    license and I have the right under that license to submit that
+    work with modifications, whether created in whole or in part
+    by me, under the same open source license (unless I am
+    permitted to submit under a different license), as indicated
+    in the file; or
+
+(c) The contribution was provided directly to me by some other
+    person who certified (a), (b) or (c) and I have not modified
+    it.
+
+(d) I understand and agree that this project and the contribution
+    are public and that a record of the contribution (including all
+    personal information I submit with it, including my sign-off) is
+    maintained indefinitely and may be redistributed consistent with
+    this project or the open source license(s) involved.
+```
+
+This process is followed by a number of open source projects, most notably the Linux kernel. Here's the gist of it:
+
+```
+[Your normal Git commit message here.]
+
+Signed-off-by: Random J Developer <random@developer.example.org>
+```
+
+`git help commit` has more info on adding this:
+
+```
+-s, --signoff
+    Add Signed-off-by line by the committer at the end of the commit log
+    message. The meaning of a signoff depends on the project, but it typically
+    certifies that committer has the rights to submit this work under the same
+    license and agrees to a Developer Certificate of Origin (see
+    http://developercertificate.org/ for more information).
+```

LICENSE

@@ -1,232 +1,674 @@
-GNU GENERAL PUBLIC LICENSE
+                    GNU GENERAL PUBLIC LICENSE
-Version 3, 29 June 2007
+                       Version 3, 29 June 2007
-
+
-Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
-
+ Everyone is permitted to copy and distribute verbatim copies
-Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+ of this license document, but changing it is not allowed.
-
+
-Preamble
+                            Preamble
-
+
-The GNU General Public License is a free, copyleft license for software and other kinds of works.
+  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.
+
-
+  The licenses for most software and other practical works are designed
-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 take away your freedom to share and change the works.  By contrast,
-
+the GNU General Public License is intended to guarantee your freedom to
-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.
+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
-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.
+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
-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.
+your programs, too.
-
+
-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.
+  When we speak of free software, we are referring to freedom, not
-
+price.  Our General Public Licenses are designed to make sure that you
-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.
+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
-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.
+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.
-The precise terms and conditions for copying, distribution and modification follow.
+
-
+  To protect your rights, we need to prevent others from denying you
-TERMS AND CONDITIONS
+these rights or asking you to surrender the rights.  Therefore, you have
-
+certain responsibilities if you distribute copies of the software, or if
-0. Definitions.
+you modify it: responsibilities to respect the freedom of others.
-
+
-“This License” refers to version 3 of the GNU General Public License.
+  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
-“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+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
-“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.
+know their rights.
-
+
-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.
+  Developers that use the GNU GPL protect your rights with two steps:
-
+(1) assert copyright on the software, and (2) offer you this License
-A “covered work” means either the unmodified Program or a work based on the Program.
+giving you legal permission to copy, distribute and/or modify it.
-
+
-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.
+  For the developers' and authors' protection, the GPL clearly explains
-
+that there is no warranty for this free software.  For both users' and
-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.
+authors' sake, the GPL requires that modified versions be marked as
-
+changed, so that their problems will not be attributed erroneously to
-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.
+authors of previous versions.
-
+
-1. Source Code.
+  Some devices are designed to deny users access to install or run
-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.
+modified versions of the software inside them, although the manufacturer
-
+can do so.  This is fundamentally incompatible with the aim of
-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.
+protecting users' freedom to change the software.  The systematic
-
+pattern of such abuse occurs in the area of products for individuals to
-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.
+use, which is precisely where it is most unacceptable.  Therefore, we
-
+have designed this version of the GPL to prohibit the practice for those
-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.
+products.  If such problems arise substantially in other domains, we
-
+stand ready to extend this provision to those domains in future versions
-The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+of the GPL, as needed to protect the freedom of users.
-
+
-The Corresponding Source for a work in source code form is that same work.
+  Finally, every program is threatened constantly by software patents.
-
+States should not allow patents to restrict development and use of
-2. Basic Permissions.
+software on general-purpose computers, but in those that do, we wish to
-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.
+avoid the special danger that patents applied to a free program could
-
+make it effectively proprietary.  To prevent this, the GPL assures that
-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.
+patents cannot be used to render the program non-free.
-
+
-Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+  The precise terms and conditions for copying, distribution and
-
+modification follow.
-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.
+                       TERMS AND CONDITIONS
-
+
-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.
+  0. Definitions.
-
+
-4. Conveying Verbatim Copies.
+  "This License" refers to version 3 of the GNU General Public License.
-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.
+
-
+  "Copyright" also means copyright-like laws that apply to other kinds of
-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.
+works, such as semiconductor masks.
-
+
-5. Conveying Modified Source Versions.
+  "The Program" refers to any copyrightable work licensed under this
-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:
+License.  Each licensee is addressed as "you".  "Licensees" and
-
+"recipients" may be individuals or organizations.
-     a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+
-
+  To "modify" a work means to copy from or adapt all or part of the work
-     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”.
+in a fashion requiring copyright permission, other than the making of an
-
+exact copy.  The resulting work is called a "modified version" of the
-     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.
+earlier work or a work "based on" the earlier work.
-
+
-     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 "covered work" means either the unmodified Program or a work based
-
+on the Program.
-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.
+
-
+  To "propagate" a work means to do anything with it that, without
-6. Conveying Non-Source Forms.
+permission, would make you directly or secondarily liable for
-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:
+infringement under applicable copyright law, except executing it on a
-
+computer or modifying a private copy.  Propagation includes copying,
-     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.
+distribution (with or without modification), making available to the
-
+public, and in some countries other activities as well.
-     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.
+
-
+  To "convey" a work means any kind of propagation that enables other
-     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.
+parties to make or receive copies.  Mere interaction with a user through
-
+a computer network, with no transfer of a copy, is not conveying.
-     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.
+
-
+  An interactive user interface displays "Appropriate Legal Notices"
-     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.
+to the extent that it includes a convenient and prominently visible
-
+feature that (1) displays an appropriate copyright notice, and (2)
-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.
+tells the user that there is no warranty for the work (except to the
-
+extent that warranties are provided), that licensees may convey the
-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.
+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
-“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.
+menu, a prominent item in the list meets this criterion.
-
+
-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).
+  1. Source Code.
-
+
-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.
+  The "source code" for a work means the preferred form of the work
-
+for making modifications to it.  "Object code" means any non-source
-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.
+form of a work.
-
+
-7. Additional Terms.
+  A "Standard Interface" means an interface that either is an official
-“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.
+standard defined by a recognized standards body, or, in the case of
-
+interfaces specified for a particular programming language, one that
-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.
+is widely used among developers working in that language.
-
+
-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:
+  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
-     a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
+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
-     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
+Major Component, or to implement a Standard Interface for which an
-
+implementation is available to the public in source code form.  A
-     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
+"Major Component", in this context, means a major essential component
-
+(kernel, window system, and so on) of the specific operating system
-     d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
+(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.
-     e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
+
-
+  The "Corresponding Source" for a work in object code form means all
-     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.
+the source code needed to generate, install, and (for an executable
-
+work) run the object code and to modify the work, including scripts to
-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.
+control those activities.  However, it does not include the work's
-
+System Libraries, or general-purpose tools or generally available free
-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.
+programs which are used unmodified in performing those activities but
-
+which are not part of the work.  For example, Corresponding Source
-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.
+includes interface definition files associated with source files for
-
+the work, and the source code for shared libraries and dynamically
-8. Termination.
+linked subprograms that the work is specifically designed to require,
-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).
+such as by intimate data communication or control flow between those
-
+subprograms and other parts of the work.
-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.
+
-
+  The Corresponding Source need not include anything that users
-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.
+can regenerate automatically from other parts of the Corresponding
-
+Source.
-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.
+
-
+  The Corresponding Source for a work in source code form is that
-9. Acceptance Not Required for Having Copies.
+same work.
-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.
+
-
+  2. Basic Permissions.
-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.
+  All rights granted under this License are granted for the term of
-
+copyright on the Program, and are irrevocable provided the stated
-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.
+conditions are met.  This License explicitly affirms your unlimited
-
+permission to run the unmodified Program.  The output from running a
-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.
+covered work is covered by this License only if the output, given its
-
+content, constitutes a covered work.  This License acknowledges your
-11. Patents.
+rights of fair use or other equivalent, as provided by copyright law.
-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”.
+
-
+  You may make, run and propagate covered works that you do not
-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.
+convey, without conditions so long as your license otherwise remains
-
+in force.  You may convey covered works to others for the sole purpose
-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.
+of having them make modifications exclusively for you, or provide you
-
+with facilities for running those works, provided that you comply with
-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.
+the terms of this License in conveying all material for which you do
-
+not control copyright.  Those thus making or running the covered works
-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.
+for you must do so exclusively on your behalf, under your direction
-
+and control, on terms that prohibit them from making any copies of
-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.
+your copyrighted material outside their relationship with you.
-
+
-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.
+  Conveying under any other circumstances is permitted solely under
-
+the conditions stated below.  Sublicensing is not allowed; section 10
-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.
+makes it unnecessary.
-
+
-12. No Surrender of Others' Freedom.
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-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.
+
-
+  No covered work shall be deemed part of an effective technological
-13. Use with the GNU Affero General Public License.
+measure under any applicable law fulfilling obligations under article
-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.
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
-
+similar laws prohibiting or restricting circumvention of such
-14. Revised Versions of this License.
+measures.
-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.
+
-
+  When you convey a covered work, you waive any legal power to forbid
-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.
+circumvention of technological measures to the extent such circumvention
-
+is effected by exercising rights under this License with respect to
-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.
+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
-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.
+users, your or third parties' legal rights to forbid circumvention of
-
+technological measures.
-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.
+  4. Conveying Verbatim Copies.
-
+
-16. Limitation of Liability.
+  You may convey verbatim copies of the Program's source code as you
-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.
+receive it, in any medium, provided that you conspicuously and
-
+appropriately publish on each copy an appropriate copyright notice;
-17. Interpretation of Sections 15 and 16.
+keep intact all notices stating that this License and any
-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.
+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
-END OF TERMS AND CONDITIONS
+recipients a copy of this License along with the Program.
-
+
-How to Apply These Terms to Your New Programs
+  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.
-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.
+
-
+  5. Conveying Modified Source Versions.
-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.
+
-
+  You may convey a work based on the Program, or the modifications to
-     <one line to give the program's name and a brief idea of what it does.>
+produce it from the Program, in the form of source code under the
-     Copyright (C) <year>  <name of author>
+terms of section 4, provided that you also meet all of these conditions:
-
+
-     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.
+    a) The work must carry prominent notices stating that you modified
-
+    it, and giving a relevant date.
-     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.
+
-
+    b) The work must carry prominent notices stating that it is
-     You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.
+    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:
+  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>
+    <program>  Copyright (C) <year>  <name of author>
-     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    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.
+    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”.
+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 <http://www.gnu.org/licenses/>.
+  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 <http://www.gnu.org/philosophy/why-not-lgpl.html>.
+  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>.

MAINTAINERS.md

@@ -0,0 +1,10 @@
+# Maintainers
+
+This file contains information about people permitted to make major decisions and direction on the project.
+
+## Contributing Under the DCO
+
+By adding your name and email address to this section, you certify that all of your subsequent contributions to the
+Buildable Stick System are made under the terms of the Developer's Certificate of Origin 1.1, available at `DCO.txt`.
+
+* Brian S. Stephan (<bss@incorporeal.org>)

Makefile

@@ -1,14 +1,13 @@
-SRC_FILES := $(wildcard ./src/*.scad)
+all:
-SRC_FILES := $(filter-out ./src/blown-up-demo.scad, $(SRC_FILES))
+	python build.py
-SRC_FILES := $(filter-out ./src/components.scad, $(SRC_FILES))
+	mkdir -p ./build/docs
-SRC_FILES := $(filter-out ./src/roundedcube.scad, $(SRC_FILES))
+	cp ./README.md ./build/README.md
-all: $(SRC_FILES)
+	cp ./docs/README-objects.md ./build/README-objects.md
-	mkdir -p ./build
+	cp ./docs/assembly-and-tips.md ./build/docs/assembly-and-tips.md
-	for file in $^ ; do \
+	cp ./docs/printing-and-materials.md ./build/docs/printing-and-materials.md
-		openscad -o $${file}.stl $${file} ; \
+	cp ./LICENSE ./build/LICENSE
-		mv $${file}.stl ./build/ ; \
+	cp ./CHANGELOG.md ./build/CHANGELOG.md
-	done
+	pushd ./build; zip ./buildable-stick-system-`git describe --dirty`-stls.zip . -r; popd
-	zip ./build/buildable-stick-system-`git describe --dirty`-stls.zip ./build/*
 
 clean:
 	rm -rf ./build

README.md

@@ -2,7 +2,21 @@
 
 Files for 3D printing an arcade stick.
 
-![An example of stick components displayed in OpenSCAD](docs/two-panel-example-v3.png)
+Have you ever wanted to conjure your own arcade stick out of the ether (well, plastic), or to prototype a new layout or
+design before sending it to a custom builder? Do you just love having your space filled with arcade stick enclosures,
+because you keep making different variants, colorways, and so on? Or do you simply want a good stick on the cheap, and
+know someone or a library with a 3D printer? The Buildable Stick System may be the project for you!
+
+**Join the project IRC channel: [#buildable-stick-system @
+Randomus](https://webirc.randomus.net/#buildable-stick-system)!**
+
+![An example of stick components displayed in OpenSCAD](docs/blown-up-demo.png)
+
+[OpenSCAD-based illustration of how the components for an overhang panel-based stick fit together.]
+
+![A photo of a completed stick](docs/finished-v4.4.jpg)
+
+[Photo of a completed inset panel-based stick.]
 
 Originally an attempt to make a couple customized STL files for the [OpenStickCommunity Fightstick
 Case](https://github.com/OpenStickCommunity/Hardware/tree/main/Fightstick%20Case), the changes ballooned to fit my
@@ -16,11 +30,52 @@ component objects or create new ones. The OpenSCAD language is essentially a fun
 it easy to reuse, alter, and compose objects. If you do not see the object you would like, you can likely create it by
 starting with an existing object and constructing what you'd like with new or existing components.
 
+## Usage of Parts
+
+There are a lot of parts to pick from, but there are some structural variants to pay attention to; here's some help
+about what the types of parts are and how to use them:
+
+* `frames/`
+    * `complete/` --- these are the four walls of the frame as one piece, in a couple variations for combining into
+      larger arcade sticks. They are simple to assemble, but you have fewer modularity/customization options, and they
+      are harder to print because the physics of the material cooling will probably pull the corners up. They also need
+      supports, since the top and bottom of the frame both have trays for panels to go into. Use at your own risk.
+    * `pieces/` these are the same four walls (generally speaking) as in the complete frames above, broken out into
+      modular pieces to print separately. Because they are separate pieces, you can mix and match colors, and you can
+      lay them all face down on the print surface for better adhesion and surface patterns. There are also variants
+      here, the "windowed" pieces, for doing two-tone variants and that kind of thing. There are also frame walls pulled
+      out to create MCZ TE-style extended sides. There is an interconnect that stands in for the joined inner wall
+      between boxes of the overall unit. You need this if you are combining multiple sets of walls, e.g. for a
+      two-panel-long stick.
+* `panels/`
+    * `inset/` --- various panels, all of the same size, that fit into and flush with the frame, making the arcade stick
+      top or bottom. Aside from using up a bit of the space for components inside the frame, come with no downsides ---
+      they print easily and are a pretty simple shape to tweak and remix.
+    * `overhang/` --- overhang panels have their plane extending over the edge of the frame, creating a bit of a
+      sandwich look. This is mostly an aesthetic choice, but they sit higher in the frame as well, the main panel being
+      over/under the frame rather than within it. This extra space is useful for taller levers. The only downside to
+      these is that they aren't as reusable as the inset panels, since the inset panels can go anywhere, but the
+      overhang panels must be designed to not overlap with other overhang panels, so you might have to make more custom
+      variants depending on where you put things.
+* `misc/`
+    * Pieces that I haven't organized better (yet) --- there are decorative plates for top buttons and similar to give
+      more color variance and some layers to the arcade stick, some very simple dustwashers, plates that fit rocker
+      switches and the like in Neutrik D or 20mm holes, and a lever mount spacer for getting your lever shaft at the
+      desired height. You don't *need* any of these, but you'll probably use a few.
+* `extras/`
+    * Various experiments and things not directly related to making an arcade stick. At time of writing, there's a
+      couple pieces for a little stand for the stick, solely for vanity purposes.
+        * `bss-ae/` --- these are pieces for an arcade control panel that fits on the Qanba 2009. See the docs in that
+          directory for details.
+
+Feel free to request or contribute to more objects. Additional documentation regarding assembling the stick is available
+in `docs/assembly-and-tips.md`.
+
 ## Printing
 
 These items all fit on a 256mm^2 print bed; I use a Bambu Lab P1P based on what I've learned from the
-OpenStickCommunity. Standard settings seem sufficiently sturdy for my purposes, though the slicer has done a couple
+OpenStickCommunity. Standard settings seem sufficiently sturdy, but see `docs/printing-and-materials.md` for more
-weird things, in my experience.
+thoughts and settings based on my tinkering with prints.
 
 ## Assembling
 
@@ -29,10 +84,14 @@ What you'll need beyond these objects:
 * An arcade stick board (I recommend [TheTrain's RP2040 Advanced Breakout
   Board](https://github.com/OpenStickCommunity/Hardware/tree/main/RP2040%20Advanced%20Breakout%20Board))
     * 4 M3 8mm hex bolts to secure the PCB to a panel
-* Per frame and plate combo:
+* Per frame and panel combo:
-    * 4 45mm M4 hex brass standoffs
+    * 4 45mm M4 hex brass standoffs (or equivalent)
-    * 8 12-16mm M4 countersunk hex bolts
+    * 8 M4 countersunk hex bolts
-* Per frame connection point:
+        * Overhang panels should use 12-16mm length bolts since they are taller
+        * Inset panels should probably use 8-12mm bolts --- some standoffs aren't threaded the whole way, making 16mm
+          too long to go flush
+        * If making the 45mm standoffs from multiple smaller ones, make sure they have enough length to take your bolts!
+* Per frame connection point (only necessary if you are using complete frames and not frame pieces):
     * 8 16mm M4 bolts
     * 8 M4 flange nuts
 * For a lever:
@@ -47,32 +106,34 @@ What you'll need beyond these objects:
 ## Rough Costs
 
 This is a rough estimate of the cost to produce one of these sticks, assuming a usual 2-frame design and layout.
-Filament masses from Bambu Studio estimates, using Bambu PLA Basic.
+Filament masses from Bambu Studio estimates, using Bambu PLA Basic, 20% gyroid infill and 3 wall loops.
 
-* Left and right frame: **$7.08 USD** (141.84g each, as of 2023-09-12)
+* Left and right frame: **$10.42 USD** (208.50g each, as of 2024-02-22)
-* Left and right top panels: **~$6.74 USD** (~135g each, as of 2023-09-12)
+* Left and right (inset) top panels: **~$6.40 USD** (~128g each, as of 2024-02-22)
-* Left and right bottom panels: **$5.90 USD** (118.16g each, as of 2023-09-12)
+* Left and right (non-overhang) bottom panels: **$6.80 USD** (135.99g each, as of 2024-02-22)
-* Miscellaneous mounting plates, decorative plates, etc.: **~$1.00 USD** (~40g, as of 2023-09-12)
+* Miscellaneous mounting plates, decorative plates, etc.: **~$1.83 USD** (~73g, as of 2024-02-22)
 * 8 16mm M4 bolts to connect the frames: **$0.72 USD** (you can get a pack of 100 on Amazon for $9, as of 2023-09-12)
+    * These are only necessary if you are using the whole frames, but as a heads up, the material cost of the
+      pieces-based interconnect piece costs around $1, so it's roughly a wash since that's also a frame wall.
 * 8 M4 flange nuts to connect the frames: **$0.68 USD** (you can get a pack of 100 on Amazon for $8.50, as of 2023-09-12)
 * 4 10mm M3 bolts to connect Neutrik D plates to frames: **$0.40 USD** (you can get a pack of 100 on Amazon for $10, as
   of 2023-09-12)
 * 4 M3 flange nuts to connect Neutrik D plates to frames: **$0.34 USD** (you can get a pack of 100 on Amazon for $8.50,
   as of 2023-09-12)
-* 8 45mm M4 spacers to connect panels to frames: **$2.40 USD** (you can get a pack of 10 on AliExpress for $3, as of
+* 8 45mm M4 standoffs to connect panels to frames: **$2.40 USD** (you can get a pack of 10 on AliExpress for $3, as of
   2023-09-12)
     * You could 3D print these too, but you're probably better off with brass ones as they give some weight to the
       stick anyway
-* 8 16mm M4 bolts to connect top plates to frames: **$0.72 USD** (you can get a pack of 100 on Amazon for $9, as of
+    * You can also use a shorter length with longer bolts, or combine multiple standoffs, if either of those yield better
-* 8 12mm M4 bolts to connect bottom plates to frames: **$0.72 USD** (you can get a pack of 100 on Amazon for $9, as of
+      prices
+* 8 16mm M4 bolts to connect top panels to frames: **$0.72 USD** (you can get a pack of 100 on Amazon for $9, as of
+* 8 12mm M4 bolts to connect bottom panels to frames: **$0.72 USD** (you can get a pack of 100 on Amazon for $9, as of
   2023-09-12)
-    * You may be tempted to use 16mm M4 bolts for both the top and bottom, but the spacers I have aren't threaded all
-      the way through the shaft, and 16mm bolts won't make it all the way on the bottom panel, but do on the top panel
-      (which is 5mm thicker); be careful I guess
 
-With an enclosure coming in around $26, depending on your choices --- say, ~$30 for TheTrain's RP2040 Advanced Breakout
+With an enclosure coming in around $31, depending on your choices --- say, ~$30 for TheTrain's RP2040 Advanced Breakout
 Board, ~$60 for Sanwa buttons and a lever, and ~$20 for miscellaneous connectors and wiring --- you can put a
-full-featured controller with an open source foundation together for around $135.
+full-featured controller with an open source foundation together for around $140. Reducing wall and infill settings
+will probably save you around $5 of material, and you can probably decide what you want to do from there.
 
 ## Miscellany
 
@@ -90,8 +151,33 @@ Improvements, variants, new layouts, novel ideas, and etc. are all welcome.
 These files are suitable for previewing and rendering in OpenSCAD. They may also work in FreeCAD and perhaps other
 software, but they are developed in OpenSCAD, so YMMV otherwise.
 
+This project is hosted at [my personal Git site](https://git.incorporeal.org/bss/buildable-stick-system), but people are
+more likely to want to interact with [the GitHub mirror](https://github.com/bsstephan/buildable-stick-system). Feel free
+to use either.
+
+I'm reachable on the fediverse, over email, or on Discord, but if you're looking for an option I prefer, I maintain an
+IRC channel, `#buildable-stick-system`, on [my IRC network, Randomus](https://randomus.net/) if you would like a place
+to hang out and discuss issues and features and whatnot.
+
 ## Attribution
 
+### Author and Licensing
+
+Written by and copyright Brian S. Stephan (<bss@incorporeal.org>).
+
+The Buildable Stick System 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.
+
+The Buildable Stick System 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 the Buildable Stick System. If not, see
+<https://www.gnu.org/licenses/>.
+
+### Lineage
+
 Inspired by the incredible work of [TheTrain](https://github.com/TheTrainGoes) on the [OpenStickCommunity Fightstick
 Case](https://github.com/OpenStickCommunity/Hardware/tree/main/Fightstick%20Case), itself based on the incredible work
 by [Dash n'Mash](https://twitter.com/Dash_xx_Mash?s=20). Original work Copyright 2023 TheTrain, [licensed under CC BY
@@ -99,16 +185,13 @@ by [Dash n'Mash](https://twitter.com/Dash_xx_Mash?s=20). Original work Copyright
 
 Made possible by the amazing efforts of [slagcoin](https://www.slagcoin.com/).
 
-## Author and Licensing
+### Distributing BSS Sticks
 
-Written by and copyright Brian S. Stephan (<bss@incorporeal.org>).
+Under the terms of the GPLv3, you must inform the receiver of the "object code" of their rights under the GPLv3. This is
+a bit of a gray area for physical objects, but likely applies to distribution of modified or unmodified STL, STEP, etc.
+files at a minimum. The easiest way to satisfy the GPLv3 in either situation is to provide a link to the source code
+(either the unmodified mainline project, or your copy, with modifications listed in a "prominent notice"); something
+like the below should suffice in either electronic or printed form:
 
-The Buildable Stick System is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
+> This arcade stick is part of the Buildable Stick System, version X.Y.Z; the source code to this program is available
-License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
+> under the terms of the GNU General Public License, at [LINK].
-version.
-
-The Buildable Stick System 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 the Buildable Stick System. If not, see
-<https://www.gnu.org/licenses/>.

TODO.md

@@ -2,9 +2,10 @@
 
 Notes for "next time".
 
-## v4
+## v4.x
 
-* Engraving some cosmetic stuff? Or maybe a place to mount other plates?
+* Engraving some cosmetic stuff? Or maybe a place to mount other plates on the top?
-* Try making it so top plates are bolted in from the side of the frame rather than the top
+
-    * I'm thinking of abandoning this, because it makes the frame more complicated to have a portion of a column rather
+## v5
-      than the full column, but I'll keep it here for a bit longer
+
+* Finishing the build123d rewrite?

attic/README.md

@@ -0,0 +1,4 @@
+# The Attic
+
+This directory includes abandoned pieces that I'd like to revisit some time, but I cannot support or recommend using
+as-is. Print at your own caution, or better yet, maybe fix them!

attic/extras/tower-of-hovering-power-mount.scad

@@ -0,0 +1,68 @@
+/*
+ * A stick mount that fits rectangular (non-extended) BSS sticks.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <../parameters.scad>
+include <../components.scad>
+
+holder_x = 114;
+holder_y = 60;
+holder_z = 45;
+tall_holder_post = frame_y-10;
+
+module stick_holder() {
+	difference() {
+		cube([holder_x, holder_y, holder_z], center=true);
+		translate([14, 0, 132]) rotate([90, -40, 0]) frame_solid();
+	}
+}
+
+module mount() {
+	difference() {
+		union() {
+			// lowest post
+			translate([62, -frame_z-25, holder_z/2]) stick_holder();				// top = 45
+
+			// middle post
+			translate([0, 0, ((tall_holder_post)/2)/2])
+				cube([holder_x, holder_y, (tall_holder_post)/2], center=true);
+			translate([0, 0, ((tall_holder_post)/2)+holder_z/2]) stick_holder();			// top = 139
+
+			// highest post
+			translate([-62, frame_z+25, tall_holder_post/2])
+				cube([holder_x, holder_y, tall_holder_post], center=true);
+			translate([-62, frame_z+25, tall_holder_post+holder_z/2]) stick_holder();		// top = 233
+
+			// post stabilizers
+			translate([31, -41, holder_z/2]) cube([52, 23, holder_z], center=true);
+			translate([-31, 41, ((tall_holder_post/2)+holder_z)/2])
+				cube([52, 23, (tall_holder_post/2)+holder_z], center=true);
+
+			// base
+			hull() {
+				translate([110, 103, -2.5]) cylinder(r=15, h=5, center=true);
+				translate([110, -103, -2.5]) cylinder(r=15, h=5, center=true);
+				translate([-110, 103, -2.5]) cylinder(r=15, h=5, center=true);
+				translate([-110, -103, -2.5]) cylinder(r=15, h=5, center=true);
+			}
+
+			// placard
+			translate([0, -112, 15]) cube([frame_y, 5, 30], center=true);
+
+			/* // test */
+			/* translate([62+14, -frame_z-25, 132+holder_z/2]) rotate([90, -40, 0]) frame_solid(); */
+			/* translate([14, 0, 132+(frame_y/2)-20+holder_z/2]) rotate([90, -40, 0]) frame_solid(); */
+			/* translate([-62+14, frame_z+25, 132+tall_holder_post+holder_z/2]) rotate([90, -40, 0]) frame_solid(); */
+		}
+		// text on the placard
+		translate([-frame_z*3.3/2.5, -holder_x, 15]) rotate([90, 0, 0])
+			linear_extrude(1) text("Buildable Stick System", font="Noto Sans");
+		translate([-frame_z*3.3/2.5, -holder_x, 4]) rotate([90, 0, 0])
+			linear_extrude(1) text("v4 by bss", font="Noto Sans", size=6);
+	}
+}
+
+mount();

build.py

@@ -0,0 +1,52 @@
+"""Compile all OpenSCAD files into a build directory and package it with docs.
+
+(a.k.a.: "make is hard"
+
+SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+SPDX-License-Identifier: GPL-3.0-or-later
+"""
+import os
+import os.path
+import re
+import subprocess
+
+PROJECT_ROOT = os.path.abspath(os.getcwd())
+BUILD_DIR = os.path.join(PROJECT_ROOT, 'build/')
+SOURCE_DIR = os.path.join(PROJECT_ROOT, 'src/')
+
+EXCLUDES = ['components.scad', 'parameters.scad']
+
+# set up our environment to point openscad at the right stuff
+os.environ['OPENSCADPATH'] = SOURCE_DIR
+
+# track processes to wait on
+processes = []
+
+os.chdir(SOURCE_DIR)
+for root, dirs, files in os.walk('.'):
+    print(f"{root} {dirs} {files}")
+    # make the current directory so that openscad can write stuff into it
+    try:
+        os.makedirs(os.path.join(BUILD_DIR, root))
+    except FileExistsError:
+        pass
+
+    input_dir = os.path.join(SOURCE_DIR, root)
+    output_dir = os.path.join(BUILD_DIR, root)
+    for file in files:
+        if not re.match(r'.*\.scad$', file):
+            continue
+        if file in EXCLUDES:
+            continue
+
+        stl_file = re.sub(r'\.scad$', '.stl', file)
+        input_ = os.path.join(input_dir, file)
+        output = os.path.join(output_dir, stl_file)
+        cmd = f'openscad --hardwarnings -o {output} {input_}'
+        print(cmd)
+        processes.append(subprocess.Popen(cmd.split(' ')))
+
+for process in processes:
+    process.wait()
+    if process.returncode != 0:
+        raise Exception(f"building {process.args} failed")

demo/all-together-demo-extended-with-windows.scad

@@ -0,0 +1,37 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/side-trapezoid.scad>
+use <frames/pieces/front-or-back-aux-and-neutrik.scad>
+use <frames/pieces/front-or-back-windowed-horiz-stripes.scad>
+use <panels/inset/lever-and-dir_arc-plus-w-30mm-panel.scad>
+use <panels/inset/sega-2p-nine-plus-control-panel-with-mount.scad>
+use <misc/decorative-plate-24mm-button.scad>
+use <misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine.scad>
+use <misc/dustwasher-lsx-nobi.scad>
+
+top_panel_color        = "#5B6579";
+bottom_panel_color     = "#8E9089";
+frame_top_bottom_color = "#8E9089";
+frame_side_color       = "#8E9089";
+top_deco_color         = "#8E9089";
+
+color(top_panel_color) translate([-panel_x/2, 0, frame_z/2-panel_z+0.01]) lever_and_dir_arc_w_30mm_panel();
+color(top_panel_color) translate([panel_x/2, 0, frame_z/2-panel_z+0.01]) sega_2p_nine_plus_control_panel_with_mount();
+color(frame_side_color) translate([-frame_x/2+4, 0, -2.5]) side_trapezoid_frame_piece();
+color(frame_side_color) translate([frame_x/2-4, 0, -2.5]) mirror([1, 0, 0]) side_trapezoid_frame_piece();
+color(frame_top_bottom_color) translate([-frame_x/2+4, 0, -2.5])  horiz_striped_windowed_front_or_back_frame_piece();
+color(frame_top_bottom_color) translate([frame_x/2-4, 0, -2.5])  horiz_striped_windowed_front_or_back_frame_piece();
+color(frame_top_bottom_color) translate([-frame_x/2+4, 0, -2.5]) rotate([180, 0, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(frame_top_bottom_color) translate([frame_x/2-4, 0, -2.5]) rotate([180, 180, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(bottom_panel_color) translate([-panel_x/2, 0, -5-frame_z/2+5]) panel();
+color(bottom_panel_color) translate([panel_x/2, 0, -5-frame_z/2+5]) panel();
+
+/* color(top_deco_color) translate([0, 0, 3+frame_z/2-4]) dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate_of_plates(); */
+color(top_deco_color) translate([0, 0, 3+frame_z/2-panel_z]) dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate();
+color(top_deco_color) translate([-170, 20, 3+frame_z/2-panel_z]) lsx_nobi_dustwasher();
+color(top_deco_color) translate([panel_x-24, 30, 3+frame_z/2-panel_z]) button_24mm_decorative_plate();

demo/all-together-demo-extended.scad

@@ -0,0 +1,36 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/front-or-back-trapezoid.scad>
+use <frames/pieces/side-trapezoid-extended-to-front-trapezoid.scad>
+use <frames/pieces/front-or-back-aux-and-neutrik.scad>
+use <panels/inset/lever-and-dir_arc-plus-w-30mm-panel.scad>
+use <panels/inset/sega-2p-nine-plus-control-panel-with-mount.scad>
+use <misc/decorative-plate-24mm-button.scad>
+use <misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine.scad>
+use <misc/dustwasher-lsx-nobi.scad>
+
+top_panel_color        = "#5B6579";
+bottom_panel_color     = "#8E9089";
+frame_top_bottom_color = "#8E9089";
+frame_side_color       = "#8E9089";
+top_deco_color         = "#8E9089";
+
+color(top_panel_color) translate([-panel_x/2, 0, frame_z/2-panel_z+0.01]) lever_and_dir_arc_w_30mm_panel();
+color(top_panel_color) translate([panel_x/2, 0, frame_z/2-panel_z+0.01]) sega_2p_nine_plus_control_panel_with_mount();
+color(frame_side_color) translate([-frame_x/2+4, 0, -2.5]) side_trapezoid_extended_to_front_frame_piece();
+color(frame_side_color) translate([frame_x/2-4, 0, -2.5]) mirror([1, 0, 0]) side_trapezoid_extended_to_front_frame_piece();
+color(frame_top_bottom_color) translate([-frame_x/2+4, 0, -2.5])  front_or_back_trapezoid_frame_piece();
+color(frame_top_bottom_color) translate([frame_x/2-4, 0, -2.5])  front_or_back_trapezoid_frame_piece();
+color(frame_top_bottom_color) translate([-frame_x/2+4, 0, -2.5]) rotate([180, 0, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(frame_top_bottom_color) translate([frame_x/2-4, 0, -2.5]) rotate([180, 180, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(bottom_panel_color) translate([-panel_x/2, 0, -5-frame_z/2+5]) panel();
+color(bottom_panel_color) translate([panel_x/2, 0, -5-frame_z/2+5]) panel();
+
+color(top_deco_color) translate([0, 0, 3+frame_z/2-panel_z]) dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate();
+color(top_deco_color) translate([-170, 20, 3+frame_z/2-panel_z]) lsx_nobi_dustwasher();
+color(top_deco_color) translate([panel_x-24, 30, 3+frame_z/2-panel_z]) button_24mm_decorative_plate();

demo/all-together-demo-solo.scad

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/front-or-back-trapezoid.scad>
+use <frames/pieces/side-trapezoid-extended-to-front-trapezoid.scad>
+use <frames/pieces/front-or-back-aux-and-neutrik.scad>
+use <panels/inset/lever-and-dir_arc-plus-w-30mm-panel.scad>
+use <panels/inset/lever-and-sega-2p-6-button-panel-with-aux-with-mount.scad>
+use <misc/dustwasher-jlf.scad>
+
+top_panel_color        = "#5B6579";
+bottom_panel_color     = "#8E9089";
+frame_top_bottom_color = "#8E9089";
+frame_side_color       = "#8E9089";
+top_deco_color         = "#000000";
+
+color(top_panel_color) translate([0, 0, frame_z/2-panel_z+0.01]) lever_and_sega_2p_6_button_panel_with_aux_with_mount();
+color(frame_side_color) translate([0, 0, -2.5]) side_trapezoid_extended_to_front_frame_piece();
+color(frame_side_color) translate([0, 0, -2.5]) mirror([1, 0, 0]) side_trapezoid_extended_to_front_frame_piece();
+color(frame_top_bottom_color) translate([0, 0, -2.5])  front_or_back_trapezoid_frame_piece();
+color(frame_top_bottom_color) translate([0, 0, -2.5]) rotate([180, 0, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(bottom_panel_color) translate([0, 0, -5-frame_z/2+5]) panel();
+
+color(top_deco_color) translate([-65, 5, 3+frame_z/2-panel_z]) jlf_dustwasher();

demo/all-together-demo.scad

@@ -0,0 +1,41 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/side.scad>
+use <frames/pieces/front-or-back.scad>
+use <frames/pieces/front-or-back-aux-and-neutrik.scad>
+use <panels/inset/lever-and-dir_arc-plus-w-30mm-panel.scad>
+use <panels/inset/sega-2p-nine-plus-control-panel-with-mount.scad>
+use <misc/decorative-plate-24mm-button.scad>
+use <misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine.scad>
+use <misc/dustwasher-lsx-nobi.scad>
+use <misc/decorative-corner.scad>
+
+panel_color    = "red";
+base_color     = "gray";
+top_deco_color = "white";
+brace_color    = "gray";
+
+color(panel_color) translate([-panel_x/2, 0, frame_z/2-panel_z/2+0.001]) lever_and_dir_arc_w_30mm_panel();
+color(panel_color) translate([panel_x/2, 0, frame_z/2-panel_z/2+0.001]) sega_2p_nine_plus_control_panel_with_mount();
+color(base_color) translate([panel_x/2, 0, 0]) rotate([0, 180, 0]) side_frame_piece();
+color(base_color) translate([-panel_x/2, 0, 0]) side_frame_piece();
+color(base_color) translate([panel_x/2, 0, 0]) front_or_back_frame_piece();
+color(base_color) translate([-panel_x/2, 0, 0]) front_or_back_frame_piece();
+color(base_color) translate([panel_x/2, 0, 0]) rotate([180, 180, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(base_color) translate([-panel_x/2, 0, 0]) rotate([180, 0, 0]) front_or_back_aux_and_neutrik_frame_piece();
+color(base_color) translate([-panel_x/2, 0, -frame_z/2+panel_z/2]) panel();
+color(base_color) translate([panel_x/2, 0, -frame_z/2+panel_z/2]) panel();
+
+color(brace_color) translate([-panel_x/2, 0, 0]) decorative_corner();
+color(brace_color) mirror([1, 0, 0]) translate([-panel_x/2, 0, 0]) decorative_corner();
+color(brace_color) mirror([0, 1, 0]) translate([-panel_x/2, 0, 0]) decorative_corner();
+color(brace_color) mirror([1, 0, 0]) mirror([0, 1, 0]) translate([-panel_x/2, 0, 0]) decorative_corner();
+
+color(top_deco_color) translate([0, 0, 4+frame_z/2-panel_z/2+0.001]) dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate();
+color(top_deco_color) translate([-170, 20, 4+frame_z/2-panel_z/2+0.001]) lsx_nobi_dustwasher();
+color(top_deco_color) translate([panel_x-24, 30, 4+frame_z/2-panel_z/2+0.001]) button_24mm_decorative_plate();

demo/blown-up-demo.scad

@@ -0,0 +1,34 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/interconnect.scad>
+use <frames/pieces/side.scad>
+use <frames/pieces/front-or-back.scad>
+use <frames/pieces/front-or-back-aux-and-neutrik.scad>
+use <panels/overhang/left-lever-and-dir_arc-plus-w-30mm-panel.scad>
+use <panels/overhang/right-sega-2p-nine-plus-control-panel-with-mount.scad>
+use <panels/overhang/left-or-right-panel.scad>
+use <misc/decorative-plate-24mm-button.scad>
+use <misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine.scad>
+use <misc/dustwasher-lsx-nobi.scad>
+
+color("#C12E1F") translate([-panel_x/2-25, 0, frame_z/2+75]) lever_and_dir_arc_w_30mm_left_overhang_panel();
+color("#C12E1F") translate([panel_x/2+25, 0, frame_z/2+75]) sega_2p_nine_plus_control_right_overhang_panel_with_mount();
+color("black") translate([-frame_x/2+5-25, -55, -2.5]) front_or_back_frame_piece();
+color("black") rotate([0, 180, 0]) translate([-frame_x/2+5-25, -55, -2.5]) front_or_back_frame_piece();
+color("black") translate([-frame_x/2+5-50, 0, -2.5]) side_frame_piece();
+color("black") rotate([0, 180, 0]) translate([-frame_x/2+5-50, 0, -2.5]) side_frame_piece();
+color("black") rotate([180, 0, 0]) translate([-frame_x/2+5-25, -55, -2.5]) front_or_back_aux_and_neutrik_frame_piece();
+color("black") rotate([180, 0, 0]) rotate([0, 180, 0]) translate([-frame_x/2+5-25, -55, -2.5]) front_or_back_aux_and_neutrik_frame_piece();
+color("black") rotate([0, 180, 0]) interconnect_frame_piece();
+color("#C12E1F") translate([-panel_x/2-25, 0, -5-frame_z/2-75]) left_or_right_overhang_panel();
+color("#C12E1F") mirror([0, 1, 0]) translate([panel_x/2+25, 0, -5-frame_z/2-75]) rotate([0, 0, 180])
+	left_or_right_overhang_panel();
+
+color("black") translate([0, 0, 3+frame_z/2+150]) dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate();
+color("black") translate([-195, 25, 3+frame_z/2+150]) lsx_nobi_dustwasher();
+color("black") translate([panel_x, 25, 3+frame_z/2+150]) button_24mm_decorative_plate();

docs/README-objects.md

@@ -0,0 +1,49 @@
+# The Buildable Stick System
+
+Files for 3D printing an arcade stick. See `README.md` for the core documentation, this file is specific to distributed
+objects.
+
+## Attribution
+
+### Author and Licensing
+
+Written by and copyright Brian S. Stephan (<bss@incorporeal.org>).
+
+These arcade stick parts are from the Buildable Stick System; the source code to this program is available under the
+terms of the GNU General Public License, at:
+
+* <https://github.com/bsstephan/buildable-stick-system>, or
+* <https://git.incorporeal.org/bss/buildable-stick-system>
+
+See the tags/releases for the version of the source code corresponding to the STLs you received.
+
+The Buildable Stick System 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.
+
+The Buildable Stick System 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 the Buildable Stick System. If not, see
+<https://www.gnu.org/licenses/>.
+
+### Lineage
+
+Inspired by the incredible work of [TheTrain](https://github.com/TheTrainGoes) on the [OpenStickCommunity Fightstick
+Case](https://github.com/OpenStickCommunity/Hardware/tree/main/Fightstick%20Case), itself based on the incredible work
+by [Dash n'Mash](https://twitter.com/Dash_xx_Mash?s=20). Original work Copyright 2023 TheTrain, [licensed under CC BY
+4.0](https://creativecommons.org/licenses/by/4.0/).
+
+Made possible by the amazing efforts of [slagcoin](https://www.slagcoin.com/).
+
+### Distributing BSS Sticks
+
+Under the terms of the GPLv3, you must inform the receiver of the "object code" of their rights under the GPLv3. This is
+a bit of a gray area for physical objects, but likely applies to distribution of modified or unmodified STL, STEP, etc.
+files at a minimum. The easiest way to satisfy the GPLv3 in either situation is to provide a link to the source code
+(either the unmodified mainline project, or your copy, with modifications listed in a "prominent notice"); something
+like the below should suffice in either electronic or printed form:
+
+> This arcade stick is part of the Buildable Stick System, version X.Y.Z; the source code to this program is available
+> under the terms of the GNU General Public License, at [LINK].

docs/assembly-and-tips.md

@@ -0,0 +1,72 @@
+# Assembly and Tips
+
+These are the parts you need and instructions for creating a simple two panel arcade stick. The end product is a
+rectangular prism roughly 18" long, with ample space for back buttons and enough top panel space for almost any layout
+you can imagine. There are more pieces and designs to experiment with, but this will get you an awesome "standard"
+build.
+
+## Parts for a Basic Enclosure
+
+The pieces you need to print (all colors to your taste):
+
+* **The base frame:** `frame/pieces/front-or-back.stl` x2 + `frame/pieces/front-or-back-aux-and-neutrik.stl` x2 +
+  `frame/pieces/interconnect.stl`. This creates a large "H" with six 24mm button holes and two Neutrik D holes on the
+  back, which can mount USB connectors or rocker switches, or be covered if not used. All four of the front or back
+  pieces connect to the interconnect piece, which creates one frame out of the individual pieces, and also adds some
+  support to the center of the enclosure. The interconnect has a large hole that can either make wire routing easier, or
+  leave space in the center for button layouts that span it.
+* **The frame sides:** `frame/pieces/side.stl` x2. These cap the "H", completing the overall frame.
+* **The top:** `panels/inset/[LAYOUTS].stl`. These panels go on the top of the frame and are where you mount all of your
+  main buttons and levers and whatnot. There are a couple layouts whose panels are meant to be paired (e.g.
+  `shiokenstar-left-panel.stl` and `shiokenstar-right-panel.stl`), but usually you simply pick a left panel (e.g.
+  `lever-panel-with-mount.stl`) and right panel (e.g. `sega-2p-panel.stl`) based on what you want. Note that one of your
+  choices should be "with mount", which is where the usually-sized PCB will screw into inside the box.
+* **The bottom:** `panels/inset/panel.stl` x2. Other than being the color of your choice, these just close the box.
+  You could put foam pads or something on these if you wanted.
+
+The above gets you the basics. Some common things you may also want:
+
+* **Mounting Neutrik connectors:** Neutrik D connectors can mount flush to the inside of the frame, but you can choose
+  to have a little decorative plate (`misc/neutrik-d-plate.stl` for added depth or color choices on the outside of the
+  frame, if you'd like.
+* **Mounting a 24mm switch:** a rocker switch can also be mounted in the Neutrik D connector, but it needs to be placed
+  into a `misc/neutrik-d-plate-24mm-hole.stl` plate, and the plate mounted to the frame.
+* **Flair for the auxillary buttons:** the three buttons in a row on the back of the frame can also get some style, just
+  place a `misc/decorative-plate-aux-control-three-button-cluster.stl` between the buttons and the frame. This only
+  works for screw-in buttons.
+* **Flair for the top buttons:** same as above, a decorative plate for top panel layouts --- e.g.
+  `misc/decorative-plate-sega-2p.stl` --- can be sandwiched between the buttons and panel to add some style. This also
+  only tends to work on screw-in buttons.
+* **Dustwashers/flair:** same deal, if you want to print one, use e.g. `misc/dustwasher-jlf.stl`.
+
+## Putting a BSS Stick Together
+
+Assembly of a stick is pretty straightforward, but there are some choices that can make it easier or harder. The
+following is the most consistent way I've found to put one together.
+
+1. Prepare the frame pieces: this is your best shot to get the e.g. Neutrik plates for the USB mount, SPDT switches, etc.
+   installed, so do it now, and give them a good tighten. You shouldn't need to adjust these again, so finish their
+   installation while the pieces are free.
+    1. You could also do the decorative plates and related buttons, but it might be just as well to leave those for step 7,
+       just to make sure the buttons don't get in the way of other buttons or a lever or so on.
+2. Start the top panels: you want both to get the components installed now when it's easy, and to make sure that the
+   overall assembly works with your components, so again get your buttons, lever, etc., in place. You can secure them at
+   this point.
+    1. If you are using a button decorative plate that spans two panels --- e.g.
+       `misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-plus-one` --- take care to align the two panels as tightly
+       as possible, and accurately, as they will be hard to adjust once everything is secured and in the frame.
+    2. If using a lever, don't forget the lever mount spacer --- `misc/lever-mount-sanwa-seimitsu` --- if you want it,
+       and tighten those mounting bolts now as well.
+3. Create the frame box by combining your frame piece parts, box or extended, together. This will be relatively stable
+   just via friction fit.
+4. Rest the frame top-up on a desk, and put the standoffs through the holes. This will probably be tight, and you may
+   even need a rubber mallet or similar to drive the standoffs through the holes.
+5. Insert the top panels into the frame.
+6. Insert the bolts for the top panels, make any last adjustments, and tighten them.
+7. At this point you have an open box with access to all your components. Do all of your wiring.
+    1. Tighten the buttons and etc. if you didn't in step 2.
+8. Insert the bottom panels into the frame.
+9. Insert the bottom bolts for the bottom panels, and tighten them.
+
+In the end, this should be extremely sturdy. None of the frame or panels should be loose at all, and you should be able
+to move, flip, gently toss, etc. the stick without anything moving or feeling loose.

docs/materials.md

@@ -1,24 +0,0 @@
-# Materials
-
-bss's random thoughts and notes on 3D printing materials.
-
-## Bambu Lab PLA
-
-### Basic
-
-* In general, nice texture, but under direct light, you can see a bit of the infill pattern through the walls. Not super
-  distracting, but it's there.
-
-#### White
-
-* Walls are practically translucent, you can almost always see the infill. Do not use for major components.
-* Looks perfectly good for thin things like the Neutrik plates, decorative pieces, that kind of thing.
-
-### Matte
-
-* I don't like the texture as much, but they do produce nice non-primary color colorways, and you don't see the infill.
-* Seems like their plastic treatment leaves some plate residue, so be better about cleaning it or you'll get ghosts.
-
-## Hatchbox PLA
-
-* Haven't done a lot of this yet, but my wife really likes the blue.

docs/printing-and-materials.md

@@ -0,0 +1,88 @@
+# Printing and Materials
+
+bss's random thoughts and notes on the actual printing of the Buildable Stick System.
+
+## Printing Settings
+
+My preferred settings are 3 wall loops with 25% gyroid sparse infill. This gives the models a bit more weight and
+strength against bowing forces, but something more default, like 2 wall loops, 15% grid sparse infill, is fine and does
+not lead to a weak enclosure.
+
+### Supports and Positioning
+
+All of the parts are designed to be printed outside-face-down. The bevels are at an angle (45 degrees) that should print
+fine with no supports. Make sure everything is aligned properly on your plate so that the flat face you will look at the
+most is on the bottom.
+
+The only exception to this is the interconnect piece(s), which are not visible and need a support to print. Maybe one
+day I'll rejigger these.
+
+### Working With Flatness
+
+A lot of the pieces are long and flat, so I recommend really dialing in your printer settings. The frame pieces make
+corner curling of the frame less of a problem, but you may still get it on the panels and the beveled frame pieces.
+
+#### Bottom Layer Notes
+
+Considering the visible layer (usually, the bottom layer) pattern is ideal. Monotonic prints fast but creates long,
+uniform lines that create reflection patterns on long, flat surfaces. This can be especially distracting for the top
+panels and their decorative plates, since they're what you're looking at 90% of the time, and the holes break up a
+perfect pattern, making the long lines stand out even more.
+
+Some specific parts are worth some additional notes:
+
+* **Top panels:** using a non-uniform pattern reduces if not eliminates the problem of the surface catching the light,
+  but for some patterns, it may come at the expense of time.
+    * **Avoid:** monotonic.
+    * **Good for the time:** Archimedean chords create the look of a circular ripple radiating out the center, and
+      depending on the material, you may not even notice it much, so it's a pretty good look/speed balance.
+    * **Great if you can wait:** hilbert curve leaves no discernable pattern on most materials, but some high gloss,
+      high contrast materials may show the winding pattern at some angles --- consider Archimedean chords for these.
+* **Circle-centric decorative plates:** simple ones could be fine in whatever, but the ones for action buttons end up
+  having lots of weird interaction points.
+    * **Avoid:** none; monotonic doesn't look *good*, but the plates don't have enough surface area for the pattern to
+      stand out too much.
+    * **Decent:** concentric is generally good, but you can get some pitting when the pattern radiating away from
+      buttons collides with other patterns, because none of the geometry lines up well.
+    * **Great:** Archimedean chords, just crank up the infill/wall overlap to avoid pits on the edges.
+* **Frame walls with Neutrik or aux button cutouts:** a reduced but similar problem with the action button decorative
+  plates, the circles near each other create weird interactions with the walls.
+    * **Avoid:** concentric, again, has problems with pitting where geometries clash.
+    * **Decent:** monotonic is pretty decent here, and you probably won't look at the sides too much, so maybe it
+      doesn't bother you.
+    * **Great:** Archimedean chords again, with the same infill/wall overlap as decorative plates.
+* **Flush frame walls:** you can pretty much do whatever you like here.
+    * **Great:** concentric produces an interesting pattern and you won't have collision problems in a rectangle.
+    * **Essentially great:** Archimedean chords yet again, you may just not like the pattern as much as the end result
+      of concentric.
+
+The Archimedean chord pattern is a good default and prints awesome parts, with the only exception being the top panels,
+which benefit from using a Hilbert curve initial layer pattern instead, though you may be happy enough with Archimedean
+chord.
+
+## Materials
+
+Some notes on PLA brands, usages, etc.
+
+### Bambu Lab PLA
+
+#### Basic
+
+* In general, nice texture, but under direct light, you can see a bit of the infill pattern through the walls. Not super
+  distracting, but it's there.
+
+##### White
+
+* Walls are practically translucent, you can almost always see the infill. 3 wall loops and a varying infill pattern
+  definitely help here.
+* Looks perfectly good for thin things like the Neutrik plates, decorative pieces, that kind of thing.
+
+#### Matte
+
+* I don't like the texture as much, but they do produce nice non-primary color colorways, and you don't see the infill.
+* Seems like their plastic treatment leaves some plate residue, so be better about cleaning it or you'll get ghosts.
+
+### Hatchbox PLA
+
+* **Blue:** very blue. Wife likes it.
+* **White:** more opaque than the Bambu PLA mentioned above, makes a pretty decent (still slightly translucent) frame.

src/blown-up-demo.scad

@@ -1,39 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <frame-left.scad>
-use <frame-right.scad>
-use <top-panel-left-lever-and-dir_arc-plus-w-30mm.scad>
-use <top-panel-right-sega-2p-plus-one-plus-control-with-mount.scad>
-use <bottom-panel-left.scad>
-use <bottom-panel-right.scad>
-use <misc-decorative-plate-24mm-button.scad>
-use <misc-decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-plus-one.scad>
-use <misc-dustwasher-lsx-nobi.scad>
-
-color("#C12E1F") translate([-top_plate_x/2-25, 0, frame_z/2+75]) top_panel_left_lever_and_dir_arc_w_30mm();
-color("#C12E1F") translate([top_plate_x/2+25, 0, frame_z/2+75]) top_panel_right_sega_2p_plus_one_plus_control_with_mount();
-color("black") translate([-frame_x/2+5-25, 0, -2.5]) left_frame();
-color("black") translate([frame_x/2+25, 0, -2.5]) right_frame();
-color("#C12E1F") translate([-top_plate_x/2-25, 0, -5-frame_z/2-75]) bottom_panel_left();
-color("#C12E1F") translate([top_plate_x/2+25, 0, -5-frame_z/2-75]) bottom_panel_right();
-
-color("black") translate([0, 0, 3+frame_z/2+150]) dir_arc_plus_w_30mm_and_sega_2p_plus_one_decorative_plate();
-color("black") translate([-195, 25, 3+frame_z/2+150]) lsx_nobi_dustwasher();
-color("black") translate([top_plate_x, 25, 3+frame_z/2+150]) button_24mm_decorative_plate();

src/bottom-panel-left.scad

@@ -1,30 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <bottom-panel-solo.scad>
-
-module bottom_panel_left() {
-	difference() {
-		bottom_panel_solo();
-		// chop the right edge off
-		side_chopper();
-	}
-}
-
-bottom_panel_left();

src/bottom-panel-middle.scad

@@ -1,30 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <bottom-panel-left.scad>
-use <bottom-panel-right.scad>
-
-module bottom_panel_middle() {
-	intersection() {
-		bottom_panel_left();
-		bottom_panel_right();
-	}
-}
-
-bottom_panel_middle();

src/bottom-panel-no-overhang.scad

@@ -1,28 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module bottom_panel() {
-	difference() {
-		mirror([0, 0, 1]) topplate();
-		translate([0, 0, top_plate_z/2]) cube([top_plate_x*5/6, top_plate_y*5/6, top_plate_z], center=true);
-	}
-}
-
-bottom_panel();

src/bottom-panel-right.scad

@@ -1,26 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <bottom-panel-left.scad>
-
-module bottom_panel_right() {
-	rotate([0, 0, 180]) bottom_panel_left();
-}
-
-bottom_panel_right();

src/bottom-panel-solo.scad

@@ -1,28 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module bottom_panel_solo() {
-	difference() {
-		bottom_plate_with_overhang();
-		translate([0, 0, top_plate_z/2]) cube([top_plate_x*5/6, top_plate_y*5/6, top_plate_z], center=true);
-	}
-}
-
-bottom_panel_solo();

src/components.scad

@@ -1,86 +1,8 @@
-/* Copyright Brian Stephan 2023
+/*
- *
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
- * This file is part of the Buildable Stick System.
+ * SPDX-License-Identifier: GPL-3.0-or-later
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
  */
 
-include <roundedcube.scad>
-
-/* QUASI-CONSTANTS */
-
-// adjustments
-hole_tolerance = 0.15;
-
-// M3
-m3_screw_selftap_radius = 1.3;
-
-// M4
-m4_bolt_radius = 2 + hole_tolerance;
-m4_bolt_countersink_radius = 6.1 + hole_tolerance;
-m4_bolt_hex_exterior_radius = 3.6 + hole_tolerance;
-
-// 24mm button
-small_button_radius = 12 + hole_tolerance;
-
-// 30mm button
-big_button_radius = 15 + hole_tolerance;
-
-// JLF mount dimensions
-lever_mount_x = 53;
-lever_mount_y = 95;
-lever_mount_z = 2;
-
-// case dimensions
-// base frame box. reminder: top of inside (including mounts) is chopped by top_plate_z for plates
-frame_x = 233;
-frame_y = 208;
-frame_z = 50;
-
-// depth of the "lip" of the frame that the top plate sets into/supports the overhang
-frame_wall = 8;
-
-// per neutrik (mm)
-neutrik_panel_thickness = 3;
-
-// top plate, which can either be the whole plate ("inset") or the mounting frame for a plate that overhangs
-top_plate_x = frame_x - frame_wall;
-top_plate_y = frame_y - frame_wall;
-top_plate_z = 5;
-
-// how much the top plate x/y is expanded to overhang the frame
-// note that this is relative to the top plate (so the wall is added back)
-top_plate_overhang_amount = frame_wall + 17;
-overhang_top_plate_x = top_plate_x + top_plate_overhang_amount;
-overhang_top_plate_y = top_plate_y + top_plate_overhang_amount;
-
-plate_to_frame_point_x = (top_plate_x/2)-10;
-plate_to_frame_point_y = (top_plate_y/2)-10;
-
-// frame interior that supports the top plates
-panel_support_width = 5;
-
-// neutrik D screw holes
-neutrik_d_screw_radius = 1.6 + hole_tolerance;
-neutrik_d_radius = 12 + hole_tolerance;
-
-// additional button radius for decorative panels, etc.
-decorative_radius = 12;
-jumbo_decorative_radius = 15;
-
-/* PARTS */
-
 module m4_hole() {
 	cylinder(r=m4_bolt_radius, h=100, $fn=50, center=true);
 }
@@ -89,43 +11,45 @@ module m4_hole_countersink() {
 	cylinder(r1=m4_bolt_radius, r2=m4_bolt_countersink_radius, h=3.2, $fn=50, center=true);
 }
 
-module top_plate_holes() {
+module m6_hole() {
+	cylinder(r=m6_bolt_radius, h=100, $fn=50, center=true);
+}
+
+module panel_holes() {
 	// holes for mount bolts
-	translate([plate_to_frame_point_x, plate_to_frame_point_y, 0]) m4_hole();
+	translate([panel_to_frame_point_x, panel_to_frame_point_y, 0]) m4_hole();
-	translate([plate_to_frame_point_x, -plate_to_frame_point_y, 0]) m4_hole();
+	translate([panel_to_frame_point_x, -panel_to_frame_point_y, 0]) m4_hole();
-	translate([-plate_to_frame_point_x, plate_to_frame_point_y, 0]) m4_hole();
+	translate([-panel_to_frame_point_x, panel_to_frame_point_y, 0]) m4_hole();
-	translate([-plate_to_frame_point_x, -plate_to_frame_point_y, 0]) m4_hole();
+	translate([-panel_to_frame_point_x, -panel_to_frame_point_y, 0]) m4_hole();
 	// holes for mount bolt countersinks
-	translate([plate_to_frame_point_x, plate_to_frame_point_y, 2]) m4_hole_countersink();
+	translate([panel_to_frame_point_x, panel_to_frame_point_y, 2]) m4_hole_countersink();
-	translate([plate_to_frame_point_x, -plate_to_frame_point_y, 2]) m4_hole_countersink();
+	translate([panel_to_frame_point_x, -panel_to_frame_point_y, 2]) m4_hole_countersink();
-	translate([-plate_to_frame_point_x, plate_to_frame_point_y, 2]) m4_hole_countersink();
+	translate([-panel_to_frame_point_x, panel_to_frame_point_y, 2]) m4_hole_countersink();
-	translate([-plate_to_frame_point_x, -plate_to_frame_point_y, 2]) m4_hole_countersink();
+	translate([-panel_to_frame_point_x, -panel_to_frame_point_y, 2]) m4_hole_countersink();
 }
 
 // button hole, with extra wide bits for various uses (cutting out space
 // for snap-ins, etc.
 module button_24mm_hole() {
-	cylinder(r=small_button_radius, h=100, $fn=50, center=true);
+	cylinder(r=small_button_radius, h=100, $fn=100, center=true);
-	// carve out space for snap-ins, leave 3mm
+	// carve out space for snap-ins and screw-in nuts
-	// slagcoin has screw-in nut diameter at 29.5mm, so radius+6 to leave some space
 	// translation is to leave 3mm thickness in the plate without recentering anything
-	translate([0, 0, -25]) cylinder(r=small_button_radius+6, h=49, $fn=50, center=true);
+	translate([0, 0, -25]) cylinder(r=small_button_radius+button_radius_connector_space, h=49, $fn=100, center=true);
 	// space for decorative button surround stuff
-	translate([0, 0, 50]) cylinder(r=small_button_radius+decorative_radius, h=20, $fn=50, center=true);
+	translate([0, 0, 50]) cylinder(r=small_button_radius*decorative_radius_scale, h=20, $fn=100, center=true);
-	translate([0, 0, 70]) cylinder(r=small_button_radius+jumbo_decorative_radius, h=20, $fn=50, center=true);
+	translate([0, 0, 70]) cylinder(r=small_button_radius*jumbo_decorative_radius_scale, h=20, $fn=100, center=true);
 }
 
 // button hole, with extra wide bits for various uses (cutting out space
 // for snap-ins, etc.
 module button_30mm_hole() {
-	cylinder(r=big_button_radius, h=100, $fn=50, center=true);
+	cylinder(r=big_button_radius, h=100, $fn=100, center=true);
-	// carve out space for snap-ins, leave 3mm
+	// carve out space for snap-ins and screw-in nuts
-	// slagcoin has screw-in nut diameter at 36mm, so radius+6 to leave some space
 	// translation is to leave 3mm thickness in the plate without recentering anything
-	translate([0, 0, -25]) cylinder(r=big_button_radius+6, h=49, $fn=50, center=true);
+	translate([0, 0, -25]) cylinder(r=big_button_radius+button_radius_connector_space, h=49, $fn=100, center=true);
 	// space for decorative button surround stuff
-	translate([0, 0, 50]) cylinder(r=big_button_radius+decorative_radius, h=20, $fn=50, center=true);
+	translate([0, 0, 50]) cylinder(r=big_button_radius*decorative_radius_scale, h=20, $fn=100, center=true);
-	translate([0, 0, 70]) cylinder(r=big_button_radius+jumbo_decorative_radius, h=20, $fn=50, center=true);
+	translate([0, 0, 70]) cylinder(r=big_button_radius*jumbo_decorative_radius_scale, h=20, $fn=100, center=true);
 }
 
 module frame_hex_bolt_hole() {
@@ -133,7 +57,7 @@ module frame_hex_bolt_hole() {
 }
 
 module frame_interchange_hole() {
-	cylinder(r=15, h=50, $fn=50, center=true);
+	cylinder(r=37, h=50, $fn=50, center=true);
 }
 
 module neutrik_d_hole() {
@@ -150,9 +74,49 @@ module neutrik_d_mount() {
 	translate([-9.5, -12, 0]) neutrik_d_screw_hole();
 }
 
-// space for a neutrik D mount or 24mm button
+module rocker_20mm_mount() {
+	cylinder(r=10+hole_tolerance, h=5, $fn=50, center=true);
+	cube([2.2, 22, 5], center=true);
+	translate([9.5, 12, 0]) neutrik_d_screw_hole();
+	translate([-9.5, -12, 0]) neutrik_d_screw_hole();
+}
+
+// space for a neutrik D mount or 24mm button --- Z is meant to leave some lip now that frames
+// are primarily printed on their side
 module frame_cutout() {
-	cube([36.5, 8, 40], center=true);
+	cube([35, 8, frame_z-(panel_z*3)], center=true);
+}
+
+// bank of three 24mm buttons, commonly on a frame face
+module aux_control_three_button_cluster() {
+	translate([-37, 0, 0]) button_24mm_hole();
+	translate([0, 0, 0]) button_24mm_hole();
+	translate([37, 0, 0]) button_24mm_hole();
+}
+
+module aux_control_three_button_tight_cluster() {
+	translate([-32, 0, 0]) button_24mm_hole();
+	translate([0, 0, 0]) button_24mm_hole();
+	translate([32, 0, 0]) button_24mm_hole();
+}
+
+module m2_mount_post() {
+	difference() {
+		cylinder(r=m2_screw_selftap_radius*2.25, h=3, $fn=6, center=true);
+		cylinder(r=m2_screw_selftap_radius, h=3*2, $fn=50, center=true);
+	}
+}
+
+module oled_ssd1306_mount() {
+	translate([11.5, 12, 0]) m2_mount_post();
+	translate([11.5, -12, 0]) m2_mount_post();
+	translate([-11.5, 12, 0]) m2_mount_post();
+	translate([-11.5, -12, 0]) m2_mount_post();
+}
+
+module oled_ssd1306_mount_cutout() {
+	translate([0, 1.9, 0]) cube([25, 14, 5], center=true);
+	translate([0, 0, -1.0]) cube([35, 35, 4], center=true);
 }
 
 module m3_mount_post() {
@@ -184,7 +148,7 @@ module levermountbase() {
 // should work with JLF, JLW, LS-32, LS-33, LS-40, LS-55, LS-56
 module levermountholes() {
 	// joystick hole
-	cylinder(r=12, h=5.1, $fn=50, center=true);
+	cylinder(r=lever_plate_hole, h=5.1, $fn=50, center=true);
 	// holes for joystick bolts
 	translate([20, 42.5, 0])
 		m4_hole();
@@ -194,6 +158,9 @@ module levermountholes() {
 		m4_hole();
 	translate([-20, -42.5, 0])
 		m4_hole();
+}
+
+module levermountcountersinks() {
 	// holes for joystick bolt countersinks
 	translate([20, 42.5, 2])
 		m4_hole_countersink();
@@ -205,62 +172,142 @@ module levermountholes() {
 		m4_hole_countersink();
 }
 
-module base_topplate() {
+module base_panel() {
-	cube([top_plate_x, top_plate_y, top_plate_z], center=true);
+	cube([panel_x, panel_y, panel_z], center=true);
+}
+
+module panel() {
+	difference() {
+		base_panel();
+		panel_holes();
+	}
 }
 
 module overhang_plate() {
-	roundedcube([overhang_top_plate_x, overhang_top_plate_y, top_plate_z], center=true, radius=1);
+	top_points = [
+		// top bevel
+		[(overhang_panel_x/2)-(overhang_panel_bevel_height*2),
+		 (overhang_panel_y/2)-(overhang_panel_bevel_height*2),
+		 panel_z/2-overhang_panel_bevel_height/2],
+		[-(overhang_panel_x/2)+(overhang_panel_bevel_height*2),
+		 (overhang_panel_y/2)-(overhang_panel_bevel_height*2),
+		 panel_z/2-overhang_panel_bevel_height/2],
+		[(overhang_panel_x/2)-(overhang_panel_bevel_height*2),
+		 -(overhang_panel_y/2)+(overhang_panel_bevel_height*2),
+		 panel_z/2-overhang_panel_bevel_height/2],
+		[-(overhang_panel_x/2)+(overhang_panel_bevel_height*2),
+		 -(overhang_panel_y/2)+(overhang_panel_bevel_height*2),
+		 panel_z/2-overhang_panel_bevel_height/2],
+	];
+	hull() {
+		for (p = top_points) {
+			translate(p) cylinder(r=overhang_panel_bevel_height, h=overhang_panel_bevel_height, center=true);
+		}
+		translate([0, 0, -overhang_panel_bevel_height])
+			cube([overhang_panel_x, overhang_panel_y, panel_z-overhang_panel_bevel_height*2], center=true);
+	}
 }
 
-// this takes the base_topplate and makes it a small frame, putting a larger top plate
+// this takes the base_panel and makes it a small frame, putting a larger top plate
-module base_top_plate_with_raised_overhang() {
+module base_panel_with_raised_overhang() {
 	// make a frame out of the top plate (and keep the main plate on the center plane)
 	translate([0, 0, -5]) difference() {
-		base_topplate();
+		base_panel();
-		cube([top_plate_x-(panel_support_width*2), top_plate_y-(panel_support_width*2), top_plate_z*2], center=true);
+		cube([panel_x-(panel_support_width*2), panel_y-(panel_support_width*2), panel_z], center=true);
 	}
-	translate([plate_to_frame_point_x, plate_to_frame_point_y, -2.5]) resize([0, 0, 10]) frame_mount_column();
+	translate([panel_to_frame_point_x, panel_to_frame_point_y, -2.5]) resize([0, 0, 10])
-	translate([-(plate_to_frame_point_x), plate_to_frame_point_y, -2.5]) resize([0, 0, 10]) frame_mount_column();
+		frame_mount_column();
-	translate([plate_to_frame_point_x, -(plate_to_frame_point_y), -2.5]) resize([0, 0, 10]) frame_mount_column();
+	translate([-(panel_to_frame_point_x), panel_to_frame_point_y, -2.5]) resize([0, 0, 10])
-	translate([-(plate_to_frame_point_x), -(plate_to_frame_point_y), -2.5]) resize([0, 0, 10]) frame_mount_column();
+		rotate([0, 0, 90]) frame_mount_column();
+	translate([panel_to_frame_point_x, -(panel_to_frame_point_y), -2.5]) resize([0, 0, 10])
+		rotate([0, 0, 270]) frame_mount_column();
+	translate([-(panel_to_frame_point_x), -(panel_to_frame_point_y), -2.5]) resize([0, 0, 10])
+		rotate([0, 0, 180]) frame_mount_column();
 	overhang_plate();
 }
 
-module topplate() {
+module panel_with_raised_overhang() {
 	difference() {
-		base_topplate();
+		base_panel_with_raised_overhang();
-		top_plate_holes();
+		panel_holes();
 	}
 }
 
-module bottom_plate_with_overhang() {
+module frame_solid() {
 	difference() {
-		overhang_plate();
+		top_points = [
-		rotate([180, 0, 0]) top_plate_holes();
+			// top bevel
-	}
+			[(frame_x/2)-(frame_bevel_height*2),
-}
+			 (frame_y/2)-(frame_bevel_height*2),
-
+			 frame_z/2-frame_bevel_height/2],
-module top_plate_with_raised_overhang() {
+			[-(frame_x/2)+(frame_bevel_height*2),
-	difference() {
+			 (frame_y/2)-(frame_bevel_height*2),
-		base_top_plate_with_raised_overhang();
+			 frame_z/2-frame_bevel_height/2],
-		top_plate_holes();
+			[(frame_x/2)-(frame_bevel_height*2),
+			 -(frame_y/2)+(frame_bevel_height*2),
+			 frame_z/2-frame_bevel_height/2],
+			[-(frame_x/2)+(frame_bevel_height*2),
+			 -(frame_y/2)+(frame_bevel_height*2),
+			 frame_z/2-frame_bevel_height/2],
+		];
+		base_points = [
+			// majority of shape
+			[(frame_x/2)-frame_bevel_height, (frame_y/2)-frame_bevel_height, 0],
+			[-(frame_x/2)+frame_bevel_height, (frame_y/2)-frame_bevel_height, 0],
+			[(frame_x/2)-frame_bevel_height, -(frame_y/2)+frame_bevel_height, 0],
+			[-(frame_x/2)+frame_bevel_height, -(frame_y/2)+frame_bevel_height, 0],
+		];
+		bottom_points = [
+			// bottom bevel
+			[(frame_x/2)-(frame_bevel_height*2),
+			 (frame_y/2)-(frame_bevel_height*2),
+			 -frame_z/2+frame_bevel_height/2],
+			[-(frame_x/2)+(frame_bevel_height*2),
+			 (frame_y/2)-(frame_bevel_height*2),
+			 -frame_z/2+frame_bevel_height/2],
+			[(frame_x/2)-(frame_bevel_height*2),
+			 -(frame_y/2)+(frame_bevel_height*2),
+			 -frame_z/2+frame_bevel_height/2],
+			[-(frame_x/2)+(frame_bevel_height*2),
+			 -(frame_y/2)+(frame_bevel_height*2),
+			 -frame_z/2+frame_bevel_height/2],
+		];
+		hull() {
+			for (p = top_points) {
+				translate(p) cylinder(r=2, h=frame_bevel_height, center=true, $fn=4);
+			}
+			for (p = base_points) {
+				translate(p) cylinder(r=2, h=frame_z-(frame_bevel_height*2), center=true, $fn=4);
+			}
+			for (p = bottom_points) {
+				translate(p) cylinder(r=2, h=frame_bevel_height, center=true, $fn=4);
+			}
+		}
 	}
 }
 
 module frame_box() {
 	difference() {
-		roundedcube([frame_x, frame_y, frame_z], center=true, radius=3);
+		frame_solid();
-		cube([top_plate_x-(panel_support_width*2), top_plate_y-(panel_support_width*2), frame_z+5], center=true);
+		// cut out the middle to make it a box
+		cube([panel_x-(panel_support_width*2), panel_y-(panel_support_width*2), frame_z+5], center=true);
 	}
 }
 
 module frame_mount_column() {
-	cube([20, 20, frame_z], center=true);
+	cube([frame_mount_column_width, frame_mount_column_width, frame_z], center=true);
+	// add some corners back to do a lame chamfer
+	linear_extrude(height=frame_z, center=true)
+		polygon([
+			[frame_mount_column_width/2, frame_mount_column_width/2],
+			[-frame_mount_column_width, frame_mount_column_width/2],
+			[frame_mount_column_width/2, -frame_mount_column_width]
+		]);
 }
 
 module side_chopper() {
-	translate([frame_x/2+4, 0, 0]) cube([16, 2*(frame_y+top_plate_y), 2*(frame_z+top_plate_z)], center=true);
+	translate([(frame_x-frame_wall)/2+panel_overhang_amount, 0, 0])
+		cube([frame_wall+panel_overhang_amount*2, overhang_panel_y, frame_z], center=true);
 }
 
 module frame_connection_holes() {
@@ -276,28 +323,46 @@ module frame_connection_holes() {
 }
 
 module frame_cable_routing_hole() {
-	translate([frame_x/2, 0, 0]) rotate([0, 90, 0]) frame_interchange_hole();
+	// frame_y/12 is a hack for "kinda a bit above the center point"
+	translate([frame_x/2, frame_y/12+1, 25]) rotate([0, 90, 0]) frame_interchange_hole();
 }
 
 module base_frame() {
 	frame_box();
-	translate([plate_to_frame_point_x, plate_to_frame_point_y, 0]) frame_mount_column();
+	translate([panel_to_frame_point_x, panel_to_frame_point_y, 0]) frame_mount_column();
-	translate([-plate_to_frame_point_x, plate_to_frame_point_y, 0]) frame_mount_column();
+	translate([-panel_to_frame_point_x, panel_to_frame_point_y, 0]) rotate([0, 0, 90]) frame_mount_column();
-	translate([plate_to_frame_point_x, -(plate_to_frame_point_y), 0]) frame_mount_column();
+	translate([-panel_to_frame_point_x, -(panel_to_frame_point_y), 0]) rotate([0, 0, 180])  frame_mount_column();
-	translate([-plate_to_frame_point_x, -(plate_to_frame_point_y), 0]) frame_mount_column();
+	translate([panel_to_frame_point_x, -(panel_to_frame_point_y), 0]) rotate([0, 0, 270])  frame_mount_column();
 }
 
 module frame() {
 	difference() {
 		base_frame();
-		translate([0, 0, frame_z/2]) scale([1, 1, 2]) base_topplate();
+		translate([0, 0, frame_z/2]) scale([1, 1, 2]) base_panel();
-		translate([plate_to_frame_point_x, plate_to_frame_point_y, 0]) frame_hex_bolt_hole();
+		translate([0, 0, -frame_z/2]) scale([1, 1, 2]) base_panel();;
-		translate([-plate_to_frame_point_x, plate_to_frame_point_y, 0]) frame_hex_bolt_hole();
+		translate([panel_to_frame_point_x, panel_to_frame_point_y, 0]) frame_hex_bolt_hole();
-		translate([plate_to_frame_point_x, -plate_to_frame_point_y, 0]) frame_hex_bolt_hole();
+		translate([-panel_to_frame_point_x, panel_to_frame_point_y, 0]) frame_hex_bolt_hole();
-		translate([-plate_to_frame_point_x, -plate_to_frame_point_y, 0]) frame_hex_bolt_hole();
+		translate([panel_to_frame_point_x, -panel_to_frame_point_y, 0]) frame_hex_bolt_hole();
+		translate([-panel_to_frame_point_x, -panel_to_frame_point_y, 0]) frame_hex_bolt_hole();
 	}
 }
 
+/* MISC SHAPES --- for cutting out decorative panels, frame wall windows, etc. */
+
+// for cutting out slashes from the frame outer wall
+module slash_cutout() {
+	polyhedron([
+		[slash_inner_displacement/2, -wall_cutout_depth, -slash_height/2],
+		[(slash_inner_displacement/2+slash_width), -wall_cutout_depth, -slash_height/2],
+		[(slash_inner_displacement/2+slash_width), wall_cutout_depth, -slash_height/2],
+		[slash_inner_displacement/2, wall_cutout_depth, -slash_height/2],
+		[-(slash_inner_displacement/2+slash_width), -wall_cutout_depth, slash_height/2],
+		[-slash_inner_displacement/2, -wall_cutout_depth, slash_height/2],
+		[-slash_inner_displacement/2, wall_cutout_depth, slash_height/2],
+		[-(slash_inner_displacement/2+slash_width), wall_cutout_depth, slash_height/2]
+	], [[0, 1, 2, 3], [4, 5, 1, 0], [7, 6, 5, 4], [5, 6, 2, 1], [6, 7, 3, 2], [7, 4, 0, 3]]);
+}
+
 /* LAYOUTS */
 
 // Directional Arc (both hands)
@@ -311,49 +376,76 @@ module dir_arc_24mm_directionals() {
 
 module dir_arc_24mm_6_button() {
 	dir_arc_24mm_directionals();
-	translate([29.5+26.3+15.5+9.7+2.6, 0, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8, 0, 0]) button_24mm_hole();
-	translate([29.5+26.3+15.5+9.7+2.6+26.9, 10.9, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9, 10.9, 0]) button_24mm_hole();
-	translate([29.5+26.3+15.5+9.7+2.6+26.9+29.6, 10.9, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9+29.6, 10.9, 0]) button_24mm_hole();
 	translate([29.5+26.3+15.5+9.7, -29.4, 0]) button_24mm_hole();
-	translate([29.5+26.3+15.5+9.7+2.6+26.9-1.7, 10.9-30.1, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9-1.7, 10.9-30.1, 0]) button_24mm_hole();
-	translate([29.5+26.3+15.5+9.7+2.6+26.9+29.6, 10.9-30.1, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9+29.6-0.2, 10.9-30.1, 0]) button_24mm_hole();
+}
+
+module dir_arc_24mm_8_button() {
+	dir_arc_24mm_6_button();
+	translate([29.5+26.3+27.8+26.9+29.6+29.5, 7.1, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9+29.6+29.5-0.3, -23.9, 0]) button_24mm_hole();
 }
 
 // 6 button plus the normal fourth column for 8 button actually on a third row
 module dir_arc_24mm_8_button_compressed() {
 	dir_arc_24mm_6_button();
-	translate([29.5+26.3+15.5+9.7+2.6+2.6, 29.4, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+2.6, 29.4, 0]) button_24mm_hole();
-	translate([29.5+26.3+15.5+9.7+2.6+26.9+2.6, 40.3, 0]) button_24mm_hole();
+	translate([29.5+26.3+27.8+26.9+2.6, 40.3, 0]) button_24mm_hole();
+}
+
+module dir_arc_plus_w_24mm_8_button() {
+	dir_arc_24mm_8_button();
+	translate([36, 28, 0]) button_24mm_hole();
 }
 
 // Directional Arc (left hand)
 
 module dir_arc_30mm_thumb_button() {
 	// just my guesstimate on this one, but note that this is the same position as sega 2p (just mirrored)
-	translate([(top_plate_x/2)-28.06, (-top_plate_y/2)+67, 0]) button_30mm_hole();
+	translate([(panel_x/2)-sega_2p_column_1_left_panel_edge_offset, (-panel_y/2)+62, 0]) button_30mm_hole();
 }
 
-module dir_arc_30mm() {
+module dir_arc_30mm_fingers_left_button() {
-	dir_arc_30mm_thumb_button();
+	translate([-dir_arc_30mm_column_3_offset, dir_arc_30mm_row_3_offset, 0]) dir_arc_30mm_thumb_button();
-	translate([-5.4, 52.2, 0]) dir_arc_30mm_thumb_button();
+}
-	translate([-5.4-33.8, 52.2+12.9, 0]) dir_arc_30mm_thumb_button();
+
-	translate([-5.4-33.8-34.8, 52.2+12.9, 0]) dir_arc_30mm_thumb_button();
+module dir_arc_30mm_fingers_middle_button() {
+	translate([-dir_arc_30mm_column_2_offset, dir_arc_30mm_row_3_offset, 0]) dir_arc_30mm_thumb_button();
+}
+
+module dir_arc_30mm_fingers_right_button() {
+	translate([0, dir_arc_30mm_row_2_offset, 0]) dir_arc_30mm_thumb_button();
+}
+
+module dir_arc_30mm_finger_buttons() {
+	dir_arc_30mm_fingers_left_button();
+	dir_arc_30mm_fingers_middle_button();
+	dir_arc_30mm_fingers_right_button();
+}
+
+module dir_arc_30mm_w_button() {
+	translate([-26.8, dir_arc_w_30mm_row_4_offset, 0]) dir_arc_30mm_thumb_button();
 }
 
 module dir_arc_w_30mm() {
-	dir_arc_30mm();
+	dir_arc_30mm_thumb_button();
-	translate([-5.4-26.8, 52.2+12.9+34.5, 0]) dir_arc_30mm_thumb_button();
+	dir_arc_30mm_finger_buttons();
+	dir_arc_30mm_w_button();
 }
 
 module dir_arc_w_30mm_plus_one() {
 	dir_arc_w_30mm();
-	translate([-5.4-33.8-34.8-33.8, 52.2, 0]) dir_arc_30mm_thumb_button();
+	translate([-dir_arc_30mm_column_3_offset-33.8, dir_arc_30mm_row_2_offset, 0]) dir_arc_30mm_thumb_button();
 }
 
 // Namco Noir (right hand)
 
 module noir_button_p1() {
-	translate([-top_plate_x/2, -top_plate_y/2, 0]) translate([35, 145, 0]) button_30mm_hole();
+	translate([-panel_x/2, -panel_y/2, 0]) translate([35, 140, 0]) button_30mm_hole();
 }
 
 module noir_plus_one() {
@@ -374,27 +466,43 @@ module noir_plus_one() {
 // Sega Astro City 2P (right hand)
 
 module sega_2p_p1() {
-	translate([-top_plate_x/2, -top_plate_y/2, 0]) translate([28.06, 145, 0]) button_30mm_hole();
+	translate([-panel_x/2, -panel_y/2, 0]) translate([sega_2p_column_1_left_panel_edge_offset, 140, 0])
+		button_30mm_hole();
 }
 
 module sega_2p_6_button() {
 	// via slagcoin
 	sega_2p_p1();
-	translate([30.5, 11+9, 0]) sega_2p_p1();
+	translate([sega_2p_column_2_offset, 11+9, 0]) sega_2p_p1();
-	translate([30.5+36, 11+9, 0]) sega_2p_p1();
+	translate([sega_2p_column_3_offset, 11+9, 0]) sega_2p_p1();
 	translate([0, -19-9-11, 0]) sega_2p_p1();
-	translate([30.5, -19, 0]) sega_2p_p1();
+	translate([sega_2p_column_2_offset, -19, 0]) sega_2p_p1();
-	translate([30.5+36, -19, 0]) sega_2p_p1();
+	translate([sega_2p_column_3_offset, -19, 0]) sega_2p_p1();
 }
 
 module sega_2p() {
 	sega_2p_6_button();
-	translate([30.5+36+36, 11, 0]) sega_2p_p1();
+	translate([sega_2p_column_4_offset, 11, 0]) sega_2p_p1();
-	translate([30.5+36+36, -19-9, 0]) sega_2p_p1();
+	translate([sega_2p_column_4_offset, -19-9, 0]) sega_2p_p1();
 }
 
-module sega_2p_plus_one() {
+module sega_2p_nine_thumb_button() {
-	sega_2p();
 	// just my guesstimate on this one
 	translate([0, -19-9-11-19-9-11, 0]) sega_2p_p1();
 }
+
+module sega_2p_nine() {
+	sega_2p();
+	sega_2p_nine_thumb_button();
+}
+
+module sega_2p_eleven() {
+	sega_2p_nine();
+	translate([sega_2p_column_5_offset, 0, 0]) sega_2p_p1();
+	translate([sega_2p_column_5_offset, -19-9-11, 0]) sega_2p_p1();
+}
+
+module shiokenstar() {
+	translate([-172, 32, 0]) dir_arc_24mm_directionals();
+	sega_2p();
+}

src/extras/bss-ae/README.md

@@ -0,0 +1,38 @@
+# BSS Arcade Edition
+
+Pieces for mounting to a Qanba 2009 in order to create the Buildable Stick System - Arcade Edition.
+
+## Pieces
+
+* 4 `interconnect-x` --- creating the internal support for joining two rows of panels
+* 6 `frames/pieces/interconnect` --- (core project) the standard piece for joining two+ columns of panels
+* 4 `extended-side-no-back` --- the extended side pieces, flush on the back to connect to each other
+* 4 `frames/pieces/extended/front-or-back` --- (core project) the front extended piece
+* 2 `extended-back` --- a small piece that fits into the Qanba 2009 "lip" for running cables
+* 1 `extended-back-left-mount`
+* 1 `extended-back-right-mount` --- extended back pieces that can be mounted to the Qanba 2009 base
+* 1 `panel-front-left-mount`
+* 1 `panel-front-right-mount` --- blank panels that can be mounted to the Qanba 2009 base
+* 6 `panels/inset/panel` --- the rest of the bottom panels
+* 4 `panels/inset/` panels of your choice for the front controls
+* 2 `panel-three-aux-buttons` --- for aux controls in the back row
+* 2 `panel-three-aux-buttons-and-rocker-hole` --- for aux controls and the wired rocker in the back row
+* 4 `decorative-plate-aux-control-tight-three-button-cluster` --- for decorating the aux control clusters
+* 4 `src/misc/` decorative plates of your choice for the front controls, and similar miscellany
+* 4 `mount-spacer` --- making a flush mount between the enclosure and the base
+
+## Hardware
+
+* 32 45mm M4 hex brass standoffs (or equivalent) for each panel/frame compartment
+* 64 8-12mm M4 countersunk hex bolts for attaching panels to the compartments
+* 4 8-12mm M3 hex bolts and 4 M3 flange nuts for attaching rocker switches to the back panels
+* 4 40mm M6 bolts for connecting the enclosure to the base
+* 4 M6 flange nuts
+
+## Components
+
+* 2 controller boards, e.g. the RP2040 Advanced Breakout Board
+* buttons and/or levers as desired
+* necessary wiring
+
+For the rest of the build (e.g. mounting a level to a panel), see the core README.

src/extras/bss-ae/decorative-plate-aux-control-tight-three-button-cluster.scad

@@ -0,0 +1,23 @@
+/* Decorative plate for aux buttons.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module aux_control_three_button_tight_cluster_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -25]) hull() aux_control_three_button_tight_cluster();
+		// keep a thin slice
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) aux_control_three_button_tight_cluster();
+	}
+}
+
+aux_control_three_button_tight_cluster_decorative_plate();

src/extras/bss-ae/extended-back-left-mount.scad

@@ -0,0 +1,26 @@
+/* A back piece of the enclosure, with a mounting hole.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <extended-back.scad>
+
+// X: inner post to post (inclusive) is approx. 428.625mm, so half that, minus half the post itself
+// (41.28mm) is how much in from a normal panel to put the M6 mounting hole
+// Y: eyeballed it to 30mm
+mount_hole_x = (panel_x / 2) - (panel_x - ((428.625 / 2) - (41.28 / 2)));
+mount_hole_y = (panel_y / 2) + 30;
+
+module left_mount_extended_back() {
+	difference() {
+		extended_back();
+		translate([mount_hole_x, -mount_hole_y, -30]) m6_hole();
+		// punch out the back for cables
+		cube([frame_x-70, frame_y+160, frame_z-20], center=true);
+	}
+}
+
+left_mount_extended_back();

src/extras/bss-ae/extended-back-right-mount.scad

@@ -0,0 +1,15 @@
+/* A back piece of the enclosure, with a mounting hole.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <extended-back-left-mount.scad>
+
+module right_mount_extended_back() {
+	mirror([1, 0, 0]) left_mount_extended_back();
+}
+
+right_mount_extended_back();

src/extras/bss-ae/extended-back.scad

@@ -0,0 +1,30 @@
+/* A back piece extended the rest of the depth of the base.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/front-or-back-trapezoid.scad>
+
+module back_piece_extension() {
+	// combine the original wall with a copy to "pull" the wall out
+	hull() {
+		linear_extrude(height=80) bottom_piece_wall();
+		linear_extrude(height=(frame_wall-frame_bevel_height)) bottom_piece_wall();
+	}
+}
+
+module extended_back() {
+	difference() {
+		union() {
+			clean_front_or_back();
+			translate([0, -frame_y/2+frame_wall, 0]) rotate([90, 0, 0]) back_piece_extension();
+		}
+		cube([frame_x-60, frame_y+160-10, frame_z-10], center=true);
+		translate([0, -frame_y/2-35, 0]) cube([frame_x-20, 70, frame_z-10], center=true);
+	}
+}
+
+extended_back();

src/extras/bss-ae/extended-side-no-back.scad

@@ -0,0 +1,60 @@
+/* Create an extended side that is flush on the back to lay against another side.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/complete/left-frame.scad>
+use <frames/pieces/side.scad>
+use <frames/pieces/front-or-back-trapezoid.scad>
+
+module side_frame_piece_wall() {
+	// this doesn't use the side_frame_piece because of the 45 degree angle geometry
+	// not creating a clean thing to cut, so we just take the whole wall and use that
+	projection(cut=true) rotate([0, 90, 0]) translate([frame_x/2-frame_wall-(frame_bevel_height/2), 0, 0])
+		left_frame();
+}
+
+module side_and_bottom_frame_piece_wall() {
+	// get a slice of the pieces, to use it in extruding
+	// this doesn't use the side_frame_piece because of the 45 degree angle geometry
+	// not creating a clean thing to cut, so we just take the whole wall and use that
+	side_frame_piece_wall();
+	projection(cut=true) translate([0, -frame_y/2+frame_wall, 0]) rotate([90, 90, 0]) bottom_piece_extension();
+}
+
+module side_and_bottom_frame_piece_extension() {
+	// combine the original with a shrunken piece to "pull" the wall out
+	hull() {
+		linear_extrude(height=frame_extension_y) scale([0.5, 0.90, 1]) side_and_bottom_frame_piece_wall();
+		linear_extrude(height=frame_extension_y) scale([0.5, 1, 1])
+			difference() {
+				side_frame_piece_wall();
+				// remove the front piece so it doesn't interfere with the front extend
+				translate([0, -frame_y/2, 0]) square([frame_x, frame_y], center=true);
+			}
+		linear_extrude(height=frame_bevel_height) side_and_bottom_frame_piece_wall();
+	}
+}
+
+module extra_extended_left_or_right_frame_piece() {
+	difference() {
+		union() {
+			difference() {
+				side_frame_piece();
+				// chop off the old edge which is getting replaced with the extension
+				translate([-frame_x/2+frame_bevel_height/2, 0, 0])
+					cube([frame_bevel_height, frame_y, frame_z], center=true);
+			}
+			translate([-frame_x/2+frame_bevel_height*2, 0, 0])
+				rotate([0, -90, 0]) side_and_bottom_frame_piece_extension();
+		}
+		// minus the back piece where the wall would be, since there is no wall and the pieces and panels
+		// go flush against one another
+		translate([0, frame_y/2-(frame_wall/2), 0]) cube([frame_x*2, frame_wall, frame_z], center=true);
+	}
+}
+
+extra_extended_left_or_right_frame_piece();

src/extras/bss-ae/interconnect-x.scad

@@ -0,0 +1,30 @@
+/* Interconnect frames along the x-axis (the longer side)
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/pieces/front-or-back.scad>
+
+module interconnect_frame_half_piece() {
+	translate([0, frame_y/2-frame_wall, 0]) difference() {
+		front_or_back_frame_piece();
+		translate([0, (-frame_y+frame_wall)/2-panel_overhang_amount, 0])
+			cube([overhang_panel_x, frame_wall+panel_overhang_amount*2, frame_z], center=true);
+	}
+}
+
+module interconnect_frame_piece() {
+	difference() {
+		union() {
+			// slight translate is to make this a 2-manifold in OpenSCAD
+			translate([0, -0.01, 0]) interconnect_frame_half_piece();
+			mirror([0, 1, 0]) interconnect_frame_half_piece();
+		}
+		rotate([0, 0, 90]) translate([-frame_y/2, 0, 0]) frame_cable_routing_hole();
+	}
+}
+
+interconnect_frame_piece();

src/extras/bss-ae/mount-spacer.scad

@@ -0,0 +1,17 @@
+/* Just a simple washer to go between the frame post and the arcade enclosure.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module mount_spacer() {
+	difference() {
+		cylinder(r=25, h=1.25, $fn=50, center=true);
+		m6_hole();
+	}
+}
+
+mount_spacer();

src/extras/bss-ae/panel-front-left-mount.scad

@@ -0,0 +1,24 @@
+/* A panel with a mount point for the front left of the enclosure.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <panels/inset/panel.scad>
+
+// X: inner post to post (inclusive) is approx. 428.625mm, so half that, minus half the post itself
+// (41.28mm) is how much in from a normal panel to put the M6 mounting hole
+// Y: eyeballed it to 2": 50.80mm
+mount_hole_x = (panel_x / 2) - (panel_x - ((428.625 / 2) - (41.28 / 2)));
+mount_hole_y = (panel_y / 2) - 50.80;
+
+module front_left_mount_panel() {
+	difference() {
+		panel();
+		translate([-mount_hole_x, -mount_hole_y, 0]) m6_hole();
+	}
+}
+
+front_left_mount_panel();

src/extras/bss-ae/panel-front-right-mount.scad

@@ -0,0 +1,14 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <panel-front-left-mount.scad>
+
+module front_right_mount_panel() {
+	mirror([1, 0, 0]) front_left_mount_panel();
+}
+
+front_right_mount_panel();

src/extras/bss-ae/panel-three-aux-buttons-and-rocker-hole.scad

@@ -0,0 +1,18 @@
+/* A panel for mounting a couple aux buttons in a out of the way spot.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module three_aux_button_and_20mm_panel() {
+	difference() {
+		panel();
+		translate([0, -70, 0]) aux_control_three_button_tight_cluster();
+		translate([0, frame_y/2-30, 0]) rotate([180, 0, 0]) neutrik_d_mount();
+	}
+}
+
+three_aux_button_and_20mm_panel();

src/extras/bss-ae/panel-three-aux-buttons.scad

@@ -0,0 +1,17 @@
+/* A panel for mounting a couple aux buttons in a out of the way spot.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module three_aux_button_panel() {
+	difference() {
+		panel();
+		translate([0, -70, 0]) aux_control_three_button_tight_cluster();
+	}
+}
+
+three_aux_button_panel();

src/extras/stand-base.scad

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <../parameters.scad>
+include <../components.scad>
+use <stand.scad>
+
+module stand_base() {
+	difference() {
+		cube([frame_x, stand_y*2, 3], center=true);
+		translate([0, 0, 1.5]) rotate([180, 0, 0]) stand();
+		translate([-frame_x*0.4, 0, 1.5]) rotate([180, 0, 0]) stand();
+		translate([frame_x*0.4, 0, 1.5]) rotate([180, 0, 0]) stand();
+	}
+}
+
+stand_base();

src/extras/stand.scad

@@ -0,0 +1,29 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <../parameters.scad>
+include <../components.scad>
+
+base_extra = 10;
+back_extra_multiplier = 4.25;
+rotation_alignment = 15;
+
+module stand() {
+	difference() {
+		union() {
+			/* front lip piece */
+			translate([0, 0, stand_z/2]) cube([stand_x, stand_y, stand_z], center=true);
+			/* back supporting piece */
+			translate([0, (stand_y-rotation_alignment)/4, stand_z*back_extra_multiplier/2])
+				cube([stand_x, (stand_y+rotation_alignment)/2, stand_z*back_extra_multiplier], center=true);
+			/* base */
+			translate([0, 0, 0.5]) cube([stand_x+base_extra, stand_y+base_extra, 1], center=true);
+		}
+		/* cut out the actual frame solid */
+		translate([0, rotation_alignment, (frame_y/2)+7]) rotate([65, 0, 0]) frame_solid();
+	}
+}
+
+stand();

src/frame-left.scad

@@ -1,52 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module base_left_frame() {
-	difference() {
-		frame();
-		// chop the right edge off
-		side_chopper();
-	}
-}
-
-module left_frame() {
-	difference() {
-		base_left_frame();
-		// connection holes to other frames
-		translate([0, 0, -top_plate_z/2]) frame_connection_holes();
-
-		// cable routing hole
-		translate([0, 0, -top_plate_z/2]) frame_cable_routing_hole();
-
-		// aux button holes
-		translate([-30, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([-30, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([-70, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([-70, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([10, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([10, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-
-		// neutrix button hole
-		translate([70, (frame_y/2)-neutrik_panel_thickness, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([70, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-	}
-}
-
-left_frame();

src/frame-middle.scad

@@ -1,51 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module base_middle_frame() {
-	difference() {
-		frame();
-		// chop the left and right edge off
-		side_chopper();
-		mirror([1, 0, 0]) side_chopper();
-	}
-}
-
-module middle_frame() {
-	difference() {
-		base_middle_frame();
-		// connection holes to other frames
-		translate([0, 0, -top_plate_z/2]) frame_connection_holes();
-		translate([0, 0, -top_plate_z/2]) mirror([1, 0, 0]) frame_connection_holes();
-
-		// cable routing holes
-		translate([0, 0, -top_plate_z/2]) frame_cable_routing_hole();
-		translate([0, 0, -top_plate_z/2]) mirror([1, 0, 0]) frame_cable_routing_hole();
-
-		// neutrik mounts for connector, switches
-		translate([0, (frame_y/2)-neutrik_panel_thickness, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([0, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([-40, (frame_y/2)-neutrik_panel_thickness, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([-40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([40, (frame_y/2)-neutrik_panel_thickness, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-	}
-}
-
-middle_frame();

src/frame-right.scad

@@ -1,52 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module base_right_frame() {
-	difference() {
-		frame();
-		// chop the left edge off
-		mirror([1, 0, 0]) side_chopper();
-	}
-}
-
-module right_frame() {
-	difference() {
-		base_right_frame();
-		// connection holes to other frames
-		mirror([1, 0, 0]) translate([0, 0, -top_plate_z/2]) frame_connection_holes();
-
-		// cable routing hole
-		mirror([1, 0, 0]) translate([0, 0, -top_plate_z/2]) frame_cable_routing_hole();
-
-		// aux button holes
-		translate([30, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([30, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([70, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([70, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([-10, 101.5, 0]) rotate([270, 0, 0]) button_24mm_hole();
-		translate([-10, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-
-		// neutrix button hole
-		translate([-70, (frame_y/2)-neutrik_panel_thickness, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([-70, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-	}
-}
-
-right_frame();

src/frame-solo.scad

@@ -1,55 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module solo_frame() {
-	difference() {
-		frame();
-
-		// neutrik mounts for connector, switches
-		translate([0, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([0, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([-40, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([-40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-		translate([40, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
-		translate([40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
-
-		// aux button holes
-		translate([-frame_x/2+2.5, 0, 0]) rotate([0, 0, 270])
-			translate([0, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([(frame_x/2)-neutrik_panel_thickness-4, 0, 0]) rotate([0, 0, 90]) frame_cutout();
-		translate([-frame_x/2+2.5, 0, 0]) rotate([0, 0, 270])
-			translate([-40, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([(frame_x/2)-neutrik_panel_thickness-4, -40, 0]) rotate([0, 0, 90]) frame_cutout();
-		translate([-frame_x/2+2.5, 0, 0]) rotate([0, 0, 270])
-			translate([40, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([(frame_x/2)-neutrik_panel_thickness-4, 40, 0]) rotate([0, 0, 90]) frame_cutout();
-		translate([frame_x/2-2.5, 0, 0]) rotate([0, 0, 90])
-			translate([0, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([-(frame_x/2)+neutrik_panel_thickness+4, 0, 0]) rotate([0, 0, 90]) frame_cutout();
-		translate([frame_x/2-2.5, 0, 0]) rotate([0, 0, 90])
-			translate([-40, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([-(frame_x/2)+neutrik_panel_thickness+4, -40, 0]) rotate([0, 0, 90]) frame_cutout();
-		translate([frame_x/2-2.5, 0, 0]) rotate([0, 0, 90])
-			translate([40, 0, 0]) rotate([90, 0, 0]) button_24mm_hole();
-		translate([-(frame_x/2)+neutrik_panel_thickness+4, 40, 0]) rotate([0, 0, 90]) frame_cutout();
-	}
-}
-
-solo_frame();

src/frames/complete/left-frame.scad

@@ -0,0 +1,40 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module base_left_frame() {
+	difference() {
+		frame();
+		// chop the right edge off
+		side_chopper();
+	}
+}
+
+module left_frame() {
+	difference() {
+		base_left_frame();
+		// connection holes to other frames
+		frame_connection_holes();
+
+		// cable routing hole
+		frame_cable_routing_hole();
+
+		// aux button holes
+		translate([-35.25, 101.5, 0]) rotate([270, 0, 0]) aux_control_three_button_cluster();
+		translate([-35.25, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([-72.25, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([2, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+
+		// neutrix button hole
+		translate([frame_center_to_neutrik, (frame_y/2)-neutrik_panel_thickness, 0])
+			rotate([90, 0, 0]) neutrik_d_mount();
+		translate([frame_center_to_neutrik, (frame_y/2)-neutrik_panel_thickness-4, 0])
+			frame_cutout();
+	}
+}
+
+left_frame();

src/frames/complete/middle-frame.scad

@@ -0,0 +1,42 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module base_middle_frame() {
+	difference() {
+		frame();
+		// chop the left and right edge off
+		side_chopper();
+		mirror([1, 0, 0]) side_chopper();
+	}
+}
+
+module middle_frame() {
+	difference() {
+		base_middle_frame();
+		// connection holes to other frames
+		frame_connection_holes();
+		mirror([1, 0, 0]) frame_connection_holes();
+
+		// cable routing holes
+		frame_cable_routing_hole();
+		mirror([1, 0, 0]) frame_cable_routing_hole();
+
+		// neutrik mounts for connector, switches
+		translate([0, (frame_y/2)-neutrik_panel_thickness, 0])
+			rotate([90, 0, 0]) neutrik_d_mount();
+		translate([0, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([-40, (frame_y/2)-neutrik_panel_thickness, 0])
+			rotate([90, 0, 0]) neutrik_d_mount();
+		translate([-40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([40, (frame_y/2)-neutrik_panel_thickness, 0])
+			rotate([90, 0, 0]) neutrik_d_mount();
+		translate([40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+	}
+}
+
+middle_frame();

src/frames/complete/right-frame.scad

@@ -0,0 +1,40 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module base_right_frame() {
+	difference() {
+		frame();
+		// chop the left edge off
+		mirror([1, 0, 0]) side_chopper();
+	}
+}
+
+module right_frame() {
+	difference() {
+		base_right_frame();
+		// connection holes to other frames
+		mirror([1, 0, 0]) frame_connection_holes();
+
+		// cable routing hole
+		mirror([1, 0, 0]) frame_cable_routing_hole();
+
+		// aux button holes
+		translate([35.25, 101.5, 0]) rotate([270, 0, 0]) aux_control_three_button_cluster();
+		translate([35.25, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([72.25, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([-2, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+
+		// neutrix button hole
+		translate([-frame_center_to_neutrik, (frame_y/2)-neutrik_panel_thickness, 0])
+			rotate([90, 0, 0]) neutrik_d_mount();
+		translate([-frame_center_to_neutrik, (frame_y/2)-neutrik_panel_thickness-4, 0])
+			frame_cutout();
+	}
+}
+
+right_frame();

src/frames/complete/solo-frame.scad

@@ -0,0 +1,36 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module solo_frame() {
+	difference() {
+		frame();
+
+		// neutrik mounts for connector, switches
+		translate([0, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
+		translate([0, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([-40, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
+		translate([-40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+		translate([40, (frame_y/2)-2.5, 0]) rotate([90, 0, 0]) neutrik_d_mount();
+		translate([40, (frame_y/2)-neutrik_panel_thickness-4, 0]) frame_cutout();
+
+		// aux button holes
+		translate([-frame_x/2+2.5, 0, 0]) rotate([90, 0, 270])
+			aux_control_three_button_cluster();
+		translate([(frame_x/2)-neutrik_panel_thickness-4, 0, 0]) rotate([0, 0, 90]) frame_cutout();
+		translate([(frame_x/2)-neutrik_panel_thickness-4, -37, 0]) rotate([0, 0, 90]) frame_cutout();
+		translate([(frame_x/2)-neutrik_panel_thickness-4, 37, 0]) rotate([0, 0, 90]) frame_cutout();
+
+		translate([frame_x/2+2.5, 0, 0]) rotate([90, 0, 270])
+			aux_control_three_button_cluster();
+		translate([-(frame_x/2)+neutrik_panel_thickness+4, 0, 0]) rotate([0, 0, 90]) frame_cutout();
+		translate([-(frame_x/2)+neutrik_panel_thickness+4, -37, 0]) rotate([0, 0, 90]) frame_cutout();
+		translate([-(frame_x/2)+neutrik_panel_thickness+4, 37, 0]) rotate([0, 0, 90]) frame_cutout();
+	}
+}
+
+solo_frame();

src/frames/pieces/front-or-back-aux-and-neutrik.scad

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+
+module front_or_back_aux_and_neutrik_frame_piece() {
+	difference() {
+		front_or_back_frame_piece();
+
+		// aux button holes
+		translate([-35.25, -101.5, 0]) rotate([90, 0, 0]) aux_control_three_button_cluster();
+		translate([-35.25, -(frame_y/2)+neutrik_panel_thickness+4, 0]) frame_cutout();
+		translate([-72.25, -(frame_y/2)+neutrik_panel_thickness+4, 0]) frame_cutout();
+		translate([2, -(frame_y/2)+neutrik_panel_thickness+4, 0]) frame_cutout();
+
+		// neutrix button hole
+		translate([frame_center_to_neutrik, -(frame_y/2)+neutrik_panel_thickness, 0])
+			rotate([270, 0, 0]) neutrik_d_mount();
+		translate([frame_center_to_neutrik, -(frame_y/2)+neutrik_panel_thickness+4, 0])
+			frame_cutout();
+	}
+}
+
+front_or_back_aux_and_neutrik_frame_piece();

src/frames/pieces/front-or-back-inner-wall-for-horiz-stripes.scad

@@ -0,0 +1,31 @@
+/* The inner top/bottom wall of the frame, for being displayed through a horizontal stripe windowed part.
+ *
+ * SPDX-FileCopyrightText: © 2025 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back-inner-wall.scad>
+use <front-or-back-windowed-horiz-stripes.scad>
+
+// for stability's sake, this piece juts out a bit from the outside of the wall, so we
+// need to hack the window piece a bit to subtract from the longer and get ours longer
+module horiz_striped_windowed_front_or_back_frame_piece() {
+	difference() {
+		front_or_back_longish_frame_piece();
+		// subtract frame wall windows
+		front_horiz_stripes();
+		// subtract the inner wall area that will be provided by the other piece
+		front_or_back_inner_wall_frame_piece();
+	}
+}
+
+module front_or_back_windowed_horiz_stripes_inner_wall_frame_piece() {
+	difference() {
+		front_or_back_longish_frame_piece();
+		horiz_striped_windowed_front_or_back_frame_piece();
+	}
+}
+
+front_or_back_windowed_horiz_stripes_inner_wall_frame_piece();

src/frames/pieces/front-or-back-inner-wall.scad

@@ -0,0 +1,65 @@
+/* The inner top/bottom wall of the frame, for being displayed through a windowed part.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+
+module mount_column_cutout() {
+	intersection() {
+		frame_mount_column();
+		cube([frame_mount_column_width*3/2, frame_mount_column_width*3/2, inner_frame_z*5/8], center=true);
+	}
+}
+
+module front_or_back_inner_wall_frame_base_piece() {
+	difference() {
+		// Z is scaled so that some part of the original part inner wall is retained
+		scale([1, 1, inner_frame_z_decorative_scale]) front_or_back_frame_piece();
+		// minus the outer wall
+		translate([0, -(frame_y-frame_wall)/2, 0]) cube([frame_x, frame_wall, frame_z], center=true);
+		// minus half of the mounting posts (the other half provided by the outer wall)
+		translate([-panel_to_frame_point_x, -(panel_to_frame_point_y), 0]) rotate([0, 0, 180])
+			mount_column_cutout();
+		translate([panel_to_frame_point_x, -(panel_to_frame_point_y), 0]) rotate([0, 0, 270])
+			mount_column_cutout();
+	}
+}
+
+module front_or_back_inner_wall_frame_piece() {
+	front_or_back_inner_wall_frame_base_piece();
+	// extend the outward face 2mm in order to have it cut deeper into the frame outer wall
+	translate([0, -(frame_y-frame_wall)/2, 0]) rotate([-90, 0, 0]) linear_extrude(height=2) projection()
+		translate([0, 0, 50]) rotate([90, 0, 0]) front_or_back_inner_wall_frame_base_piece();
+}
+
+// this is here for use in inner wall pieces, but unlike the side longish piece (in its own
+// .scad), front_or_back_longish_frame_piece is not printable so we'll just stash it here
+module front_or_back_frame_piece_wall() {
+       // get a slice of the whole wall, to use it for making the extended version
+       difference() {
+               front_or_back_frame_piece();
+               cube([frame_x, frame_y-frame_wall*2, frame_z], center=true);
+       }
+}
+
+// this is here for use in inner wall pieces, but unlike the side longish piece (in its own
+// .scad), front_or_back_longish_frame_piece is not printable so we'll just stash it here
+module front_or_back_frame_piece_extension() {
+	hull() {
+		front_or_back_frame_piece_wall();
+		translate([0, -frame_bevel_height*2, 0]) front_or_back_frame_piece_wall();
+	}
+}
+
+// this is here for use in inner wall pieces, but unlike the side longish piece (in its own
+// .scad), front_or_back_longish_frame_piece is not printable so we'll just stash it here
+module front_or_back_longish_frame_piece() {
+	front_or_back_frame_piece_extension();
+	front_or_back_frame_piece();
+}
+
+front_or_back_inner_wall_frame_piece();

src/frames/pieces/front-or-back-trapezoid.scad

@@ -0,0 +1,37 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+
+module clean_front_or_back() {
+	difference() {
+		front_or_back_frame_piece();
+		// chop off the lip we left on the basic piece
+		translate([-frame_x/2+frame_wall/2, 0, 0]) cube([frame_wall, frame_y, frame_z], center=true);
+	};
+}
+
+module bottom_piece_wall() {
+	// get a slice of the piece (before the bevel), to use it in extruding
+	projection(cut=true) rotate([-90, 0, 0]) translate([0, frame_y/2-(frame_wall-frame_bevel_height)*3/2, 0])
+		clean_front_or_back();
+}
+
+module bottom_piece_extension() {
+	// combine the original with a shrunken piece to "pull" the wall out
+	hull() {
+		linear_extrude(height=frame_extension_y) scale([1, 0.5, 1]) bottom_piece_wall();
+		linear_extrude(height=(frame_wall-frame_bevel_height)) bottom_piece_wall();
+	}
+}
+
+module front_or_back_trapezoid_frame_piece() {
+	clean_front_or_back();
+	translate([0, -frame_y/2+frame_wall, 0]) rotate([90, 0, 0]) bottom_piece_extension();
+}
+
+front_or_back_trapezoid_frame_piece();

src/frames/pieces/front-or-back-windowed-backslashes.scad

@@ -0,0 +1,40 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+use <front-or-back-inner-wall.scad>
+
+module backslashes() {
+	translate([-70, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([-50, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([-30, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([-10, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([10, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([30, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([50, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+	translate([70, -(frame_y-frame_wall)/2, 0]) slash_cutout();
+}
+
+module backslashes_windowed_front_or_back_frame_piece() {
+	difference() {
+		front_or_back_frame_piece();
+		// subtract slashes from the frame wall
+		backslashes();
+		// subtract the inner wall area that will be provided by the other piece
+		front_or_back_inner_wall_frame_piece();
+	}
+}
+
+module backslashes_windowed_front_or_back_frame_piece_for_extended_side() {
+	difference() {
+		backslashes_windowed_front_or_back_frame_piece();
+		// ...minus the frame wall and lip on the left
+		translate([-frame_x/2+frame_wall/2, 0, 0]) cube([frame_wall, frame_y, frame_z], center=true);
+	}
+}
+
+backslashes_windowed_front_or_back_frame_piece_for_extended_side();

src/frames/pieces/front-or-back-windowed-forwardslashes.scad

@@ -0,0 +1,30 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+use <front-or-back-inner-wall.scad>
+use <front-or-back-windowed-backslashes.scad>
+
+module forwardslashes_windowed_front_or_back_frame_piece() {
+	difference() {
+		front_or_back_frame_piece();
+		// subtract slashes from the frame wall
+		mirror([0, 0, 1]) backslashes();
+		// subtract the inner wall area that will be provided by the other piece
+		front_or_back_inner_wall_frame_piece();
+	}
+}
+
+module forwardslashes_windowed_front_or_back_frame_piece_for_extended_side() {
+	difference() {
+		forwardslashes_windowed_front_or_back_frame_piece();
+		// ...minus the frame wall and lip on the left
+		translate([-frame_x/2+frame_wall/2, 0, 0]) cube([frame_wall, frame_y, frame_z], center=true);
+	}
+}
+
+forwardslashes_windowed_front_or_back_frame_piece_for_extended_side();

src/frames/pieces/front-or-back-windowed-horiz-stripes.scad

@@ -0,0 +1,33 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+use <front-or-back-inner-wall.scad>
+
+module front_horiz_stripe() {
+	cube([frame_x-(frame_mount_column_width*1.75)*2, wall_cutout_depth, 5], center=true);
+}
+
+module front_horiz_stripes() {
+	translate([0, -(frame_y-frame_wall)/2, 18]) front_horiz_stripe();
+	translate([0, -(frame_y-frame_wall)/2, 9]) front_horiz_stripe();
+	translate([0, -(frame_y-frame_wall)/2, 0]) front_horiz_stripe();
+	translate([0, -(frame_y-frame_wall)/2, -9]) front_horiz_stripe();
+	translate([0, -(frame_y-frame_wall)/2, -18]) front_horiz_stripe();
+}
+
+module horiz_striped_windowed_front_or_back_frame_piece() {
+	difference() {
+		front_or_back_frame_piece();
+		// subtract frame wall windows
+		front_horiz_stripes();
+		// subtract the inner wall area that will be provided by the other piece
+		front_or_back_inner_wall_frame_piece();
+	}
+}
+
+horiz_striped_windowed_front_or_back_frame_piece();

src/frames/pieces/front-or-back-windowed.scad

@@ -0,0 +1,35 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <front-or-back.scad>
+use <front-or-back-inner-wall.scad>
+
+module front_or_back_window() {
+	translate([0, -frame_y/2, 0])
+		cube([frame_x-frame_mount_column_width*3.5, (frame_wall+panel_support_width)*2,
+			frame_z-panel_z*3], center=true);
+}
+
+module windowed_front_or_back_frame_piece() {
+	difference() {
+		front_or_back_frame_piece();
+		// subtract frame wall window
+		front_or_back_window();
+		// subtract the inner wall area that will be provided by the other piece
+		front_or_back_inner_wall_frame_piece();
+	}
+}
+
+module windowed_front_or_back_frame_piece_for_extended_side() {
+	difference() {
+		windowed_front_or_back_frame_piece();
+		// ...minus the frame wall and lip on the left
+		translate([-frame_x/2+frame_wall/2, 0, 0]) cube([frame_wall, frame_y, frame_z], center=true);
+	}
+}
+
+windowed_front_or_back_frame_piece_for_extended_side();

src/frames/pieces/front-or-back.scad

@@ -0,0 +1,25 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/complete/left-frame.scad>
+use <side.scad>
+
+module front_or_back_frame_piece() {
+	piece_width = panel_support_width+frame_wall+frame_mount_column_width;
+	intersection() {
+		left_frame();
+		difference() {
+			// include the whole bottom wall (including mount columns)
+			translate([0, -(frame_y/2)+(piece_width/2), 0])
+				cube([frame_piece_x_x, piece_width, frame_z], center=true);
+			// ...minus a slot for the combining piece to go into
+			cube([frame_x, frame_y-(panel_support_width+frame_wall)*2, inner_frame_z/3], center=true);
+		}
+	}
+}
+
+front_or_back_frame_piece();

src/frames/pieces/interconnect.scad

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+
+module interconnect_frame_half_piece() {
+	translate([frame_x/2-frame_wall, 0, 0]) difference() {
+		side_frame_piece();
+		rotate([0, 0, 180]) side_chopper();
+	}
+}
+
+module interconnect_frame_piece() {
+	difference() {
+		union() {
+			// slight translate is to make this a 2-manifold in OpenSCAD
+			translate([-0.01, 0, 0]) interconnect_frame_half_piece();
+			mirror([1, 0, 0]) interconnect_frame_half_piece();
+		}
+		translate([-frame_x/2, 0, 0]) frame_cable_routing_hole();
+	}
+}
+
+interconnect_frame_piece();

src/frames/pieces/side-inner-wall-for-horiz-stripes.scad

@@ -0,0 +1,32 @@
+/* The inner side wall of the frame, for being displayed through a horizontal stripe windowed part.
+ *
+ * SPDX-FileCopyrightText: © 2025 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side-inner-wall.scad>
+use <side-longish.scad>
+use <side-windowed-horiz-stripes.scad>
+
+// for stability's sake, this piece juts out a bit from the outside of the wall, so we
+// need to hack the window piece a bit to subtract from the longer and get ours longer
+module horiz_striped_windowed_side_frame_piece() {
+	difference() {
+		side_longish_frame_piece();
+		// subtract frame wall windows
+		side_horiz_stripes();
+		// subtract the inner wall area that will be provided by the other piece
+		side_inner_wall_frame_piece();
+	}
+}
+
+module side_windowed_horiz_stripes_inner_wall_frame_piece() {
+	difference() {
+		side_longish_frame_piece();
+		horiz_striped_windowed_side_frame_piece();
+	}
+}
+
+side_windowed_horiz_stripes_inner_wall_frame_piece();

src/frames/pieces/side-inner-wall.scad

@@ -0,0 +1,43 @@
+/* The inner side wall of the frame, for being displayed through a windowed part.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+
+module mount_column_cutout() {
+	intersection() {
+		frame_mount_column();
+		cube([frame_mount_column_width*3/2, frame_mount_column_width*3/2, inner_frame_z*21/24], center=true);
+	}
+}
+
+module side_inner_wall_frame_base_piece() {
+	difference() {
+		// Z is scaled so that some part of the original part inner wall is retained
+		scale([1, 1, inner_frame_z_decorative_scale]) side_frame_piece();
+		// minus the outer wall
+		translate([-(frame_x-frame_wall)/2, 0, 0]) cube([frame_wall, frame_y, frame_z], center=true);
+		// minus half of the mounting posts (the other half provided by the outer wall)
+		translate([-panel_to_frame_point_x, panel_to_frame_point_y, inner_frame_z/2]) rotate([0, 0, 90])
+			mount_column_cutout();
+		translate([-panel_to_frame_point_x, -(panel_to_frame_point_y), -inner_frame_z/2]) rotate([0, 0, 180])
+			mount_column_cutout();
+		translate([-panel_to_frame_point_x, panel_to_frame_point_y, -inner_frame_z/2]) rotate([0, 0, 90])
+			mount_column_cutout();
+		translate([-panel_to_frame_point_x, -(panel_to_frame_point_y), inner_frame_z/2]) rotate([0, 0, 180])
+			mount_column_cutout();
+	}
+}
+
+module side_inner_wall_frame_piece() {
+	side_inner_wall_frame_base_piece();
+	// extend the outward face 2mm in order to have it cut deeper into the frame outer wall
+	translate([-(frame_x-frame_wall)/2, 0, 0]) rotate([0, 90, 0]) linear_extrude(height=2) projection()
+		translate([0, 0, 50]) rotate([0, -90, 0]) side_inner_wall_frame_base_piece();
+}
+
+side_inner_wall_frame_piece();

src/frames/pieces/side-longish.scad

@@ -0,0 +1,32 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+
+module side_frame_piece_wall() {
+	// get a slice of the whole wall, to use it for making the extended version
+	difference() {
+		side_frame_piece();
+		cube([frame_x-frame_wall*2, frame_y, frame_z], center=true);
+	}
+}
+
+module side_frame_piece_extension() {
+	// hulling the two walls provides a wall with a thicker x
+	hull() {
+		side_frame_piece_wall();
+		translate([-frame_bevel_height*2, 0, 0]) side_frame_piece_wall();
+	}
+}
+
+module side_longish_frame_piece() {
+	// combine the wider wall and the original piece
+	side_frame_piece_extension();
+	side_frame_piece();
+}
+
+side_longish_frame_piece();

src/frames/pieces/side-trapezoid-extended-to-front-trapezoid.scad

@@ -0,0 +1,38 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/complete/left-frame.scad>
+use <side.scad>
+use <front-or-back-trapezoid.scad>
+
+module side_and_bottom_frame_piece_wall() {
+	// get a slice of the pieces, to use it in extruding
+	// this doesn't use the side_frame_piece because of the 45 degree angle geometry
+	// not creating a clean thing to cut, so we just take the whole wall and use that
+	projection(cut=true) rotate([0, 90, 0]) translate([frame_x/2-frame_wall-(frame_bevel_height/2), 0, 0])
+		left_frame();
+	projection(cut=true) translate([0, -frame_y/2+frame_wall, 0]) rotate([90, 90, 0]) bottom_piece_extension();
+}
+
+module side_and_bottom_frame_piece_extension() {
+	// combine the original with a shrunken piece to "pull" the wall out
+	hull() {
+		linear_extrude(height=frame_extension_y) scale([0.5, 0.90, 1]) side_and_bottom_frame_piece_wall();
+		linear_extrude(height=frame_bevel_height) side_and_bottom_frame_piece_wall();
+	}
+}
+
+module side_trapezoid_extended_to_front_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// chop off the old edge which is getting replaced with the extension
+		translate([-frame_x/2+frame_bevel_height/2, 0, 0]) cube([frame_bevel_height, frame_y, frame_z], center=true);
+	}
+	translate([-frame_x/2+frame_bevel_height*2, 0, 0]) rotate([0, -90, 0]) side_and_bottom_frame_piece_extension();
+}
+
+side_trapezoid_extended_to_front_frame_piece();

src/frames/pieces/side-trapezoid.scad

@@ -0,0 +1,36 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/complete/left-frame.scad>
+use <side.scad>
+
+module side_frame_piece_wall() {
+	// get a slice of the piece, to use it in extruding
+	// this doesn't use the side_frame_piece because of the 45 degree angle geometry
+	// not creating a clean thing to cut, so we just take the whole wall and use that
+	projection(cut=true) rotate([0, 90, 0]) translate([frame_x/2-frame_wall-(frame_bevel_height/2), 0, 0])
+		left_frame();
+}
+
+module side_frame_piece_extension() {
+	// combine the original with a shrunken piece to "pull" the wall out
+	hull() {
+		linear_extrude(height=frame_extension_y) scale([0.5, 0.85, 1]) side_frame_piece_wall();
+		linear_extrude(height=frame_bevel_height) side_frame_piece_wall();
+	}
+}
+
+module side_trapezoid_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// chop off the old edge which is getting replaced with the extension
+		translate([-frame_x/2+frame_bevel_height/2, 0, 0]) cube([frame_bevel_height, frame_y, frame_z], center=true);
+	}
+	translate([-frame_x/2+frame_bevel_height*2, 0, 0]) rotate([0, -90, 0]) side_frame_piece_extension();
+}
+
+side_trapezoid_frame_piece();

src/frames/pieces/side-windowed-backslashes.scad

@@ -0,0 +1,30 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+use <side-inner-wall.scad>
+
+module backslashes() {
+	translate([-(frame_x-frame_wall)/2, -50, 0]) rotate([0, 0, -90]) slash_cutout();
+	translate([-(frame_x-frame_wall)/2, -30, 0]) rotate([0, 0, -90]) slash_cutout();
+	translate([-(frame_x-frame_wall)/2, -10, 0]) rotate([0, 0, -90]) slash_cutout();
+	translate([-(frame_x-frame_wall)/2, 10, 0]) rotate([0, 0, -90]) slash_cutout();
+	translate([-(frame_x-frame_wall)/2, 30, 0]) rotate([0, 0, -90]) slash_cutout();
+	translate([-(frame_x-frame_wall)/2, 50, 0]) rotate([0, 0, -90]) slash_cutout();
+}
+
+module backslashes_windowed_side_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// subtract slashes from the frame wall
+		backslashes();
+		// subtract the inner wall area that will be provided by the other piece
+		side_inner_wall_frame_piece();
+	}
+}
+
+backslashes_windowed_side_frame_piece();

src/frames/pieces/side-windowed-forwardslashes.scad

@@ -0,0 +1,22 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+use <side-inner-wall.scad>
+use <side-windowed-backslashes.scad>
+
+module forwardslashes_windowed_side_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// subtract slashes from the frame wall
+		mirror([0, 0, 1]) backslashes();
+		// subtract the inner wall area that will be provided by the other piece
+		side_inner_wall_frame_piece();
+	}
+}
+
+forwardslashes_windowed_side_frame_piece();

src/frames/pieces/side-windowed-horiz-stripes.scad

@@ -0,0 +1,33 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+use <side-inner-wall.scad>
+
+module side_horiz_stripe() {
+	cube([wall_cutout_depth, frame_y-(frame_mount_column_width*1.75)*2, 5], center=true);
+}
+
+module side_horiz_stripes() {
+	translate([-(frame_x-frame_wall)/2, 0, 18]) side_horiz_stripe();
+	translate([-(frame_x-frame_wall)/2, 0, 9]) side_horiz_stripe();
+	translate([-(frame_x-frame_wall)/2, 0, 0]) side_horiz_stripe();
+	translate([-(frame_x-frame_wall)/2, 0, -9]) side_horiz_stripe();
+	translate([-(frame_x-frame_wall)/2, 0, -18]) side_horiz_stripe();
+}
+
+module horiz_striped_windowed_side_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// subtract frame wall windows
+		side_horiz_stripes();
+		// subtract the inner wall area that will be provided by the other piece
+		side_inner_wall_frame_piece();
+	}
+}
+
+horiz_striped_windowed_side_frame_piece();

src/frames/pieces/side-windowed.scad

@@ -0,0 +1,23 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <side.scad>
+use <side-inner-wall.scad>
+
+module windowed_side_frame_piece() {
+	difference() {
+		side_frame_piece();
+		// subtract frame wall window
+		translate([-frame_x/2, 0, 0])
+			cube([(frame_wall+panel_support_width)*2, frame_y-frame_mount_column_width*3.5,
+				frame_z-panel_z*3], center=true);
+		// subtract the inner wall area that will be provided by the other piece
+		side_inner_wall_frame_piece();
+	}
+}
+
+windowed_side_frame_piece();

src/frames/pieces/side.scad

@@ -0,0 +1,26 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <frames/complete/left-frame.scad>
+use <front-or-back.scad>
+
+module side_frame_piece() {
+	piece_width = panel_support_width+frame_wall+frame_mount_column_width;
+	difference() {
+		intersection() {
+			left_frame();
+			// include the whole left wall (including mount columns)
+			translate([-(frame_x/2)+(piece_width/2), 0, 0])
+				cube([piece_width, frame_piece_y_y, frame_z], center=true);
+		}
+		// minus the top and bottom
+		front_or_back_frame_piece();
+		rotate([180, 0, 0]) front_or_back_frame_piece();
+	}
+}
+
+side_frame_piece();

src/misc-decorative-plate-24mm-button.scad

@@ -1,33 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module button_24mm_decorative_plate() {
-	difference() {
-		decorative_add=10;
-		// get a 1mm slice of the bigger button cylinders
-		translate([0, 0, -45]) button_24mm_hole();
-		translate([0, 0, -50]) cube([500, 500, 98], center=true);
-		translate([0, 0, 50]) cube([500, 500, 98], center=true);
-		// cut out the normal holes
-		translate([0, 0, -1]) button_24mm_hole();
-	}
-}
-
-button_24mm_decorative_plate();

src/misc-decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-plus-one.scad

@@ -1,38 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module dir_arc_plus_w_30mm_and_sega_2p_plus_one_decorative_plate() {
-	difference() {
-		// get a 1mm slice of the bigger button cylinders
-		union() {
-			translate([-top_plate_x/2, 0, -65]) dir_arc_w_30mm();
-			translate([top_plate_x/2, 0, -65]) sega_2p_plus_one();
-		}
-		translate([0, 0, -100]) cube([500, 500, 198], center=true);
-		translate([0, 0, 100]) cube([500, 500, 198], center=true);
-		// cut out the normal holes
-		translate([-top_plate_x/2, 0, -1]) dir_arc_w_30mm();
-		translate([top_plate_x/2, 0, -1]) sega_2p_plus_one();
-	}
-	/* // fill in some space */
-	/* translate([-6, -6, 0]) cube([23, 23, 1], center=true); */
-}
-
-dir_arc_plus_w_30mm_and_sega_2p_plus_one_decorative_plate();

src/misc-decorative-plate-dir_arc-plus-w-30mm.scad

@@ -1,32 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module dir_arc_plus_w_30mm_decorative_plate() {
-	difference() {
-		// get a 1mm slice of the bigger button cylinders
-		translate([0, 0, -45]) dir_arc_w_30mm();
-		translate([0, 0, -50]) cube([500, 500, 98], center=true);
-		translate([0, 0, 50]) cube([500, 500, 98], center=true);
-		// cut out the normal holes
-		translate([0, 0, -1]) dir_arc_w_30mm();
-	}
-}
-
-dir_arc_plus_w_30mm_decorative_plate();

src/misc-decorative-plate-sega-2p-plus-one.scad

@@ -1,33 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module sega_2p_plus_one_decorative_plate() {
-	difference() {
-		decorative_add=10;
-		// get a 1mm slice of the bigger button cylinders
-		translate([0, 0, -45]) sega_2p_plus_one();
-		translate([0, 0, -50]) cube([500, 500, 98], center=true);
-		translate([0, 0, 50]) cube([500, 500, 98], center=true);
-		// cut out the normal holes
-		translate([0, 0, -1]) sega_2p_plus_one();
-	}
-}
-
-sega_2p_plus_one_decorative_plate();

src/misc-dustwasher-lsx-nobi.scad

@@ -1,29 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module lsx_nobi_dustwasher() {
-	difference() {
-		cylinder(r=jumbo_decorative_radius+5+hole_tolerance, h=2, $fn=50, center=true);
-		// 5.25 = 5 (diameter of shaft is 10mm) + .25 to let it take an angle
-		cylinder(r=5.25+hole_tolerance, h=2.1, $fn=50, center=true);
-	}
-}
-
-lsx_nobi_dustwasher();

src/misc-neutrik-d-plate-20mm-hole.scad

@@ -1,30 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <misc-neutrik-d-plate.scad>
-
-module neutrik_d_plate_20mm() {
-	difference() {
-		neutrik_d_plate();
-		cylinder(r=10+hole_tolerance, h=5, $fn=50, center=true);
-		cube([2.2, 22, 5], center=true);
-	}
-}
-
-neutrik_d_plate_20mm();

src/misc-neutrik-d-plate-24mm-hole.scad

@@ -1,29 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-use <misc-neutrik-d-plate.scad>
-
-module neutrik_d_plate_24mm() {
-	difference() {
-		neutrik_d_plate();
-		cylinder(r=12+hole_tolerance, h=5, $fn=50, center=true);
-	}
-}
-
-neutrik_d_plate_24mm();

src/misc-neutrik-d-plate.scad

@@ -1,29 +0,0 @@
-/* Copyright Brian Stephan 2023
- *
- * This file is part of the Buildable Stick System.
- *
- * The Buildable Stick System 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.
- *
- * The Buildable Stick System 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
- * the Buildable Stick System. If not, see <https://www.gnu.org/licenses/>.
- */
-
-include <components.scad>
-
-module neutrik_d_plate() {
-	difference() {
-		cube([30, 35, 2], center=true);
-		translate([9.5, 12, 0]) neutrik_d_screw_hole();
-		translate([-9.5, -12, 0]) neutrik_d_screw_hole();
-	}
-}
-
-neutrik_d_plate();

src/misc/decorative-corner.scad

@@ -0,0 +1,31 @@
+/* A bit of plastic to put on the corners of a case, just for more flair and seam hiding.
+ *
+ * Note: this only works on the standard side and front/back pieces, not the longish/extended pieces.
+ *
+ * SPDX-FileCopyrightText: © 2025 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module decorative_corner() {
+	deco_thickness = 2;
+	difference() {
+		// start with the frame shape itself, just grown a bit
+		resize(newsize=[frame_x+(deco_thickness*2), frame_y+(deco_thickness*2), frame_z+(deco_thickness*2)])
+			frame_solid();
+		// lob off the pieces to make a corner
+		translate([(panel_to_frame_point_offset+deco_thickness*2)*1.5, 0, 0])
+			cube([frame_x, frame_y*2, frame_z*2], center=true);
+		translate([0, (panel_to_frame_point_offset+deco_thickness*2)*1.5, 0])
+			cube([frame_x*2, frame_y, frame_z*2], center=true);
+		// carve out the inside
+		frame_solid();
+		// holes for bolts
+		translate([0, 0, frame_z/2]) panel_holes();
+		translate([0, 0, -frame_z/2]) rotate([0, 180, 0]) panel_holes();
+	}
+}
+
+decorative_corner();

src/misc/decorative-middle.scad

@@ -0,0 +1,36 @@
+/* A bit of plastic to put on the center of a case front, just for more flair and seam hiding.
+ *
+ * SPDX-FileCopyrightText: © 2025 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module decorative_half_middle() {
+	deco_thickness = 2;
+	translate([-frame_x/2+frame_wall, 0, 0]) difference() {
+		// start with the frame shape itself, just grown a bit
+		resize(newsize=[frame_x+(deco_thickness*2), frame_y+(deco_thickness*2), frame_z+(deco_thickness*2)])
+			frame_solid();
+		// make this appropriate for the middle
+		scale([1, 1, 2]) side_chopper();
+		// lob off the pieces to make a cornerish piece
+		translate([-(panel_to_frame_point_offset+deco_thickness*2)*1.65, 0, 0])
+			cube([frame_x, frame_y*2, frame_z*2], center=true);
+		translate([0, (panel_to_frame_point_offset+deco_thickness*2)*1.5, 0])
+			cube([frame_x*2, frame_y, frame_z*2], center=true);
+		// carve out the inside
+		frame_solid();
+		// holes for bolts
+		translate([0, 0, frame_z/2]) panel_holes();
+		translate([0, 0, -frame_z/2]) rotate([0, 180, 0]) panel_holes();
+	}
+}
+
+module decorative_middle() {
+	decorative_half_middle();
+	mirror([1, 0, 0]) decorative_half_middle();
+}
+
+decorative_middle();

src/misc/decorative-plate-24mm-button.scad

@@ -0,0 +1,21 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module button_24mm_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) button_24mm_hole();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) button_24mm_hole();
+	}
+}
+
+button_24mm_decorative_plate();

src/misc/decorative-plate-aux-connectors-neutrik-and-rocker-cluster.scad

@@ -0,0 +1,21 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <neutrik-d-plate.scad>
+
+module aux_connectors_two_neutrik_cluster_decorative_plate() {
+	difference() {
+		hull() {
+			translate([-50, 0, 0]) neutrik_d_plate();
+			translate([50, 0, 0]) neutrik_d_plate();
+		}
+		translate([(frame_x/2)-frame_center_to_neutrik-frame_wall, 0, 0]) rocker_20mm_mount();
+		translate([-((frame_x/2)-frame_center_to_neutrik-frame_wall), 0, 0]) neutrik_d_mount();
+	}
+}
+
+aux_connectors_two_neutrik_cluster_decorative_plate();

src/misc/decorative-plate-aux-control-three-button-cluster.scad

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+use <neutrik-d-plate.scad>
+
+module aux_control_three_button_cluster_decorative_plate() {
+	difference() {
+		hull() {
+			translate([-44, 0, 0]) neutrik_d_plate();
+			translate([44, 0, 0]) neutrik_d_plate();
+		}
+		translate([0, 0, -10]) aux_control_three_button_cluster();
+	}
+}
+
+aux_control_three_button_cluster_decorative_plate();

src/misc/decorative-plate-dir_arc-plus-w-24mm-8-button.scad

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module dir_arc_plus_w_24mm_8_button_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) dir_arc_plus_w_24mm_8_button();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) dir_arc_plus_w_24mm_8_button();
+	}
+}
+
+dir_arc_plus_w_24mm_8_button_decorative_plate();

src/misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine-rectangles.scad

@@ -0,0 +1,35 @@
+/*
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate_of_plates() {
+	difference() {
+		// layout offset + 30 = width for layout plus button width + 19+3 = space around button
+		left_plate_x = dir_arc_30mm_column_3_offset + 30 + 19;
+		// layout offset + 30 = width for layout plus button width + 19+3 = space around button
+		left_plate_y = dir_arc_w_30mm_row_4_offset + 30 + 19;
+		left_plate_center_x = (left_plate_x + sega_2p_column_1_left_panel_edge_offset - 22)/2;
+		// layout offset + 30 = width for layout plus button width + 19+3 = space around button
+		right_plate_x = sega_2p_column_4_offset + 30 + 19;
+		right_plate_center_x = (right_plate_x + sega_2p_column_1_left_panel_edge_offset - 22)/2;
+
+		union() {
+			// y values are based on the other half below
+			translate([right_plate_center_x, 15, 0]) linear_extrude(2) offset(r=3, $fn=100)
+				square([right_plate_x, left_plate_y], center=true);
+			translate([-left_plate_center_x, 15, 0]) linear_extrude(2) offset(r=3, $fn=100)
+				square([left_plate_x, left_plate_y], center=true);
+			/* translate([-50, 0, 0]) cube([200, 200, 2], center=true); */
+		}
+		// cut out the normal holes
+		translate([-panel_x/2, 0, -1]) dir_arc_w_30mm();
+		translate([panel_x/2, 0, -1]) sega_2p_nine();
+	}
+}
+
+dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate_of_plates();

src/misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine-superplate.scad

@@ -0,0 +1,34 @@
+/* decorative plate for directional and action buttons.
+ *
+ * SPDX-FileCopyrightText: © 2025 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_superplate() {
+	difference() {
+		union() {
+			hull() difference() {
+				// get a 2mm slice of the bigger button cylinders
+				union() {
+					translate([-panel_x/2, 0, -50]) dir_arc_w_30mm();
+					translate([panel_x/2, 0, -50]) sega_2p_nine();
+					// customized position to make a top point even with the
+					// top of the dir_arc_w_30mm piece, because it being
+					// at an angle otherwise looks silly IMO
+					translate([panel_x*23/32, 26.6, -50]) sega_2p_p1();
+				}
+				translate([0, 0, -100]) cube([500, 500, 198], center=true);
+				translate([0, 0, 100]) cube([500, 500, 198], center=true);
+			}
+		}
+		// cut out the normal holes
+		translate([-panel_x/2, 0, -1]) dir_arc_w_30mm();
+		translate([panel_x/2, 0, -1]) sega_2p_nine();
+	}
+}
+
+dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_superplate();

src/misc/decorative-plate-dir_arc-plus-w-30mm-and-sega-2p-nine.scad

@@ -0,0 +1,24 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		union() {
+			translate([-panel_x/2, 0, -65]) dir_arc_w_30mm();
+			translate([panel_x/2, 0, -65]) sega_2p_nine();
+		}
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([-panel_x/2, 0, -1]) dir_arc_w_30mm();
+		translate([panel_x/2, 0, -1]) sega_2p_nine();
+	}
+}
+
+dir_arc_plus_w_30mm_and_sega_2p_nine_decorative_plate();

src/misc/decorative-plate-dir_arc-plus-w-30mm-plate.scad

@@ -0,0 +1,22 @@
+/* Decorative plate for directional buttons.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module dir_arc_plus_w_30mm_plate_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([-panel_x/2, 0, -25]) hull() dir_arc_w_30mm();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([-panel_x/2, 0, -1]) dir_arc_w_30mm();
+	}
+}
+
+dir_arc_plus_w_30mm_plate_decorative_plate();

src/misc/decorative-plate-dir_arc-plus-w-30mm.scad

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module dir_arc_plus_w_30mm_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) dir_arc_w_30mm();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) dir_arc_w_30mm();
+	}
+}
+
+dir_arc_plus_w_30mm_decorative_plate();

src/misc/decorative-plate-sega-2p-6-button.scad

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module sega_2p_6_button_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) sega_2p_6_button();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) sega_2p_6_button();
+	}
+}
+
+sega_2p_6_button_decorative_plate();

src/misc/decorative-plate-sega-2p-eleven-plate.scad

@@ -0,0 +1,22 @@
+/* Decorative plate for directional buttons.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module sega_2p_eleven_plate_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([panel_x/2, 0, -25]) hull() sega_2p_eleven();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([panel_x/2, 0, -1]) sega_2p_eleven();
+	}
+}
+
+sega_2p_eleven_plate_decorative_plate();

src/misc/decorative-plate-sega-2p-nine-plate.scad

@@ -0,0 +1,24 @@
+/* A rounded corner decorative plate for the Sega 2P + 1 button layout.
+ *
+ * SPDX-FileCopyrightText: © 2024 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+decorative_radius_scale = 1.5;
+include <components.scad>
+
+module sega_2p_nine_decorative_plate_of_plates() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		union() {
+			translate([panel_x/2, 0, -25]) hull() sega_2p_nine();
+		}
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([panel_x/2, 0, -1]) sega_2p_nine();
+	}
+}
+
+sega_2p_nine_decorative_plate_of_plates();

src/misc/decorative-plate-sega-2p-nine.scad

@@ -0,0 +1,20 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module sega_2p_nine_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) sega_2p_nine();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) sega_2p_nine();
+	}
+}
+
+sega_2p_nine_decorative_plate();

src/misc/decorative-plate-sega-2p.scad

@@ -0,0 +1,21 @@
+/* A decorative plate for the Sega 2P layout.
+ *
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module sega_2p_decorative_plate() {
+	difference() {
+		// get a 2mm slice of the bigger button cylinders
+		translate([0, 0, -55]) sega_2p();
+		translate([0, 0, -100]) cube([500, 500, 198], center=true);
+		translate([0, 0, 100]) cube([500, 500, 198], center=true);
+		// cut out the normal holes
+		translate([0, 0, -1]) sega_2p();
+	}
+}
+
+sega_2p_decorative_plate();

src/misc/dustwasher-jlf.scad

@@ -0,0 +1,17 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module jlf_dustwasher() {
+	difference() {
+		cylinder(r=jlf_dustwasher_radius, h=2, $fn=100, center=true);
+		cylinder(r1=jlf_shaft_inner_radius, r2=jlf_shaft_inner_radius+shaft_position_tolerance,
+			h=2.001, $fn=100, center=true);
+	}
+}
+
+jlf_dustwasher();

src/misc/dustwasher-lsx-nobi.scad

@@ -0,0 +1,17 @@
+/*
+ * SPDX-FileCopyrightText: © 2023 Brian S. Stephan <bss@incorporeal.org>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+include <parameters.scad>
+include <components.scad>
+
+module lsx_nobi_dustwasher() {
+	difference() {
+		cylinder(r=lsx_nobi_dustwasher_radius, h=2, $fn=100, center=true);
+		cylinder(r1=lsx_nobi_shaft_inner_radius, r2=lsx_nobi_shaft_inner_radius+shaft_position_tolerance,
+			h=2.001, $fn=100, center=true);
+	}
+}
+
+lsx_nobi_dustwasher();