apex-app v6.1.2

apex-app

For creating interactive apps using pixi.js.

Example App

Particle Sandbox
URL: http://particlesandbox.com
GitHub: https://github.com/apexearth/particle-sandbox
App Class: https://github.com/apexearth/particle-sandbox/blob/develop/app/ParticleSandbox.js#L25

Basic Usage

1. Create an App.
2. Add AppObjects to it.
3. Create a renderer for the App.
4. The renderer starts the update & draw loop, rendering the App.

const {
   App,
   AppObject,
   createRenderer,
   PIXI,
   setting,
   properties,
   property
} = require('apex-app')

// Extend App
// Initialize with a single AppObject drawn as a white square.
class Game extends App {
   constructor() {
       super()
       let obj = new AppObject({parent: this})
       obj.graphics.beginFill(0xffffff, 1)
       obj.graphics.drawRect(0, 0, 10, 10)
       obj.graphics.endFill()
       this.add(obj)
   }
}

// Create renderer and attach canvas to `document.body`.
createRenderer(new Game(), {
   rendererOptions: {
       backgroundColor: 0x333333
   }
})

App

The core app containing the update loop.

Kind: global class

• App
  • new App(options)
  • instance
    • .type : string
    • .objects : Array.<AppObject>
    • .view
    • .position ⇒ App.container.position | Object
    • .scale ⇒ App.container.scale | Object
    • .targetScale ⇒ Object
    • .screenWidth ⇒ Number
    • .screenHeight ⇒ Number
    • .paused ⇒ boolean
    • .paused
    • .zoom
    • .zoom
    • .centerOn(object)
    • .togglePause()
    • .pauseRendering()
    • .resumeRendering()
    • .kill()
    • .translatePosition(position) ⇒ Object
    • .update(seconds)
    • .previewObject(object) ⇒ AppObject
    • .cancelPreview(object) ⇒ AppObject
    • .removeObjects(objects)
    • .contains(object) ⇒ boolean
    • .add(object) ⇒ AppObject
    • .remove(object) ⇒ AppObject
    • .addFx(object)
    • .removeFx(object)
    • .updateZoom(seconds)
    • .selectObject(object, additive)
    • .select(left, top, right, bottom, additive)
    • .selectAll()
    • .deselectAll()
    • .removeSelected()
  • static
    • .defaultOptions ⇒ Object

new App(options)

app.type : string

The object type. ("app")

Kind: instance property of App

app.objects : Array.<AppObject>

The AppObjects added to the App.

Kind: instance property of App

app.view

View options.

Kind: instance property of App

app.position ⇒ App.container.position | Object

This position {x, y} of the App view.

Kind: instance property of App

app.scale ⇒ App.container.scale | Object

The scale {x, y} of the App view.

Kind: instance property of App

app.targetScale ⇒ Object

The target scale {x, y} of the App view. (zoom target)

Kind: instance property of App

app.screenWidth ⇒ Number

The width of the window.

Kind: instance property of App

app.screenHeight ⇒ Number

The height of the window.

Kind: instance property of App

app.paused ⇒ boolean

Get the app paused value.

Kind: instance property of App

app.paused

Set the app paused value.

Kind: instance property of App

app.zoom

Get the zoom value.

Kind: instance property of App

app.zoom

Set the zoom value.

Kind: instance property of App

app.centerOn(object)

Center on an object in the App.

Kind: instance method of App

app.togglePause()

Toggle app paused value.

Kind: instance method of App

app.pauseRendering()

Pause rendering of the app.

Kind: instance method of App

app.resumeRendering()

Resume rendering of the app.

Kind: instance method of App

app.kill()

Kill the app renderer.

Kind: instance method of App

app.translatePosition(position) ⇒ Object

Translate a position from the window into the app.

Kind: instance method of App

app.update(seconds)

The main update loop of the app, which is triggered by the renderer.

Kind: instance method of App

app.previewObject(object) ⇒ AppObject

Add an AppObject to the view, but not the game loop.

Kind: instance method of App
Returns: AppObject - - (object)

app.cancelPreview(object) ⇒ AppObject

Remove an AppObject from the view which was added with .previewObject()

Kind: instance method of App
Returns: AppObject - - (object)

app.removeObjects(objects)

Remove an array of AppObjects.

Kind: instance method of App

app.contains(object) ⇒ boolean

Check if the App contains an AppObject.

Kind: instance method of App

app.add(object) ⇒ AppObject

Add an AppObject to the App.

Kind: instance method of App

app.remove(object) ⇒ AppObject

Remove an AppObject from the App.

Kind: instance method of App

app.addFx(object)

Add an AppObject to the FX layer.

Kind: instance method of App

app.removeFx(object)

Remove an AppObject from the FX layer.

Kind: instance method of App

app.updateZoom(seconds)

Update the App scale and position based on the targetScale (zoom).

Kind: instance method of App

app.selectObject(object, additive)

Select an AppObject.

Kind: instance method of App

app.select(left, top, right, bottom, additive)

Select all objects within the given coordinates.

Kind: instance method of App

app.selectAll()

Select all objects within the app.

Kind: instance method of App

app.deselectAll()

Deselect all selected objects.

Kind: instance method of App

app.removeSelected()

Remove all selected objects.

Kind: instance method of App

App.defaultOptions ⇒ Object

The default options which are used in an App.

Kind: static property of App

AppObject

AppObjects which are added to the App.

Kind: global class

• AppObject
  • new AppObject(app, parent, player, position, scale, pivot, rotation, momentum, dampening)
  • .select()
  • .deselect()
  • .selectionHitTest()
  • .beforeUpdate(seconds)
  • .update(seconds)
  • .afterUpdate(seconds)
  • .updateMovement(seconds)
  • .updateDampening(seconds)
  • .draw()

new AppObject(app, parent, player, position, scale, pivot, rotation, momentum, dampening)

Instantiate a new AppObject.

appObject.select()

Select this AppObject.

Kind: instance method of AppObject

appObject.deselect()

Deselect this AppObject

Kind: instance method of AppObject

appObject.selectionHitTest()

Check if provided coordinates are cause for the selection of this AppObject

Kind: instance method of AppObject

appObject.beforeUpdate(seconds)

The update operation to occur before all normal update operations within the App.

Kind: instance method of AppObject

appObject.update(seconds)

The update operation for the main loop of the App.

Kind: instance method of AppObject

appObject.afterUpdate(seconds)

The update operation to occur after all normal update operations within the App.

Kind: instance method of AppObject

appObject.updateMovement(seconds)

Update movement based on momentum.

Kind: instance method of AppObject

appObject.updateDampening(seconds)

Update movement dampening, causing the AppObject to slow down.

Kind: instance method of AppObject

appObject.draw()

Update the visual appearance of the AppObject.

Kind: instance method of AppObject