Examples included with OpenSCAD
There will be some changes regarding the examples shipped with OpenSCAD.
Mainly all examples will be CC0 licensed which means there's no need
to think about attribution or other things when using ideas/snippets
from the examples.
(http://creativecommons.org/publicdomain/zero/1.0/)
In addition we are trying to reorganize and also extend the list
of examples.
As it's not very easy to just have a look at what changed so fare, I've
generated some HTML pages with all examples, including the new ones:
e.g.: http://files.openscad.org/examples/Basics/projection.html
Suggestions for more intuitive categories or ideas which topics to
cover or complete examples would be very welcome.
ciao,
Torsten.
List of new examples so far:
http://files.openscad.org/examples/Basics/LetterBlock.html
http://files.openscad.org/examples/Basics/children.html
http://files.openscad.org/examples/Basics/children_indexed.html
http://files.openscad.org/examples/Basics/linear_extrude.html
http://files.openscad.org/examples/Basics/projection.html
http://files.openscad.org/examples/Basics/rotate_extrude.html
http://files.openscad.org/examples/Basics/surface_image.html
http://files.openscad.org/examples/Functions/functions.html
http://files.openscad.org/examples/Functions/recursion.html
On Jan 19, 2015, at 15:47 PM, Torsten Paul Torsten.Paul@gmx.de wrote:
I’ve generated some HTML pages with all examples, including the new ones:
I really like the HTML examples. That should be part of the online docs!
-Marius
I’ve generated some HTML pages with all examples, including the new ones:
I really like the HTML examples. That should be part of the online docs!
+1
The images might be a bit bigger, but otherwise, this is perfect.
If you think there are other types of examples which would be useful, list
them and I'll have a go for those within my skill level.
Do we have a target date for release?
Unless specifically shown otherwise above, my contribution is in the Public Domain; To the extent possible under law, I have waived all copyright and related or neighbouring rights to this work. This work is published globally via the internet. :) Inclusion of works of previous authors is not included in the above.
The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/
View this message in context: http://forum.openscad.org/Examples-included-with-OpenSCAD-tp11096p11126.html
Sent from the OpenSCAD mailing list archive at Nabble.com.
Also in case you would like any of those, let me know and I'll make them CC0.
https://github.com/3DprintFIT/openscad-tasks (lesson01 and lesson02)
Miro Hrončok
Telefon: +420777974800
2015-01-19 21:47 GMT+01:00 Torsten Paul Torsten.Paul@gmx.de:
There will be some changes regarding the examples shipped with OpenSCAD.
Mainly all examples will be CC0 licensed which means there's no need
to think about attribution or other things when using ideas/snippets
from the examples.
(http://creativecommons.org/publicdomain/zero/1.0/)
In addition we are trying to reorganize and also extend the list
of examples.
As it's not very easy to just have a look at what changed so fare, I've
generated some HTML pages with all examples, including the new ones:
e.g.: http://files.openscad.org/examples/Basics/projection.html
Suggestions for more intuitive categories or ideas which topics to
cover or complete examples would be very welcome.
ciao,
Torsten.
List of new examples so far:
http://files.openscad.org/examples/Basics/LetterBlock.html
http://files.openscad.org/examples/Basics/children.html
http://files.openscad.org/examples/Basics/children_indexed.html
http://files.openscad.org/examples/Basics/linear_extrude.html
http://files.openscad.org/examples/Basics/projection.html
http://files.openscad.org/examples/Basics/rotate_extrude.html
http://files.openscad.org/examples/Basics/surface_image.html
http://files.openscad.org/examples/Functions/functions.html
http://files.openscad.org/examples/Functions/recursion.html
http://files.openscad.org/examples/Advanced/animation.html
OpenSCAD mailing list
Discuss@lists.openscad.org
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
I’ve generated some HTML pages with all examples, including the new ones:
I really like the HTML examples. That should be part of the online docs!
The images might be a bit bigger, but otherwise, this is perfect.
Right, for actually using this as online doucmentation, some more
polishing of the HTML template is certainly required (e.g. zoom / hide
of the image, maybe some additional explanation, ...). I'd put that
on hold for after the release :-).
- Open issues
The hardest part is probably finding a relatively simple example that
still shows why it's useful.
- Example using hull() - https://github.com/openscad/openscad/issues/355
- Example using minkowski() - https://github.com/openscad/openscad/issues/356
- Example using resize() - https://github.com/openscad/openscad/issues/357
- List comprehension example - https://github.com/openscad/openscad/issues/814
(someone expressed interrest in doing the last one, not sure if that
still is going to happen)
Other than that there's a number of possible examples, but I don't
have a good idea how to explain those:
- Basics / Features
- Usage of modules
- multmatrix()
- math functions / calculations
- libraries (e.g. an example using MCAD)
- $fn / $fa / $fs
- Variables? (or should we start calling those constants?)
- ...
- Other ideas are related to specific usage patterns (probably for
the Advanced cateogory). I guess this list could be extended by
looking through the mailing list archive for questions.
- Chain hulls
- Recursive modules
- ...
ciao,
Torsten.
On Jan 20, 2015, at 06:57 AM, MichaelAtOz oz.at.michael@gmail.com wrote:
Do we have a target date for release?
As soon as possible. I'll build a Release Candidate once all critical issues are resolved. We can work on examples and docs while the Release Candidate goes through external testing.
-Marius
I have been lurking for the last 9 months or so, using release
2014.03.04. I try to follow the examples as they fly by.
I have to say that the list comprehensions are the things that are the
most difficult for me to grasp. I hope that examples will be available
for that feature. It seems powerful.
Jon
On 1/20/2015 6:57 AM, MichaelAtOz wrote:
If you think there are other types of examples which would be useful, list
them and I'll have a go for those within my skill level.
Do we have a target date for release?
Unless specifically shown otherwise above, my contribution is in the Public Domain; To the extent possible under law, I have waived all copyright and related or neighbouring rights to this work. This work is published globally via the internet. :) Inclusion of works of previous authors is not included in the above.
The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/
View this message in context: http://forum.openscad.org/Examples-included-with-OpenSCAD-tp11096p11126.html
Sent from the OpenSCAD mailing list archive at Nabble.com.
OpenSCAD mailing list
Discuss@lists.openscad.org
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
No virus found in this message.
Checked by AVG - www.avg.com
Version: 2015.0.5645 / Virus Database: 4260/8964 - Release Date: 01/20/15
very nice, https://github.com/3DprintFIT/openscad-tasks
maybe others can use this as a curriculum to teach in schools or other
educational environments.
--
View this message in context: http://forum.openscad.org/Examples-included-with-OpenSCAD-tp11096p11178.html
Sent from the OpenSCAD mailing list archive at Nabble.com.
This may be one? No actual geometry tho.
// hex.scad
// released to the public domain, by MichaelAtOz
// feel free to remove the above.
// converts a string of hexadecimal digits into a decimal number
function h2d(h="0",i=-1) =
(i == -1) // are we starting?
? h2d(h,i=len(h)-1) // then set to length
: i == 0 // have we finished
? hexDigit(h[0]) // return the first char
: hexDigit(h[i]) + 16*h2d(h,i-1); // else, do the conversion.
// test h2d()
echo( "Results: ",
h2d(), h2d("0"), h2d("9"), h2d("a"),
h2d("f"), h2d("ff"), h2d("fff"),
h2d("abc"), h2d("def"),
h2d("fff0")
);
echo( "Expected:",0,0,9,10,15,255,4096,2748,3567,65520);
function hexDigit(d="") =
len(d) != 1 ? undef : // only valid for single char
d[0] == "0" ? 0 : // test char & return result
d[0] == "1" ? 1 :
d[0] == "2" ? 2 :
d[0] == "3" ? 3 :
d[0] == "4" ? 4 :
d[0] == "5" ? 5 :
d[0] == "6" ? 6 :
d[0] == "7" ? 7 :
d[0] == "8" ? 8 :
d[0] == "9" ? 9 :
d[0] == "a" ? 10 :
d[0] == "b" ? 11 :
d[0] == "c" ? 12 :
d[0] == "d" ? 13 :
d[0] == "e" ? 14 :
d[0] == "f" ? 15
: (0/0); // 0/0=nan - ie anything other than 0-f, is bad
// test hexDigit
hexList="fedcba9876543210";
for (i = [0 : 15] )
echo("Hex Char=",hexList[i]," Hex Digit=",hexDigit(hexList[i]));
echo(hexDigit("ff")); // undef
echo(hexDigit("g")); // nan
Unless specifically shown otherwise above, my contribution is in the Public Domain; To the extent possible under law, I have waived all copyright and related or neighbouring rights to this work. This work is published globally via the internet. :) Inclusion of works of previous authors is not included in the above.
The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/
View this message in context: http://forum.openscad.org/Examples-included-with-OpenSCAD-tp11096p11189.html
Sent from the OpenSCAD mailing list archive at Nabble.com.