HTML5 / WebGL2 Setup

Configure WebGL2 for Pixscape Runtime in a LibGDX HTML project.

When generating the project with gdx-liftoff, select Pixscape Runtime and the HTML target.

LiftOff configures the Pixscape Runtime and GWT integration. Pixscape requires WebGL2, so enable GL30 in GwtLauncher.

Enable WebGL2

@Override
public GwtApplicationConfiguration getConfig() {
    GwtApplicationConfiguration cfg =
            new GwtApplicationConfiguration(true);

    cfg.useGL30 = true;

    return cfg;
}

Custom Artemis systems

If you add custom Artemis systems, include their package in Artemis’ GWT reflection configuration:

<extend-configuration-property
    name="artemis.reflect.include"
    value="your.package.system" />

Replace your.package.system with the package that contains the systems that need Artemis reflection.

Validation

./gradlew html:dist

Scene loading on HTML

HTML cannot always wait inside a blocking loadScene(...) call when scene resources still need network delivery. In that case, use beginLoadScene(...) and advance the SceneLoadHandle from the render loop.

See Scene Loading for the complete example.