sane-project-backends/include/sane/saneopts.h

352 wiersze
15 KiB
C

/* sane - Scanner Access Now Easy.
Copyright (C) 1996, 1997 David Mosberger-Tang and Andreas Beck
This file is part of the SANE package.
SANE is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.
SANE is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with sane; see the file COPYING. If not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
This file declares common option names, titles, and descriptions. A
backend is not limited to these options but for the sake of
consistency it's better to use options declared here when appropriate.
*/
/* This file defines several option NAMEs, TITLEs and DESCs
that are (or should be) used by several backends.
All well known options should be listed here. But this does
not mean that all options that are listed here are well known options.
To find out if an option is a well known option and how well known
options have to be defined please take a look at the sane standard!!!
*/
#ifndef saneopts_h
#define saneopts_h
#ifndef SANE_I18N
#define SANE_I18N(text) text
#endif
/* This _must_ be the first option (index 0): */
#define SANE_NAME_NUM_OPTIONS "" /* never settable */
#define SANE_NAME_PREVIEW "preview"
#define SANE_NAME_GRAY_PREVIEW "preview-in-gray"
#define SANE_NAME_BIT_DEPTH "depth"
#define SANE_NAME_SCAN_MODE "mode"
#define SANE_NAME_SCAN_SPEED "speed"
#define SANE_NAME_SCAN_SOURCE "source"
#define SANE_NAME_BACKTRACK "backtrack"
/* Most user-interfaces will let the user specify the scan area as the
top-left corner and the width/height of the scan area. The reason
the backend interface uses the top-left/bottom-right corner is so
that the scan area values can be properly constraint independent of
any other option value. */
#define SANE_NAME_SCAN_TL_X "tl-x"
#define SANE_NAME_SCAN_TL_Y "tl-y"
#define SANE_NAME_SCAN_BR_X "br-x"
#define SANE_NAME_SCAN_BR_Y "br-y"
#define SANE_NAME_SCAN_RESOLUTION "resolution"
#define SANE_NAME_SCAN_X_RESOLUTION "resolution"
#define SANE_NAME_SCAN_Y_RESOLUTION "y-resolution"
#define SANE_NAME_CUSTOM_GAMMA "custom-gamma"
#define SANE_NAME_GAMMA_VECTOR "gamma-table"
#define SANE_NAME_GAMMA_VECTOR_R "red-gamma-table"
#define SANE_NAME_GAMMA_VECTOR_G "green-gamma-table"
#define SANE_NAME_GAMMA_VECTOR_B "blue-gamma-table"
#define SANE_NAME_BRIGHTNESS "brightness"
#define SANE_NAME_CONTRAST "contrast"
#define SANE_NAME_GRAIN_SIZE "grain"
#define SANE_NAME_HALFTONE "halftoning"
#define SANE_NAME_BLACK_LEVEL "black-level"
#define SANE_NAME_WHITE_LEVEL "white-level"
#define SANE_NAME_SHADOW "shadow"
#define SANE_NAME_SHADOW_R "shadow-r"
#define SANE_NAME_SHADOW_G "shadow-g"
#define SANE_NAME_SHADOW_B "shadow-b"
#define SANE_NAME_HIGHLIGHT "highlight"
#define SANE_NAME_HIGHLIGHT_R "highlight-r"
#define SANE_NAME_HIGHLIGHT_G "highlight-g"
#define SANE_NAME_HIGHLIGHT_B "highlight-b"
#define SANE_NAME_HUE "hue"
#define SANE_NAME_SATURATION "saturation"
#define SANE_NAME_FILE "filename"
#define SANE_NAME_HALFTONE_DIMENSION "halftone-size"
#define SANE_NAME_HALFTONE_PATTERN "halftone-pattern"
#define SANE_NAME_RESOLUTION_BIND "resolution-bind"
#define SANE_NAME_NEGATIVE "negative"
#define SANE_NAME_QUALITY_CAL "quality-cal"
#define SANE_NAME_DOR "double-res"
#define SANE_NAME_RGB_BIND "rgb-bind"
#define SANE_NAME_THRESHOLD "threshold"
#define SANE_NAME_ANALOG_GAMMA "analog-gamma"
#define SANE_NAME_ANALOG_GAMMA_R "analog-gamma-r"
#define SANE_NAME_ANALOG_GAMMA_G "analog-gamma-g"
#define SANE_NAME_ANALOG_GAMMA_B "analog-gamma-b"
#define SANE_NAME_ANALOG_GAMMA_BIND "analog-gamma-bind"
#define SANE_NAME_WARMUP "warmup"
#define SANE_NAME_CAL_EXPOS_TIME "cal-exposure-time"
#define SANE_NAME_CAL_EXPOS_TIME_R "cal-exposure-time-r"
#define SANE_NAME_CAL_EXPOS_TIME_G "cal-exposure-time-g"
#define SANE_NAME_CAL_EXPOS_TIME_B "cal-exposure-time-b"
#define SANE_NAME_SCAN_EXPOS_TIME "scan-exposure-time"
#define SANE_NAME_SCAN_EXPOS_TIME_R "scan-exposure-time-r"
#define SANE_NAME_SCAN_EXPOS_TIME_G "scan-exposure-time-g"
#define SANE_NAME_SCAN_EXPOS_TIME_B "scan-exposure-time-b"
#define SANE_NAME_SELECT_EXPOSURE_TIME "select-exposure-time"
#define SANE_NAME_CAL_LAMP_DEN "cal-lamp-density"
#define SANE_NAME_SCAN_LAMP_DEN "scan-lamp-density"
#define SANE_NAME_SELECT_LAMP_DENSITY "select-lamp-density"
#define SANE_TITLE_NUM_OPTIONS SANE_I18N("Number of options")
#define SANE_TITLE_PREVIEW SANE_I18N("Preview")
#define SANE_TITLE_GRAY_PREVIEW SANE_I18N("Force monochrome preview")
#define SANE_TITLE_BIT_DEPTH SANE_I18N("Bit depth")
#define SANE_TITLE_SCAN_MODE SANE_I18N("Scan mode")
#define SANE_TITLE_SCAN_SPEED SANE_I18N("Scan speed")
#define SANE_TITLE_SCAN_SOURCE SANE_I18N("Scan source")
#define SANE_TITLE_BACKTRACK SANE_I18N("Force backtracking")
#define SANE_TITLE_SCAN_TL_X SANE_I18N("Top-left x")
#define SANE_TITLE_SCAN_TL_Y SANE_I18N("Top-left y")
#define SANE_TITLE_SCAN_BR_X SANE_I18N("Bottom-right x")
#define SANE_TITLE_SCAN_BR_Y SANE_I18N("Bottom-right y")
#define SANE_TITLE_SCAN_RESOLUTION SANE_I18N("Scan resolution")
#define SANE_TITLE_SCAN_X_RESOLUTION SANE_I18N("X-resolution")
#define SANE_TITLE_SCAN_Y_RESOLUTION SANE_I18N("Y-resolution")
#define SANE_TITLE_CUSTOM_GAMMA SANE_I18N("Use custom gamma table")
#define SANE_TITLE_GAMMA_VECTOR SANE_I18N("Image intensity")
#define SANE_TITLE_GAMMA_VECTOR_R SANE_I18N("Red intensity")
#define SANE_TITLE_GAMMA_VECTOR_G SANE_I18N("Green intensity")
#define SANE_TITLE_GAMMA_VECTOR_B SANE_I18N("Blue intensity")
#define SANE_TITLE_BRIGHTNESS SANE_I18N("Brightness")
#define SANE_TITLE_CONTRAST SANE_I18N("Contrast")
#define SANE_TITLE_GRAIN_SIZE SANE_I18N("Grain size")
#define SANE_TITLE_HALFTONE SANE_I18N("Halftoning")
#define SANE_TITLE_BLACK_LEVEL SANE_I18N("Black level")
#define SANE_TITLE_WHITE_LEVEL SANE_I18N("White level")
#define SANE_TITLE_SHADOW SANE_I18N("Shadow")
#define SANE_TITLE_SHADOW_R SANE_I18N("Shadow for red")
#define SANE_TITLE_SHADOW_G SANE_I18N("Shadow for green")
#define SANE_TITLE_SHADOW_B SANE_I18N("Shadow for blue")
#define SANE_TITLE_HIGHLIGHT SANE_I18N("Highlight")
#define SANE_TITLE_HIGHLIGHT_R SANE_I18N("Highlight for red")
#define SANE_TITLE_HIGHLIGHT_G SANE_I18N("Highlight for green")
#define SANE_TITLE_HIGHLIGHT_B SANE_I18N("Highlight for blue")
#define SANE_TITLE_HUE SANE_I18N("Hue")
#define SANE_TITLE_SATURATION SANE_I18N("Saturation")
#define SANE_TITLE_FILE SANE_I18N("Filename")
#define SANE_TITLE_HALFTONE_DIMENSION SANE_I18N("Halftone pattern size")
#define SANE_TITLE_HALFTONE_PATTERN SANE_I18N("Halftone pattern")
#define SANE_TITLE_RESOLUTION_BIND SANE_I18N("Bind X and Y resolution")
#define SANE_TITLE_NEGATIVE SANE_I18N("Negative")
#define SANE_TITLE_QUALITY_CAL SANE_I18N("Quality calibration")
#define SANE_TITLE_DOR SANE_I18N("Double Optical Resolution")
#define SANE_TITLE_RGB_BIND SANE_I18N("Bind RGB")
#define SANE_TITLE_THRESHOLD SANE_I18N("Threshold")
#define SANE_TITLE_ANALOG_GAMMA SANE_I18N("Analog gamma correction")
#define SANE_TITLE_ANALOG_GAMMA_R SANE_I18N("Analog gamma red")
#define SANE_TITLE_ANALOG_GAMMA_G SANE_I18N("Analog gamma green")
#define SANE_TITLE_ANALOG_GAMMA_B SANE_I18N("Analog gamma blue")
#define SANE_TITLE_ANALOG_GAMMA_BIND SANE_I18N("Bind analog gamma")
#define SANE_TITLE_WARMUP SANE_I18N("Warmup lamp")
#define SANE_TITLE_CAL_EXPOS_TIME SANE_I18N("Cal. exposure-time")
#define SANE_TITLE_CAL_EXPOS_TIME_R SANE_I18N("Cal. exposure-time for red")
#define SANE_TITLE_CAL_EXPOS_TIME_G SANE_I18N("Cal. exposure-time for " \
"green")
#define SANE_TITLE_CAL_EXPOS_TIME_B SANE_I18N("Cal. exposure-time for blue")
#define SANE_TITLE_SCAN_EXPOS_TIME SANE_I18N("Scan exposure-time")
#define SANE_TITLE_SCAN_EXPOS_TIME_R SANE_I18N("Scan exposure-time for red")
#define SANE_TITLE_SCAN_EXPOS_TIME_G SANE_I18N("Scan exposure-time for " \
"green")
#define SANE_TITLE_SCAN_EXPOS_TIME_B SANE_I18N("Scan exposure-time for blue")
#define SANE_TITLE_SELECT_EXPOSURE_TIME SANE_I18N("Set exposure-time")
#define SANE_TITLE_CAL_LAMP_DEN SANE_I18N("Cal. lamp density")
#define SANE_TITLE_SCAN_LAMP_DEN SANE_I18N("Scan lamp density")
#define SANE_TITLE_SELECT_LAMP_DENSITY SANE_I18N("Set lamp density")
/* Descriptive/help strings for above options: */
#define SANE_DESC_NUM_OPTIONS \
SANE_I18N("Read-only option that specifies how many options a specific " \
"devices supports.")
#define SANE_DESC_PREVIEW \
SANE_I18N("Request a preview-quality scan.")
#define SANE_DESC_GRAY_PREVIEW \
SANE_I18N("Request that all previews are done in monochrome mode. On a " \
"three-pass scanner this cuts down the number of passes to one and on a " \
"one-pass scanner, it reduces the memory requirements and scan-time of the " \
"preview.")
#define SANE_DESC_BIT_DEPTH \
SANE_I18N("Number of bits per sample, typical values are 1 for \"line-art\" " \
"and 8 for multibit scans.")
#define SANE_DESC_SCAN_MODE \
SANE_I18N("Selects the scan mode (e.g., lineart,monochrome, or color).")
#define SANE_DESC_SCAN_SPEED \
SANE_I18N("Determines the speed at which the scan proceeds.")
#define SANE_DESC_SCAN_SOURCE \
SANE_I18N("Selects the scan source (such as a document-feeder).")
#define SANE_DESC_BACKTRACK \
SANE_I18N("Controls whether backtracking is forced.")
#define SANE_DESC_SCAN_TL_X \
SANE_I18N("Top-left x position of scan area.")
#define SANE_DESC_SCAN_TL_Y \
SANE_I18N("Top-left y position of scan area.")
#define SANE_DESC_SCAN_BR_X \
SANE_I18N("Bottom-right x position of scan area.")
#define SANE_DESC_SCAN_BR_Y \
SANE_I18N("Bottom-right y position of scan area.")
#define SANE_DESC_SCAN_RESOLUTION \
SANE_I18N("Sets the resolution of the scanned image.")
#define SANE_DESC_SCAN_X_RESOLUTION \
SANE_I18N("Sets the horizontal resolution of the scanned image.")
#define SANE_DESC_SCAN_Y_RESOLUTION \
SANE_I18N("Sets the vertical resolution of the scanned image.")
#define SANE_DESC_CUSTOM_GAMMA \
SANE_I18N("Determines whether a builtin or a custom gamma-table should be " \
"used.")
#define SANE_DESC_GAMMA_VECTOR \
SANE_I18N("Gamma-correction table. In color mode this option equally " \
"affects the red, green, and blue channels simultaneously (i.e., it is an " \
"intensity gamma table).")
#define SANE_DESC_GAMMA_VECTOR_R \
SANE_I18N("Gamma-correction table for the red band.")
#define SANE_DESC_GAMMA_VECTOR_G \
SANE_I18N("Gamma-correction table for the green band.")
#define SANE_DESC_GAMMA_VECTOR_B \
SANE_I18N("Gamma-correction table for the blue band.")
#define SANE_DESC_BRIGHTNESS \
SANE_I18N("Controls the brightness of the acquired image.")
#define SANE_DESC_CONTRAST \
SANE_I18N("Controls the contrast of the acquired image.")
#define SANE_DESC_GRAIN_SIZE \
SANE_I18N("Selects the \"graininess\" of the acquired image. Smaller values " \
"result in sharper images.")
#define SANE_DESC_HALFTONE \
SANE_I18N("Selects whether the acquired image should be halftoned (dithered).")
#define SANE_DESC_BLACK_LEVEL \
SANE_I18N("Selects what radiance level should be considered \"black\".")
#define SANE_DESC_WHITE_LEVEL \
SANE_I18N("Selects what radiance level should be considered \"white\".")
#define SANE_DESC_SHADOW \
SANE_I18N("Selects what radiance level should be considered \"black\".")
#define SANE_DESC_SHADOW_R \
SANE_I18N("Selects what red radiance level should be considered \"black\".")
#define SANE_DESC_SHADOW_G \
SANE_I18N("Selects what green radiance level should be considered \"black\".")
#define SANE_DESC_SHADOW_B \
SANE_I18N("Selects what blue radiance level should be considered \"black\".")
#define SANE_DESC_HIGHLIGHT \
SANE_I18N("Selects what radiance level should be considered \"white\".")
#define SANE_DESC_HIGHLIGHT_R \
SANE_I18N("Selects what red radiance level should be considered \"full red\".")
#define SANE_DESC_HIGHLIGHT_G \
SANE_I18N("Selects what green radiance level should be considered \"full " \
"green\".")
#define SANE_DESC_HIGHLIGHT_B \
SANE_I18N("Selects what blue radiance level should be considered \"full " \
"blue\".")
#define SANE_DESC_HUE \
SANE_I18N("Controls the \"hue\" (blue-level) of the acquired image.")
#define SANE_DESC_SATURATION \
SANE_I18N("The saturation level controls the amount of \"blooming\" that " \
"occurs when acquiring an image with a camera. Larger values cause more " \
"blooming.")
#define SANE_DESC_FILE \
SANE_I18N("The filename of the image to be loaded.")
#define SANE_DESC_HALFTONE_DIMENSION \
SANE_I18N("Sets the size of the halftoning (dithering) pattern used when " \
"scanning halftoned images.")
#define SANE_DESC_HALFTONE_PATTERN \
SANE_I18N("Defines the halftoning (dithering) pattern for scanning " \
"halftoned images.")
#define SANE_DESC_RESOLUTION_BIND \
SANE_I18N("Use same values for X and Y resolution")
#define SANE_DESC_NEGATIVE \
SANE_I18N("Swap black and white")
#define SANE_DESC_QUALITY_CAL \
SANE_I18N("Do a quality white-calibration")
#define SANE_DESC_DOR \
SANE_I18N("Use lens that doubles optical resolution")
#define SANE_DESC_RGB_BIND \
SANE_I18N("In RGB-mode use same values for each color")
#define SANE_DESC_THRESHOLD \
SANE_I18N("Select minimum-brightness to get a white point")
#define SANE_DESC_ANALOG_GAMMA \
SANE_I18N("Analog gamma-correction")
#define SANE_DESC_ANALOG_GAMMA_R \
SANE_I18N("Analog gamma-correction for red")
#define SANE_DESC_ANALOG_GAMMA_G \
SANE_I18N("Analog gamma-correction for green")
#define SANE_DESC_ANALOG_GAMMA_B \
SANE_I18N("Analog gamma-correction for blue")
#define SANE_DESC_ANALOG_GAMMA_BIND \
SANE_I18N("In RGB-mode use same values for each color")
#define SANE_DESC_WARMUP \
SANE_I18N("Warmup lamp before scanning")
#define SANE_DESC_CAL_EXPOS_TIME \
SANE_I18N("Define exposure-time for calibration")
#define SANE_DESC_CAL_EXPOS_TIME_R \
SANE_I18N("Define exposure-time for red calibration")
#define SANE_DESC_CAL_EXPOS_TIME_G \
SANE_I18N("Define exposure-time for green calibration")
#define SANE_DESC_CAL_EXPOS_TIME_B \
SANE_I18N("Define exposure-time for blue calibration")
#define SANE_DESC_SCAN_EXPOS_TIME \
SANE_I18N("Define exposure-time for scan")
#define SANE_DESC_SCAN_EXPOS_TIME_R \
SANE_I18N("Define exposure-time for red scan")
#define SANE_DESC_SCAN_EXPOS_TIME_G \
SANE_I18N("Define exposure-time for green scan")
#define SANE_DESC_SCAN_EXPOS_TIME_B \
SANE_I18N("Define exposure-time for blue scan")
#define SANE_DESC_SELECT_EXPOSURE_TIME \
SANE_I18N("Enable selection of exposure-time")
#define SANE_DESC_CAL_LAMP_DEN \
SANE_I18N("Define lamp density for calibration")
#define SANE_DESC_SCAN_LAMP_DEN \
SANE_I18N("Define lamp density for scan")
#define SANE_DESC_SELECT_LAMP_DENSITY \
SANE_I18N("Enable selection of lamp density")
#endif /* saneopts_h */