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