TImageEnView.TransitionParams

Declaration

TransitionParams: TIETransitionParams;

Description

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

Properties

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:

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;

---