anachronox-sdk/docs/APE_Intro.html

42 lines
2.7 KiB
HTML

<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
<TITLE>Anachronox Editing Documentation</TITLE>
</HEAD>
<BODY BGCOLOR="#000000" TEXT="#EFEFEF" LINK="#00FFFF" ALINK="#FFFFFF" VLINK="#05F3D0">
<CENTER>
<P>
<FONT FACE="Tahoma">
<FONT SIZE=5 COLOR="#0055DD"><P>Introduction to A.P.E.</P>
</FONT>
</CENTER>
<P>
<HR>
<BR>
&nbsp;
<P>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<FONT COLOR="#0055DD">A.P.E. (Anachronox Programming Environment)</font> is the scripting language layer that controls most of the standard interactivity within the world. If you can click something in the world that triggers a dialog, interface, or event, then chances are
APE has played a major part in it. Now before you hop straight into APE, there are a few things you should know about it.
<P>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;APE was originally written as a simple dialog parser. However as more interactivity was needed it was added to, and slowly it evolved into a relatively powerful scripting language. This evolution is important to understand when looking at the
structure of the language. The first major thing you might notice is that there are two types of functions in APE, a window and a switch, and instead of function names there are sequences. These sequences are comprised of a bank and entry number. A typical window header might
look like this:<BR>
<PRE>#window 123:1024</PRE>
In this case <FONT COLOR="#0055DD">#window</font> is the type <FONT COLOR="#0055DD">"123" is the bank</font>, and <FONT COLOR="#0055DD">"1024" is the entry</font>. Typically a single bank number is used for an entire map or project. The APE lessons will get into all of this in much greater detail, so don't worry if this doesn't make sense at the moment.
<P>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The next major thing you might notice is that most of APE's power is external from APE itself. Since APE was originally only for dialog, additional features have been written into functions called externs. You can simply call these
<FONT COLOR="#0055DD">externs</font> from APE to do an unlimited amount of things, from setting the XYZ of an entity, to adding to inventory, to fading out the screen. There are dozens and dozens of APE externs available, and with the DLL structure of Anachronox, it is even possible to add your own.
<P>
Lastly, if this is your first time looking at APE, I highly recommend you start with the <A HREF="APE%20Lessons.html">Ape Lessons</A>.
<P>
If you have any APE specific questions, drop me a line at <A HREF="mailto:thezealot@thezealot.com">thezealot@thezealot.com</A>. I will try to answer them, as time permits. Please make sure you scour the documentation for your answer first, before mailing.
<P>&nbsp;<P>
</BODY>
</HTML>