dmPMSetupVideoTransition(3dm)

NAME
     dmPMSetupVideoTransition, dmPMExecuteVideoTransition,
     dmPMCleanupVideoTransition, dmPMBufferSetupVideoTransition,
     dmPMBufferExecuteVideoTransition - sets up, executes, and cleanups video
     transitions


SYNOPSIS
     #include <dmedia/fx_plugin_mgr.h>

     DMstatus dmPMSetupVideoTransition
           ( DMeffect* effect,
             void *srcA,
             DMparams *srcAParams,
             void *srcB,
             DMparams *srcBParams,
             unsigned int part,
             unsigned int total )

     DMstatus dmPMExecuteVideoTransition
           ( DMeffect* effect,
             void *srcA,
             DMparams *srcAParams,
             void *srcB,
             DMparams *srcBParams,
             void *dst,
             DMparams *dstParams,
             unsigned int part,
             unsigned int total )

     DMstatus dmPMCleanupVideoTransition
           ( DMeffect* effect )

     DMstatus dmPMBufferSetupVideoTransition
           ( DMeffect* effect,
             DMfxbuffer *srcABuffer,
             DMparams *srcAParams,
             DMfxbuffer *srcBBuffer,
             DMparams *srcBParams,
             unsigned int part,
             unsigned int total )

     DMstatus dmPMBufferExecuteVideoTransition
           ( DMeffect* effect,
             DMfxbuffer *srcABuffer,
             DMparams *srcAParams,
             DMfxbuffer *srcBBuffer,
             DMparams *srcBParams,
             DMfxbuffer *dstBuffer,
             DMparams *dstParams,
             unsigned int part,
             unsigned int total )
PARAMETERS
     effect       A pointer to a DMeffect, which was returned from
                  dmPMCreateEffect.

     srcA         A pointer to the video source image for track A.

     srcAParams   The source (track A) parameter/value list, a pointer to
                  DMparams, can be created with dmParamsCreate.

     srcB         A pointer to the video source image for track B.

     srcBParams   The source (trackB) parameter/value list, a pointer to
                  DMparams, can be created with dmParamsCreate.

     part         Goes from 0 to total (inclusive).

     total        The total number of frames.

     dst          A pointer to the video destination image.

     dstParams    The destination parameter/value list, a pointer to DMparams,
                  can be created with dmParamsCreate.

     srcABuffer   A pointer to a DMfxbuffer for the source (track A), which
                  was returned from dmFXAllocateImageBuffers.

     srcBBuffer   A pointer to a DMfxbuffer for the source (track B), which
                  was returned from dmFXAllocateImageBuffers.

     dstBuffer    A pointer to a DMfxbuffer for the destination, which was
                  returned from dmFXAllocateImageBuffers.


DESCRIPTION
     Video transitions may have user customizable settings in the form of a
     dialog box.  Calling dmPMSetupVideoTransition allows the video transition
     plugin to post the dialog and query values from the user.  Because all
     plugins must have default values, calling dmPMSetupVideoTransition is
     optional.  Calling dmPMExecuteVideoTransition will cause the video
     transition to be executed on your video clips.
     dmPMCleanupVideoTransition does not normally need to be called directly
     from your application.


RETURN VALUES
     dmPMSetupVideoTransition will return DM_SUCCESS if successful, or will
     return DM_FAILURE if it fails.  dmPMExecuteVideoTransition will return
     DM_SUCCESS if successful, or will return DM_FAILURE if it fails.
     dmPMCleanupVideoTransition will return DM_SUCCESS if successful, or will
     return DM_FAILURE if it fails.  dmPMBufferSetupVideoTransition will
     return DM_SUCCESS if successful, or will return DM_FAILURE if it fails.
     dmPMBufferExecuteVideoTransition will return DM_SUCCESS if successful, or
     will return DM_FAILURE if it fails.


SEE ALSO
     dmPMCreateManager(3dm), dmPMCreateEffect(3dm), dmGetError(3dm).