HOME
The Info List - ActionScript


--- Advertisement ---



(i)

ACTIONSCRIPT is an object-oriented programming language originally developed by Macromedia
Macromedia
Inc. (later acquired by Adobe Systems
Adobe Systems
). It is a derivation of HyperTalk , the scripting language for HyperCard
HyperCard
. It is now a dialect of ECMAScript (meaning it is a superset of the syntax and semantics of the language more widely known as JavaScript
JavaScript
), though it originally arose as a sibling, both being influenced by HyperTalk.

ActionScript
ActionScript
is used primarily for the development of websites and software targeting the Adobe Flash Player
Adobe Flash Player
platform, used on Web pages in the form of embedded SWF files.

ActionScript
ActionScript
3 is also used with Adobe AIR
Adobe AIR
system for the development of desktop and mobile applications. The language itself is open-source in that its specification is offered free of charge and both an open source compiler (as part of Apache Flex
Apache Flex
) and open source virtual machine (Mozilla Tamarin ) are available.

ActionScript
ActionScript
is also used with Scaleform GFx for the development of 3D video game user interfaces and HUDs .

CONTENTS

* 1 Overview

* 2 History

* 2.1 Timeline by player version * 2.2 Timeline by ActionScript
ActionScript
version * 2.3 Flash Lite * 2.4 AIR

* 3 Syntax

* 3.1 ActionScript
ActionScript
2.0 * 3.2 ActionScript
ActionScript
3.0

* 4 Data structures

* 4.1 Data types * 4.2 Using data types

* 5 Code protection * 6 References * 7 External links

OVERVIEW

ActionScript
ActionScript
was initially designed for controlling simple 2D vector animations made in Adobe Flash
Adobe Flash
(formerly Macromedia
Macromedia
Flash). Initially focused on animation, early versions of Flash content offered few interactivity features and thus had very limited scripting capability. Later versions added functionality allowing for the creation of Web-based games and rich Internet applications with streaming media (such as video and audio). Today, ActionScript
ActionScript
is suitable for mobile development through Adobe AIR
Adobe AIR
, use in some database applications, and in basic robotics, as with the Make Controller Kit .

Flash MX 2004 introduced ActionScript
ActionScript
2.0, a scripting language more suited to the development of Flash applications. It is often possible to save time by scripting something rather than animating it, which usually also enables a higher level of flexibility when editing.

Since the arrival of the Flash Player 9 alpha (in 2006) a newer version of ActionScript
ActionScript
has been released, ActionScript
ActionScript
3.0. This version of the language is intended to be compiled and run on a version of the ActionScript Virtual Machine that has been itself completely re-written from the ground up (dubbed AVM2). Because of this, code written in ActionScript
ActionScript
3.0 is generally targeted for Flash Player 9 and higher and will not work in previous versions. At the same time, ActionScript
ActionScript
3.0 executes up to 10 times faster than legacy ActionScript
ActionScript
code due to the Just-In-Time compiler enhancements.

Flash libraries can be used with the XML
XML
capabilities of the browser to render rich content in the browser. This technology is known as Asynchronous Flash and XML, much like AJAX . Adobe offers its Flex product line to meet the demand for Rich Internet Applications built on the Flash runtime, with behaviors and programming done in ActionScript. ActionScript
ActionScript
3.0 forms the foundation of the Flex 2 API.

HISTORY

ActionScript
ActionScript
started as an object-oriented language for Macromedia
Macromedia
's Flash authoring tool, now developed by Adobe Systems
Adobe Systems
as Adobe Flash
Adobe Flash
. The first three versions of the Flash authoring tool provided limited interactivity features. Early Flash developers could attach a simple command, called an "action", to a button or a frame. The set of actions was basic navigation controls, with commands such as "play", "stop", "getURL", and "gotoAndPlay".

