Skip to content

Known as the "Cross-Platform Game Engine", Starling is a popular Stage3D framework for OpenFL and Haxe

License

Notifications You must be signed in to change notification settings

openfl/starling

Repository files navigation

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 Haxe, TypeScript, JavaScript, or ActionScript 3. The main target is the creation of 2D games, but Starling may be used for any graphical application. Thanks to OpenFL, Starling-based applications can be deployed to mobile devices (iOS, Android), the desktop (Windows, macOS, Linux), and to web browsers via either JavaScript or WebAssembly.

While Starling mimics the classic display tree architecture of OpenFL, it provides much better performance than the OpenFL version: all objects are rendered directly by the GPU (using the Stage3D API) with improved batching and support for things like texture atlases. 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 are built right into its core. Starling hides Stage3D internals from developers who don't need low-level access, 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)

First, install the Haxe toolkit.

Then, you can easily install Starling by running the following command in a terminal or command prompt:

haxelib install starling

To include Starling in an OpenFL project, add this line to your project.xml file:

<haxelib name="starling" />

You can also create a new empty project by running the following command:

openfl create starling:project StarlingProject

You can also try the Starling demo project:

openfl create starling:demo
cd demo
openfl test html5

Getting Started (NPM)

To use Starling with TypeScript, JavaScript, or AS3 with Apache Royale, 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. To enable high-dpi, add this line to your project file:

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

You also need to set a flag in your code to tell Starling to support high resolutions:

starling.supportHighResolutions = true;

Quick Links (Haxe)

Quick Links (AS3)

About

Known as the "Cross-Platform Game Engine", Starling is a popular Stage3D framework for OpenFL and Haxe

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published