ImageEn, unit iexBitmaps

TIEMultiBitmap.InsertTransitionFrames

TIEMultiBitmap.InsertTransitionFrames


Declaration

// Standard transition overload
procedure InsertTransitionFrames(Idx: integer; FrameCount: integer; Effect: TIETransitionType;
                                 iWidth: Integer = -1; iHeight: Integer = -1; BackgroundColor: TColor = clBlack;
                                 ResamplingFilter: TResampleFilter = rfFastLinear; Params: TIETransitionParams = nil); overload;

// Pan-Zoom overloads
procedure InsertTransitionFrames(Idx: Integer; FrameCount: Integer; Effect: TIETransitionType;
                                 StartRect, EndRect: TRect; RectMaintainAspectRatio: boolean = True;
                                 iWidth: Integer = -1; iHeight: Integer = -1; bStretchSmall: Boolean = False;
                                 BackgroundColor: TColor = clBlack; ResamplingFilter: TResampleFilter = rfFastLinear;
                                 Smoothing: Integer = 255; Timing: TIETransitionTiming = iettLinear); overload;
procedure InsertTransitionFrames(Idx: Integer; FrameCount: Integer; Effect: TIETransitionType;
                                 StartRect, EndRect: TRect; RectMaintainAspectRatio: boolean;
                                 iWidth, iHeight: Integer; bStretchSmall: Boolean;
                                 BackgroundColor: TColor; ResamplingFilter: TResampleFilter;
                                 Params: TIETransitionParams); overload;


Description

Create a series of transition frames from the image at Idx - 1 to the image at Idx (and insert them at position Idx). If Idx = 0 then the transition is from a blank frame to the first image. If Idx = Count then the transition is from the last image to a blank frame.
The second overload is primarily used when you need to create a series of frames that show a Pan-Zoom from StartRect to EndRect for the image specified at Idx - 1.

Standard Transition Overload:
Parameter Description
Idx The insertion position
FrameCount The number of frames to insert
Effect The desired transition effect
iWidth, iHeight The size to create the transition bitmaps. If either of these are -1 then the size will be the larger of the two images in each dimension. Aspect Ratios will be maintained and any non-image area will be filled with BackgroundColor
BackgroundColor The color that will be used for blank frames or non-image area (default is clBlack)
ResamplingFilter The algorithm that is used to improve quality when resizing the source images
Params Extra transition properties

Pan-Zoom Overloads:
Parameter Description
Idx The insertion position
FrameCount The number of frames to insert
Effect The desired transition effect
StartRect When using an iettPanZoom effect this is the portion of the image that is shown at the start
EndRect When using an iettPanZoom effect this is the portion of the image that is shown at the end
RectMaintainAspectRatio ImageEn will ensure that the starting and ending rects are automatically adjusted to ensure the resultant image has the correct aspect ratio (iettPanZoom only)
iWidth, iHeight The size to create the transition bitmaps. If either of these are -1 then the size will be the larger of the two images in each dimension. Aspect Ratios will be maintained and any non-image area will be filled with BackgroundColor
bStretchSmall If the images are smaller than the transition bitmap size (iWidth x iHeight) should they be stretched to fit (which can lead to distortion)
BackgroundColor The color that will be used for blank frames or non-image area (Default is clBlack)
ResamplingFilter The algorithm that is used to improve quality when resizing the source images
Smoothing In order to reduce the "jumpiness" of pan-zoom effects, transition frames can be alpha blended. A low value will improve smoothness, but increase blurriness. A high value will improve clarity, but increase jumpiness. Typical range is 64 - 196. 255 means no alpha blending (which is best when outputting to a bitmap)
Timing The rate at which the transition progresses
Params Extra transition properties

Note:
 Cannot be used if a TIEDBMultiBitmap is attached to the control or is virtual
 You will need to add iexTransitions to your uses clause to access the transition types


Examples

// Create ten frames that use a cross dissolve transition from image 5 to image 6
MBitmap.InsertTransitionFrames(6, 10, iettCrossDissolve);


// Create ten Pan-Zoom frames for the image at index 5

// Top Left corner of image
StartingRect := Rect(0, 0, MBitmap.ImageWidth[5] div 4, MBitmap.ImageHeight[5] div 4);

// Bottom right corner of image
EndingRect := Rect(MulDiv(MBitmap.ImageWidth[5], 3, 4), MulDiv(MBitmap.ImageHeight[5], 3, 4), MBitmap.ImageWidth[5], MBitmap.ImageHeight[5]);

// Create frames
MBitmap.InsertTransitionFrames(5, 10, iettPanZoom, StartRect, EndRect);