TWAIN规范的第四章(2)

步骤一

源支持某些性能不代表源支持设置此性能。应用程序必须检查MSG_GET的返回值以确定发生了什么：

返回TWRC_SUCCESS表示源按要求设置了性能。

返回TWRC_CHECKSTATUS表示源无法使用一个或多个您限定的值。例如，你要求值310但它只能接受100、200、300或400。您的请求不在它的有效范围内，因此它选择一个最接近的有效值。

此时使用DG_CONTROL / DAT_CAPABILITY / MSG_GET操作来获取当前值和可用值是判断源的选择对应用程序是否可接受的唯一途径。 返回TWRC_FAILURE或TWCC_BADVALUE表示： ? 源不允许您设置或限定值的请求。或

? 请求的值不在有效值范围内，源可能尝试设置为一个最接近的可用值。

此时应同样使用DG_CONTROL/DAT_CAPABILITY/MSG_GET来确定应用程序是否能继续工作。

4.1.3 常用的性能

TWAIN定义了超过150种的性能。虽然数量看起来很大，但如果认识到只有一部分是常用的，你就会觉得轻松点。以下是其中一些： 4.1.3.1 基础性能 Units（单位）

ICAP_UNITS性能用于确定源所使用的计量单位。默认为英寸，其它允许的值为厘米、像素等。此性能的值用于衡量其它一些性能或结构的值，包括： ICAP_PHYSICALHEIGHT， ICAP_PHYSICALWIDTH， ICAP_XNATIVERESOLUTION， ICAP_YNATIVERESOLUTION， ICAP_XRESOLUTION， ICAP_YRESOLUTION，

TW_FRAME，TW_IMAGEINFO.XResolution， TW_IMAGE.YResolution Sense of the Pixel（像素涵义）

ICAP_PIXELFLAVOR描述从源传送到应用程序后位数据应如何解释。默认值为

TWPF_CHOCOLATE，它表示0为黑色（最深的颜色）；另一个值为TWPF_VANILLA，它表示0为白色（最浅的颜色）。 3Resolution（分辨率）

图像分辨率在TW_IMAGEINFO结构中提供。若要查询或设置源的分辨率，请使用ICAP_XRESOLUTION，ICAP_YRESOLUTION。

同样还有CAP_XNATIVERESOLUTION，ICAP_YNATIVERESOLUTION。 4.1.3.2 图像类型性能 Types of Pixel（像素类型）

应用程序应协商ICAP_PIXELTYPE和ICAP_BITDEPTH，除非它能在所有位深度上处理所有像素类型。允许的像素类型包括TWPT_BW，TWPT_GRAY，TWPT_RGB、TWPT_PALETTE，TWPT_CMY，TWPT_CMYK，TWPT_YUV，TWPT_YUVK，TWPT-CIEXYZ和TWPT_INFRARED。

Depth of the Pixels(in bits) 像素位深度

对于TWPT_BW这样的像素类型，一个像素仅占一位。其它像素类型允许每个像素占多个位（4位或8位灰度图像或24位彩色图像）。请确保先设置ICAP_PIXELTYPE，然后再设置ICAP_BITDEPTH。 4.1.3.3 图形采集参数 Exposure（曝光）

许多性能对此有影响，包括ICAP_BRIGHTNESS，ICAP_CONTRAST，ICAP_SHADOW，ICAP_HIGHLIGHT，ICAP_GAMMA和ICAP_AUTOBRIGHT。 Scaling（缩放）

若要通知源在传输前缩放图像，请参考ICAP_XSCALING和ICAP_YSCALING。 Rotation（旋转）

若要通知源在传输前旋转图像，请参考ICAP_ROTATION和ICAP_ORIENTATION。

4.1.4 限制性能以及消息响应

在应用程序给性能支持的值施行了限制后，数据源在响应性能的相关查询时会存在不确定性。以下指南有助于厘清这种状况。 MSG_RESET

我们已经知道这将使性能的值重置为默认值，但还必须声明一点：这也会重置任何应用程序施加在性能上的限制。

MSG_GETCURRENT和MSG_GETDEFAULT

显然没有当前或默认值的性能将不会支持这些消息。但第10章描述了另一种可能性，在这种情况下，简单地采用与MSG_GET相同的方式响应这些消息是有意义的。

同样直观的是数据源将在所有允许的情况下使用TW_ONEVALUE来响应对性能的请求。 MSG_GET …… 此处隐藏：151字，全部文档内容请下载后查看。喜欢就下载吧 ……