ImageEn, unit imageenview

TImageEnView.TransitionParams

TImageEnView.TransitionParams


Declaration

TransitionParams: TIETransitionParams;


Description

Specify extra properties to customize transition effects which are available when loading or changing images.

Properties
Published Property  AlternativeStyle
Published Property  PanZoomFilter
Published Property  PanZoomSmoothing
Published Property  Timing
Published Property  TransitionShape
Published Property  WordTransWord
Published Property  WordTransFontName
Published Property  WordTransFontStyle
Published Property  WordTransQuality
Published Property  WipeLineColor
Published Property  WipeLineWidth


Examples

// Set properties for Word transition
ImageEnView1.TransitionParams.WordTransWord      := 'BLAM';
ImageEnView1.TransitionParams.WordTransFontName  := 'Arial';
ImageEnView1.TransitionParams.WordTransFontStyle := [fsBold];

// Prepare ImageEnView1 for a transition (e.g. so loading the image will not immediately update the display)
ImageEnView1.PrepareTransition();

// Load the next image
ImageEnView1.IO.LoadFromFile( GetNextImage() );

// Run the transition
ImageEnView1.RunTransition( iettRandomBoxesWithWord, 1000 );




// Display an alternative transition with a pentagonal shape
ImageEnView1.TransitionParams.TransitionShape  := iesPentagon;
ImageEnView1.TransitionParams.AlternativeStyle := True;
ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( NextImage );
ImageEnView1.RunTransition( iettExpandingStar6 , 3000 );


// Display snowflakes in random positions
ImageEnView1.TransitionParams.WordTransWord      := 'T';  // Snowflake in the Wingdings font
ImageEnView1.TransitionParams.WordTransFontName  := 'Wingdings';
ImageEnView1.TransitionParams.WordTransFontStyle := [fsBold];

ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( GetNextImage() );
ImageEnView1.RunTransition( iettRandomWord, 2000 );


// Transition, showing each letter of the word "ImageEn" in turn
ImageEnView1.TransitionParams.WordTransWord := 'ImageEn';
ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( GetNextImage() );
ImageEnView1.RunTransition( iettWordWipeInAndOut, 5000 );


// Transition wiping the screen with the word "GO!"
ImageEnView1.TransitionParams.WordTransWord := '"GO!"'; // Enclose in quotes to avoid cyling. Small words are best
ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( GetNextImage() );
ImageEnView1.RunTransition( iettWordWipeInAndOut, 5000 );



Compatibility Information

From v12.0.0, all extra transition properties were centralized in the TIETransitionParams class.

Code changes are as follows:
Old Property New Property
IEGlobalSettings().TransitionsDrawAlternative ImageEnView1.TransitionParams.AlternativeStyle
IEGlobalSettings().TransitionsDrawShape ImageEnView1.TransitionParams.TransitionShape
IEGlobalSettings().PanZoomQualityFilter ImageEnView1.TransitionParams.PanZoomFilter
ImageEnView1.TransitionTiming ImageEnView1.TransitionParams.Timing
IEGlobalSettings().WordTransitionParams.Word ImageEnView1.TransitionParams.WordTransWord
IEGlobalSettings().WordTransitionParams.FontName ImageEnView1.TransitionParams.WordTransFontName
IEGlobalSettings().WordTransitionParams.Style ImageEnView1.TransitionParams.WordTransFontStyle
IEGlobalSettings().WordTransitionParams.Quality ImageEnView1.TransitionParams.WordTransQuality

Compatibility Examples
// Old code
// Set properties for Word transition
IEGlobalSettings().WordTransitionParams.Word     := 'BLAM';
IEGlobalSettings().WordTransitionParams.FontName := 'Arial';
IEGlobalSettings().WordTransitionParams.Style    := [fsBold];
ImageEnView1.PrepareTransition();

// New code
// Set properties for Word transition
ImageEnView1.TransitionParams.WordTransWord      := 'BLAM';
ImageEnView1.TransitionParams.WordTransFontName  := 'Arial';
ImageEnView1.TransitionParams.WordTransFontStyle := [fsBold];
ImageEnView1.PrepareTransition();


// Old code
// Display an alternative transition with a pentagonal shape
IEGlobalSettings().TransitionsDrawShape := iesPentagon;
IEGlobalSettings().TransitionsDrawAlternative := True;
ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( NextImage );
ImageEnView1.RunTransition( iettExpandingStar6 , 3000 );

// New code
// Display an alternative transition with a pentagonal shape
ImageEnView1.TransitionParams.TransitionShape  := iesPentagon;
ImageEnView1.TransitionParams.AlternativeStyle := True;
ImageEnView1.PrepareTransition();
ImageEnView1.IO.LoadFromFile( NextImage );
ImageEnView1.RunTransition( iettExpandingStar6 , 3000 );


// Old code
// Use exponential timing
ImageEnView1.TransitionTiming := iettExponential;

// New code
// Use exponential timing
ImageEnView1.TransitionParams.Timing := iettExponential;