Aesthe is 3D scripting development environment controlled by command line with built-in 3D modeller, allowing you to create interactive script-driven 3D simulations or animations. Copyleft (ↄ) 2008 by Tomáš Darmovzal This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/> . You can download sources of Aesthe from SourceForge.Net Command shown above runs demo application - robot arm simulation. By default mouse and keyboard events are bounded as follows (see script/event.lua for more precise description): Aesthe is assembled of several modules: Kernel is aesthe module, which holds scene graph and exports simple interface for its manipulation. Kernel interface is designed to allow only primitive-type values passing, thus application developer cannot break scene content with invalid pointer. This interface allows developer to create and destroy basic elements of scene (vertices, faces, objects and textures), set or read element's attributes, traversal through scene graph and some more. Kernel module is written with respect to keep no dependency to any external library (excluding libc, of course), thus you can use it separately in any other 3D GPL project. Kernel is designed as finite automaton, which has set of variables - one for each basic element type - which can be used to store reference to current basic elements passed as parameters to other operations (eg. setting/getting attributes). This set of variables is furthermore provided as stack - that means, you can save current state of variables by push() operation (which duplicates top of the stack) and then again restore previously saved state by calling pop() . Furthermore, you can use concept of registry (similar to processor registry), which serves as array of basic scene elements with user-defined length. You can use this registry as temporary array of elements, which are accessible by numerical index. Registry are bounded to current state, that means if you call pop(), you lose along with current variables also current registry. In C, struct AeKernel is the most important kernel data structure - it holds root of scene graph as well as current variable state stack and registry. This structure has several methods for scene manipulation: CREATE enum AeType Creates new element of provided type and sets it as current. All attribute values are reset to its default values. AeType enumeration parameter is provided for chosing type of created element. DESTROY Destroys element set as current value of provided element type. SET / GET Methods for setting/reading attribute values of elements which are set as current. In C, parameter value must reference to value of correct data type (see following list of attribute types). Parameter maxlength states maximal length of read attribute value. It has sense only while reading attribute of variable length (currently only char */string). In other cases is value of this parameter ignored. enum AeAttribute: FIND Find() is multi-purpose method for any kind of scene elements traversal. First parameter specifies type of basic element for traversal, second and third specifies traversal rule and its optional integer parameter (see AeRule table below). Fourth parameter is optional, if set specifies callback which will be called for every found element. Found element is before invoking callback set as current, so it is often useful to surround find() call with push() and pop() brackets. Optional last parameter is userdata used for callback. Callback prototype takes integer parameter index, which represents index of each found element incremented from zero. Callback returns integer flag used as indicator of premature stop of search loop (zero means continue, nonzero means stop search immediately). Find method returns number of found elements. If callback is not specified (is set to NULL in C), this method can be used to count number of searched elements and/or set last (sometimes only) searched element as current. enum AeRule BIND / UNBIND These functions are used to (un)bind vertices with faces and faces with textures. Faces-vertices as well as faces-textures has many-to-many relationship, so if you wish to eg. add vertex to 3rd index in face, you must set desired face and vertex as current and call bind(AET_VERTEX, AET_FACE, 3, 0). PUSH / POP Function push() duplicates current state at the top of state stack excluding registry values. Function pop() removes top of the state stack (call is successfull only if stack size is > 1). CLEAR This method clears current element of chosen type in top of state stack. It does not destroy the element, only clears its reference in current state. REGISTRY / LOAD / STORE Call registry(type, size) allocates in current state registry array of specified type and size. If size is 0, registry are cleared, if size is larger then previous registry size, then all previous items are preserved. Call load(type, index) replaces current state element of specified type by item in registry array at specified index. Calling of store(type, index) sets current state element reference of specified type into registry at specified index. Indices parameters in load() and store() are boundary-checked.

Author: Tomáš Darmovzal tomas dot darmovzal at gmail dot you-know-what Generated by DocumentPreProcessor (dpp) - DPP source