With the release of Flash 4 in 1999, this simple set of actions became a small scripting language . New capabilities introduced for Flash 4 included variables , expressions , operators , if statements , and loops . Although referred to internally as "ActionScript", the Flash 4 user manual and marketing documents continued to use the term "actions" to describe this set of commands.

TIMELINE BY PLAYER VERSION

* FLASH PLAYER 2: The first version with scripting support. Actions included gotoAndPlay, gotoAndStop, nextFrame and nextScene for timeline control. * FLASH PLAYER 3: Expanded basic scripting support with the ability to load external SWFs (loadMovie). * FLASH PLAYER 4: First player with a full scripting implementation (called Actions). The scripting was a flash based syntax and contained support for loops, conditionals, variables and other basic language constructs. * FLASH PLAYER 5: Included the first version of ActionScript. Used prototype-based programming based on ECMAScript, and allowed full procedural programming and object-oriented programming . Design based development. * FLASH PLAYER 6: Added an event handling model, accessibility controls and support for switch . The first version with support for the AMF and RTMP protocols which allowed for on demand audio/video streaming. * FLASH PLAYER 7: Additions include CSS styling for text and support for ActionScript
ActionScript
2.0, a programming language based on the ECMAScript 4 Netscape Proposal with class -based inheritance . However, ActionScript
ActionScript
2.0 can cross compile to ActionScript
ActionScript
1.0 byte-code , so that it can run in Flash Player 6. * FLASH PLAYER 8: Further extended ActionScript
ActionScript
1/ ActionScript
ActionScript
2 by adding new class libraries with APIs for controlling bitmap data at run-time, file uploads and live filters for blur and dropshadow. * FLASH PLAYER 9 (INITIALLY CALLED 8.5): Added ActionScript
ActionScript
3.0 with the advent of a new virtual machine, called ActionScript
ActionScript
Virtual Machine 2 (AVM2), which coexists with the previous AVM1 needed to support legacy content. Performance increases were a major objective for this release of the player including a new JIT compiler. Support for binary sockets, E4X XML
XML
parsing, full-screen mode and Regular Expressions were added. This is the first release of the player to be titled Adobe Flash
Adobe Flash
Player. * FLASH PLAYER 10 (INITIALLY CALLED ASTRO): Added basic 3D manipulation, such as rotating on the X, Y, and Z axis , a 3D drawing API, and texture mapping . Ability to create custom filters using Adobe Pixel Bender . Several visual processing tasks are now offloaded to the GPU
GPU
which gives a noticeable decrease to rendering time for each frame, resulting in higher frame rates , especially with H.264 video. There is a new sound API which allows for custom creation of audio in flash, something that has never been possible before. Furthermore, Flash Player 10 supports Peer to Peer (P2P) communication with Real Time Media Flow Protocol (RTMFP). * FLASH PLAYER 11: The major addition in this version are advanced (graphic card accelerated) 3D capabilities for Windows Desktop, Mac Desktop, iOS , Android , and other major platforms. Significant compatibility improvements have been added for the iOS platform, and other non-desktop platforms. Other features include H.264
H.264
encoding for cameras, Native JSON
JSON
support, Cubic Bézier Curves, a secure random number generator, LZMA compression for swf files, workers to offload some code execution to other processor threads, graphics card accelerated camera feed rendering, memory intrinsics and performance analysis, and the ActionScript
ActionScript
Compiler
Compiler
2.0, as well as some other minor additions. * FLASH PLAYER 11.2: released in March 2012, focused on adding features that are key for the gaming and video markets. Some of the features in the release include the following: Mouse-lock support. Right and middle mouse-click support. Context menu disabling. Hardware-accelerated graphics/Stage 3D support for Apple iOS and Android via Adobe AIR. Support for more hardware accelerated video cards (from January 2008) in order to expand availability of hardware-accelerated content. New Throttle event API (dispatches event when Flash Player throttles, pauses, or resumes content). Multithreaded video decoding pipeline on PCs, which improves overall performance of video on all desktop platforms. Notification of use of premium features in the debug players; content runs unrestricted in the release players. * FLASH PLAYER 11.3: released in June 2012, focused on enabling features and functionality key for the gaming market, as well as addressing popular feature requests from developers. Some of the features in this release include the following: Keyboard input support in full-screen mode. Improved audio support for working with low-latency audio. Ability to progressively stream textures for Stage 3D content. Protected mode for Flash Player in Firefox. Frame label events. Support for compressing BitmapData to JPEG and PNG formats. Support for Mac OS X App Store application sandboxing requirements. Text streaming support for Stage 3D. Expanded information about GPU driver details. Bitmap draw with quality API (new). Release outside mouse event API. Flash Player silent update support for Mac OS. Stylus support for Android 4.0 devices (Adobe AIR). USB debugging for iOS (Adobe AIR). iOS simulator support (Adobe AIR). * FLASH PLAYER 11.4: released in August 2012, focused on enabling features and functionality that are key for the gaming market, as well as addressing popular feature requests from developers. Some of the features in this release include the following: ActionScript
ActionScript
workers (enables concurrent ActionScript
ActionScript
execution on separate threads). Support for advanced profiling. LZMA compression support for ByteArray. Support for hardware-accelerated video cards for Stage 3D expanded to 2006. Improved ActionScript
ActionScript
performance when targeting Apple iOS. Performance index API to inform about performance capabilities of current environment. Support for compressed textures with alpha support. Support for StageVideo.attachCamera API. Support for push notifications for iOS (Adobe AIR). * FLASH PLAYER 11.5: released in November 2012, focused on performance improvement and stability. Some of the features in this release include the following: Shared ByteArray support for ActionScript
ActionScript
workers. Debug stack trace in release builds of Flash Player. Various bug fixes * FLASH PLAYER 11.6: released in March 2013, focuses on performance improvements, security enhancements, and stability. Some of the features in this release include the following: Ability to query graphics vector data at runtime. Full-screen permission dialog user interface improvements. Ability to load SWFs at runtime when deploying as an AIR application in AOT mode on iOS. Finer grained control over supported display resolution on iOS devices when deploying as an AIR application. HiDPI support for Flash Professional. ActionScript
ActionScript
3 access to fast memory operations/intrinsics * FLASH PLAYER 11.7: released in June 2013, code-named "Geary." This release focuses on premium video, gaming, security, and stability. Some of the features planned for this release include the following: Android captive runtime debugging. Support for the OUYA controller. Remote hosting of SWF files on iOS. Preventing backup of shared objects on iOS for better iCloud support. * FLASH PLAYER 11.8 (CODE NAME HARRISON): Adobe is planning a release in the early part of the second half of 2013, code-named "Harrison." This release focuses on premium video, gaming, security, and stability. Some of the features in this release include the following: Recursive stop API on MovieClips. GamePad support on desktop browsers and Android

