Adds API documentation for SkyGames

sky/examples/game/lib/game_demo_world.dart

 part of game;
 
 const double _steeringThreshold = 0.0;
 const double _steeringMax = 150.0;
 
 // Random generator
 Math.Random _rand = new Math.Random();
 
 const double _gameSizeWidth = 1024.0;
 const double _gameSizeHeight = 1024.0;
@@ skipping 24 matching lines @@
   bool _fire;
 
   Node _gameLayer;
 
   Ship _ship;
   List<Asteroid> _asteroids = [];
   List<Laser> _lasers = [];
   StarField _starField;
   Nebula _nebula;
   
-  GameDemoWorld(ImageMap images) : super.withSize(new Size(_gameSizeWidth, _gameSizeHeight)) {
+  GameDemoWorld(ImageMap images) : super(new Size(_gameSizeWidth, _gameSizeHeight)) {
 
     // Fetch images
     _imgBg = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Packages/SpriteBuilder%20Resources.sbpack/resources-auto/BurnTexture.png"];
     _imgAsteroid = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Packages/SpriteBuilder%20Resources.sbpack/Sprites/resources-auto/asteroid_big_002.png"];
     _imgShip = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Packages/SpriteBuilder%20Resources.sbpack/Sprites/resources-auto/GG_blueship_Lv3.png"];
     _imgLaser = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Packages/SpriteBuilder%20Resources.sbpack/Sprites/resources-auto/laserBlue.png"];
     _imgStar = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Packages/SpriteBuilder%20Resources.sbpack/Sprites/resources-auto/laserFlashPurple.png"];
     _imgNebula = images["https://raw.githubusercontent.com/slembcke/GalacticGuardian.spritebuilder/GDC/Source/Resources/NebulaClouds.png"];
 
     _gameLayer = new Node();
@@ skipping 18 matching lines @@
     // Add nebula
     addNebula();
 
     userInteractionEnabled = true;
     handleMultiplePointers = true;
   }
 
   // Methods for adding game objects
 
   void addBackground() {
-    Sprite sprtBg = new Sprite.withImage(_imgBg);
+    Sprite sprtBg = new Sprite(_imgBg);
     sprtBg.size = new Size(_gameSizeWidth, _gameSizeHeight);
     sprtBg.pivot = Point.origin;
     _gameLayer.addChild(sprtBg);
   }
   
   void addAsteroid(AsteroidSize size, [Point pos]) {
     Asteroid asteroid = new Asteroid.withImage(_imgAsteroid, size);
     asteroid.zPosition = 1.0;
     if (pos != null) asteroid.position = pos;
     _gameLayer.addChild(asteroid);
@@ skipping 194 matching lines @@
   double _radius;
 
   double get radius {
     if (_radius != null) return _radius;
     if (_asteroidSize == AsteroidSize.small) _radius = _smlAsteroidRadius;
     else if (_asteroidSize == AsteroidSize.medium) _radius = _medAsteroidRadius;
     else if (_asteroidSize == AsteroidSize.large) _radius = _lrgAsteroidRadius;
     return _radius;
   }
 
-  Asteroid.withImage(Image img, AsteroidSize this._asteroidSize) : super.withImage(img) {
+  Asteroid.withImage(Image img, AsteroidSize this._asteroidSize) : super(img) {
     size = new Size(radius * 2.0, radius * 2.0);
     position = new Point(_gameSizeWidth * _rand.nextDouble(), _gameSizeHeight * _rand.nextDouble());
     rotation = 360.0 * _rand.nextDouble();
 
     _movementVector = new Point(_rand.nextDouble() * _maxAsteroidSpeed * 2 - _maxAsteroidSpeed,
                                 _rand.nextDouble() * _maxAsteroidSpeed * 2 - _maxAsteroidSpeed);
 
     userInteractionEnabled = true;
   }
 
   bool handleEvent(SpriteBoxEvent event) {
     if (event.type == "pointerdown") {
       colorOverlay = new Color(0x99ff0000);
     }
     else if (event.type == "pointerup") {
       colorOverlay = null;
     }
     return false;
   }
 }
 
 class Ship extends Sprite {
   Vector2 _movementVector;
   double _rotationTarget;
 
-  Ship.withImage(Image img) : super.withImage(img) {
+  Ship.withImage(Image img) : super(img) {
     _movementVector = new Vector2.zero();
     rotation = _rotationTarget = 270.0;
 
     // Create sprite
     size = new Size(_shipRadius * 2.0, _shipRadius * 2.0);
     position = new Point(_gameSizeWidth/2.0, _gameSizeHeight/2.0);
   }
 
   void thrust(double x, double y) {
     _rotationTarget = convertRadians2Degrees(Math.atan2(y, x));
     Vector2 directionVector = new Vector2(x, y).normalize();
     _movementVector.addScaled(directionVector, 1.0);
   }
 
   void move() {
     position = new Point(position.x + _movementVector[0], position.y + _movementVector[1]);
     _movementVector.scale(0.9);
 
     rotation = dampenRotation(rotation, _rotationTarget, 0.1);
   }
 }
 
 class Laser extends Sprite {
   int _frameCount = 0;
   Point _movementVector;
   double radius = 10.0;
 
-  Laser.withImage(Image img, Ship ship) : super.withImage(img) {
+  Laser.withImage(Image img, Ship ship) : super(img) {
     size = new Size(20.0, 20.0);
     position = ship.position;
     rotation = ship.rotation + 90.0;
     transferMode = TransferMode.plus;
     double rotRadians = convertDegrees2Radians(rotation);
     _movementVector = pointMult(new Point(Math.sin(rotRadians), -Math.cos(rotRadians)), 10.0);
     _movementVector = new Point(_movementVector.x + ship._movementVector[0], _movementVector.y + ship._movementVector[1]);
   }
 
   void move() {
@@ skipping 65 matching lines @@
       _starPositions[i] = new Point(xPos, yPos);
     }
   }
 }
 
 class Nebula extends Node {
 
   Nebula.withImage(Image img) {
     for (int i = 0; i < 2; i++) {
       for (int j = 0; j < 2; j++) {
-        Sprite sprt = new Sprite.withImage(img);
+        Sprite sprt = new Sprite(img);
         sprt.pivot = Point.origin;
         sprt.position = new Point(i * _gameSizeWidth - _gameSizeWidth, j * _gameSizeHeight - _gameSizeHeight);
         addChild(sprt);
       }
     }
   }
 }
 
 // Convenience methods
 
@@ skipping 19 matching lines @@
   double dy = a.y - b.y;
   if (dx < 0.0) dx = -dx;
   if (dy < 0.0) dy = -dy;
   if (dx > dy) {
     return dx + dy/2.0;
   }
   else {
     return dy + dx/2.0;
   }
 }