Google Flix Engine Linux Reference Manual - Manual (Page 150)

144 Flix Engine Linux Module Documentation
5.35 Scale
5.35.1 Detailed Description
The video scale (resize) filter implements a high quality bicubic scaler to change the dimensions of the
video.
Filter Parameters:
Name | Type | Opt/Reqd | Range
=======================================================================================
FE2_SCALE_WIDTH | Numeric | Optional | [-19,)
FE2_SCALE_HEIGHT | Numeric | Optional | [-19,)
Example Usage:
sc = Flix2_AddFilter(&filter, flix, FE2_FILTER_SCALE);
// scale to 320xXXX maintaining the display aspect ratio
// e.g., 640x480 -> 320x240 (4:3)
// 640x360 -> 320x180 (16:9)
if(sc == ON2_OK)
sc = Flix2_FilterSetParam(filter, FE2_SCALE_WIDTH, 320);
if (sc == ON2_OK)
sc = Flix2_FilterSetParam(filter, FE2_SCALE_HEIGHT, -2);
5.35.2 Reserved values
The following values have special meaning and are applicable to both FE2_SCALE_WIDTH and FE2_-
SCALE_HEIGHT:
• 0: display dimension
• -1: original dimension (default)
• -2: calculate dimension based on its complement and the display aspect ratio
• -3: calculate dimension based on its complement and the original aspect ratio
• n-4∗x: where n is one of the values above with the resulting dimension being an even multiple of
2
∧
x
Display aspect ratio is calculated based on the desired resolution, as set by the container, e.g., the input is
encoded at 4:3, but displays at 16:9. Needless to say, this is clip dependent and requires the correct values
be set within the container and forwarded from the input source. If unavailable this value will be set to the
encoded resolution.
Attention:
Only one dimension may be set to {-2-4∗[0,4],-3-4∗[0,4]}. The other MUST be
{0-4 ∗[0,4],-1-4∗[0,4]} or > 0.
Deprecated functions
• on2sc video_options_GetImageHeight (const FLIX2HANDLE flix, int32_t ∗lpImageHeight)
Get the current scaled image height.
Generated on Tue Jul 20 17:39:03 2010 for Flix Engine Linux by Doxygen