      *  
      *  <p>The image location can be a URL or file reference. If it is a file reference, its location is relative to
      *  the location of the file that is being compiled.</p>
-     *  
-     *  <p>The BitmapImage class is designed to work with embedded images or images that are 
-     *  loaded at run time</p>
      * 
-     *  <p>If the source is a Bitmap or BitmapData instance or is an external image file, it
+     *  <p>If the source is a Bitmap or BitmapData instance, it
      *  is the responsibility of the caller to dispose of the source once it is no longer needed.
      *  If BitmapImage created the BitmapData instance, then it will dispose of the BitmapData once the 
      *  source has changed.</p>

     *   <li>A class representing a subclass of DisplayObject. The BitmapFill instantiates 
     *       the class and creates a bitmap rendering of it.</li>
     *   <li>An instance of a DisplayObject. The BitmapFill copies it into a Bitmap for filling.</li>
     *   <li>The name of an external image file. This file must have the extention
     *   .jpg, .jpeg, .gif, or .png.</li>
     *  </ul>
     *  
     *  <p>If you use an image file for the source, it can be of type PNG, GIF, or JPG.</p>

import flash.display.BitmapData;
import flash.display.DisplayObject;
import flash.display.Graphics;
import flash.display.Sprite;
import flash.geom.Matrix;
import flash.geom.Point;
import flash.geom.Rectangle;

import mx.graphics.BitmapFillMode;

import spark.primitives.supportClasses.GraphicElement; 

/**
 *  A BitmapImage element defines a rectangular region in its parent element's 
