Examples included with OpenSCAD

classic Classic list List threaded Threaded
10 messages Options
tp3
Reply | Threaded
Open this post in threaded view
|

Examples included with OpenSCAD

tp3
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
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

kintel
Administrator
On Jan 19, 2015, at 15:47 PM, Torsten Paul <[hidden email]> 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


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

Miro Hrončok
>> 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.

_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

MichaelAtOz
Administrator
In reply to this post by tp3
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?
Admin - email* me if you need anything, or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

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.
Obviously inclusion of works of previous authors is not included in the above.
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

Miro Hrončok
In reply to this post by tp3
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 <[hidden email]>:

> 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
> [hidden email]
> http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org

_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
tp3
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

tp3
In reply to this post by Miro Hrončok
> > > 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.

_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

kintel
Administrator
In reply to this post by MichaelAtOz
On Jan 20, 2015, at 06:57 AM, MichaelAtOz <[hidden email]> 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


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

jon_bondy
In reply to this post by MichaelAtOz
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
> [hidden email]
> 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


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

digital
In reply to this post by Miro Hrončok
very nice, https://github.com/3DprintFIT/openscad-tasks

maybe others can use this as a curriculum to teach in schools or other educational environments.
Reply | Threaded
Open this post in threaded view
|

Re: Examples included with OpenSCAD

MichaelAtOz
Administrator
In reply to this post by tp3
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
Admin - email* me if you need anything, or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

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.
Obviously inclusion of works of previous authors is not included in the above.