Defining the viewable screen area
The Plazmic® Composer includes a Camera tool that you can use to define the view box. The view box outlines the portion of the canvas that the user sees in the view port on the BlackBerry device.
You can use a view box to create effects similar to those you can create using a video camera. You can, for example, display only a certain portion of your scene, then pull away to reveal the whole scene, or pan across the background.
When you select the Camera tool, the Plazmic Composer displays the view box over the canvas. The content in the view box is the content that users view on their BlackBerry® devices. Like shapes or text, the view box has configurable transformation properties; you can scale the view box or reposition it on the canvas, just like any other object. In addition, you can animate these transformation properties. For example, you can simulate zooming in and out of the scene on the canvas by animating the size of the view box over time; or you can simulate panning across the canvas by animating the position of the view box.
Because BlackBerry devices come in a variety of models with a variety of screen sizes, you might not know the dimensions of the view port when you create your content. By default, the content is stretched to fill the entire BlackBerry device screen, which can distort the content.
To avoid having the content stretched to fit the BlackBerry device screen, you can use the Preserve Aspect Ratio property for the Camera tool to control how the contents of the view box are resized.