1/*****************************************************
2*
3*  Copyright 2009 Adobe Systems Incorporated.  All Rights Reserved.
4*
5*****************************************************
6*  The contents of this file are subject to the Mozilla Public License
7*  Version 1.1 (the "License"); you may not use this file except in
8*  compliance with the License. You may obtain a copy of the License at
9*  http://www.mozilla.org/MPL/
10*
11*  Software distributed under the License is distributed on an "AS IS"
12*  basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
13*  License for the specific language governing rights and limitations
14*  under the License.
15*
16*
17*  The Initial Developer of the Original Code is Adobe Systems Incorporated.
18*  Portions created by Adobe Systems Incorporated are Copyright (C) 2009 Adobe Systems
19*  Incorporated. All Rights Reserved.
20*
21*****************************************************/
22package org.osmf.layout
23{
24	/**
25	 * ScaleMode defines the layout of a single piece of content within
26	 * a MediaContainer.
27	 *
28	 *  @langversion 3.0
29	 *  @playerversion Flash 10
30	 *  @playerversion AIR 1.5
31	 *  @productversion OSMF 1.0
32	 */
33	public final class ScaleMode
34	{
35		/**
36		 * <code>NONE</code> implies that the media size is set to match its intrinsic size.
37		 *
38		 *  @langversion 3.0
39		 *  @playerversion Flash 10
40		 *  @playerversion AIR 1.5
41		 *  @productversion OSMF 1.0
42		 */
43		public static const NONE:String 		= "none";
44
45		/**
46		 * <code>STRETCH</code> sets the width and the height of the content to the
47		 * container width and height, possibly changing the content aspect ratio.
48		 *
49		 *  @langversion 3.0
50		 *  @playerversion Flash 10
51		 *  @playerversion AIR 1.5
52		 *  @productversion OSMF 1.0
53		 */
54		public static const STRETCH:String		= "stretch";
55
56		/**
57		 * <code>LETTERBOX</code> sets the width and height of the content as close to the container width and height
58		 * as possible while maintaining aspect ratio.  The content is stretched to a maximum of the container bounds,
59		 * with spacing added inside the container to maintain the aspect ratio if necessary.
60		 *
61		 *  @langversion 3.0
62		 *  @playerversion Flash 10
63		 *  @playerversion AIR 1.5
64		 *  @productversion OSMF 1.0
65		 */
66		public static const LETTERBOX:String 	= "letterbox";
67
68		/**
69		 * <code>ZOOM</code> is similar to <code>LETTERBOX</code>, except that <code>ZOOM</code> stretches the
70		 * content past the bounds of the container, to remove the spacing required to maintain aspect ratio.
71		 * This has the effect of using the entire bounds of the container, but also possibly cropping some content.
72		 *
73		 *  @langversion 3.0
74		 *  @playerversion Flash 10
75		 *  @playerversion AIR 1.5
76		 *  @productversion OSMF 1.0
77		 */
78		public static const ZOOM:String			= "zoom";
79	}
80}