Add hint for users of this package when encountering slow rendering or missing

objects.

1 files changed, 18 insertions, 0 deletions

diff --git a/cad/openscad/MESSAGE b/cad/openscad/MESSAGE
new file mode 100644
index 00000000000..24f87cc3c01
--- /dev/null
+++ b/cad/openscad/MESSAGE
@@ -0,0 +1,18 @@
+Hints and tips for OpenSCAD:
+
+openscad-2011.12: Sometimes it doesn't seem to render all objects when
+rendering with the fast OpenCSG. It is not yet clear if this is a problem with
+OpenSCAD or with OpenCSG. The solution is to add the render() primitive to the
+function. This will then use CGAL to create a primitive even when rendering
+with OpenCSG. It also speeds up rendering significantly since it creates them
+as primitives! So transform 
+
+	func(l) {
+		....
+	}
+to
+	func(l) render() {
+		....
+	}
+
+if you encounter render problems or when rendering a primitive is very slow.