This commit is contained in:
Sébastien Dante Ursini 2025-02-12 17:23:27 -03:00
parent 07aff71e1e
commit 2f3c573c19
6 changed files with 87 additions and 0 deletions

2
.gitignore vendored
View File

@ -1 +1,3 @@
.DS_Store
docgen

3
.openscad_docsgen_rc Normal file
View File

@ -0,0 +1,3 @@
TargetProfile: githubwiki
ProjectName: Metal Library
GenerateDocs: Files, TOC, Index, Topics, CheatSheet, Sidebar

1
docs/.source_hashes Normal file
View File

@ -0,0 +1 @@
metalib.scad|3979a0093760105008a8e3283ce8796093ccaba9a37aa2ff4bfcf5f9ba386c4e

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

81
docs/metalib.scad.md Normal file
View File

@ -0,0 +1,81 @@
# LibFile: metalib.scad
To use, add the following lines to the beginning of your file:
include <metalib.scad>;
## File Contents
- [`miter_profile()`](#module-miter_profile) – Creates a miter profile
- [`miter_tubes()`](#module-miter_tubes) – Generates a sequence of mitered tubes
### Module: miter\_profile()
**Synopsis:** Creates a miter profile
**Usage:** As Module
- miter_profile(length,height,depth);
**Description:**
Generates a flexible battery holder for 'n' cylindrical batteries with complex features like wire channels, screw holes, and contact points.
**Arguments:**
<abbr title="These args can be used by position or by name.">By&nbsp;Position</abbr> | What it does
-------------------- | ------------
`length` | Length
`height` | Height
`depth` | Depth
**Example 1:** Simple Case
<img align="left" alt="miter\_profile() Example 1" src="images/metalib/miter_profile.png" width="320" height="240">
include <metalib.scad>;
miter_profile(length=200, height=30, depth=20);
<br clear="all" /><br/>
---
### Module: miter\_tubes()
**Synopsis:** Generates a sequence of mitered tubes
**Description:**
This module generates a sequence of mitered tubes based on the provided section lengths,
with options for customizing their dimensions and unfolding their arrangement.
**Arguments:**
<abbr title="These args can be used by position or by name.">By&nbsp;Position</abbr> | What it does
-------------------- | ------------
`section` | An array of section lengths, each specifying the length of an individual tube. Example: `[10, 20, 30]` will create three tubes of lengths 10, 20, and 30 units respectively.
`heights` | The height of each tube. This value defines the dimension perpendicular to the tube's length and depth.
`depth` | The depth of each tube. This value defines the dimension perpendicular to the tube's length and height.
`unfold` | Determines whether the sequence of tubes should be unfolded for easier visualization or fabrication. When `true`, the tubes are laid out in a flat arrangement. Defaults to `false`.
**Example 1:** Simple Case
<img align="left" alt="miter\_tubes() Example 1" src="images/metalib/miter_tubes.png" width="320" height="240">
include <metalib.scad>;
miter_tubes(
sections = [800,750,800],
height = 50,
depth = 50,
start=false,
end=false,
unfold = false,
quote=true
);
<br clear="all" /><br/>
---