Syntax


 

 PXL_RETURN_CODE PxLFormatClip (

 LPCSTR pInputFileName,

 LPCSTR pOutputFileName,

 U32    outputFormat );

 

Description


This function converts a PixeLINK data stream file (.pds) into a standard Windows video clip file.

  • pInputFileName is the name of the PixeLINK data stream file to be converted.  
  • pOutputFileName is the name of the video clip file that is to be created.  
  • outputFormat is the format of the output video file. Valid formats flags are:  
    • CLIP_FORMAT_AVI — Convert to standard Windows .avi file.


This value is defined in the file PixeLINKTypes.h.   


Comments, Restrictions and Limitations


To create the input file in PixeLINK data stream format, use PxLGetClip.


In addition to video image data, the PixeLINK data stream file includes descriptors containing sets of properties for each frame in the file.  For more information, go to descriptors.   


If the height and width of the frames in the source file varies, the smallest values are used and any larger frames are cropped.


For an .avi output file (CLIP_FORMAT_AVI), the frame timing is determined from the descriptors in the .pds input file.


The maximum size of a valid avi file created using  PxLFormatClip is 2GB (2,097,151 bytes).


Callback


If you want a chance to modify the individual frames, specify a callback function with PxLSetCallback, using the callback type CALLBACK_FORMAT_CLIP.