.:: Atmosphere and Beyond ::.

 

Tutorials -> AtmoScripter

What is it?

AJScripter is an ambitious attempt at an Atmosphere Javascript GUI. It's aim is, one day, to allow people without Atmosphere javascript knowledge to add interactions to their Atmosphere worlds without needing to learn anything about scripting. Why do it? For some people, scripting presents a challenge, enhancing a world using scripts is not easy. Perhaps we could bring the ability to have interactions to them, without them needing to learn how to code. Basically, trying to help people help themselves :)

Note: It is important that you are already familiar with and own a copy of the Adobe Atmosphere Builder. Atmosphere currently retails for $399 US, or $99 US for qualified educators. AJScripter is meant to compiliment Atmosphere & cannot be used without it. AJScripter BETA however is free, read below :)

 

Screenshots

Technical

AJScripter is currently being developed in Java. "Gads man, WHY on earth Java, and not VB or Delphi or C++?" i hear you ask? There are 3 very good reasons for it:

  • Portability - & i'm not getting paid for this, WYSIWYG. I can't afford time outside the basics.
  • Extensible - with other stuff developed in Java i'd like to import into the program. For example, this includes instant configuration of Java Applets (for the chat bots :))
  • Other stuff (involves 'intelligent' software)

Ok, you still may not agree/disagree with me, but that's ok.

And where are we going with this? At the moment, you can define several dozen different javascript interactions/features with the world and auto-generate the script to be added to the Atmosphere world. This is the core functionality, but plans in the near future could be extended to:

  • Importing pre-made scripts from external sources to be auto-generated (?)
  • Methods for securing your script so that you can protect it from prying eyes
  • Script compression for 56k modem optimisation
  • etc that won't come to mind

 

User PC Requirements

  • Pentium II 266 or higher
  • Windows XP, 2000 for the .exe version (possibly NT, 98 - untested)
  • .jar version available for Linux/Mac upon request (in future)

Basically, trying to keep it inline with the Adobe Atmosphere minimum requirements - which officially works on XP only.

How does it work?

Basically, steps to adding an interaction in the world using AJScripter are:

  • Define a new Model (.atmo/.aer), Viewpoint Object, SolidObject or Primitive
  • Define a set of Actions to be taken on this Model/VP/Primitive
  • Define a trigger (or triggers) which start those Actions
  • Auto-generate the script & save to new .js file

Not too difficult i hope? :)

Licensing & Version

Current version of AJScripter : v0.51 BETA

At present, AJScripter exists purely in BETA form. There's still plenty of work to go into it, so don't mind the occasional bug. If you find a bug or want to ask a question about Atmosphere scripting or AJScripter go through the Adobe Atmosphere Forums (checked regularly) or you can contact me directory via email "ajscripter [at] hotmail , com" (checked once or twice a week). I can't guarentee that the problem with be solved. Remember that AJScripter is meant to be used in conjunction with Adobe Atmosphere, but is in no way related to or has any other affiliation with Adobe Systems Incorporation. So don't go contacting Adobe saying 'AJScripter doesnt work' because they'll laugh at you.

AJScripter BETA is provided for you to download and use for FREE. That is, you don't have to pay any money for AJScripter BETA and any script you generate using AJScripter is yours to keep & use within your own worlds.

However, you must acknowledge all of the following legal notices by downloading AJScripter:

  • AJScripter is provided "as is" and without warranties or any kind, express or implied, including without limitation any implied warranties or merchantibility or fitness for a particular purpose.
  • The author assumes no responsibility for and shall not be liable for any consequential or actual damages resulting from the use, performance, or application of the software. You assume all risk associated with the use or attempted use of this software.
  • You may not make any other use of AJScripter, including mirroring, retransmitting, republishing, or reselling without the express written consent of the author.

Now that you've read the licensing, you can now download AJScripter :)

Downloads

Thank you to RayR (http://www.trucker2000.net) for hosting the AJScripter downloads you see below!

1) Environment (dlls, etc) + Ajscripter.

This bundle contains the environment files required to run AJScripter on your computer. In addition, the AJScripter exe is also packaged. For the first time downloader of AJScripter, you will need only to download this bundle.

2) Updates for AJScripter.

If you have already downloaded the above AJScripter bundle in 1), then for subsequent updates of AJScripter you may need only download the ajscripter exe file. The exe file just replaces the one in the original bundle.

3) Jar File

ajscripter.jar for all platforms (600kb) -- disabled
(Please note - requires Java SDK Version 1.3 or higher to run)

 

Documentation

A help page has been provided documenting a quick 'how to' on AJScripter

 

Known Bugs

  • 'Compress' doesn't quite work properly on the script generation window
  • Wierd click sequence bug which manages to move Actions between Triggers. Haven't been able to reproduce it yet, just occasionally happens
  • Colour pickers may not work under Windows 2000
  • Doesn't remember which directory you last stored a script each time you load a new instance of AJScripter
  • On the "Save As" file selection window, the "create new directory" button doesnt work sometimes
  • No overwrite warning on Save for a generated script
  • Saving and opening an "AJScripter Project" file doesn't work. Thus, all the work you do on generating a script cannot be saved yet.
  • In "Move to a position/direction" action, the smooth transition checkbox doesn't work. Work around is to use anchors

Support

There is little support for AJScripter, as it is provided for free & i've unfortunately little time continue to update it on a regular basis. I will however make an attempt for bug fixes on a bi-monthly basis, and perhaps even new features. If you have any problems or requests, feel free to email me:

ajscripter [at] hotmail [dt] com

Good luck!


Obligatory counter for stats. Pay not attention to it.

Counter
Sound Files

Page Last updated: 29th October 2003


Content by superted. Find me at the adobe forums located here.