Home
Home
Map
Map
Download
OS++
Down
Load
Doco A
Doco_A
Videos
Youtube
Chat
Chat
News
News
Shop
Shop

//#! Language documentation - http://osplusplus.org/2022doco

It’s a Doco (and this is a quick stub)

TLDR; Doco, it explains stuff. Download “80/20 A documentation”

Click here to download 80/20 doco_A.

But you should not be using it. You should be using OS++ examples directly, by downloading the framework below.

http://osplusplus.org/2022standard/The_Download.tar.gz

Once downloaded and uncompressed check-out “Learn_Hard1A_v1_0_0.scad” for examples in the root directory

NB Learn_Hard1A covers the same subject mater as doco_A. Hard1B will cover the next chapter, when it’s released …..


The OS++; code comes in a downloadable compressed file. Once uncompressed you will find a file in the root called something like “Learn_Hard1A_v1_0_0.scad.” You can open this up with openscad. Everything should be in the right place to just render by pressing F6 or F5 for colour. This file contains blocks of code, all remmed out. These block examples start with a simple statement and then becomes increasingly complex examples. So just unrem the code and play with it and then reload when you break it. This is the best way to learn in my opinion.

Why is this the best way to learn?

  1. This is quick for me to compile and therefore this file should be up to date.
  2. I use it as a quick way do unit testing when adding new features. Therefore the code should work straight off the bat.
  3. Alternatively Code examples in the doco pdf sometimes do not work due to character conversions when copying and pasting ie The Double quote chracter conversion problem.
  4. I am not a teacher. My wordy explanations probably make little sense and probably will annoy you with my irreverence.

Obviously there is a lot to remember here. So I have added a cheat sheet which is in the same download and is called cheatsheet.pdf

while “Learn_Hard1A_v1_0_0.scad.” contains many single examples. An actual coherent and full example of a shape can be found in same downloads. The files all start with the word “example” and include support files.


Doco_80-20.pdf

This file includes what I think are useful things to know. I have tried to explain the rational for why things are the way they are. If things get a little bit off topic I will continue the trail of thought in doco_80-20_indepth.pdf

Click here to download 80/20 doco_A.

Doco_80-20_indepth.pdf

This file contains trains of thought that probably should be taken out and shot. Spelling will be haphazard. Punctuation non existent. You have been warned. Do not download if you value your sanity or are a punctuation/spelling Nazi.


In other news

If you have found a random bit of code on the internet and it’s directed you here and you just want it to work. Then

Goto http://osplusplus.org/2022standard and download the standard. Called “The_Download” which is a compressed tar.

Once you have unziped, decompressed and untared it. Simply shove the code you have found into the root sub directory of the tarball. The root directory is essentially the directory below z_lib. From there its should just work when you load it up with openscad and press f6.

Enjoy.


Site summary (added to bottom of every page)

Web links    
 The_Download = UNIX - The_Download - OS++ Framework
 The_Download = Windows - The_Download - OS++ Framework
 Front_door = OSplusplus.org
 2022standard = OSplusplus.org/2022standard
 Grade EG = OSplusplus.org/2022standard/Professional
 Doco = OSplusplus.org/2022doco/
 Terms & datatypes = OSplusplus.org/2022term/
  =  
 Youtube Channel = https://www.youtube.com/channel/UC5GqhceNMLX4iDNClEWT0Fg
Code map    (Download page)
 Examples = /Example_lucky_dice_succinct_v2_0_0.scad
 Templates (Use this) = /Template_minimal_v1_2_0.scad
 Templates (too long) = /Template_verbose_v1_1_0.scad
 Project_template (Use this) = /project_template
 Libs root = /z_lib/
 3rd party code = /z_lib/addon
 Cuboid = /z_lib/lib_cuboid
 Cones = /z_lib/lib_cone
 Spheres = /z_lib/lib_sphere
 Cone Maths = /z_lib/L0_cone
 Cone Math/Cyl = /z_lib/L0_cone/z_ref_Cyl
 Libs_unit_test = In directories above
   
Hard_code_learning (Play/Learn by example)
  Download 2022standard, Uncompress, untar.
  Open Openscad (AppImage 2021.01-x86_64).
  Load Learn_Hard1A_v1_0_0.scad
  Press F6. Nothing happens.
  unRem block, Press F6 and render.
  See code example come to life.
  Change parms. Destroy code. Reload. Repeat.
Procedure for use
  Download 2022standard,uncompress,untar.
  Delete all files in root except template
  Copy template to new file name
  Edit new filename
   
Author
 Stephen George
 3rd March 2023
Contribute (LOL)    
 Buy me a coffee =
 Talk to me = Sure! Buy me a coffee. I think there is a message feature on the coffee site.
 Bugs & Finance = TBA
 RFC = TBA