 use namespace mx_internal;
 
 /**
- *  SplashScreenImageSource specifies a Class (typically an embedded image)
+ *  Use the SplashScreenImageSource class to specify a Class (typically an embedded image)
  *  to be displayed as splash screen at a particular device configuration such as
  *  DPI, orientation and resolution.
  *
- *  Developers typically use one or more <code>SplashScreenImageSource</code>
- *  objects to define a <code>SplashScreenImage</code> class in MXML
- *  and set the Application's <code>splashScreenImage</code> property to that class.
+ *  <p>You typically use one or more SplashScreenImageSource
+ *  objects to define a SplashScreenImage class in MXML
+ *  and set the application's <code>splashScreenImage</code> property to that class.</p>
+ *
+ *  <p>Shown below is SplashScreenImage component with three different 
+ *  definitions for SplashScreenImageSource:</p>
+ *
+ *  <pre>
+ *    &lt;?xml version="1.0" encoding="utf-8"?&gt; 
+ *    &lt;s:SplashScreenImage xmlns:fx="http://ns.adobe.com/mxml/2009" 
+ *        xmlns:s="library://ns.adobe.com/flex/spark"&gt; 
+ *     
+ *        &lt;!-- Default splashscreen image. --&gt; 
+ *        &lt;s:SplashScreenImageSource 
+ *            source="&#64;Embed('assets/logoDefault.jpg')"/&gt; 
+ *        
+ *        &lt;s:SplashScreenImageSource 
+ *            source="&#64;Embed('assets/logo240Portrait.jpg')" 
+ *            dpi="240" 
+ *            aspectRatio="portrait"/&gt; 
+ *        
+ *        &lt;s:SplashScreenImageSource 
+ *            source="&#64;Embed('assets/logo240Landscape.jpg')" 
+ *            dpi="240" 
+ *            aspectRatio="landscape"/&gt; 
+ *        
+ *    &lt;/s:SplashScreenImage&gt;      
+ *  </pre>
  *
  *  @see spark.preloaders.SplashScreenImage
  *  @see spark.components.Application#splashScreenImage
+ *  
+ *  @langversion 3.0
+ *  @playerversion AIR 3
+ *  @productversion Flex 4.5.2
  */  
 public class SplashScreenImageSource
 {


    /**
     *  The image class for the splash screen to use for the defined
     *  device configuration.  Typically you set this property to an 
     *  embedded resource.
     * 
     *  For example:
     *
     *  <pre>source="&#64;Embed('Default.png')"</pre>
     * 
     *  @see spark.preloaders.SplashScreenImage
     *
     *  @default null
     */ 
    public var source:Class;


    [Inspectable(category="General", enumeration="portrait,landscape")]

    /**
     *  The required aspect ratio of the mobile device.
     *  This property can be either <code>flash.display.StageAspectRatio.PORTRAIT</code> 
     *  or <code>flash.display.StageAspectRatio.LANDSCAPE</code>.
     * 
     *  <p>If not set, then <code>SplashScreenImage</code> ignores this property.</p> 
     *
     *  @see flash.display.StageAspectRatio
     * 
     *  @langversion 3.0
     *  @playerversion AIR 3
     *  @productversion Flex 4.5.2
     */ 
    public var aspectRatio:String = null;
    
