The gendl Reference Manual

1 Introduction
2 Systems
3 Files
- 3.1 Lisp
4 Packages
5 Definitions
- 5.1 Exported definitions
- 5.2 Internal definitions
Appendix A Indexes

This is the gendl Reference Manual, version 2013031600, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 11:50:11 2018 GMT+0.

1 Introduction

Gendl® is a Generative Programming and Knowledge Based Engineering framework, implementing concepts which date back to the 1980s and which cutting-edge companies have been quietly using to gain competitive advantage with mission-critical engineering applications. These concepts required hundreds of thousands of dollars investment in hardware and software just a couple decades ago. They are now at your fingertips as an integral part of the Open-Source ecosystem, running on commodity consumer-grade hardware.

Gendl allows for high-level declarative, object-oriented problem solving and application development, including but not limited to the ability to generate and manipulate 3D geometry. To solve a problem in Gendl, you formulate it using the define-object operator, which allows you to specify inputs, outputs (computed-slots), and child objects, which then gives the ability to generate a "tree" of objects, useful for decomposing complexity.

A graphical web-based interface, tasty, is available for interacting with your system as it is developed.

The web-based GUI framework used to make tasty (GWL) is also available for creating your own custom web-based user interfaces.

Fundamental KBE Features Provided

Gendl ships with a full set of wireframe 3D and 2D geometry primitives along with output lenses for standard browser-based viewing and exchange formats such as PDF, SVG, X3D, PNG, as well as DXF.

Optionally there is available a set of surface- and solid-modeling primitives which currently depend on SMLib, a commercial geometry kernel available from Solid Modeling Solutions, Inc. SMLib enables the use of standard CAD data exchange formats such as Iges, STEP, and STL (for 3D printing).

Basic Requirements:

Installation

Emacs Editor/IDE Support

Slime (Superior Lisp Interaction Mode for Emacs) is recommended for developing Gendl applications with Emacs.

