dlls/sane.ds/capability.c

   1 /*
   2  * Copyright 2000 Corel Corporation
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #define NONAMELESSUNION
  20 #define NONAMELESSSTRUCT
  21
  22 #include "config.h"
  23
  24 #include <stdarg.h>
  25
  26 #include "windef.h"
  27 #include "winbase.h"
  28 #include "twain.h"
  29 #include "sane_i.h"
  30 #include "wine/debug.h"
  31
  32 WINE_DEFAULT_DEBUG_CHANNEL(twain);
  33
  34 static TW_UINT16 get_onevalue(pTW_CAPABILITY pCapability, TW_UINT16 *type, TW_UINT32 *value)
  35 {
  36     if (pCapability->hContainer)
  37     {
  38         pTW_ONEVALUE pVal = GlobalLock (pCapability->hContainer);
  39         if (pVal)
  40         {
  41             *value = pVal->Item;
  42             if (type)
  43                 *type = pVal->ItemType;
  44             GlobalUnlock (pCapability->hContainer);
  45             return TWCC_SUCCESS;
  46         }
  47     }
  48     return TWCC_BUMMER;
  49 }
  50
  51
  52 static TW_UINT16 set_onevalue(pTW_CAPABILITY pCapability, TW_UINT16 type, TW_UINT32 value)
  53 {
  54     pCapability->hContainer = GlobalAlloc (0, sizeof(TW_ONEVALUE));
  55
  56     if (pCapability->hContainer)
  57     {
  58         pTW_ONEVALUE pVal = GlobalLock (pCapability->hContainer);
  59         if (pVal)
  60         {
  61             pCapability->ConType = TWON_ONEVALUE;
  62             pVal->ItemType = type;
  63             pVal->Item = value;
  64             GlobalUnlock (pCapability->hContainer);
  65             return TWCC_SUCCESS;
  66         }
  67     }
  68    return TWCC_LOWMEMORY;
  69 }
  70
  71 static TW_UINT16 msg_set(pTW_CAPABILITY pCapability, TW_UINT32 *val)
  72 {
  73     if (pCapability->ConType == TWON_ONEVALUE)
  74         return get_onevalue(pCapability, NULL, val);
  75
  76     FIXME("Partial Stub:  MSG_SET only supports TW_ONEVALUE\n");
  77     return TWCC_BADCAP;
  78 }
  79
  80
  81 static TW_UINT16 msg_get_enum(pTW_CAPABILITY pCapability, const TW_UINT32 *values, int value_count,
  82                               TW_UINT16 type, TW_UINT32 current, TW_UINT32 default_value)
  83 {
  84     TW_ENUMERATION *enumv = NULL;
  85     TW_UINT32 *p32;
  86     TW_UINT16 *p16;
  87     int i;
  88
  89     pCapability->ConType = TWON_ENUMERATION;
  90     pCapability->hContainer = 0;
  91
  92     if (type == TWTY_INT16 || type == TWTY_UINT16)
  93         pCapability->hContainer = GlobalAlloc (0, FIELD_OFFSET( TW_ENUMERATION, ItemList[value_count * sizeof(TW_UINT16)]));
  94
  95     if (type == TWTY_INT32 || type == TWTY_UINT32)
  96         pCapability->hContainer = GlobalAlloc (0, FIELD_OFFSET( TW_ENUMERATION, ItemList[value_count * sizeof(TW_UINT32)]));
  97
  98     if (pCapability->hContainer)
  99         enumv = GlobalLock(pCapability->hContainer);
 100
 101     if (! enumv)
 102         return TWCC_LOWMEMORY;
 103
 104     enumv->ItemType = type;
 105     enumv->NumItems = value_count;
 106
 107     p16 = (TW_UINT16 *) enumv->ItemList;
 108     p32 = (TW_UINT32 *) enumv->ItemList;
 109     for (i = 0; i < value_count; i++)
 110     {
 111         if (values[i] == current)
 112             enumv->CurrentIndex = i;
 113         if (values[i] == default_value)
 114             enumv->DefaultIndex = i;
 115         if (type == TWTY_INT16 || type == TWTY_UINT16)
 116             p16[i] = values[i];
 117         if (type == TWTY_INT32 || type == TWTY_UINT32)
 118             p32[i] = values[i];
 119     }
 120
 121     GlobalUnlock(pCapability->hContainer);
 122     return TWCC_SUCCESS;
 123 }
 124
 125 #ifdef SONAME_LIBSANE
 126 static TW_UINT16 msg_get_range(pTW_CAPABILITY pCapability, TW_UINT16 type,
 127             TW_UINT32 minval, TW_UINT32 maxval, TW_UINT32 step, TW_UINT32 def,  TW_UINT32 current)
 128 {
 129     TW_RANGE *range = NULL;
 130
 131     pCapability->ConType = TWON_RANGE;
 132     pCapability->hContainer = 0;
 133
 134     pCapability->hContainer = GlobalAlloc (0, sizeof(*range));
 135     if (pCapability->hContainer)
 136         range = GlobalLock(pCapability->hContainer);
 137
 138     if (! range)
 139         return TWCC_LOWMEMORY;
 140
 141     range->ItemType = type;
 142     range->MinValue = minval;
 143     range->MaxValue = maxval;
 144     range->StepSize = step;
 145     range->DefaultValue = def;
 146     range->CurrentValue = current;
 147
 148     GlobalUnlock(pCapability->hContainer);
 149     return TWCC_SUCCESS;
 150 }
 151 #endif
 152
 153 static TW_UINT16 TWAIN_GetSupportedCaps(pTW_CAPABILITY pCapability)
 154 {
 155     TW_ARRAY *a;
 156     static const UINT16 supported_caps[] = { CAP_SUPPORTEDCAPS, CAP_XFERCOUNT, CAP_UICONTROLLABLE,
 157                     ICAP_XFERMECH, ICAP_PIXELTYPE, ICAP_UNITS, ICAP_BITDEPTH, ICAP_COMPRESSION, ICAP_PIXELFLAVOR,
 158                     ICAP_XRESOLUTION, ICAP_YRESOLUTION };
 159
 160     pCapability->hContainer = GlobalAlloc (0, FIELD_OFFSET( TW_ARRAY, ItemList[sizeof(supported_caps)] ));
 161     pCapability->ConType = TWON_ARRAY;
 162
 163     if (pCapability->hContainer)
 164     {
 165         UINT16 *u;
 166         int i;
 167         a = GlobalLock (pCapability->hContainer);
 168         a->ItemType = TWTY_UINT16;
 169         a->NumItems = sizeof(supported_caps) / sizeof(supported_caps[0]);
 170         u = (UINT16 *) a->ItemList;
 171         for (i = 0; i < a->NumItems; i++)
 172             u[i] = supported_caps[i];
 173         GlobalUnlock (pCapability->hContainer);
 174         return TWCC_SUCCESS;
 175     }
 176     else
 177         return TWCC_LOWMEMORY;
 178 }
 179
 180
 181 /* ICAP_XFERMECH */
 182 static TW_UINT16 SANE_ICAPXferMech (pTW_CAPABILITY pCapability, TW_UINT16 action)
 183 {
 184     static const TW_UINT32 possible_values[] = { TWSX_NATIVE, TWSX_MEMORY };
 185     TW_UINT32 val;
 186     TW_UINT16 twCC = TWCC_BADCAP;
 187
 188     TRACE("ICAP_XFERMECH\n");
 189
 190     switch (action)
 191     {
 192         case MSG_QUERYSUPPORT:
 193             twCC = set_onevalue(pCapability, TWTY_INT32,
 194                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 195             break;
 196
 197         case MSG_GET:
 198             twCC = msg_get_enum(pCapability, possible_values, sizeof(possible_values) / sizeof(possible_values[0]),
 199                     TWTY_UINT16, activeDS.capXferMech, TWSX_NATIVE);
 200             break;
 201
 202         case MSG_SET:
 203             twCC = msg_set(pCapability, &val);
 204             if (twCC == TWCC_SUCCESS)
 205             {
 206                activeDS.capXferMech = (TW_UINT16) val;
 207                FIXME("Partial Stub:  XFERMECH set to %d, but ignored\n", val);
 208             }
 209             break;
 210
 211         case MSG_GETDEFAULT:
 212             twCC = set_onevalue(pCapability, TWTY_UINT16, TWSX_NATIVE);
 213             break;
 214
 215         case MSG_RESET:
 216             activeDS.capXferMech = TWSX_NATIVE;
 217             /* .. fall through intentional .. */
 218
 219         case MSG_GETCURRENT:
 220             twCC = set_onevalue(pCapability, TWTY_UINT16, activeDS.capXferMech);
 221             FIXME("Partial Stub:  XFERMECH of %d not actually used\n", activeDS.capXferMech);
 222             break;
 223     }
 224     return twCC;
 225 }
 226
 227
 228 /* CAP_XFERCOUNT */
 229 static TW_UINT16 SANE_CAPXferCount (pTW_CAPABILITY pCapability, TW_UINT16 action)
 230 {
 231     TW_UINT32 val;
 232     TW_UINT16 twCC = TWCC_BADCAP;
 233
 234     TRACE("CAP_XFERCOUNT\n");
 235
 236     switch (action)
 237     {
 238         case MSG_QUERYSUPPORT:
 239             twCC = set_onevalue(pCapability, TWTY_INT32,
 240                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 241             break;
 242
 243         case MSG_GET:
 244             twCC = set_onevalue(pCapability, TWTY_INT16, -1);
 245             FIXME("Partial Stub:  Reporting only support for transfer all\n");
 246             break;
 247
 248         case MSG_SET:
 249             twCC = msg_set(pCapability, &val);
 250             if (twCC == TWCC_SUCCESS)
 251                FIXME("Partial Stub:  XFERCOUNT set to %d, but ignored\n", val);
 252             break;
 253
 254         case MSG_GETDEFAULT:
 255             twCC = set_onevalue(pCapability, TWTY_INT16, -1);
 256             break;
 257
 258         case MSG_RESET:
 259             /* .. fall through intentional .. */
 260
 261         case MSG_GETCURRENT:
 262             twCC = set_onevalue(pCapability, TWTY_INT16, -1);
 263             break;
 264     }
 265     return twCC;
 266 }
 267
 268 #ifdef SONAME_LIBSANE
 269 static BOOL pixeltype_to_sane_mode(TW_UINT16 pixeltype, SANE_String mode, int len)
 270 {
 271     SANE_String_Const m = NULL;
 272     switch (pixeltype)
 273     {
 274         case TWPT_GRAY:
 275             m = SANE_VALUE_SCAN_MODE_GRAY;
 276             break;
 277         case TWPT_RGB:
 278             m = SANE_VALUE_SCAN_MODE_COLOR;
 279             break;
 280         case TWPT_BW:
 281             m = SANE_VALUE_SCAN_MODE_LINEART;
 282             break;
 283     }
 284     if (! m)
 285         return FALSE;
 286     if (strlen(m) >= len)
 287         return FALSE;
 288     strcpy(mode, m);
 289     return TRUE;
 290 }
 291 static BOOL sane_mode_to_pixeltype(SANE_String_Const mode, TW_UINT16 *pixeltype)
 292 {
 293     if (strcmp(mode, SANE_VALUE_SCAN_MODE_LINEART) == 0)
 294         *pixeltype = TWPT_BW;
 295     else if (memcmp(mode, SANE_VALUE_SCAN_MODE_GRAY, strlen(SANE_VALUE_SCAN_MODE_GRAY)) == 0)
 296         *pixeltype = TWPT_GRAY;
 297     else if (strcmp(mode, SANE_VALUE_SCAN_MODE_COLOR) == 0)
 298         *pixeltype = TWPT_RGB;
 299     else
 300         return FALSE;
 301
 302     return TRUE;
 303 }
 304
 305 static TW_UINT16 sane_status_to_twcc(SANE_Status rc)
 306 {
 307     switch (rc)
 308     {
 309         case SANE_STATUS_GOOD:
 310             return TWCC_SUCCESS;
 311         case SANE_STATUS_UNSUPPORTED:
 312             return TWCC_CAPUNSUPPORTED;
 313         case SANE_STATUS_JAMMED:
 314             return TWCC_PAPERJAM;
 315         case SANE_STATUS_NO_MEM:
 316             return TWCC_LOWMEMORY;
 317         case SANE_STATUS_ACCESS_DENIED:
 318             return TWCC_DENIED;
 319
 320         case SANE_STATUS_IO_ERROR:
 321         case SANE_STATUS_NO_DOCS:
 322         case SANE_STATUS_COVER_OPEN:
 323         case SANE_STATUS_EOF:
 324         case SANE_STATUS_INVAL:
 325         case SANE_STATUS_CANCELLED:
 326         case SANE_STATUS_DEVICE_BUSY:
 327         default:
 328             return TWCC_BUMMER;
 329     }
 330 }
 331 #endif
 332
 333 /* ICAP_PIXELTYPE */
 334 static TW_UINT16 SANE_ICAPPixelType (pTW_CAPABILITY pCapability, TW_UINT16 action)
 335 {
 336     TW_UINT16 twCC = TWCC_BADCAP;
 337 #ifdef SONAME_LIBSANE
 338     TW_UINT32 possible_values[3];
 339     int possible_value_count;
 340     TW_UINT32 val;
 341     SANE_Status rc;
 342     SANE_Int status;
 343     SANE_String_Const *choices;
 344     char current_mode[64];
 345     TW_UINT16 current_pixeltype = TWPT_BW;
 346     SANE_Char mode[64];
 347
 348     TRACE("ICAP_PIXELTYPE\n");
 349
 350     rc = sane_option_probe_mode(activeDS.deviceHandle, &choices, current_mode, sizeof(current_mode));
 351     if (rc != SANE_STATUS_GOOD)
 352     {
 353         ERR("Unable to retrieve mode from sane, ICAP_PIXELTYPE unsupported\n");
 354         return twCC;
 355     }
 356
 357     sane_mode_to_pixeltype(current_mode, &current_pixeltype);
 358
 359     /* Sane does not support a concept of a default mode, so we simply cache
 360      *   the first mode we find */
 361     if (! activeDS.PixelTypeSet)
 362     {
 363         activeDS.PixelTypeSet = TRUE;
 364         activeDS.defaultPixelType = current_pixeltype;
 365     }
 366
 367     switch (action)
 368     {
 369         case MSG_QUERYSUPPORT:
 370             twCC = set_onevalue(pCapability, TWTY_INT32,
 371                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 372             break;
 373
 374         case MSG_GET:
 375             for (possible_value_count = 0; choices && *choices && possible_value_count < 3; choices++)
 376             {
 377                 TW_UINT16 pix;
 378                 if (sane_mode_to_pixeltype(*choices, &pix))
 379                     possible_values[possible_value_count++] = pix;
 380             }
 381             twCC = msg_get_enum(pCapability, possible_values, possible_value_count,
 382                     TWTY_UINT16, current_pixeltype, activeDS.defaultPixelType);
 383             break;
 384
 385         case MSG_SET:
 386             twCC = msg_set(pCapability, &val);
 387             if (twCC == TWCC_SUCCESS)
 388             {
 389                 TRACE("Setting pixeltype to %d\n", val);
 390                 if (! pixeltype_to_sane_mode(val, mode, sizeof(mode)))
 391                     return TWCC_BADVALUE;
 392
 393                 status = 0;
 394                 rc = sane_option_set_str(activeDS.deviceHandle, "mode", mode, &status);
 395                 /* Some SANE devices use 'Grayscale' instead of the standard 'Gray' */
 396                 if (rc == SANE_STATUS_INVAL && strcmp(mode, SANE_VALUE_SCAN_MODE_GRAY) == 0)
 397                 {
 398                     strcpy(mode, "Grayscale");
 399                     rc = sane_option_set_str(activeDS.deviceHandle, "mode", mode, &status);
 400                 }
 401                 if (rc != SANE_STATUS_GOOD)
 402                     return sane_status_to_twcc(rc);
 403                 if (status & SANE_INFO_RELOAD_PARAMS)
 404                     psane_get_parameters (activeDS.deviceHandle, &activeDS.sane_param);
 405             }
 406             break;
 407
 408         case MSG_GETDEFAULT:
 409             twCC = set_onevalue(pCapability, TWTY_UINT16, activeDS.defaultPixelType);
 410             break;
 411
 412         case MSG_RESET:
 413             current_pixeltype = activeDS.defaultPixelType;
 414             if (! pixeltype_to_sane_mode(current_pixeltype, mode, sizeof(mode)))
 415                 return TWCC_BADVALUE;
 416
 417             status = 0;
 418             rc = sane_option_set_str(activeDS.deviceHandle, "mode", mode, &status);
 419             /* Some SANE devices use 'Grayscale' instead of the standard 'Gray' */
 420             if (rc == SANE_STATUS_INVAL && strcmp(mode, SANE_VALUE_SCAN_MODE_GRAY) == 0)
 421             {
 422                 strcpy(mode, "Grayscale");
 423                 rc = sane_option_set_str(activeDS.deviceHandle, "mode", mode, &status);
 424             }
 425             if (rc != SANE_STATUS_GOOD)
 426                 return sane_status_to_twcc(rc);
 427             if (status & SANE_INFO_RELOAD_PARAMS)
 428                 psane_get_parameters (activeDS.deviceHandle, &activeDS.sane_param);
 429
 430             /* .. fall through intentional .. */
 431
 432         case MSG_GETCURRENT:
 433             twCC = set_onevalue(pCapability, TWTY_UINT16, current_pixeltype);
 434             TRACE("Returning current pixeltype of %d\n", current_pixeltype);
 435             break;
 436     }
 437
 438 #endif
 439     return twCC;
 440 }
 441
 442 /* ICAP_UNITS */
 443 static TW_UINT16 SANE_ICAPUnits (pTW_CAPABILITY pCapability, TW_UINT16 action)
 444 {
 445     TW_UINT32 val;
 446     TW_UINT16 twCC = TWCC_BADCAP;
 447
 448     TRACE("ICAP_UNITS\n");
 449
 450     switch (action)
 451     {
 452         case MSG_QUERYSUPPORT:
 453             twCC = set_onevalue(pCapability, TWTY_INT32,
 454                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 455             break;
 456
 457         case MSG_GET:
 458             twCC = set_onevalue(pCapability, TWTY_UINT16, TWUN_INCHES);
 459             break;
 460
 461         case MSG_SET:
 462             twCC = msg_set(pCapability, &val);
 463             if (twCC == TWCC_SUCCESS)
 464             {
 465                 if  (val != TWUN_INCHES)
 466                 {
 467                     ERR("Sane supports only SANE_UNIT_DPI\n");
 468                     twCC = TWCC_BADVALUE;
 469                 }
 470             }
 471             break;
 472
 473         case MSG_GETDEFAULT:
 474         case MSG_RESET:
 475             /* .. fall through intentional .. */
 476
 477         case MSG_GETCURRENT:
 478             twCC = set_onevalue(pCapability, TWTY_UINT16, TWUN_INCHES);
 479             break;
 480     }
 481
 482     return twCC;
 483 }
 484
 485 /* ICAP_BITDEPTH */
 486 static TW_UINT16 SANE_ICAPBitDepth(pTW_CAPABILITY pCapability, TW_UINT16 action)
 487 {
 488     TW_UINT16 twCC = TWCC_BADCAP;
 489 #ifdef SONAME_LIBSANE
 490     TW_UINT32 possible_values[1];
 491
 492     TRACE("ICAP_BITDEPTH\n");
 493
 494     possible_values[0] = activeDS.sane_param.depth;
 495
 496     switch (action)
 497     {
 498         case MSG_QUERYSUPPORT:
 499             twCC = set_onevalue(pCapability, TWTY_INT32,
 500                     TWQC_GET | TWQC_GETDEFAULT | TWQC_GETCURRENT  );
 501             break;
 502
 503         case MSG_GET:
 504             twCC = msg_get_enum(pCapability, possible_values, sizeof(possible_values) / sizeof(possible_values[0]),
 505                     TWTY_UINT16, activeDS.sane_param.depth, activeDS.sane_param.depth);
 506             break;
 507
 508         case MSG_GETDEFAULT:
 509             /* .. Fall through intentional .. */
 510
 511         case MSG_GETCURRENT:
 512             TRACE("Returning current bitdepth of %d\n", activeDS.sane_param.depth);
 513             twCC = set_onevalue(pCapability, TWTY_UINT16, activeDS.sane_param.depth);
 514             break;
 515     }
 516 #endif
 517     return twCC;
 518 }
 519
 520 /* CAP_UICONTROLLABLE */
 521 static TW_UINT16 SANE_CAPUiControllable(pTW_CAPABILITY pCapability, TW_UINT16 action)
 522 {
 523     TW_UINT16 twCC = TWCC_BADCAP;
 524
 525     TRACE("CAP_UICONTROLLABLE\n");
 526
 527     switch (action)
 528     {
 529         case MSG_QUERYSUPPORT:
 530             twCC = set_onevalue(pCapability, TWTY_INT32, TWQC_GET);
 531             break;
 532
 533         case MSG_GET:
 534             twCC = set_onevalue(pCapability, TWTY_BOOL, TRUE);
 535             break;
 536
 537     }
 538     return twCC;
 539 }
 540
 541 /* ICAP_COMPRESSION */
 542 static TW_UINT16 SANE_ICAPCompression (pTW_CAPABILITY pCapability, TW_UINT16 action)
 543 {
 544     static const TW_UINT32 possible_values[] = { TWCP_NONE };
 545     TW_UINT32 val;
 546     TW_UINT16 twCC = TWCC_BADCAP;
 547
 548     TRACE("ICAP_COMPRESSION\n");
 549
 550     switch (action)
 551     {
 552         case MSG_QUERYSUPPORT:
 553             twCC = set_onevalue(pCapability, TWTY_INT32,
 554                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 555             break;
 556
 557         case MSG_GET:
 558             twCC = msg_get_enum(pCapability, possible_values, sizeof(possible_values) / sizeof(possible_values[0]),
 559                     TWTY_UINT16, TWCP_NONE, TWCP_NONE);
 560             FIXME("Partial stub:  We don't attempt to support compression\n");
 561             break;
 562
 563         case MSG_SET:
 564             twCC = msg_set(pCapability, &val);
 565             if (twCC == TWCC_SUCCESS)
 566                FIXME("Partial Stub:  COMPRESSION set to %d, but ignored\n", val);
 567             break;
 568
 569         case MSG_GETDEFAULT:
 570             twCC = set_onevalue(pCapability, TWTY_UINT16, TWCP_NONE);
 571             break;
 572
 573         case MSG_RESET:
 574             /* .. fall through intentional .. */
 575
 576         case MSG_GETCURRENT:
 577             twCC = set_onevalue(pCapability, TWTY_UINT16, TWCP_NONE);
 578             break;
 579     }
 580     return twCC;
 581 }
 582
 583 /* ICAP_XRESOLUTION, ICAP_YRESOLUTION  */
 584 static TW_UINT16 SANE_ICAPResolution (pTW_CAPABILITY pCapability, TW_UINT16 action,  TW_UINT16 cap)
 585 {
 586     TW_UINT16 twCC = TWCC_BADCAP;
 587 #ifdef SONAME_LIBSANE
 588     TW_UINT32 val;
 589     SANE_Int current_resolution;
 590     TW_FIX32 *default_res;
 591     const char *best_option_name;
 592     SANE_Int minval, maxval, quantval;
 593     SANE_Status sane_rc;
 594     SANE_Int set_status;
 595
 596     TRACE("ICAP_%cRESOLUTION\n", cap == ICAP_XRESOLUTION ? 'X' : 'Y');
 597
 598     /* Some scanners support 'x-resolution', most seem to just support 'resolution' */
 599     if (cap == ICAP_XRESOLUTION)
 600     {
 601         best_option_name = "x-resolution";
 602         default_res = &activeDS.defaultXResolution;
 603     }
 604     else
 605     {
 606         best_option_name = "y-resolution";
 607         default_res = &activeDS.defaultYResolution;
 608     }
 609     if (sane_option_get_int(activeDS.deviceHandle, best_option_name, &current_resolution) != SANE_STATUS_GOOD)
 610     {
 611         best_option_name = "resolution";
 612         if (sane_option_get_int(activeDS.deviceHandle, best_option_name, &current_resolution) != SANE_STATUS_GOOD)
 613             return TWCC_BADCAP;
 614     }
 615
 616     /* Sane does not support a concept of 'default' resolution, so we have to
 617      *   cache the resolution the very first time we load the scanner, and use that
 618      *   as the default */
 619     if (cap == ICAP_XRESOLUTION && ! activeDS.XResolutionSet)
 620     {
 621         default_res->Whole = current_resolution;
 622         default_res->Frac = 0;
 623         activeDS.XResolutionSet = TRUE;
 624     }
 625
 626     if (cap == ICAP_YRESOLUTION && ! activeDS.YResolutionSet)
 627     {
 628         default_res->Whole = current_resolution;
 629         default_res->Frac = 0;
 630         activeDS.YResolutionSet = TRUE;
 631     }
 632
 633     switch (action)
 634     {
 635         case MSG_QUERYSUPPORT:
 636             twCC = set_onevalue(pCapability, TWTY_INT32,
 637                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 638             break;
 639
 640         case MSG_GET:
 641             sane_rc = sane_option_probe_resolution(activeDS.deviceHandle, best_option_name, &minval, &maxval, &quantval);
 642             if (sane_rc != SANE_STATUS_GOOD)
 643                 twCC = TWCC_BADCAP;
 644             else
 645                 twCC = msg_get_range(pCapability, TWTY_FIX32,
 646                                 minval, maxval, quantval == 0 ? 1 : quantval, default_res->Whole, current_resolution);
 647             break;
 648
 649         case MSG_SET:
 650             twCC = msg_set(pCapability, &val);
 651             if (twCC == TWCC_SUCCESS)
 652             {
 653                 TW_FIX32 f32;
 654                 memcpy(&f32, &val, sizeof(f32));
 655                 sane_rc = sane_option_set_int(activeDS.deviceHandle, best_option_name, f32.Whole, &set_status);
 656                 if (sane_rc != SANE_STATUS_GOOD)
 657                 {
 658                     FIXME("Status of %d not expected or handled\n", sane_rc);
 659                     twCC = TWCC_BADCAP;
 660                 }
 661                 else if (set_status == SANE_INFO_INEXACT)
 662                     twCC = TWCC_CHECKSTATUS;
 663             }
 664             break;
 665
 666         case MSG_GETDEFAULT:
 667             twCC = set_onevalue(pCapability, TWTY_FIX32, default_res->Whole);
 668             break;
 669
 670         case MSG_RESET:
 671             sane_rc = sane_option_set_int(activeDS.deviceHandle, best_option_name, default_res->Whole, NULL);
 672             if (sane_rc != SANE_STATUS_GOOD)
 673                 return TWCC_BADCAP;
 674
 675             /* .. fall through intentional .. */
 676
 677         case MSG_GETCURRENT:
 678             twCC = set_onevalue(pCapability, TWTY_FIX32, current_resolution);
 679             break;
 680     }
 681 #endif
 682     return twCC;
 683 }
 684
 685 /* ICAP_PIXELFLAVOR */
 686 static TW_UINT16 SANE_ICAPPixelFlavor (pTW_CAPABILITY pCapability, TW_UINT16 action)
 687 {
 688     static const TW_UINT32 possible_values[] = { TWPF_CHOCOLATE, TWPF_VANILLA };
 689     TW_UINT32 val;
 690     TW_UINT16 twCC = TWCC_BADCAP;
 691
 692     TRACE("ICAP_PIXELFLAVOR\n");
 693
 694     switch (action)
 695     {
 696         case MSG_QUERYSUPPORT:
 697             twCC = set_onevalue(pCapability, TWTY_INT32,
 698                     TWQC_GET | TWQC_SET | TWQC_GETDEFAULT | TWQC_GETCURRENT | TWQC_RESET );
 699             break;
 700
 701         case MSG_GET:
 702             twCC = msg_get_enum(pCapability, possible_values, sizeof(possible_values) / sizeof(possible_values[0]),
 703                     TWTY_UINT16, TWPF_CHOCOLATE, TWPF_CHOCOLATE);
 704             break;
 705
 706         case MSG_SET:
 707             twCC = msg_set(pCapability, &val);
 708             if (twCC == TWCC_SUCCESS)
 709             {
 710                FIXME("Stub:  PIXELFLAVOR set to %d, but ignored\n", val);
 711             }
 712             break;
 713
 714         case MSG_GETDEFAULT:
 715             twCC = set_onevalue(pCapability, TWTY_UINT16, TWPF_CHOCOLATE);
 716             break;
 717
 718         case MSG_RESET:
 719             /* .. fall through intentional .. */
 720
 721         case MSG_GETCURRENT:
 722             twCC = set_onevalue(pCapability, TWTY_UINT16, TWPF_CHOCOLATE);
 723             break;
 724     }
 725     return twCC;
 726 }
 727
 728
 729 TW_UINT16 SANE_SaneCapability (pTW_CAPABILITY pCapability, TW_UINT16 action)
 730 {
 731     TW_UINT16 twCC = TWCC_CAPUNSUPPORTED;
 732
 733     TRACE("capability=%d action=%d\n", pCapability->Cap, action);
 734
 735     switch (pCapability->Cap)
 736     {
 737         case CAP_SUPPORTEDCAPS:
 738             if (action == MSG_GET)
 739                 twCC = TWAIN_GetSupportedCaps(pCapability);
 740             else
 741                 twCC = TWCC_BADVALUE;
 742             break;
 743
 744         case CAP_XFERCOUNT:
 745             twCC = SANE_CAPXferCount (pCapability, action);
 746             break;
 747
 748         case CAP_UICONTROLLABLE:
 749             twCC = SANE_CAPUiControllable (pCapability, action);
 750             break;
 751
 752         case ICAP_PIXELTYPE:
 753             twCC = SANE_ICAPPixelType (pCapability, action);
 754             break;
 755
 756         case ICAP_UNITS:
 757             twCC = SANE_ICAPUnits (pCapability, action);
 758             break;
 759
 760         case ICAP_BITDEPTH:
 761             twCC = SANE_ICAPBitDepth(pCapability, action);
 762             break;
 763
 764         case ICAP_XFERMECH:
 765             twCC = SANE_ICAPXferMech (pCapability, action);
 766             break;
 767
 768         case ICAP_PIXELFLAVOR:
 769             twCC = SANE_ICAPPixelFlavor (pCapability, action);
 770             break;
 771
 772         case ICAP_COMPRESSION:
 773             twCC = SANE_ICAPCompression(pCapability, action);
 774             break;
 775
 776         case ICAP_XRESOLUTION:
 777             twCC = SANE_ICAPResolution(pCapability, action, pCapability->Cap);
 778             break;
 779
 780         case ICAP_YRESOLUTION:
 781             twCC = SANE_ICAPResolution(pCapability, action, pCapability->Cap);
 782             break;
 783     }
 784
 785     /* Twain specifies that you should return a 0 in response to QUERYSUPPORT,
 786      *   even if you don't formally support the capability */
 787     if (twCC == TWCC_CAPUNSUPPORTED && action == MSG_QUERYSUPPORT)
 788         twCC = set_onevalue(pCapability, 0, TWTY_INT32);
 789
 790     if (twCC == TWCC_CAPUNSUPPORTED)
 791         TRACE("capability 0x%x/action=%d being reported as unsupported\n", pCapability->Cap, action);
 792
 793     return twCC;
 794 }