[svn:osmf:] 13988: PARB feedback: change mediaWidth and mediaHeight properties on layout renderer related classes to measuredWidth , and measuredHeight.

Question

Revision: 13988
Revision: 13988
Author:   [email protected]
Date:     2010-02-05 00:24:52 -0800 (Fri, 05 Feb 2010)
Log Message:
PARB feedback: change mediaWidth and mediaHeight properties on layout renderer related classes to measuredWidth, and measuredHeight.
Modified Paths:
    osmf/trunk/framework/OSMF/org/osmf/composition/CompositeDisplayObjectTrait.as
    osmf/trunk/framework/OSMF/org/osmf/containers/MediaContainer.as
    osmf/trunk/framework/OSMF/org/osmf/display/MediaContainerGroup.as
    osmf/trunk/framework/OSMF/org/osmf/layout/DefaultLayoutRenderer.as
    osmf/trunk/framework/OSMF/org/osmf/layout/ILayoutTarget.as
    osmf/trunk/framework/OSMF/org/osmf/layout/LayoutRenderer.as
    osmf/trunk/framework/OSMF/org/osmf/layout/LayoutTargetSprite.as
    osmf/trunk/framework/OSMF/org/osmf/layout/MediaElementLayoutTarget.as
    osmf/trunk/framework/OSMFTest/org/osmf/display/TestMediaContainerGroup.as
    osmf/trunk/framework/OSMFTest/org/osmf/layout/TestDefaultLayoutRenderer.as
    osmf/trunk/framework/OSMFTest/org/osmf/layout/TestLayoutRenderer.as
    osmf/trunk/framework/OSMFTest/org/osmf/layout/TestMediaElementLayoutTarget.as
    osmf/trunk/framework/OSMFTest/org/osmf/layout/TesterLayoutTargetSprite.as

Answer 1

Hi Lucas, 
We don't recommend making layout renderers for each item that needs to be laid out.  In fact you shouldn't be creating layout renderers at all (they are created automatically by the MediaContainer).  The best way to layout Media is to add LayoutMetadata to the MediaElements.  If you want to integrate layout into your controls, which aren't MediaElements, I wouldn't suggest you place them manually on the stage, and do you yourself.  If you absolutely need to use the OSMF layout system, I would recommend creating a MediaElement to wrap your controls, and then give the wrapper the layout metadata you need.   The easiest approach though, is to look at the OSMFPlayer example, which has a skinnable player.  You can specify image for every button in the player, as well as background color, etc....
We will be releasing a white paper on the subject of layout in the coming weeks.   I'll be sure to include a section on laying out your player controls.
Ryan O'Connell
OSMF Engineering