Important: The information in this document is obsolete and should not be used for new development.
Transition plug-ins allow the user to select a visual display that eases an otherwise potentially jarring change from one clip to another. Typical transitions are wipes, fades, and dissolves.
A transition is applied between clips; it cannot apply across multiple clips as a title can.
The HYPluginDirection enumeration defines five values for the user-selected direction:
kPluginDirectionNone
kPluginDirectionUp
kPluginDirectionDown
kPluginDirectionLeft
kPluginDirectionRight
For example, if the user clicks the right arrow, iMovie provides kPluginDirectionRight value in HYPluginTitleInfo.direction. The plug-in can also supply HYPluginGetInfo.defaultDirection to iMovie so it can set the arrow to the desired default when the plug-in is initially chosen.
The HYPluginTransitionInfo structure is returned to the plug-in when it makes the GetTransitionInfo callback. The speed member contains the setting for the Speed slider in the transitions pane; its value can be in the range 0.0–1.0. The ver2 member is defined in the HYPluginTransitionInfo structure shown in Listing 1-6.
Listing 1-6 HYPluginTransitionInfo structure
// HYPluginTransitionInfo |
typedef struct _HYPluginTransitionInfo { |
float speed; |
HY2PluginTransitionInfo ver2; |
} HYPluginTransitionInfo; |
The HY2PluginTransitionInfo structure is used only to extend HYPluginTransitionInfo. It was introduced with iMovie 2.0 to provide the direction member.
Listing 1-7 HY2PluginTransitionInfo structure
typedef struct _HY2PluginTransitionInfo { |
HYPluginDirection direction; |
} HY2PluginTransitionInfo; |
Last updated: 2007-09-04