TIMELINE BY ACTIONSCRIPT VERSION

2000–2004: ACTIONSCRIPT "1.0" With the release of Flash 5 in September 2000, the "actions" from Flash 4 were enhanced once more and named "ActionScript" for the first time. This was the first version of ActionScript
ActionScript
with influences from JavaScript
JavaScript
and the ECMA-262 (Third Edition) standard, supporting the said standard's object model and many of its core data types . Local variables may be declared with the var statement, and user-defined functions with parameter passing and return values can also be created. Notably, ActionScript
ActionScript
could now also be typed with a text editor rather than being assembled by choosing actions from drop-down lists and dialog box controls. With the next release of its authoring tool, Flash MX, and its corresponding player, Flash Player 6 , the language remained essentially unchanged; there were only minor changes, such as the addition of the switch statement and the "strict equality" (===) operator, which brought it closer to being ECMA-262 -compliant. Two important features of ActionScript
ActionScript
that distinguish it from later versions are its loose type system and its reliance on prototype-based inheritance . Loose typing refers to the ability of a variable to hold any type of data. This allows for rapid script development and is particularly well-suited for small-scale scripting projects. Prototype-based inheritance is the ActionScript
ActionScript
1.0 mechanism for code reuse and object-oriented programming . Instead of a class keyword that defines common characteristics of a class , ActionScript
ActionScript
1.0 uses a special object that serves as a "prototype" for a class of objects. All common characteristics of a class are defined in the class's prototype object and every instance of that class contains a link to that prototype object.

