PRG Mbox Designer Manual 3.8 - Manual (Page 120)

112 MBOX ® MEDIA SERVER USER MANUAL
All the various properties of this transition have been expanded to show their "children." It is critical to get all of the
properties set to both correct types and appropriate values - with the only real exceptions being the Thumbnail and
UserVisibleName properties. If you fail to use the correct type or an appropriate value for a property, then it is likely
that the entire effect or transition will fail when used with Mbox. It is best to start by modifying values to a small extent
and examine the result of those changes.
The Quartz Composer application, available as part of Apple’s Developer tools, can be helpful in determining how the
various properties of an Image Unit work. However, keep in mind that the values used in Mbox’s effect and transition
property list don’t always match the values shown in Quartz Composer.
Properties and values used for the White Diagonal transition: are as follows:
+ Filter Name: string = CISwipeTransition – This is the name of the Image Unit for this particular transition. The "CI"
portion is an acronym for CoreImage. From this, you can tell that this Image Unit is one that Apple has created.
Most PRG Image Units will begin with "ME," short for Mbox Extreme.
+ inputAngle, Value: number = -0.7854 – This is the angle of the swipe of the transition.
+ inputColor, Color: array = four values (Red, Green, Blue, Alpha) = 1, 1, 1, 1 – These four values relate to the color
of the swipe of the transition. Although this includes a value for alpha, in the case of this transition, there is a
separate control, inputOpacity, that controls the opacity of the edge.
+ inputExtent, Extent: array = two values (X, Y) = 1, 1 – These two values relate to how far across the image the
transition will move from beginning to start. To ensure a complete transition, these two values must be left at 1.0.
+ inputOpacity, Value: number = 1 – This is the opacity of the colored swipe of the transition.
+ ineptitudes, Value: number = 150 – This is the width of the colored swipe of the transition.
+ inputImage, inputTargetImage, inputTime, outputImage: You should not edit these values.
So, to change the transition around a bit, change the following properties:
+ inputAngle – 0.7854
+ inputColor – 0, 1, 0, 1
+ inputOpacity – 0.5
+ inputWidth – 500
+ UserVisibleName – Green Diagonal
Always keep in mind that if you edit an existing entry in the effects or transitions plists, all instances of that effect or
transition will be changed. If you want to make a new version of the effect or transition, then add a new entry to the
appropriate plist and give it a new, unique number. Alternately, you can save your edits to a new .txfx or .txtx file and
place it in the correct folder.