+// filamentspool.scad
+// 3D design for filament spools to hold coils as supplied by Faberdashery
+//
+
+//
+// Copyright 2012,2013,2016 Ian Jackson
+//
+// This work 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 work 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 work. If not, see <http://www.gnu.org/licenses/>
+//
+
+//
+// Each spool is a hub with 3 or 4 arms. Each arm has a cup for
+// holding the filament. The effective diameter can be adjusted by
+// setting the cup into a different seat in the arm. The cups are
+// held on with simple clips, so the filement coil can easily be
+// removed and replaced.
+//
+// This file (and its includes) can generate:
+//
+// ===== Heavy duty 4-armed spool for 3mm x 100m coil =====
+//
+// A heavy duty 4-armed spool suitable for holding a 100m
+// Faberdashery coil on the spool arm of a Lulzbot TAZ-5.
+//
+// Set
+// fdia=2.85
+// lightduty=false
+// And print following parts
+// Hub
+// ArmEnd x 4
+// FilamentCup x 4 (or FilamentCupPair x 2)
+// CupSecuringClip x 4
+//
+// You will also need 4 x M4 machine screws and nuts.
+//
+// This is the default.
+//
+// ===== Light duty 3-armed spool for 3mm x <=30m coil =====
+//
+// A light duty 3-armed spool suitable for up to around 30m
+// of Faberdashery 2.85mm PLA.
+//
+// Set
+// fdia=2.85
+// lightduty=true
+// (or look in filamentspool-lt.scad).
+//
+// And print following parts
+// Hub
+// ArmEnd x 3
+// FilamentCup x 3 (or FilamentCup + FilamentCupPair)
+// CupSecuringClip x 3
+// TowerDoveClipPin x 6
+//
+// When assembling, insert one TowerDoveClipPin from each side,
+// joining each ArmEnd to the Hub with two TowerDoveClipPins.
+// Modest force with pliers is good to seat them properly.
+//
+// (note that the light duty and heavy duty CupSecuringClips
+// are slightly different)
+//
+// ===== Notes regarding both the above spools =====
+//
+// When mounting either spool on the TAZ-5 spool arm, put the `pointy'
+// end of the hub towards the printer - ie, put put the spool on
+// `backwards'. This ensures that the spool's arms will clear the
+// printer framework.
+//
+// For the above, I generally used the Cura `Standard' PLA profile.
+//
+// ===== TAZ-5 feed tube adjustment kit =====
+//
+// With a TAZ-5 I recommend using this kit to improve the feed
+// reliability:
+//
+// Set
+// fdia=2.85
+// And print following parts
+// FilamentGuideSpacer (ideally, at `high detail')
+// FilamentGuideArmPrint (optional; `high detail' or `standard')
+//
+// And possibly also
+// t-nut_jig_0.2.stl
+// from Aleph Objects - look here:
+// http://download.lulzbot.com/TAZ/accessories/tool_heads/version_2/Dual_Extruder_v2/production_parts/stl/
+//
+// The spacer clips onto the filament guide tube holder arm, on the
+// inside, with the pointy flanged end towards the filament guide
+// tube. It stops the filament guide tube angle (and so the
+// filament's natural pickup location) changing as the print head moves.
+//
+// The FilamentGuideArm[Print] is a replacement for the arm supplied
+// with your TAZ-5. It's longer, so that the filament pickup point is
+// closer to the middle of the coil. Use the t-nut_jig to stop the
+// T-nuts in the aluminium channel from annoyingly sliding down to the
+// bottom while you swap out the arm.
+//
+// (Faberdashery coils, and therefore both the above spools, have a
+// larger diameter than the flat-walled spools often supplied by other
+// vendors. And the spools above have individual arms rather than a
+// continuous disc. If the filament `unhooks' from the arm, it can
+// pull taught around the hub and stop feeding properly.)
+//
+// ===== Spool storage arm, for mounting on walls =====
+//
+// A storage arm suitable for screwing to walls, bookshelves,
+// etc. (requires non-countersunk M4 screws); will hold two heavy duty
+// spools each with a 100m coil.
+//
+// Set
+// fdia=2.85
+// lightduty=false
+// And print one of these, according to taste
+// StorageArmLeft
+// StorageArmRight
+//
+// NB that the `light duty' version of this is shorter and
+// will only take two `light duty' spools.
+//
+// A longer arm for three spools is also available:
+// Set
+// fdia=2.85
+// lightduty=false
+// storarm_spools=3
+// (or look in filamentspool-storarm3.scad).
+//
+// And print one of these, according to taste
+// StorageArmLeft
+// StorageArmRight
+//
+// For all of these, I used the Cura `High detail' PLA profile because
+// I wanted it pretty, but the `Standard' profile should do fine.
+//
+// ===== Spools for 1.75mm filament =====
+//
+// Spool (in many parts) for handing 1.75mm filament, printable
+// on, and with parts for mounting on, a Reprappro Huxley.
+
+
+fdia=2.85; // or 1.75
+lightduty=false; // or true
+