2003–2006: ACTIONSCRIPT 2.0 The next major revision of the language, ActionScript
ActionScript
2.0, was introduced in September 2003 with the release of Flash MX 2004 and its corresponding player, Flash Player 7 . In response to user demand for a language better equipped for larger and more complex applications, ActionScript
ActionScript
2.0 featured compile-time type checking and class-based syntax , such as the keywords class and extends. (While this allowed for a more structured object-oriented programming approach, the code would still be compiled to ActionScript 1.0 bytecode , allowing it to be used on the preceding Flash Player 6 as well. In other words, the class-based inheritance syntax was a layer on top of the existing prototype-based system.) With ActionScript
ActionScript
2.0, developers could constrain variables to a specific type by adding a type annotation so that type mismatch errors could be found at compile-time . ActionScript
ActionScript
2.0 also introduced class-based inheritance syntax so that developers could create classes and interfaces, much as they would in class-based languages such as Java and C++
C++
. This version conformed partially to the ECMAScript Fourth Edition draft specification.

2006–TODAY: ACTIONSCRIPT 3.0 In June 2006, ActionScript
ActionScript
3.0 debuted with Adobe Flex 2.0 and its corresponding player, Flash Player 9 . ActionScript
ActionScript
3.0 was a fundamental restructuring of the language, so much so that it uses an entirely different virtual machine . Flash Player 9 contains two virtual machines, AVM1 for code written in ActionScript
ActionScript
1.0 and 2.0, and AVM2 for content written in ActionScript 3.0. ActionScript
ActionScript
3.0 added limited support for hardware acceleration ( DirectX
DirectX
, OpenGL
OpenGL
).

The update to the language introduced several new features:

* Compile-time and run-time type checking —type information exists at both compile-time and runtime. * Improved performance from a class-based inheritance system separate from the prototype-based inheritance system. * Support for packages , namespaces , and regular expressions . * Compiles to an entirely new type of bytecode , incompatible with ActionScript
ActionScript
1.0 and 2.0 bytecode. * Revised Flash Player API , organized into packages . * Unified event handling system based on the DOM event handling standard. * Integration of ECMAScript for XML
XML
(E4X) for purposes of XML processing. * Direct access to the Flash runtime display list for complete control of what gets displayed at runtime . * Completely conforming implementation of the ECMAScript fourth edition draft specification. * Limited support for dynamic 3D objects. (X, Y, Z rotation, and texture mapping)

FLASH LITE

* FLASH LITE 1.0: Flash Lite is the Flash technology specifically developed for mobile phones and consumer electronics devices. Supports Flash 4 ActionScript. * FLASH LITE 1.1: Flash 4 ActionScript
ActionScript
support and additional device APIs added. * FLASH LITE 2.0 AND 2.1: Added support for Flash 7 ActionScript
ActionScript
2.0 and some additional fscommand2 API. * FLASH LITE 3: Added support for Flash 8 ActionScript
ActionScript
2.0 and also FLV video playback. * FLASH LITE 4: Added support for Flash 10 ActionScript
ActionScript
3.0 as a browser plugin and also hardware graphics acceleration.

AIR

Adobe AIR
Adobe AIR
supports ActionScript, in addition to some extended contents, such as the Stage3D engine Adobe has developed. The number of APIs (Application programming interfaces) available to ActionScript 3.0 has also risen dramatically.

SYNTAX

ActionScript
ActionScript
code is free form and thus may be created with whichever amount or style of whitespace that the author desires. The basic syntax is derived from ECMAScript .

ACTIONSCRIPT 2.0

