In computing, Stage3D (codenamed Molehill) is an Adobe Flash Player API for rendering interactive 3D graphics with GPU-acceleration, within Flash games and applications. Flash Player or AIR applications written in ActionScript 3 may use Stage3D to render 3D graphics, and such applications run natively on Windows, Mac OS X, Linux, Apple iOS and Google Android. Stage3D is similar in purpose and design to WebGL.
Stage3D was introduced in Adobe Flash Player 11.0 and AIR 3.0 in order to facilitate GPU-acceleration of 3D content in Flash applications In Flash Player 10 and earlier, 3D Flash applications had to render 3D graphics completely on the CPU. Flash Player 10 supported a limited form of GPU acceleration support for materials, in an API called Pixel Bender.
GPU Shaders in Stage3D are expressed in the Adobe Graphics Assembly Language (AGAL).:57 Stage3D objects depart from the traditional SWF rendering model in that they cannot be added to SWF's display lists; instead they must be instantiated via ActionScript.:25
Because Stage3D is a low-level library that may be tedious to use directly, it has seen some higher-level 3D and 2D libraries built on top of it in order to benefit from the higher performance that it provides. An incomplete list of libraries and game engines using it includes: Unreal Engine 3, Away3D 4, CopperCube, Flare3D, Starling,:vii ND2D or Adobe Labs' Proscenium. Similarly, WebGL 3D applications may be built with three.js, a higher-level library similar to these. Away3D and Starling have been christened as official components of the Adobe Gaming SDK.
In 2011, Flash Player 11 was released, and with it the first version of Stage3D, allowing for GPU-accelerated 3D rendering for Flash applications and games, on desktop platforms such as Microsoft Windows and Mac OS X.
In March 2012, Flash Player 11.2 was released, which enabled Stage3D/GPU support on Android and iOS platforms. Games utilizing Stage3D APIs would work with no changes on these mobile platforms.
In June 2012, Flash Player 11.3 was released, enabling progressive streaming of Stage3D texture maps, allowing for faster performance and startup times for games and applications utilizing Stage3D.
In March 2012, Adobe announced that Stage3D will be part of the premium features of the Flash Player (stating with Flash Player version 11.2), and thus not available completely free of charge to developers, but based on a revenue sharing scheme. Various notable members of the Flash community objected to the change, referring to it as a "speed-tax".
In January 2013, Adobe classified all premium features as general availability, and could be freely used by Flash applications, without requiring a license or royalty from developers or publishers.
In September 2012, Flash Player 11.4 was released allowing games to target "constrained profiles" which included older graphics chips, that did not support all the features of Stage3D.
In April 2013, Flash Player 11.7 was released, which supported 16-bit texture maps for Stage3D content, which allowed reduced memory usage and improved memory management.
In July 2013, Flash Player 11.8 was released, which increased the maximum texture map size to 4096 x 4096, in addition to supporting rectangular (non-square) texture maps for Stage3D content. This allowed for greater detail in texture maps, and larger texture atlases to be created enabling better performance.
As of 2014, GPU acceleration was removed in Flash Player 11.8 onwards for Pixel Bender scripts. Pixel Bender was an older technology for writing high-performance CPU-based image processing filters. This has disrupted a number of less well-endowed projects, including MIT's Scratch, which could not find the manpower to rapidly recode their applications.
Stage3D consists of the following components:
- Unified API - Unified ActionScript 3 API for managing texture memory, vertex shading, pixel shading, and mesh rendering. Transparently executed using OpenGL (on Mac OS X and Linux) and DirectX (on Microsoft Windows).
- Accelerated GPU Rendering - Integrated support for graphic cards built by NVidia, AMD and Intel, Blacklist for incompatible graphic cards.
- Accelerated CPU Rendering - Integrated software renderer fallback using SwiftShader, for systems with missing/incompatible graphics cards.
- AGAL (Adobe Graphics Assembly Language) - A language for writing Shaders (programs that run on the GPU) such that they can be converted to OpenGL GLSL Shaders and DirectX HLSL Shaders by Flash Player.
- ATF (Adobe Texture Format) - A texture format such that textures can be converted to appropriate platform-specific texture formats such as DXT on Windows and MacOS, PVRTC on iOS.:47–48
Stage3D is supported by the following components:
- XC APIs - the "premium features" for Flash Player, consisting of high-speed memory manipulation opcodes (known as "Alchemy") and Stage3D APIs.
- CrossBridge - A cross-compilation toolkit to compile OpenGL-based 3D games or game engines to run within Flash Player.
- Adobe Scout - A visual profiler for Flash content running on desktop on mobile. Scout enables in-depth profiling of Stage3D content with the following integrated features:
- Stage3D Preview - View the current back-buffer of executed Stage3D Content
- Stage3D Recording - Capture every Stage3D command executed by the Flash content, and replay/step through executed commands
- GPU memory usage - Profile texture memory usage with a real-time breakdown
- Stage3D Program Editor - Interactively modify recorded Stage3D commands and see what effect this has on rendering. Edit the AGAL code for the vertex and fragment programs executed by each draw call.
Adobe Graphics Assembly Language (AGAL) is an assembly language for writing GPU Shaders. AGAL was invented by Adobe to provide a unified shader language for all platforms. AGAL programs are written by hand with low-level opcodes and registers. AGAL programs are compiled into bytecode which is then embedded into Flash SWF movies. This AGAL bytecode is automatically compiled into OpenGL GLSL Shaders and DirectX HLSL Shaders by Adobe Flash Player, depending on the platform.
With AGAL, developers can write shaders that transform 3D models on the GPU (vertex shader), and shaders that render complex dynamic lighting effects on the GPU (pixel shader). AGAL also allows high-quality texture rendering with mip-mapping. AGAL is used extensively in Flash game engines such as Away3D and Flare3D for various effects. AGAL is commonly used to provide dynamic lighting, high dynamic ranging (HDR), alpha masking, multipass rendering, displacement mapping, and environment mapping. Flare3D extends AGAL with a proprietary Shader language called FLSL (FLare3D Shader Language), that makes writing Shader programs easier. HLAG is another example of a high-level Shader language that compiles into AGAL.
When porting C++ 3D video games for playback in Adobe Flash Player, developers must translate traditional HLSL and GLSL shaders into AGAL. The C++ video game code can be converted into Flash-compatible code using CrossBridge.
- Joseph Labrecque (2011). What's New in Flash Player 11. O'Reilly Media, Inc. p. 17. ISBN 978-1-4493-1110-0.
- Adobe Premium Features for Flash Player, Flash Player Dev Center, Adobe
- Stage3D unsupported chipsets, drivers, Flash Player 11, AIR 3, Adobe Help
- Matt Fisher (2013). HTML5 for Flash Developers. Packt Publishing Ltd. § Stage3D versus WebGL, p. 91. ISBN 978-1-84969-333-2.
- "Stage3D vs WebGL Performance — Airtight Interactive". Airtightinteractive.com. 2011-10-28. Retrieved 2014-08-04.
- Joseph Labrecque (2011). What's New in Adobe AIR 3. O'Reilly Media, Inc. pp. 17–26. ISBN 978-1-4493-1108-7.
- Remi Arnaud (2011). "3D in a Web Browser". In Eric Lengyel (ed.). Game Engine Gems 2. CRC Press. pp. 207–212. ISBN 978-1-56881-437-7.
- Christer Kaitila (2011). Adobe Flash 11 Stage3D (Molehill) Game Programming Beginner's Guide. Packt Publishing Ltd. ISBN 978-1-84969-169-7.
- "What is AGAL | Adobe Developer Connection". Adobe.com. 2011-10-10. Retrieved 2014-08-04.
- Wagner James Au (2012). Game Design Secrets. John Wiley & Sons. p. 130. ISBN 978-1-118-46391-8.
- "Adobe Flash 11 adopts Unreal Engine 3 for better browser games | The Verge". theverge.com. Retrieved 2014-08-04.
- "Tools Spotlight: CopperCube 4.0". evelop-online.net. 2014-05-28. Retrieved 2014-09-22.
- Keith Gladstien (2013). Flash Game Development In a Social, Mobile and 3D World. Cengage Learning. pp. 383–421. ISBN 978-1-4354-6021-8.
- Thibault Imbert (2012). Introducing Starling. O'Reilly Media, Inc. ISBN 978-1-4493-2089-8.
- Rex van der Spuy (2012). Foundation Game Design with ActionScript 3.0. Apress. p. 641. ISBN 978-1-4302-3993-2.
- Thibault Imbert (December 4th, 2012) Introducing Game Developer Tools (Gaming SDK, Adobe Scout, FlasCC)
- "Adobe Gaming SDK". creative.adobe.com. Retrieved 2014-08-04.
- Adobe Flash Roadmap, Adobe
- And Then Premium Features Arrived Archived 2015-02-05 at the Wayback Machine, ASV Guy Blog
- Update: Premium Features for Flash Player, Adobe AIR and FP Blog
- Imbert, Thibault. "Introducing Flash Player 11.4/AIR 3.4 beta!". ByteArray.
- "Stage3D". scratch.mit.edu. Retrieved 2014-08-05.
- Adobe Flash Player 11.8 - Bug 3591185: Pixel Bender shader performance drastically degraded in FP11.8. Closed as "NeverFix" Archived 2014-04-22 at the Wayback Machine
- "Stage3D compressed textures – Introducing the ATF SDK - ByteArray.org". bytearray.org. Retrieved 2014-08-04.
- Getting started with Adobe Scout, Adobe Developer Connection
- What is AGAL, Adobe Developer Connection
- Mipmapping for smoother textures in Stage3D, Adobe Developer Connection
- Session : Flash to the Max! High Performance 3D Graphics in Silent Hunter Online, GDC Europe 2013
- FLSL, Flare3D Wiki
- HLAG is currently in alpha, HLAG Tool Website
- Crytek, Silent Hunter Online talks late additions to GDC Europe 2013, Gamasutra, "C++ console rendering engine into Adobe Flash using Actionscript/Stage3D and using AGAL for graphical effects such as ocean rendering"
- Stage3D articles on Adobe Developer Connection
- "3D game development for Flash and video games". adobe.com. Retrieved 2014-08-04.
- "How Stage3D works". adobe.com. Retrieved 2014-09-17.
- "Building a 3D Flash game with Flare3D and Stage3D". adobe.com. Retrieved 2014-09-17.
- "Creating 3D games and apps with Away3D 4 and Stage 3D". adobe.com. Retrieved 2014-09-17.
- "What is AGAL". adobe.com. Retrieved 2014-09-17.
- "Adding 3D content to your Flash game fast and easy". adobe.com. Retrieved 2014-09-17.
- "Introducing the Starling 2D framework". adobe.com. Retrieved 2014-09-17.
- "Vertex and Fragment Shaders". adobe.com. Retrieved 2014-09-17.
- "Mipmapping for smoother textures in Stage3D". adobe.com. Retrieved 2014-09-17.
- "Stage 3D gaming engines". adobe.com. Retrieved 2014-09-17.
- "Getting started with Adobe Scout". adobe.com. Retrieved 2014-09-17.
- "Compiling OpenGL games with the Flash C++ Compiler (FlasCC)". adobe.com. Retrieved 2014-09-17.
- Translation tools from OpenGL and GLSL: