Syntax

 

 PXL_RETURN_CODE PxLFormatClip (

   LPCSTR pInputFileName,

   LPCSTR pOutputFileName,

   U32    outputFormat );

 

Description


Please note that new applications should use the updated function PxLFormatClipEx.


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 format flags here.


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.


When recording uncompressed video, avi files are limited to a maximum size. The maximum file size may vary depending on your Operating System. For 64-bit Windows 10 systems, the maximum size of a valid avi file created using  PxLFormatClip is 4GB.


Callback


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