The following code, which works in any compliant player, creates a text field at depth 0, at position (0, 0) on the screen (measured in pixels), that is 100 pixels wide and high. Then the text parameter is set to the "Hello, world" string, and it is automatically displayed in the player:

createTextField("greet", 0, 0, 0, 100, 100); greet.text = "Hello, world";

When writing external ActionScript
ActionScript
2.0 class files the above example could be written in a file named Greeter.as as following.

class com.example.Greeter extends MovieClip { public function Greeter() { var txtHello:TextField = this.createTextField("txtHello", 0, 0, 0, 100, 100); txtHello.text = "Hello, world"; } }

ACTIONSCRIPT 3.0

ActionScript
ActionScript
3.0 has a similar syntax to ActionScript
ActionScript
2.0 but a different set of APIs for creating objects. Compare the script below to the previous ActionScript
ActionScript
2.0 version:

var greet:TextField = new TextField(); greet.text = "Hello World"; this.addChild(greet);

Minimal ActionScript
ActionScript
3.0 programs may be somewhat larger and more complicated due to the increased separation of the programming language and the Flash IDE.

Presume the following file to be Greeter.as:

package com.example { import flash.text.TextField; import flash.display.Sprite; public class Greeter extends Sprite { public function Greeter() { var txtHello:TextField = new TextField(); txtHello.text = "Hello World"; addChild(txtHello); } } }

(See also: Sprite .)

ActionScript
ActionScript
3 can also be used in M XML
XML
files when using Apache\'s Flex framework:

DATA STRUCTURES

DATA TYPES

ActionScript
ActionScript
primarily consists of "fundamental" or "simple" data types which are used to create other data types. These data types are very similar to Java data types. Since ActionScript
ActionScript
3 was a complete rewrite of ActionScript
ActionScript
2, the data types and their inheritances have changed.

ACTIONSCRIPT 2 TOP LEVEL DATA TYPES

* STRING - A list of characters such as "Hello World" * NUMBER - Any Numeric value * BOOLEAN - A simple binary storage that can only be "true" or "false". * OBJECT - Object is the data type all complex data types inherit from. It allows for the grouping of methods, functions, parameters, and other objects.

ACTIONSCRIPT 2 COMPLEX DATA TYPES

There are additional "complex" data types. These are more processor and memory intensive and consist of many "simple" data types. For AS2, some of these data types are:

* MOVIECLIP - An ActionScript
ActionScript
creation that allows easy usage of visible objects. * TEXTFIELD - A simple dynamic or input text field. Inherits the Movieclip type. * BUTTON - A simple button with 4 frames (states): Up, Over, Down and Hit. Inherits the MovieClip type. * DATE - Allows access to information about a specific point in time. * ARRAY - Allows linear storage of data. * XML
XML
- An XML
XML
object * XMLNODE - An XML
XML
node * LOADVARS - A Load Variables object allows for the storing and send of HTTP POST and HTTP GET variables * SOUND * NETSTREAM * NETCONNECTION * MOVIECLIPLOADER * EVENTLISTENER

ACTIONSCRIPT 3 PRIMITIVE (PRIME) DATA TYPES

* BOOLEAN - The Boolean data type has only two possible values: true and false or 1 and 0. No other values are valid. * INT - The int data type is a 32-bit integer between -2,147,483,648 and 2,147,483,647. * NULL - The Null data type contains only one value, null. This is the default value for the String data type and all classes that define complex data types, including the Object class. * NUMBER - The Number data type can represent integers, unsigned integers, and floating-point numbers. The Number data type uses the 64-bit double-precision format as specified by the IEEE Standard for Binary Floating-Point Arithmetic (IEEE-754). values between -9,007,199,254,740,992 (-253) to 9,007,199,254,740,992 (253) can be stored. * STRING - The String data type represents a sequence of 16-bit characters. Strings are stored internally as Unicode characters, using the UTF-16 format. Previous versions of Flash used the UTF-8 format. * UINT - The uint (Unsigned Integer) data type is a 32-bit unsigned integer between 0 and 4,294,967,295. * VOID - The void data type contains only one value, undefined. In previous versions of ActionScript, undefined was the default value for instances of the Object class. In ActionScript
ActionScript
3.0, the default value for Object instances is null.

