This function saves a clip of video to a Pixelink Data Stream (.pds) file. This file can be converted to an end-user file using the FormatClip.vi. The function is asynchronous and will start a separate thread to capture the clip.


..................................................................................................................................................................................................................................................................................


Controls and Indicators


          hCamera IN is the camera handle. This value is returned by Initialize.vi and is passed between PixeLINK VIs as a reference.


            uNumberofFrames IN is the number of frames to be captured in the clip.


            pFileName IN is the path and file name of the destination Pixelink Data Stream format file (*.pds). This file can be converted to a end-user format by the VI FormatClip.


            hCamera OUT has the same value as hCamera IN.


Details


The GetClip.vi will return immediately even if the clip capture is still taking place. While the clip capture is occurring, camera features can still be adjusted. To tell when the clip has been completed, use the SetCallback.vi to create clip termination function that will trigger an occurrence on completion of the clip capture.


The output .pds file can be converted to an AVI file using the FormatClip.vi.


Note: See Error Handling for error input and output information and error codes.