home *** CD-ROM | disk | FTP | other *** search
/ Computer Tool Software / soft.iso / Multimed / WINFAST / WFST230 / WIN95 / README.TXT next >
Encoding:
Text File  |  1996-05-22  |  10.3 KB  |  373 lines
  1. README.TXT (Windows dynamic link library: VLIB.DLL)                                                          
  2.  
  3. -----------------------------------------------------------------------------
  4. 1. VIDEO_Initialize     
  5.  
  6.     Initialize video capture board.
  7.     
  8.     Syntax:   
  9.         BOOL FAR PASCAL VIDEO_Initialize(void)        
  10.  
  11.     Return vaule:  
  12.         TRUE  
  13.             
  14.                  
  15. -----------------------------------------------------------------------------
  16. 2. VIDEO_End
  17.  
  18.     End video function.
  19.     
  20.     Syntax:   
  21.         void FAR PASCAL VIDEO_End(void)        
  22.  
  23.     Return vaule:  
  24.         none
  25.           
  26.                              
  27. -----------------------------------------------------------------------------
  28. 3. VIDEO_EnableVideo     
  29.  
  30.     Enable video.
  31.     
  32.     Syntax:   
  33.         void FAR PASCAL VIDEO_EnableVideo(void)
  34.  
  35.     Return value:   
  36.         none
  37.         
  38.     See also:
  39.         VIDEO_DisableVideo
  40.  
  41.  
  42. -----------------------------------------------------------------------------
  43. 4. VIDEO_DisableVideo
  44.  
  45.     Disable video.
  46.  
  47.     Syntax:
  48.         void FAR PASCAL VIDEO_DisableVideo(void)
  49.  
  50.     Return value:
  51.         none 
  52.         
  53.     See also:
  54.         VIDEO_EnableVideo
  55.  
  56.  
  57. -----------------------------------------------------------------------------
  58. 5. VIDEO_SetVideoSource
  59.  
  60.     Select video source.
  61.                            
  62.     Syntax:                             
  63.         void FAR PASCAL VIDEO_SetVideoSource(WORD wSource)
  64.                            
  65.     Parameter:
  66.         WORD  wSource:  1 --> Source 1 (composed)
  67.                         2 --> Source 2 (S-Video)
  68.  
  69.     Return value:
  70.         none
  71.  
  72.  
  73. -----------------------------------------------------------------------------
  74. 6. VIDEO_SetInputFormat     
  75.  
  76.     Select input format.
  77.     
  78.     Syntax:
  79.         void FAR PASCAL VIDEO_SetInputFormat(WORD wFormat)  
  80.  
  81.     Parameter:
  82.         WORD  wFormat:  VIDEO_NTSC  --> NTSC format
  83.                         VIDEO_PAL   --> PAL format  
  84.                         VIDEO_SECAM --> SECAM format
  85.  
  86.     Return value:
  87.         none
  88.                                             
  89.                                                      
  90. -----------------------------------------------------------------------------
  91. 7. VIDEO_SetVideoMode        
  92.  
  93.     Select video mode.
  94.  
  95.     Syntax:
  96.         void FAR PASCAL VIDEO_SetVideoMode(WORD wMode)
  97.     
  98.     Parameter:
  99.         WORD wMode: VIDEO_TV  --> TV mode
  100.                     VIDEO_VTR --> VTR mode
  101.  
  102.     Return value:
  103.         none                                                     
  104.         
  105.         
  106. -----------------------------------------------------------------------------
  107. 8. VIDEO_FreezeVideo     
  108.       
  109.     Freeze Video picture.
  110.     
  111.     Syntax:
  112.         void FAR PASCAL VIDEO_FreezeVideo(void)
  113.  
  114.     Return value:
  115.         none
  116.         
  117.     See also:
  118.         VIDEO_UnfreezeVideo
  119.  
  120.  
  121. -----------------------------------------------------------------------------
  122. 9. VIDEO_UnfreezeVideo     
  123.    
  124.     Unfreeze Video picture.
  125.     
  126.     Syntax:                                
  127.         void FAR PASCAL VIDEO_UnfreezeVideo(void)
  128.  
  129.     Return value:
  130.         none
  131.  
  132.     See also:       
  133.         VIDEO_FreezeVideo
  134.         
  135.         
  136. -----------------------------------------------------------------------------
  137. 10. VIDEO_SetColor                             
  138.   
  139.     Set hue, brightness, saturation, contrast value.   
  140.  
  141.     Syntax:   
  142.         void FAR PASCAL VIDEO_SetColor(BYTE bIndex, BYTE bValue)
  143.  
  144.     Parameter:
  145.         BYTE bIndex: VIDEO_HUE --> Set hue value.
  146.                      VIDEO_BRI --> Set brightness value.
  147.                      VIDEO_SAT --> Set saturation value.
  148.                      VIDEO_CON --> Set contrast value.
  149.         BYTE bValue: Specifies a value to hue, brightness, saturation or
  150.                      contrast. The value can be from 0 to 255.
  151.  
  152.     Return value:   
  153.         none
  154.  
  155.  
  156. -----------------------------------------------------------------------------
  157. 11. VIDEO_SetVideoPos                                      
  158.             
  159.     Set video window position (size and starting position).
  160.     
  161.     Syntax:                        
  162.         void FAR PASCAL VIDEO_SetVideoPos(int iX, int iY, int iCX, int iCY);
  163.  
  164.     Parameter: 
  165.         int iX:  Position in pixels of the left side of the video window.
  166.         int iY:  Position in pixels of the top of the video window.
  167.         int iCX: Width of video window in pixels.
  168.         int iCY: Height of video window in pixels.
  169.  
  170.     Return value:
  171.         none
  172.               
  173.  
  174. -----------------------------------------------------------------------------
  175. 12. VIDEO_LoadImageRect                                
  176.  
  177.     Retrieve a rectangle region from video memory.                   
  178.     
  179.     Syntax:
  180.         void FAR PASCAL VIDEO_LoadImageRect(
  181.                             BYTE _huge * lpHuge, 
  182.                             WORD wX,  WORD wY,
  183.                             WORD wCX, WORD wCY, 
  184.                             WORD wImageType, WORD wOffset)
  185.  
  186.     Parameter:                                 
  187.         BYTE _huge * lpHuge: A memory buffer to store image data.
  188.         WORD             wX: Position in pixels of the left side of the
  189.                              rectangle region.
  190.         WORD             wY: Position in pixels of the top of the
  191.                              rectangle region.
  192.         WORD            wCX: Width of the rectangle region in pixels.
  193.         WORD            wCY: Height of the rectangle region in pixels.
  194.         WORD     wImageType: Specifies the Image type to be retrieved.
  195.                                 VIDEO_BMP_8_GRAY  --> 256 color gray scale
  196.                                 VIDEO_BMP_15 --> 32K HiColor.
  197.                                 VIDEO_BMP_16 --> 64K HiColor.          
  198.                                 VIDEO_BMP_24 --> 16 million true color.
  199.         WORD        wOffset: Row offset of memory buffer.
  200.                              If wOffset is 0, this function automatically
  201.                              calculate the value. 
  202.                              (i.e. If wImageType = VIDEO_BMP_16
  203.                               and wCX = 50, then wOffset = wCX * 2 = 100)
  204.                                     
  205.     Return value:
  206.         none
  207.  
  208.     See also:       
  209.         VIDEO_RestoreImageRect
  210.  
  211.  
  212. -----------------------------------------------------------------------------
  213. 13. VIDEO_RestoreImageRect                
  214.    
  215.     Restore memory buffer to video memory.
  216.     
  217.     Syntax:
  218.         void FAR PASCAL  VIDEO_RestoreImageRect(
  219.                             BYTE _huge * lpHuge, 
  220.                             WORD wX, WORD wY,
  221.                             WORD wCX, WORD wCY, 
  222.                             WORD wImageType, WORD wOffset)
  223.                             
  224.     Parameter:                          
  225.         BYTE _huge * lpHuge: Specefies a huge pointer to a memory buffer that
  226.                              includes image data for restoring to video 
  227.                              memory.
  228.         WORD             wX: Position in pixels of the left side of the
  229.                              video screen.
  230.         WORD             wY: Position in pixels of the top of the
  231.                              video screen.
  232.         WORD            wCX: Width of the image data in pixels.
  233.         WORD            wCY: Height of the image data in pixels.
  234.         WORD     wImageType: Specifies the Image type to restore.
  235.                                 VIDEO_BMP_8_GRAY  --> 256 color gray scale
  236.                                 VIDEO_BMP_15 --> 32K HiColor.
  237.                                 VIDEO_BMP_16 --> 64K HiColor.          
  238.                                 VIDEO_BMP_24 --> 16 million true color.
  239.         WORS        wOffset: Row offset of memory buffer.
  240.                              If wOffset is 0, this function automatically
  241.                              calculate the value. 
  242.                              (i.e. If wImageType = VIDEO_BMP_16
  243.                               and wCX = 50, then wOffset = wCX * 2 = 100)
  244.                             
  245.     Return value:
  246.         none
  247.  
  248.     See also:
  249.         VIDEO_LoadImageRect
  250.  
  251.                                
  252. -----------------------------------------------------------------------------
  253. 14. VIDEO_SetHorizontalAlignment         
  254.    
  255.     Adjust horizontal alignment.
  256.     
  257.     Syntax:
  258.         void FAR PASCAL VIDEO_SetHorizontalAlignment(int iValue)
  259.                             
  260.     Parameter:                          
  261.         int iValue: Specefies a value to adjust horizontal alignment.
  262.                             
  263.     Return value:
  264.         none
  265.  
  266.     See also:
  267.         VIDEO_SetVerticalAlignment, VIDEO_SetHorizontalCrop,
  268.         VIDEO_SetVerticalCrop.
  269.                                                 
  270.                                                 
  271. -----------------------------------------------------------------------------
  272. 15. VIDEO_SetVerticalAlignment         
  273.    
  274.     Adjust vertical alignment.
  275.     
  276.     Syntax:
  277.         void FAR PASCAL VIDEO_SetVerticalAlignment(int iValue); 
  278.                             
  279.     Parameter:                          
  280.         int iValue: Specefies a value to adjust vertical alignment.
  281.                             
  282.     Return value:
  283.         none
  284.  
  285.     See also:
  286.         VIDEO_SetHorizontalAlignment, VIDEO_SetHorizontalCrop,
  287.         VIDEO_SetVerticalCrop.         
  288.         
  289.         
  290. -----------------------------------------------------------------------------
  291. 16. VIDEO_SetHorizontalCrop   
  292.    
  293.     Adjust horizontal cropping.
  294.     
  295.     Syntax:
  296.         void FAR PASCAL VIDEO_SetHorizontalCrop(WORD wValue);
  297.                             
  298.     Parameter:                          
  299.         WORD wValue: Specefies a value to adjust horizontal cropping.
  300.                             
  301.     Return value:
  302.         none
  303.  
  304.     See also:
  305.         VIDEO_SetHorizontalAlignment, VIDEO_SetVerticalAlignment,
  306.         VIDEO_SetVerticalCrop.                                                   
  307.         
  308.         
  309. -----------------------------------------------------------------------------
  310. 17. VIDEO_SetVerticalCrop   
  311.    
  312.     Adjust vertical cropping.
  313.     
  314.     Syntax:
  315.         void FAR PASCAL VIDEO_SetVerticalCrop(WORD wValue);
  316.                             
  317.     Parameter:                          
  318.         WORD wValue: Specefies a value to adjust vertical cropping.
  319.                             
  320.     Return value:
  321.         none
  322.  
  323.     See also:
  324.         VIDEO_SetHorizontalAlignment, VIDEO_SetVerticalAlignment,
  325.         VIDEO_SetHorizontalCrop.                
  326.         
  327.  
  328. -----------------------------------------------------------------------------
  329. 18. VIDEO_LoadImageRect                                
  330.  
  331.     Retrieve a rectangle region from video memory.                   
  332.     
  333.     Syntax:
  334.         BOOL FAR PASCAL    VIDEO_SaveImageFile(
  335.                             LPSTR lpFileName, 
  336.                             WORD wX,  WORD wY,
  337.                             WORD wCX, WORD wCY, 
  338.                             WORD wFileType)
  339.  
  340.     Parameter:                                 
  341.         LPSTR    lpFileName: File nmae for save image file.
  342.         WORD             wX: Position in pixels of the left side of the
  343.                              rectangle region.
  344.         WORD             wY: Position in pixels of the top of the
  345.                              rectangle region.
  346.         WORD            wCX: Width of the rectangle region in pixels.
  347.         WORD            wCY: Height of the rectangle region in pixels.
  348.         WORD      wFileType: Specifies the file format to be saved.
  349.                                 VIDEO_BMP24    -->    Windows DIB 24 bit true color
  350.                                 VIDEO_BMP8    -->    Windows DIB 8 bit palettized
  351.                                 VIDEO_BMP8G    -->    Windows DIB 8 bit gray-scale
  352.                                 VIDEO_BMP4    -->    Windows DIB 4 bit dithered
  353.                                 VIDEO_MMP    -->    IBM MMotion format 4:1:1 YUV
  354.                                 VIDEO_PCX8    -->    PCX 8 bit palettized
  355.                                 VIDEO_PCX8G    -->    PCX 8 bit gray-scale
  356.                                 VIDEO_TGA32    -->    Targa 32 bit true color
  357.                                 VIDEO_TGA24    -->    Targa 24 bit true color
  358.                                 VIDEO_TGA16    -->    Targa 16 bit true color
  359.                                 VIDEO_TIF24    -->    TIFF 24 bit true color
  360.                                 VIDEO_TIF8    -->    TIFF 8 bit palettized
  361.                                 VIDEO_TIF8G    -->    TIFF 8 bit gray-scale
  362.                                 VIDEO_PCX4    -->    PCX 4 bit dithered
  363.                                     
  364.     Return value:
  365.         TRUE:   sucessful
  366.         FALSE:  failure
  367.  
  368.     See also:       
  369.         VIDEO_LoadImageRect
  370.  
  371.  
  372. ------------------------------------(End)------------------------------------
  373.