ACTIONSCRIPT 3 SOME COMPLEX DATA TYPES

* ARRAY - Contains a list of data. Though ActionScript
ActionScript
3 is a strongly typed language, the contents of an Array may be of any type and values must be cast back to their original type after retrieval. (Support for typed Arrays has recently been added with the Vector class.) * DATE - A date object containing the date/time digital representation. * ERROR - A generic error object that allows runtime error reporting when thrown as an exception. * FLASH.DISPLAY:BITMAP - A non-animated bitmap display object. * FLASH.DISPLAY:MOVIECLIP - Animated movie clip display object; Flash timeline is, by default, a MovieClip. * FLASH.DISPLAY:SHAPE - A non-animated vector shape object. * FLASH.DISPLAY:SIMPLEBUTTON - A simple interactive button type supporting "up", "over", and "down" states with an arbitrary hit area. * FLASH.DISPLAY:SPRITE - A display object container without a timeline. * FLASH.MEDIA:VIDEO - A video playback object supporting direct (progressive download) or streaming (RTMP) transports. As of Flash Player version 9.0.115.0, the H.264/MP4 high-definition video format is also supported alongside standard Flash video (FLV) content. * FLASH.TEXT:TEXTFIELD - A dynamic, optionally interactive text field object. * FLASH.UTILS:BYTEARRAY - Contains an array of binary byte data. * FLASH.UTILS:DICTIONARY - Dictionaries are a variant of Object that may contain keys of any data type (whereas Object always uses strings for its keys). * FUNCTION - The core class for all Flash method definitions. * OBJECT - The Object data type is defined by the Object class. The Object class serves as the base class for all class definitions in ActionScript. Objects in their basic form can be used as associative arrays that contain key-value pairs, where keys are Strings and values may be any type. * REGEXP - A regular expression object for strings. * VECTOR - A variant of array supported only when publishing for Flash Player 10 or above. Vectors are typed, dense Arrays (values must be defined or null) which may be fixed-length, and are bounds-checked during retrieval. Vectors are not just more typesafe than Arrays but also perform faster. * XML
XML
- A revised XML
XML
object based on the E4X (Standard ECMA-357); nodes and attributes are accessed differently from ActionScript
ActionScript
2.0 object (a legacy class named XMLDocument is provided for backwards compatibility). * XMLLIST - An array-based object for various content lookups in the XML
XML
class.

USING DATA TYPES

The basic syntax is:

var yourVariableName:YourVariableType = new YourVariableType(Param1, Param2, ..., ParamN);

So in order to make an empty Object:

var myObject:Object = new Object();

Or, in an informal way:

var myObject = {};

Some types are automatically put in place:

var myString:String = "Hello!"; // This would automatically set the variable as a string. var myNumber:Number = 5; // This would do the same for a number. var myObject:Object = {Param1:"Hi!", Param2:76}; //This creates an object with two variables. // Param1 is a string with the data of "Hi!", // and Param2 is a number with the data of 76. var myArray:Array = ; //This is the syntax for automatically creating an Array. //It creates an Array with 3 variables. //The first (0) is a number with the value of 5, //the second (1) is a string with the value of "Hello!", //and the third (2) is an object with {a:5, b:7}.

Unlike some object-oriented languages, ActionScript
ActionScript
makes no distinction between primitive types and reference types. In ActionScript, all variables are reference types. However, objects that belong to the primitive data types, which includes Boolean, Number, int, uint, and String, are immutable.

So if a variable of a supposedly primitive type, e.g. an integer is passed to a function, altering that variable inside the function will not alter the original variable, as a new int Object is created when inside the function. If a variable of another (not primitive) datatype, e.g.