dmFXSplitFields - split a frame out into two fields
DMstatus dmFXSplitFields [Toc] [Back]
( int inputUsage,
DMfxbuffer *fieldB )
inputUsage Specifies the modes in which the destination field buffers
(fieldA and fieldB) will be used as input; says how the
image will be read from the buffers and used as input to a
plug-in or application. The value is a bitwise combination
of one or more of: bufInputDirect, bufInputTexture,
bufInputDrawPixels, bufInputMovie. The options set must
include all of the different ways in which fieldA and fieldB
will be used.
srcFrame The source frame to copy scanlines from. The even numbered
scanlines (counting from 0) will be copied to fieldA, and
the odd numbered scanlines will be copied to fieldB.
fieldA The "top-most" field.
fieldB The "bottom-most" field.
dmFXSplitFields will create two fields from a single frame. The source
frame buffer must be twice the height of the two field buffers (see
mFXAllocateImageBuffers), and the source frame width must match the width
of the two field buffers.
The scanlines from the source frame are split out into two field buffers.
The even numbered scanlines (counting from 0) from the source frame
(srcFrame) are copied into fieldA, and the odd numbered scanlines are
copied into fieldB.
dmFXSplitFields will return DM_SUCCESS on success, and DM_FAILURE on
failure. In the case of failure, error information can be obtained from
dmGetError(3dm). Potential reasons for failure include:
FX_ERROR_BAD_PARAMETER The height of the source frame buffer is not 2
times the height of the destination field
FX_ERROR_BAD_PARAMETER The width of the source frame buffer is not
equal to the width of the destination field
dmFXMovieInsertFields(3dm), dmFXAllocateImageBuffers(3dm), DMbuffer(4)
PPPPaaaaggggeeee 2222 [ Back ]