search

openfl / starling

Known as the "Cross-Platform Game Engine", Starling is a popular Stage3D framework for OpenFL and Haxe
Other
237 stars 68 forks source link
gpu haxe openfl starling starling-framework

readme

Simplified BSD License NPM Version Haxelib Version Build Status

Starling Framework

The Cross Platform Game Engine

The Starling Framework allows you to create hardware accelerated apps in ActionScript 3, Haxe, TypeScript or JavaScript. The main target is the creation of 2D games, but Starling may be used for any graphical application. Thanks to Adobe AIR, Starling-based applications can be deployed to mobile devices (iOS, Android), the desktop (Windows, OS X), and to the browser (via the Flash plugin).

You can also pair Starling with OpenFL to deploy native builds for iOS, Android, Windows, OS X, Linux or WebAssembly, as well as Flash/AIR or regular HTML5 releases without WebAssembly. HTML5 support is available in TypeScript, Haxe, ES5 JavaScript or ES6+ JavaScript.

While Starling mimics the classic display tree architecture of Adobe AIR/Flash, it provides much better performance than the Adobe version: all objects are rendered directly by the GPU (using the Stage3D API). When paired with OpenFL, Starling provides an alternative GPU renderer with helpful features. The complete architecture was designed for working well with the GPU; common game development tasks were built right into its core. Starling hides Stage3D internals from developers, but makes it easy to access them for those who need full performance and flexibility.

Starling aims to be as lightweight and easy to use as possible. As an open-source project, much care was taken to make the source code easy to read, understand and extend. With under 15k lines of code, experienced developers can easily grasp it in its entirety, or modify it to their needs.

Getting Started (Haxelib)

You can easily install Starling using haxelib:

haxelib install starling

To add it to an OpenFL project, add this to your project file:

<haxelib name="starling" />

You can also create a new empty project like this:

openfl create starling:project StarlingProject

You can also try the Starling demo:

openfl create starling:demo
cd demo
openfl test flash

Getting Started (NPM)

You can install the Yeoman generator to create an empty project:

npm install -g yo starling-framework-generator
mkdir StarlingProject
cd StarlingProject
yo starling-framework

You can also try the Starling demo:

git clone https://github.com/openfl/starling
cd starling/samples/demo_npm/typescript
npm install
npm start -s

There are AS3, ES5, ES6, Haxe and TypeScript versions of the demo available.

Note about high-dpi support

Starling supports high-dpi devices such as 4K monitors For it to work you need to add this in your project file:

<window allow-high-dpi="true"/>

You also need to tell starling to support high resolutions in your code:

starling.supportHighResolutions = true;

Quick Links (AS3)

News and Updates