`Glime' is our Gendl-specific customizations to Slime. This is implemented entirely on the swank (Common Lisp) side of things, and can be loaded with

Although not strictly necessary, the file .../gendl/emacs/gdl.el is also provided and can be used as a starting point or reference for loading Glime and Gendl into an emacs environment.

Further Documentation

Documentation is published here, and this very much an active work in progress. Training tutorials and videos are also in progress and in their current state are available in the Documentation section on http://gen.works.

Support/Community

Training/Coaching

Gendl source code Architecture:

Gendl is separated into layered components, some of which depend on others. Some components also depend on third-party external libraries, which are currently handled with the Quicklisp system.

At the core "kernel" is the :gendl (nickname :gdl) package, implemented with files in the folder gendl/base/. This includes the compiler/expanders for define-object and related macros as well as core primitives such as vanilla-mixin.

Alternative Geometry Kernels

If you have a different favorite solid modeling kernel (e.g. OpenCascade, Parasolid, Geometros sgCore), then an interesting project would be to interface the existing Surface package to that kernel, by implementing the methods in surf/source/methods.lisp.

The Surface (:surf) package (in the surf/ folder) contains all the high-level Surface and Solid modeling primitives currently implemented in Gendl. These primitives provide a protocol for what the objects should be able to do (i.e. what messages they should answer), but without the SMLib library and associated middleware available, they will not be able to return any results. The SMLib kernel and associated middleware are available as part of the commercial Genworks® GDL product from Genworks® International.

License

The AGPL, has the requirement that you release any derivatives and any applications compiled with Gendl under AGPL-compatible license (if distributed at all).

Proprietary Distribution

For Proprietary (closed-source) development and distribution, the commercial Genworks® GDL system (including Gendl® technology and, optionally, commercial CL engines, technical support, and commercial solid modeling engine) is available from Genworks.

Bug Bounty Program, Bug Fix Program

Genworks offers a modest bounty for reporting (and sometimes solving) of bugs on the Issues List.

2 Systems

2.1 gendl

2.2 cl-lite

2.3 tasty

2.4 tree

2.5 robot

2.6 yadd

2.7 gwl-graphics

2.8 geom-base

2.9 gwl

2.10 glisp

2.11 base

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

• Introduction:		What gendl is all about
• Systems:		The systems documentation
• Files:		The files documentation
• Packages:		The packages documentation
• Definitions:		The symbols documentation
• Indexes:		Concepts, functions, variables and data types

• The gendl system:
• The cl-lite system:
• The tasty system:
• The tree system:
• The robot system:
• The yadd system:
• The gwl-graphics system:
• The geom-base system:
• The gwl system:
• The glisp system:
• The base system:

• The gendl.asd file:
• The cl-lite.asd file:
• The tasty.asd file:
• The tree.asd file:
• The robot.asd file:
• The yadd.asd file:
• The gwl-graphics.asd file:
• The geom-base.asd file:
• The gwl.asd file:
• The glisp.asd file:
• The base.asd file:
• The cl-lite/source/package.lisp file:
• The cl-lite/source/parameters.lisp file:
• The cl-lite/source/cl-lite.lisp file:
• The cl-lite/source/initialize.lisp file:
• The cl-lite/source/zzinit.lisp file:
• The tasty/source/package.lisp file:
• The tasty/source/parameters.lisp file:
• The tasty/source/assembly.lisp file:
• The tasty/source/initialize.lisp file:
• The tasty/source/inspector.lisp file:
• The tasty/source/menu.lisp file:
• The tasty/source/new-inspector.lisp file:
• The tasty/source/newer-inspector.lisp file:
• The tasty/source/part-type-form.lisp file:
• The tasty/source/publish.lisp file:
• The tasty/source/status-object.lisp file:
• The tasty/source/test-part.lisp file:
• The tasty/source/test-part2.lisp file:
• The tasty/source/two-viewports.lisp file:
• The tasty/source/viewport.lisp file:
• The tasty/source/zzinit.lisp file:
• The tree/source/package.lisp file:
• The tree/source/parameters.lisp file:
• The tree/source/ajax.lisp file:
• The tree/source/assembly.lisp file:
• The tree/source/newertree.lisp file:
• The robot/source/package.lisp file:
• The robot/source/assembly.lisp file:
• The robot/source/initialize.lisp file:
• The robot/source/parameters.lisp file:
• The robot/source/zzinit.lisp file:
• The yadd/source/package.lisp file:
• The yadd/source/genworks.lisp file:
• The yadd/source/parameters.lisp file:
• The yadd/source/mixins.lisp file:
• The yadd/source/define-object-documentation.lisp file:
• The yadd/source/assembly.lisp file:
• The yadd/source/ass.lisp file:
• The yadd/source/format-documentation.lisp file:
• The yadd/source/function-documentation.lisp file:
• The yadd/source/initialize.lisp file:
• The yadd/source/publish.lisp file:
• The yadd/source/test-part.lisp file:
• The yadd/source/variable-documentation.lisp file:
• The yadd/source/zzinit.lisp file:
• The gwl-graphics/gwl/source/application-mixin.lisp file:
• The gwl-graphics/gwl/source/base-ajax-graphics-sheet.lisp file:
• The gwl-graphics/gwl/source/base-html-graphics-sheet.lisp file:
• The gwl-graphics/gwl/source/layout-mixin.lisp file:
• The gwl-graphics/gwl/source/process-graphics-fields.lisp file:
• The gwl-graphics/gwl/source/web-drawing.lisp file:
• The gwl-graphics/gwl/source/x3d-try.lisp file:
• The gwl-graphics/raphael/source/package.lisp file:
• The gwl-graphics/raphael/source/formats.lisp file:
• The gwl-graphics/raphael/source/lenses.lisp file:
• The gwl-graphics/source/parameters.lisp file:
• The gwl-graphics/zzinit/source/initialize.lisp file:
• The gwl-graphics/zzinit/source/zzinit.lisp file:
• The geom-base/prereqs/source/presets.lisp file:
• The geom-base/prereqs/source/cl-pdf-patches.lisp file:
• The geom-base/prereqs/source/matrix.lisp file:
• The geom-base/prereqs/source/parameters.lisp file:
• The geom-base/prereqs/source/3d-point-vector-data-types.lisp file:
• The geom-base/prereqs/source/utilities.lisp file:
• The geom-base/formats/source/2d-output.lisp file:
• The geom-base/formats/source/dxf.lisp file:
• The geom-base/formats/source/macro-redefs.lisp file:
• The geom-base/formats/source/obj.lisp file:
• The geom-base/formats/source/pdf-multipage.lisp file:
• The geom-base/formats/source/pdf-raw.lisp file:
• The geom-base/formats/source/pdf.lisp file:
• The geom-base/formats/source/raster.lisp file:
• The geom-base/formats/source/vector-graphics.lisp file:
• The geom-base/wire/source/base-object.lisp file:
• The geom-base/wire/source/arc.lisp file:
• The geom-base/wire/source/l-line.lisp file:
• The geom-base/wire/source/circle.lisp file:
• The geom-base/wire/source/bezier-curve.lisp file:
• The geom-base/wire/source/cylinder.lisp file:
• The geom-base/wire/source/global-polyline.lisp file:
• The geom-base/wire/source/global-filleted-polyline.lisp file:
• The geom-base/wire/source/global-polygon-projection.lisp file:
• The geom-base/wire/source/sphere.lisp file:
• The geom-base/wire/source/arcoid-mixin.lisp file:
• The geom-base/wire/source/bounding-box.lisp file:
• The geom-base/wire/source/box.lisp file:
• The geom-base/wire/source/c-cylinder.lisp file:
• The geom-base/wire/source/cone.lisp file:
• The geom-base/wire/source/directional-light.lisp file:
• The geom-base/wire/source/ellipse.lisp file:
• The geom-base/wire/source/fillet.lisp file:
• The geom-base/wire/source/global-filleted-polygon-projection.lisp file:
• The geom-base/wire/source/line-and-arc-constraints.lisp file:
• The geom-base/wire/source/null-geometric-object.lisp file:
• The geom-base/wire/source/outline-specialization-mixin.lisp file:
• The geom-base/wire/source/point-light.lisp file:
• The geom-base/wire/source/point.lisp file:
• The geom-base/wire/source/points-display.lisp file:
• The geom-base/wire/source/primitives.lisp file:
• The geom-base/wire/source/route-pipe.lisp file:
• The geom-base/wire/source/spherical-cap.lisp file:
• The geom-base/wire/source/spot-light.lisp file:
• The geom-base/wire/source/torus.lisp file:
• The geom-base/wire/source/utilities.lisp file:
• The geom-base/wire/source/views.lisp file:
• The geom-base/annotations/source/angular-dimension.lisp file:
• The geom-base/annotations/source/arrowhead.lisp file:
• The geom-base/annotations/source/center-line.lisp file:
• The geom-base/annotations/source/horizontal-dimension.lisp file:
• The geom-base/annotations/source/label.lisp file:
• The geom-base/annotations/source/leader-arc.lisp file:
• The geom-base/annotations/source/leader-line.lisp file:
• The geom-base/annotations/source/linear-dimension.lisp file:
• The geom-base/annotations/source/parallel-dimension.lisp file:
• The geom-base/annotations/source/sample-drawing.lisp file:
• The geom-base/annotations/source/vertical-dimension.lisp file:
• The geom-base/drawing/source/base-view.lisp file:
• The geom-base/drawing/source/document.lisp file:
• The geom-base/drawing/source/lenses.lisp file:
• The geom-base/drawing/source/renderer-mixin.lisp file:
• The geom-base/text/source/general-note.lisp file:
• The geom-base/text/source/typeset-block.lisp file:
• The geom-base/graphs/source/graph.lisp file:
• The geom-base/graphs/source/legend.lisp file:
• The geom-base/graphs/source/pie-chart.lisp file:
• The geom-base/lenses/source/scad.lisp file:
• The geom-base/lenses/source/vrml.lisp file:
• The geom-base/lenses/source/x3d.lisp file:
• The geom-base/math/source/polynomial.lisp file:
• The geom-base/zzinit/source/initialize.lisp file:
• The geom-base/zzinit/source/zzinit.lisp file:
• The gwl/source/package.lisp file:
• The gwl/source/with-all-servers.lisp file:
• The gwl/source/defparameters.lisp file:
• The gwl/source/base-html-sheet.lisp file:
• The gwl/source/html-format.lisp file:
• The gwl/source/macros.lisp file:
• The gwl/source/presets.lisp file:
• The gwl/source/base-html-utils.lisp file:
• The gwl/source/ignore-errors-with-backtrace.lisp file:
• The gwl/source/utilities.lisp file:
• The gwl/source/answer.lisp file:
• The gwl/source/accessories.lisp file:
• The gwl/source/gdl-remote.lisp file:
• The gwl/source/vanilla-remote.lisp file:
• The gwl/source/base64-utils.lisp file:
• The gwl/source/cl-pdf-patches.lisp file:
• The gwl/source/color-palette.lisp file:
• The gwl/source/crawler.lisp file:
• The gwl/source/log-utils.lisp file:
• The gwl/source/new-urls.lisp file:
• The gwl/source/publish.lisp file:
• The gwl/source/remote-object.lisp file:
• The gwl/source/security-check-failed.lisp file:
• The gwl/form-elements/source/grid-form-element.lisp file:
• The gwl/form-elements/source/macros.lisp file:
• The gwl/form-elements/source/primitives.lisp file:
• The gwl/ajax/source/parameters.lisp file:
• The gwl/ajax/source/ajax.lisp file:
• The gwl/ajax/source/base-ajax-sheet.lisp file:
• The gwl/ajax/source/skeleton-ui-element.lisp file:
• The gwl/gwl-session/source/parameters.lisp file:
• The gwl/gwl-session/source/cleanup.lisp file:
• The gwl/gwl-session/source/functions.lisp file:
• The gwl/gwl-session/source/session-control-auto-refresh.lisp file:
• The gwl/gwl-session/source/session-control-mixin.lisp file:
• The gwl/gwl-session/source/session-recovery.lisp file:
• The gwl/gwl-session/source/session-report.lisp file:
• The gwl/js-libs/jquery/source/package.lisp file:
• The gwl/js-libs/jquery/source/slider-form-control.lisp file:
• The gwl/zzinit/source/initialize.lisp file:
• The gwl/zzinit/source/zzinit.lisp file:
• The glisp/source/presets.lisp file:
• The glisp/source/parameters.lisp file:
• The glisp/source/genworks.lisp file:
• The glisp/source/initialize.lisp file:
• The glisp/source/zzinit.lisp file:
• The base/source/package.lisp file:
• The base/source/genworks.lisp file:
• The base/source/presets.lisp file:
• The base/source/parameters.lisp file:
• The base/source/metaclasses.lisp file:
• The base/source/utilities.lisp file:
• The base/source/start.lisp file:
• The base/source/syntax-checker.lisp file:
• The base/expanders/source/inputs.lisp file:
• The base/expanders/source/computed-slots.lisp file:
• The base/expanders/source/functions.lisp file:
• The base/expanders/source/methods.lisp file:
• The base/expanders/source/objects.lisp file:
• The base/macros/source/reference.lisp file:
• The base/macros/source/message-utils.lisp file:
• The base/macros/source/define-object.lisp file:
• The base/macros/source/defaulting.lisp file:
• The base/macros/source/define-format.lisp file:
• The base/rest/source/parameters.lisp file:
• The base/rest/source/quantification.lisp file:
• The base/rest/source/aggregate.lisp file:
• The base/rest/source/utilities.lisp file:
• The base/rest/source/null-part.lisp file:
• The base/rest/source/vanilla-mixin.lisp file:
• The base/rest/source/base-rule-object.lisp file:
• The base/rest/source/bodies.lisp file:
• The base/rest/source/ignore-errors-with-backtrace.lisp file:
• The base/rest/source/init.lisp file:
• The base/rest/source/make-part.lisp file:
• The base/rest/source/sequence.lisp file:
• The base/zzinit/source/initialize.lisp file:
• The base/zzinit/source/zzinit.lisp file:

The gendl Reference Manual

Table of Contents

The gendl Reference Manual

1 Introduction

Fundamental KBE Features Provided

Basic Requirements:

Installation

Emacs Editor/IDE Support

Further Documentation

Support/Community

Training/Coaching

Gendl source code Architecture:

Alternative Geometry Kernels

License

Proprietary Distribution

Bug Bounty Program, Bug Fix Program

2 Systems

2.1 gendl

2.2 cl-lite

2.3 tasty

2.4 tree

2.5 robot

2.6 yadd

2.7 gwl-graphics

2.8 geom-base

2.9 gwl

2.10 glisp

2.11 base

3 Files

3.1 Lisp

3.1.1 gendl.asd

3.1.2 cl-lite.asd

3.1.3 tasty.asd

3.1.4 tree.asd

3.1.5 robot.asd

3.1.6 yadd.asd

3.1.7 gwl-graphics.asd

3.1.8 geom-base.asd

3.1.9 gwl.asd

3.1.10 glisp.asd

3.1.11 base.asd

3.1.12 cl-lite/source/package.lisp

3.1.13 cl-lite/source/parameters.lisp

3.1.14 cl-lite/source/cl-lite.lisp

3.1.15 cl-lite/source/initialize.lisp

3.1.16 cl-lite/source/zzinit.lisp

3.1.17 tasty/source/package.lisp

3.1.18 tasty/source/parameters.lisp

3.1.19 tasty/source/assembly.lisp

3.1.20 tasty/source/initialize.lisp

3.1.21 tasty/source/inspector.lisp

3.1.22 tasty/source/menu.lisp

3.1.23 tasty/source/new-inspector.lisp

3.1.24 tasty/source/newer-inspector.lisp

3.1.25 tasty/source/part-type-form.lisp

3.1.26 tasty/source/publish.lisp

3.1.27 tasty/source/status-object.lisp

3.1.28 tasty/source/test-part.lisp

3.1.29 tasty/source/test-part2.lisp

3.1.30 tasty/source/two-viewports.lisp

3.1.31 tasty/source/viewport.lisp

3.1.32 tasty/source/zzinit.lisp

3.1.33 tree/source/package.lisp

3.1.34 tree/source/parameters.lisp

3.1.35 tree/source/ajax.lisp

3.1.36 tree/source/assembly.lisp

3.1.37 tree/source/newertree.lisp

3.1.38 robot/source/package.lisp

3.1.39 robot/source/assembly.lisp

3.1.40 robot/source/initialize.lisp

3.1.41 robot/source/parameters.lisp

3.1.42 robot/source/zzinit.lisp

3.1.43 yadd/source/package.lisp

3.1.44 yadd/source/genworks.lisp

3.1.45 yadd/source/parameters.lisp

3.1.46 yadd/source/mixins.lisp

3.1.47 yadd/source/define-object-documentation.lisp

2.1 `gendl`

2.2 `cl-lite`

2.3 `tasty`

2.4 `tree`

2.5 `robot`

2.6 `yadd`

2.7 `gwl-graphics`

2.8 `geom-base`

2.9 `gwl`

2.10 `glisp`

2.11 `base`

3.1.1 `gendl.asd`

3.1.2 `cl-lite.asd`

3.1.3 `tasty.asd`

3.1.4 `tree.asd`

3.1.5 `robot.asd`

3.1.6 `yadd.asd`

3.1.7 `gwl-graphics.asd`

3.1.8 `geom-base.asd`

3.1.9 `gwl.asd`

3.1.10 `glisp.asd`

3.1.11 `base.asd`

3.1.12 `cl-lite/source/package.lisp`

3.1.13 `cl-lite/source/parameters.lisp`

3.1.14 `cl-lite/source/cl-lite.lisp`

3.1.15 `cl-lite/source/initialize.lisp`

3.1.16 `cl-lite/source/zzinit.lisp`

3.1.17 `tasty/source/package.lisp`

3.1.18 `tasty/source/parameters.lisp`

3.1.19 `tasty/source/assembly.lisp`

3.1.20 `tasty/source/initialize.lisp`

3.1.21 `tasty/source/inspector.lisp`

3.1.22 `tasty/source/menu.lisp`

3.1.23 `tasty/source/new-inspector.lisp`

3.1.24 `tasty/source/newer-inspector.lisp`

3.1.25 `tasty/source/part-type-form.lisp`

3.1.26 `tasty/source/publish.lisp`

3.1.27 `tasty/source/status-object.lisp`

3.1.28 `tasty/source/test-part.lisp`

3.1.29 `tasty/source/test-part2.lisp`

3.1.30 `tasty/source/two-viewports.lisp`

3.1.31 `tasty/source/viewport.lisp`

3.1.32 `tasty/source/zzinit.lisp`

3.1.33 `tree/source/package.lisp`

3.1.34 `tree/source/parameters.lisp`

3.1.35 `tree/source/ajax.lisp`

3.1.36 `tree/source/assembly.lisp`

3.1.37 `tree/source/newertree.lisp`

3.1.38 `robot/source/package.lisp`

3.1.39 `robot/source/assembly.lisp`

3.1.40 `robot/source/initialize.lisp`

3.1.41 `robot/source/parameters.lisp`

3.1.42 `robot/source/zzinit.lisp`

3.1.43 `yadd/source/package.lisp`

3.1.44 `yadd/source/genworks.lisp`

3.1.45 `yadd/source/parameters.lisp`

3.1.46 `yadd/source/mixins.lisp`

3.1.47 `yadd/source/define-object-documentation.lisp`