This method confirms whether or not a functionality is supported by the datasource (scan device).
Parameters
Name | Explanation |
---|---|
CapNo | The number for the retrieved functionality
(hexadecimal)
0x1002 Document feeder function 0x1003 A function that checks whether or not there is paper in the document feeder 0x100b Indicator 0x100e UI control function 0x100f A function that checks the device's operating state 0x1011 A function to transfer thumbnail images 0x1012 Duplex scanning with document feeder 0x1014 Displays UI that sets scan values only (not to scan) 0x1015 Retrieve or set scan values in the UI 0x112d Undefined image size 0x112e A function that checks the number of images in a digital camera 0x1150 Auto border detection 0x1151 Deskew 0xf003 Maximum resolution when using the moire filter 0xf005 Rotate backside when using an ADF in duplex mode 0xf008 Auto detect BW/Color ratio 0xf009 Multistream 0xf00a Text orientation recognition or automatic rotation 0xf00c Punch hole removal 0xf00d Focus Postion 0xf00e Text Enhancement 0xf00f Border Adjustment 0xf010 Gamma Adjustment
The following constants can be used: (vikScanFeederEnabled = 0x1002, vikScanFeederLoaded = 0x1003, vikScanIndicator = 0x100b, vikScanUiControllable = 0x100e, vikScanDeviceonline = 0x100f, vikScanThumbnailsEnabled = 0x1011, vikScanDuplex = 0x1012, vikScanEnableDSUIOnly = 0x1014, vikScanCustomDSData = 0x1015, vikScanUndefinedImagesize = 0x112d, vikScanImageDataset = 0x112e, vikScanBorderDetection = 0x1150, vikScanDeskew = 0x1151, vikScanMoirefilterMaxResolution = 0xf003, vikScanRotateBack = 0xf005, vikScanPixelAutomationCap = 0xf008, vikScanMultiStream = 0xf009, vikScanTextOrientationRecognition = 0xf00a, vikScanRemoveHole = 0xf00c, vikScanBorder = 0xf00f, vikScanAdjustGamma = 0xf010). |
Value | A variable containing the retrieved condtions for a functionality. See explanation, "Regarding the values returned in the Value parameter" below: |
Return Value
Returns True when successful, returns False when not successful.
Explanation
The IsCapSupported method confirms whether or not a functionality is supported by the datasource (scan device). To retrieve the supported range for a functionality, the DataSourceName property must be set. If the DataSourceName property is blank then prior to executing this method, please execute the Select method. (If the OpenDataSource method has been executed, the DataSourceName property is disabled and the open scan device will be used.
To execute the IsCapSupported method you must first execute the Initialize method. If the OpenDataSource method is executed prior to executing the IsCapSupported method then the open datasource cannot be used by another application until that datasource (scan device) is closed.
the values returned in the Value parameter:
When CapNo refers to document feeder function, 0: cannot be used (only document plate can be used), 1: feeder can be used, 2: document plate and feeder can be used.
When CapNo refers to the function that checks whether or not there is paper in the document feeder, 0: there is no paper, 1: there is paper.
When CapNo refers to indicator, 0: cannot use indicator, 1: can use indicator.
When CapNo refers to UI control function, 0: must use manufacturer's UI only, 1: manufacturer's UI can be suppressed.
When CapNo refers to the function that checks the device's operating state, 0: Device does not respond, 1: Device is operating.
When CapNo refers to the function that transfers thumbnail images, 0: cannot transfer thumbnails, 1: can transfer thumbnails.
When CapNo refers to duplex scanning with the document feeder, 0: can not scan both sides, 1: can scan both sides at once, 2: can scan both sides but takes two scans.
When CapNo refers to the function that displaying a UI that sets scan values (but does not scan), 0: Cannot display UI that sets scan values, 1: Can display UI that sets scan values
When CapNo refers to the function that retrieves or sets scan values in the UI , 0: Cannot retrieve or set values in the UI. 1: Can retrieve or set values in the UI
When CapNo refers to the undefined size then in general, 0: undefined size cannot be used, 1: undefined size can be used. However, with certain Epson scan drivers, the following values are set, 0: undefined size cannot be used, 1: possible only with document plate, 2: possible only with ADF, 3: possible with both document plate and ADF
When CapNo refers to how many images are in a digital camera, the returned number is the number of images.
When CapNo refers to border detection, 0: border detection is not possible, 1: border detection is possible
When CapNo refers to deskew, 0: cannot use deskew, 1: can use deskew, 2: can use deskew with smoothing.2 is only available for certain Panasonic scan drivers.
When CapNo refers to the maximum resolution when using a moire filter, the value is that maximum resolution. Available only for certain Epson scan drivers
When CapNo refers to RotateBack when using ADF in duplex mode, 0: rotating the back side is not possible, 1: rotating the back side is possible. Available only for certain Epson "Epson Scan" scan drivers.
When CapNo refers to automatically detecting ratio of BW/Color, 0: cannot automatically detect BW/Color, 1: can automatically detect BW/Color. Available for certain Panasonic scan drivers, Canon DR scan drivers, Epson scan drivers, and PFU scan drivers.
When the CapNo refers to MultiStream, 0: MultiStream is not possible, 1: MultiStream is possible. MultiStream means that from 1 document, two different pixel type images can be retrieved. Enabled for certain Panasonic scan drivers and certain PFU scan drivers.
When the CapNo refers to TextOrientationRecognition or Automatic Rotation, 0: TextOrientationRecognition or Automatic Rotation is not possible, 1: TextOrientationRecognition or Automatic Rotation is possible. TextOrientationRecognition is enabled on Canon DR scan drivers and Panasonic scan drivers. Canon calls this "text orientation recognition" while Panasonic calls it "document orientation correction". TWAIN refers to this function as "automatic rotation".
When the CapNo refers to Punch hole removal, 0: punch hole removal is not possible, 1: punch hole removal is possible. Enabled for Canon DR scan drivers, Epson scan drivers, Panasonic scan drivers, and PFU scan drivers.
When the CapNo refers to Border Adjustment, 0: border adjustment is not possible, 1: border adjustment is possible. Enabled for certain Epson scan drivers, Panasonic scan drivers.
When the CapNo refers to Gamma Adjustment, 0: gamma adjustment is not possible, 1: gamma adjustment is possible. Enabled for certain Epson scan drivers.
* If the return value of this method is False, then the Value parameter is not set.
The IsCapSupported method corresponds to the Scan Control's ScanIsCapSupported method in earlier versions of the ImageKit.
[Differences from the ImageKit7/8/9 ActiveX]
In VCL, the constants contain a "v". In ActiveX the constants are: ikScanFeederEnabled, ikScanFeederLoaded, ikScanIndicator, ikScanUiControllable, ikScanDeviceonline, ikScanThumbnailsEnabled, ikScanDuplex, ikScanEnableDSUIOnly, ikScanCustomDSData, ikScanUndefinedImagesize, ikScanImageDataset, ikScanBorderDetection, ikScanDeskew, ikScanMoirefilterMaxResolution, ikScanRotateBack, ikScanPixelAutomationCap, ikScanMultiStream, ikScanTextOrientationRecognition, ikScanRemoveHole, ikScanBorder
[Differences from the ImageKit7 ActiveX/VCL]
Functions that display a UI that sets scan values, functions that all values to be retrieved and set in the UI, MultiStream, TextOrientationRecognition or Automatic Rotation, and Punch hole removal values been added to CapNo. Also, a new value of 2 can be set for the document feeder allowing both document feeder and ADF.
[Differences from the ImageKit8 ActiveX/VCL]
Border Adjustment and Gamma Adjustment values have been added to CapNo.