VLDMBUFFERGETVALID(3dm)                                VLDMBUFFERGETVALID(3dm)



NAME
     vlDMBufferGetValid, vlDMBufferPutValid, vlDMBufferGetVideoInfo,
     vlDMBufferSetVideoInfo - VL DMbuffer management routines

SYNOPSIS
     #include <dmedia/vl.h>

     int vlDMBufferGetValid(VLServer vlServer, VLPath path, VLNode node, DMbuffer* dmbuffer);
     int vlDMBufferPutValid(VLServer vlServer, VLPath path, VLNode node, DMbuffer dmbuffer);
     #include <sys/dmcommon.h>
     int vlDMBufferGetVideoInfo(DMbuffer dmbuffer, DMBufferVideoInfo* vidinfo)
     int vlDMBufferSetVideoInfo(DMbuffer dmbuffer, DMBufferVideoInfo* vidinfo)

DESCRIPTION
     vlDMBufferGetValid returns a valid DMbuffer containing video data from
     the specified node and path.  This call is used in video capture-type
     applications where a path is set up to route image data from a source
     video device node to drain memory node.

     The buffer that is returned contains one video image, either a field or a
     frame.  dmBufferMapData can be used to get a pointer to the image in the
     buffer.  The contents of the buffer should not be modified.

     vlDMBufferPutValid takes a valid DMbuffer and sends it to the path via
     the specified node.  This call is used in video playback-type
     applications where a path is set up to route image data from a source
     memory node to a drain video device node.

     After calling vlDMBufferPutValid, the video library and the call both
     have references to the buffer.  The contents of the buffer should not be
     changed by the caller.

     vlDMBufferGetVideoInfo copies the contents of the DMBufferVideoInfo
     structure associated with a DMBuffer to the address of a
     DMBufferVideoInfo structure specified by the user.

     vlDMBufferSetVideoInfo copies the contents of a DMBufferVideoInfo
     structure pointed to by the specified address to the DMBufferVideoInfo
     structure associated with a DMBuffer.

MACHINE DEPENDENCIES
     When using glXAssociateDMPbufferSGIX to pass DMbuffers between video and
     OpenGL on the O2 platform, VLLAYOUT should be set to VLLAYOUTGRAPHICS.
     This way, the video libary will expect DMbuffers in the format used
     internally by OpenGL.

RETURN VALUE
     Upon successful completion, vlDMBufferGetValid returns VLSuccess and
     dmbuffer points to a valid DMbuffer referencing video data.  Otherwise,
     -1 is returned, dmbuffer is set to NULL and vlErrno is set indicating the
     error.  Note that vlErrno set to VLAgain does not indicate an error but
     rather that there was no video data at the specified node when



                                                                        Page 1

VLDMBUFFERGETVALID(3dm)                                VLDMBUFFERGETVALID(3dm)



     vlDMBufferGetValid was called.

     Upon success completion, vlDMBufferPutValid returns VLSuccess, otherwise
     a value of -1 is returned and vlErrno is set indicating the error.

SEE ALSO
     vlDMPoolRegister(3dm), vlDMPoolDeregister(3dm), dmBufferAllocate(3dm),
     dmBufferFree(3dm), dmBufferMapData(3dm)















































                                                                        Page 2