1141cc406Sopenharmony_ci/* sane - Scanner Access Now Easy.
2141cc406Sopenharmony_ci   Copyright (C) 1996, 1997 David Mosberger-Tang and Andreas Beck
3141cc406Sopenharmony_ci   This file is part of the SANE package.
4141cc406Sopenharmony_ci
5141cc406Sopenharmony_ci   SANE is free software; you can redistribute it and/or modify it under
6141cc406Sopenharmony_ci   the terms of the GNU General Public License as published by the Free
7141cc406Sopenharmony_ci   Software Foundation; either version 2 of the License, or (at your
8141cc406Sopenharmony_ci   option) any later version.
9141cc406Sopenharmony_ci
10141cc406Sopenharmony_ci   SANE is distributed in the hope that it will be useful, but WITHOUT
11141cc406Sopenharmony_ci   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12141cc406Sopenharmony_ci   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
13141cc406Sopenharmony_ci   for more details.
14141cc406Sopenharmony_ci
15141cc406Sopenharmony_ci   You should have received a copy of the GNU General Public License
16141cc406Sopenharmony_ci   along with sane; see the file COPYING.
17141cc406Sopenharmony_ci   If not, see <https://www.gnu.org/licenses/>.
18141cc406Sopenharmony_ci
19141cc406Sopenharmony_ci   As a special exception, the authors of SANE give permission for
20141cc406Sopenharmony_ci   additional uses of the libraries contained in this release of SANE.
21141cc406Sopenharmony_ci
22141cc406Sopenharmony_ci   The exception is that, if you link a SANE library with other files
23141cc406Sopenharmony_ci   to produce an executable, this does not by itself cause the
24141cc406Sopenharmony_ci   resulting executable to be covered by the GNU General Public
25141cc406Sopenharmony_ci   License.  Your use of that executable is in no way restricted on
26141cc406Sopenharmony_ci   account of linking the SANE library code into it.
27141cc406Sopenharmony_ci
28141cc406Sopenharmony_ci   This exception does not, however, invalidate any other reasons why
29141cc406Sopenharmony_ci   the executable file might be covered by the GNU General Public
30141cc406Sopenharmony_ci   License.
31141cc406Sopenharmony_ci
32141cc406Sopenharmony_ci   If you submit changes to SANE to the maintainers to be included in
33141cc406Sopenharmony_ci   a subsequent release, you agree by submitting the changes that
34141cc406Sopenharmony_ci   those changes may be distributed with this exception intact.
35141cc406Sopenharmony_ci
36141cc406Sopenharmony_ci   If you write modifications of your own for SANE, it is your choice
37141cc406Sopenharmony_ci   whether to permit this exception to apply to your modifications.
38141cc406Sopenharmony_ci   If you do not wish that, delete this exception notice.
39141cc406Sopenharmony_ci
40141cc406Sopenharmony_ci   This file declares common option names, titles, and descriptions.  A
41141cc406Sopenharmony_ci   backend is not limited to these options but for the sake of
42141cc406Sopenharmony_ci   consistency it's better to use options declared here when appropriate.
43141cc406Sopenharmony_ci*/
44141cc406Sopenharmony_ci
45141cc406Sopenharmony_ci/* This file defines several option NAMEs, TITLEs and DESCs
46141cc406Sopenharmony_ci   that are (or should be) used by several backends.
47141cc406Sopenharmony_ci
48141cc406Sopenharmony_ci   All well known options should be listed here. But this does
49141cc406Sopenharmony_ci   not mean that all options that are listed here are well known options.
50141cc406Sopenharmony_ci   To find out if an option is a well known option and how well known
51141cc406Sopenharmony_ci   options have to be defined please take a look at the sane standard!!!
52141cc406Sopenharmony_ci */
53141cc406Sopenharmony_ci#ifndef saneopts_h
54141cc406Sopenharmony_ci#define saneopts_h
55141cc406Sopenharmony_ci
56141cc406Sopenharmony_ci#ifndef SANE_I18N
57141cc406Sopenharmony_ci#define SANE_I18N(text) text
58141cc406Sopenharmony_ci#endif
59141cc406Sopenharmony_ci
60141cc406Sopenharmony_ci/* This _must_ be the first option (index 0): */
61141cc406Sopenharmony_ci#define SANE_NAME_NUM_OPTIONS		""	/* never settable */
62141cc406Sopenharmony_ci
63141cc406Sopenharmony_ci/* The common option groups */
64141cc406Sopenharmony_ci#define SANE_NAME_STANDARD   		"standard"
65141cc406Sopenharmony_ci#define SANE_NAME_GEOMETRY   		"geometry"
66141cc406Sopenharmony_ci#define SANE_NAME_ENHANCEMENT		"enhancement"
67141cc406Sopenharmony_ci#define SANE_NAME_ADVANCED   		"advanced"
68141cc406Sopenharmony_ci#define SANE_NAME_SENSORS    		"sensors"
69141cc406Sopenharmony_ci
70141cc406Sopenharmony_ci#define SANE_NAME_PREVIEW		"preview"
71141cc406Sopenharmony_ci#define SANE_NAME_GRAY_PREVIEW		"preview-in-gray"
72141cc406Sopenharmony_ci#define SANE_NAME_BIT_DEPTH		"depth"
73141cc406Sopenharmony_ci#define SANE_NAME_SCAN_MODE		"mode"
74141cc406Sopenharmony_ci#define SANE_NAME_SCAN_SPEED		"speed"
75141cc406Sopenharmony_ci#define SANE_NAME_SCAN_SOURCE		"source"
76141cc406Sopenharmony_ci#define SANE_NAME_BACKTRACK		"backtrack"
77141cc406Sopenharmony_ci/* Most user-interfaces will let the user specify the scan area as the
78141cc406Sopenharmony_ci   top-left corner and the width/height of the scan area.  The reason
79141cc406Sopenharmony_ci   the backend interface uses the top-left/bottom-right corner is so
80141cc406Sopenharmony_ci   that the scan area values can be properly constraint independent of
81141cc406Sopenharmony_ci   any other option value.  */
82141cc406Sopenharmony_ci#define SANE_NAME_SCAN_TL_X		"tl-x"
83141cc406Sopenharmony_ci#define SANE_NAME_SCAN_TL_Y		"tl-y"
84141cc406Sopenharmony_ci#define SANE_NAME_SCAN_BR_X		"br-x"
85141cc406Sopenharmony_ci#define SANE_NAME_SCAN_BR_Y		"br-y"
86141cc406Sopenharmony_ci#define SANE_NAME_SCAN_RESOLUTION	"resolution"
87141cc406Sopenharmony_ci#define SANE_NAME_SCAN_X_RESOLUTION	"x-resolution"
88141cc406Sopenharmony_ci#define SANE_NAME_SCAN_Y_RESOLUTION	"y-resolution"
89141cc406Sopenharmony_ci#define SANE_NAME_PAGE_WIDTH  		"page-width"
90141cc406Sopenharmony_ci#define SANE_NAME_PAGE_HEIGHT 		"page-height"
91141cc406Sopenharmony_ci#define SANE_NAME_CUSTOM_GAMMA		"custom-gamma"
92141cc406Sopenharmony_ci#define SANE_NAME_GAMMA_VECTOR		"gamma-table"
93141cc406Sopenharmony_ci#define SANE_NAME_GAMMA_VECTOR_R	"red-gamma-table"
94141cc406Sopenharmony_ci#define SANE_NAME_GAMMA_VECTOR_G	"green-gamma-table"
95141cc406Sopenharmony_ci#define SANE_NAME_GAMMA_VECTOR_B	"blue-gamma-table"
96141cc406Sopenharmony_ci#define SANE_NAME_BRIGHTNESS		"brightness"
97141cc406Sopenharmony_ci#define SANE_NAME_CONTRAST		"contrast"
98141cc406Sopenharmony_ci#define SANE_NAME_GRAIN_SIZE		"grain"
99141cc406Sopenharmony_ci#define SANE_NAME_HALFTONE		"halftoning"
100141cc406Sopenharmony_ci#define SANE_NAME_BLACK_LEVEL           "black-level"
101141cc406Sopenharmony_ci#define SANE_NAME_WHITE_LEVEL           "white-level"
102141cc406Sopenharmony_ci#define SANE_NAME_WHITE_LEVEL_R         "white-level-r"
103141cc406Sopenharmony_ci#define SANE_NAME_WHITE_LEVEL_G         "white-level-g"
104141cc406Sopenharmony_ci#define SANE_NAME_WHITE_LEVEL_B         "white-level-b"
105141cc406Sopenharmony_ci#define SANE_NAME_SHADOW		"shadow"
106141cc406Sopenharmony_ci#define SANE_NAME_SHADOW_R		"shadow-r"
107141cc406Sopenharmony_ci#define SANE_NAME_SHADOW_G		"shadow-g"
108141cc406Sopenharmony_ci#define SANE_NAME_SHADOW_B		"shadow-b"
109141cc406Sopenharmony_ci#define SANE_NAME_HIGHLIGHT		"highlight"
110141cc406Sopenharmony_ci#define SANE_NAME_HIGHLIGHT_R		"highlight-r"
111141cc406Sopenharmony_ci#define SANE_NAME_HIGHLIGHT_G		"highlight-g"
112141cc406Sopenharmony_ci#define SANE_NAME_HIGHLIGHT_B		"highlight-b"
113141cc406Sopenharmony_ci#define SANE_NAME_HUE			"hue"
114141cc406Sopenharmony_ci#define SANE_NAME_SATURATION		"saturation"
115141cc406Sopenharmony_ci#define SANE_NAME_FILE			"filename"
116141cc406Sopenharmony_ci#define SANE_NAME_HALFTONE_DIMENSION	"halftone-size"
117141cc406Sopenharmony_ci#define SANE_NAME_HALFTONE_PATTERN	"halftone-pattern"
118141cc406Sopenharmony_ci#define SANE_NAME_RESOLUTION_BIND	"resolution-bind"
119141cc406Sopenharmony_ci#define SANE_NAME_NEGATIVE		"negative"
120141cc406Sopenharmony_ci#define SANE_NAME_QUALITY_CAL		"quality-cal"
121141cc406Sopenharmony_ci#define SANE_NAME_DOR			"double-res"
122141cc406Sopenharmony_ci#define SANE_NAME_RGB_BIND		"rgb-bind"
123141cc406Sopenharmony_ci#define SANE_NAME_THRESHOLD		"threshold"
124141cc406Sopenharmony_ci#define SANE_NAME_ANALOG_GAMMA		"analog-gamma"
125141cc406Sopenharmony_ci#define SANE_NAME_ANALOG_GAMMA_R	"analog-gamma-r"
126141cc406Sopenharmony_ci#define SANE_NAME_ANALOG_GAMMA_G	"analog-gamma-g"
127141cc406Sopenharmony_ci#define SANE_NAME_ANALOG_GAMMA_B	"analog-gamma-b"
128141cc406Sopenharmony_ci#define SANE_NAME_ANALOG_GAMMA_BIND	"analog-gamma-bind"
129141cc406Sopenharmony_ci#define SANE_NAME_WARMUP		"warmup"
130141cc406Sopenharmony_ci#define SANE_NAME_CAL_EXPOS_TIME	"cal-exposure-time"
131141cc406Sopenharmony_ci#define SANE_NAME_CAL_EXPOS_TIME_R	"cal-exposure-time-r"
132141cc406Sopenharmony_ci#define SANE_NAME_CAL_EXPOS_TIME_G	"cal-exposure-time-g"
133141cc406Sopenharmony_ci#define SANE_NAME_CAL_EXPOS_TIME_B	"cal-exposure-time-b"
134141cc406Sopenharmony_ci#define SANE_NAME_SCAN_EXPOS_TIME	"scan-exposure-time"
135141cc406Sopenharmony_ci#define SANE_NAME_SCAN_EXPOS_TIME_R	"scan-exposure-time-r"
136141cc406Sopenharmony_ci#define SANE_NAME_SCAN_EXPOS_TIME_G	"scan-exposure-time-g"
137141cc406Sopenharmony_ci#define SANE_NAME_SCAN_EXPOS_TIME_B	"scan-exposure-time-b"
138141cc406Sopenharmony_ci#define SANE_NAME_SELECT_EXPOSURE_TIME	"select-exposure-time"
139141cc406Sopenharmony_ci#define SANE_NAME_CAL_LAMP_DEN		"cal-lamp-density"
140141cc406Sopenharmony_ci#define SANE_NAME_SCAN_LAMP_DEN		"scan-lamp-density"
141141cc406Sopenharmony_ci#define SANE_NAME_SELECT_LAMP_DENSITY	"select-lamp-density"
142141cc406Sopenharmony_ci#define SANE_NAME_LAMP_OFF_AT_EXIT	"lamp-off-at-exit"
143141cc406Sopenharmony_ci#define SANE_NAME_FOCUS			"focus"
144141cc406Sopenharmony_ci#define SANE_NAME_AUTOFOCUS		"autofocus"
145141cc406Sopenharmony_ci
146141cc406Sopenharmony_ci/* well known options from 'SENSORS' group*/
147141cc406Sopenharmony_ci#define SANE_NAME_SCAN			"scan"
148141cc406Sopenharmony_ci#define SANE_NAME_EMAIL			"email"
149141cc406Sopenharmony_ci#define SANE_NAME_FAX			"fax"
150141cc406Sopenharmony_ci#define SANE_NAME_COPY			"copy"
151141cc406Sopenharmony_ci#define SANE_NAME_PDF			"pdf"
152141cc406Sopenharmony_ci#define SANE_NAME_CANCEL		"cancel"
153141cc406Sopenharmony_ci#define SANE_NAME_PAGE_LOADED		"page-loaded"
154141cc406Sopenharmony_ci#define SANE_NAME_COVER_OPEN		"cover-open"
155141cc406Sopenharmony_ci
156141cc406Sopenharmony_ci#define SANE_TITLE_NUM_OPTIONS		SANE_I18N("Number of options")
157141cc406Sopenharmony_ci
158141cc406Sopenharmony_ci#define SANE_TITLE_STANDARD   		SANE_I18N("Standard")
159141cc406Sopenharmony_ci#define SANE_TITLE_GEOMETRY   		SANE_I18N("Geometry")
160141cc406Sopenharmony_ci#define SANE_TITLE_ENHANCEMENT		SANE_I18N("Enhancement")
161141cc406Sopenharmony_ci#define SANE_TITLE_ADVANCED   		SANE_I18N("Advanced")
162141cc406Sopenharmony_ci#define SANE_TITLE_SENSORS    		SANE_I18N("Sensors")
163141cc406Sopenharmony_ci
164141cc406Sopenharmony_ci#define SANE_TITLE_PREVIEW		SANE_I18N("Preview")
165141cc406Sopenharmony_ci#define SANE_TITLE_GRAY_PREVIEW		SANE_I18N("Force monochrome preview")
166141cc406Sopenharmony_ci#define SANE_TITLE_BIT_DEPTH		SANE_I18N("Bit depth")
167141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_MODE		SANE_I18N("Scan mode")
168141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_SPEED		SANE_I18N("Scan speed")
169141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_SOURCE		SANE_I18N("Scan source")
170141cc406Sopenharmony_ci#define SANE_TITLE_BACKTRACK		SANE_I18N("Force backtracking")
171141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_TL_X		SANE_I18N("Top-left x")
172141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_TL_Y		SANE_I18N("Top-left y")
173141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_BR_X		SANE_I18N("Bottom-right x")
174141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_BR_Y		SANE_I18N("Bottom-right y")
175141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_RESOLUTION	SANE_I18N("Scan resolution")
176141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_X_RESOLUTION	SANE_I18N("X-resolution")
177141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_Y_RESOLUTION	SANE_I18N("Y-resolution")
178141cc406Sopenharmony_ci#define SANE_TITLE_PAGE_WIDTH  		SANE_I18N("Page width")
179141cc406Sopenharmony_ci#define SANE_TITLE_PAGE_HEIGHT 		SANE_I18N("Page height")
180141cc406Sopenharmony_ci#define SANE_TITLE_CUSTOM_GAMMA		SANE_I18N("Use custom gamma table")
181141cc406Sopenharmony_ci#define SANE_TITLE_GAMMA_VECTOR		SANE_I18N("Image intensity")
182141cc406Sopenharmony_ci#define SANE_TITLE_GAMMA_VECTOR_R	SANE_I18N("Red intensity")
183141cc406Sopenharmony_ci#define SANE_TITLE_GAMMA_VECTOR_G	SANE_I18N("Green intensity")
184141cc406Sopenharmony_ci#define SANE_TITLE_GAMMA_VECTOR_B	SANE_I18N("Blue intensity")
185141cc406Sopenharmony_ci#define SANE_TITLE_BRIGHTNESS		SANE_I18N("Brightness")
186141cc406Sopenharmony_ci#define SANE_TITLE_CONTRAST		SANE_I18N("Contrast")
187141cc406Sopenharmony_ci#define SANE_TITLE_GRAIN_SIZE		SANE_I18N("Grain size")
188141cc406Sopenharmony_ci#define SANE_TITLE_HALFTONE		SANE_I18N("Halftoning")
189141cc406Sopenharmony_ci#define SANE_TITLE_BLACK_LEVEL          SANE_I18N("Black level")
190141cc406Sopenharmony_ci#define SANE_TITLE_WHITE_LEVEL          SANE_I18N("White level")
191141cc406Sopenharmony_ci#define SANE_TITLE_WHITE_LEVEL_R        SANE_I18N("White level for red")
192141cc406Sopenharmony_ci#define SANE_TITLE_WHITE_LEVEL_G        SANE_I18N("White level for green")
193141cc406Sopenharmony_ci#define SANE_TITLE_WHITE_LEVEL_B        SANE_I18N("White level for blue")
194141cc406Sopenharmony_ci#define SANE_TITLE_SHADOW		SANE_I18N("Shadow")
195141cc406Sopenharmony_ci#define SANE_TITLE_SHADOW_R		SANE_I18N("Shadow for red")
196141cc406Sopenharmony_ci#define SANE_TITLE_SHADOW_G		SANE_I18N("Shadow for green")
197141cc406Sopenharmony_ci#define SANE_TITLE_SHADOW_B		SANE_I18N("Shadow for blue")
198141cc406Sopenharmony_ci#define SANE_TITLE_HIGHLIGHT		SANE_I18N("Highlight")
199141cc406Sopenharmony_ci#define SANE_TITLE_HIGHLIGHT_R		SANE_I18N("Highlight for red")
200141cc406Sopenharmony_ci#define SANE_TITLE_HIGHLIGHT_G		SANE_I18N("Highlight for green")
201141cc406Sopenharmony_ci#define SANE_TITLE_HIGHLIGHT_B		SANE_I18N("Highlight for blue")
202141cc406Sopenharmony_ci#define SANE_TITLE_HUE			SANE_I18N("Hue")
203141cc406Sopenharmony_ci#define SANE_TITLE_SATURATION		SANE_I18N("Saturation")
204141cc406Sopenharmony_ci#define SANE_TITLE_FILE			SANE_I18N("Filename")
205141cc406Sopenharmony_ci#define SANE_TITLE_HALFTONE_DIMENSION	SANE_I18N("Halftone pattern size")
206141cc406Sopenharmony_ci#define SANE_TITLE_HALFTONE_PATTERN	SANE_I18N("Halftone pattern")
207141cc406Sopenharmony_ci#define SANE_TITLE_RESOLUTION_BIND	SANE_I18N("Bind X and Y resolution")
208141cc406Sopenharmony_ci#define SANE_TITLE_NEGATIVE		SANE_I18N("Negative")
209141cc406Sopenharmony_ci#define SANE_TITLE_QUALITY_CAL		SANE_I18N("Quality calibration")
210141cc406Sopenharmony_ci#define SANE_TITLE_DOR			SANE_I18N("Double Optical Resolution")
211141cc406Sopenharmony_ci#define SANE_TITLE_RGB_BIND		SANE_I18N("Bind RGB")
212141cc406Sopenharmony_ci#define SANE_TITLE_THRESHOLD		SANE_I18N("Threshold")
213141cc406Sopenharmony_ci#define SANE_TITLE_ANALOG_GAMMA		SANE_I18N("Analog gamma correction")
214141cc406Sopenharmony_ci#define SANE_TITLE_ANALOG_GAMMA_R	SANE_I18N("Analog gamma red")
215141cc406Sopenharmony_ci#define SANE_TITLE_ANALOG_GAMMA_G	SANE_I18N("Analog gamma green")
216141cc406Sopenharmony_ci#define SANE_TITLE_ANALOG_GAMMA_B	SANE_I18N("Analog gamma blue")
217141cc406Sopenharmony_ci#define SANE_TITLE_ANALOG_GAMMA_BIND    SANE_I18N("Bind analog gamma")
218141cc406Sopenharmony_ci#define SANE_TITLE_WARMUP		SANE_I18N("Warmup lamp")
219141cc406Sopenharmony_ci#define SANE_TITLE_CAL_EXPOS_TIME	SANE_I18N("Cal. exposure-time")
220141cc406Sopenharmony_ci#define SANE_TITLE_CAL_EXPOS_TIME_R	SANE_I18N("Cal. exposure-time for red")
221141cc406Sopenharmony_ci#define SANE_TITLE_CAL_EXPOS_TIME_G	SANE_I18N("Cal. exposure-time for " \
222141cc406Sopenharmony_ci"green")
223141cc406Sopenharmony_ci#define SANE_TITLE_CAL_EXPOS_TIME_B	SANE_I18N("Cal. exposure-time for blue")
224141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_EXPOS_TIME	SANE_I18N("Scan exposure-time")
225141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_EXPOS_TIME_R	SANE_I18N("Scan exposure-time for red")
226141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_EXPOS_TIME_G	SANE_I18N("Scan exposure-time for " \
227141cc406Sopenharmony_ci"green")
228141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_EXPOS_TIME_B	SANE_I18N("Scan exposure-time for blue")
229141cc406Sopenharmony_ci#define SANE_TITLE_SELECT_EXPOSURE_TIME	SANE_I18N("Set exposure-time")
230141cc406Sopenharmony_ci#define SANE_TITLE_CAL_LAMP_DEN		SANE_I18N("Cal. lamp density")
231141cc406Sopenharmony_ci#define SANE_TITLE_SCAN_LAMP_DEN	SANE_I18N("Scan lamp density")
232141cc406Sopenharmony_ci#define SANE_TITLE_SELECT_LAMP_DENSITY	SANE_I18N("Set lamp density")
233141cc406Sopenharmony_ci#define SANE_TITLE_LAMP_OFF_AT_EXIT	SANE_I18N("Lamp off at exit")
234141cc406Sopenharmony_ci#define SANE_TITLE_FOCUS		SANE_I18N("Focus position")
235141cc406Sopenharmony_ci#define SANE_TITLE_AUTOFOCUS		SANE_I18N("Autofocus")
236141cc406Sopenharmony_ci
237141cc406Sopenharmony_ci/* well known options from 'SENSORS' group*/
238141cc406Sopenharmony_ci#define SANE_TITLE_SCAN			"Scan button"
239141cc406Sopenharmony_ci#define SANE_TITLE_EMAIL		"Email button"
240141cc406Sopenharmony_ci#define SANE_TITLE_FAX			"Fax button"
241141cc406Sopenharmony_ci#define SANE_TITLE_COPY			"Copy button"
242141cc406Sopenharmony_ci#define SANE_TITLE_PDF			"PDF button"
243141cc406Sopenharmony_ci#define SANE_TITLE_CANCEL		"Cancel button"
244141cc406Sopenharmony_ci#define SANE_TITLE_PAGE_LOADED		"Page loaded"
245141cc406Sopenharmony_ci#define SANE_TITLE_COVER_OPEN		"Cover open"
246141cc406Sopenharmony_ci
247141cc406Sopenharmony_ci/* Descriptive/help strings for above options: */
248141cc406Sopenharmony_ci#define SANE_DESC_NUM_OPTIONS \
249141cc406Sopenharmony_ciSANE_I18N("Read-only option that specifies how many options a specific " \
250141cc406Sopenharmony_ci"device supports.")
251141cc406Sopenharmony_ci
252141cc406Sopenharmony_ci#define SANE_DESC_STANDARD    SANE_I18N("Source, mode and resolution options")
253141cc406Sopenharmony_ci#define SANE_DESC_GEOMETRY    SANE_I18N("Scan area and media size options")
254141cc406Sopenharmony_ci#define SANE_DESC_ENHANCEMENT SANE_I18N("Image modification options")
255141cc406Sopenharmony_ci#define SANE_DESC_ADVANCED    SANE_I18N("Hardware specific options")
256141cc406Sopenharmony_ci#define SANE_DESC_SENSORS     SANE_I18N("Scanner sensors and buttons")
257141cc406Sopenharmony_ci
258141cc406Sopenharmony_ci#define SANE_DESC_PREVIEW \
259141cc406Sopenharmony_ciSANE_I18N("Request a preview-quality scan.")
260141cc406Sopenharmony_ci
261141cc406Sopenharmony_ci#define SANE_DESC_GRAY_PREVIEW \
262141cc406Sopenharmony_ciSANE_I18N("Request that all previews are done in monochrome mode.  On a " \
263141cc406Sopenharmony_ci"three-pass scanner this cuts down the number of passes to one and on a " \
264141cc406Sopenharmony_ci"one-pass scanner, it reduces the memory requirements and scan-time of the " \
265141cc406Sopenharmony_ci"preview.")
266141cc406Sopenharmony_ci
267141cc406Sopenharmony_ci#define SANE_DESC_BIT_DEPTH \
268141cc406Sopenharmony_ciSANE_I18N("Number of bits per sample, typical values are 1 for \"line-art\" " \
269141cc406Sopenharmony_ci"and 8 for multibit scans.")
270141cc406Sopenharmony_ci
271141cc406Sopenharmony_ci#define SANE_DESC_SCAN_MODE \
272141cc406Sopenharmony_ciSANE_I18N("Selects the scan mode (e.g., lineart, monochrome, or color).")
273141cc406Sopenharmony_ci
274141cc406Sopenharmony_ci#define SANE_DESC_SCAN_SPEED \
275141cc406Sopenharmony_ciSANE_I18N("Determines the speed at which the scan proceeds.")
276141cc406Sopenharmony_ci
277141cc406Sopenharmony_ci#define SANE_DESC_SCAN_SOURCE \
278141cc406Sopenharmony_ciSANE_I18N("Selects the scan source (such as a document-feeder).")
279141cc406Sopenharmony_ci
280141cc406Sopenharmony_ci#define SANE_DESC_BACKTRACK \
281141cc406Sopenharmony_ciSANE_I18N("Controls whether backtracking is forced.")
282141cc406Sopenharmony_ci
283141cc406Sopenharmony_ci#define SANE_DESC_SCAN_TL_X \
284141cc406Sopenharmony_ciSANE_I18N("Top-left x position of scan area.")
285141cc406Sopenharmony_ci
286141cc406Sopenharmony_ci#define SANE_DESC_SCAN_TL_Y \
287141cc406Sopenharmony_ciSANE_I18N("Top-left y position of scan area.")
288141cc406Sopenharmony_ci
289141cc406Sopenharmony_ci#define SANE_DESC_SCAN_BR_X \
290141cc406Sopenharmony_ciSANE_I18N("Bottom-right x position of scan area.")
291141cc406Sopenharmony_ci
292141cc406Sopenharmony_ci#define SANE_DESC_SCAN_BR_Y \
293141cc406Sopenharmony_ciSANE_I18N("Bottom-right y position of scan area.")
294141cc406Sopenharmony_ci
295141cc406Sopenharmony_ci#define SANE_DESC_SCAN_RESOLUTION \
296141cc406Sopenharmony_ciSANE_I18N("Sets the resolution of the scanned image.")
297141cc406Sopenharmony_ci
298141cc406Sopenharmony_ci#define SANE_DESC_SCAN_X_RESOLUTION \
299141cc406Sopenharmony_ciSANE_I18N("Sets the horizontal resolution of the scanned image.")
300141cc406Sopenharmony_ci
301141cc406Sopenharmony_ci#define SANE_DESC_SCAN_Y_RESOLUTION \
302141cc406Sopenharmony_ciSANE_I18N("Sets the vertical resolution of the scanned image.")
303141cc406Sopenharmony_ci
304141cc406Sopenharmony_ci#define SANE_DESC_PAGE_WIDTH \
305141cc406Sopenharmony_ciSANE_I18N("Specifies the width of the media.  Required for automatic " \
306141cc406Sopenharmony_ci"centering of sheet-fed scans.")
307141cc406Sopenharmony_ci
308141cc406Sopenharmony_ci#define SANE_DESC_PAGE_HEIGHT \
309141cc406Sopenharmony_ciSANE_I18N("Specifies the height of the media.")
310141cc406Sopenharmony_ci
311141cc406Sopenharmony_ci#define SANE_DESC_CUSTOM_GAMMA \
312141cc406Sopenharmony_ciSANE_I18N("Determines whether a builtin or a custom gamma-table should be " \
313141cc406Sopenharmony_ci"used.")
314141cc406Sopenharmony_ci
315141cc406Sopenharmony_ci#define SANE_DESC_GAMMA_VECTOR \
316141cc406Sopenharmony_ciSANE_I18N("Gamma-correction table.  In color mode this option equally " \
317141cc406Sopenharmony_ci"affects the red, green, and blue channels simultaneously (i.e., it is an " \
318141cc406Sopenharmony_ci"intensity gamma table).")
319141cc406Sopenharmony_ci
320141cc406Sopenharmony_ci#define SANE_DESC_GAMMA_VECTOR_R \
321141cc406Sopenharmony_ciSANE_I18N("Gamma-correction table for the red band.")
322141cc406Sopenharmony_ci
323141cc406Sopenharmony_ci#define SANE_DESC_GAMMA_VECTOR_G \
324141cc406Sopenharmony_ciSANE_I18N("Gamma-correction table for the green band.")
325141cc406Sopenharmony_ci
326141cc406Sopenharmony_ci#define SANE_DESC_GAMMA_VECTOR_B \
327141cc406Sopenharmony_ciSANE_I18N("Gamma-correction table for the blue band.")
328141cc406Sopenharmony_ci
329141cc406Sopenharmony_ci#define SANE_DESC_BRIGHTNESS \
330141cc406Sopenharmony_ciSANE_I18N("Controls the brightness of the acquired image.")
331141cc406Sopenharmony_ci
332141cc406Sopenharmony_ci#define SANE_DESC_CONTRAST \
333141cc406Sopenharmony_ciSANE_I18N("Controls the contrast of the acquired image.")
334141cc406Sopenharmony_ci
335141cc406Sopenharmony_ci#define SANE_DESC_GRAIN_SIZE \
336141cc406Sopenharmony_ciSANE_I18N("Selects the \"graininess\" of the acquired image.  Smaller values " \
337141cc406Sopenharmony_ci"result in sharper images.")
338141cc406Sopenharmony_ci
339141cc406Sopenharmony_ci#define SANE_DESC_HALFTONE \
340141cc406Sopenharmony_ciSANE_I18N("Selects whether the acquired image should be halftoned (dithered).")
341141cc406Sopenharmony_ci
342141cc406Sopenharmony_ci#define SANE_DESC_BLACK_LEVEL \
343141cc406Sopenharmony_ciSANE_I18N("Selects what radiance level should be considered \"black\".")
344141cc406Sopenharmony_ci
345141cc406Sopenharmony_ci#define SANE_DESC_WHITE_LEVEL \
346141cc406Sopenharmony_ciSANE_I18N("Selects what radiance level should be considered \"white\".")
347141cc406Sopenharmony_ci
348141cc406Sopenharmony_ci#define SANE_DESC_WHITE_LEVEL_R \
349141cc406Sopenharmony_ciSANE_I18N("Selects what red radiance level should be considered \"white\".")
350141cc406Sopenharmony_ci
351141cc406Sopenharmony_ci#define SANE_DESC_WHITE_LEVEL_G \
352141cc406Sopenharmony_ciSANE_I18N("Selects what green radiance level should be considered \"white\".")
353141cc406Sopenharmony_ci
354141cc406Sopenharmony_ci#define SANE_DESC_WHITE_LEVEL_B \
355141cc406Sopenharmony_ciSANE_I18N("Selects what blue radiance level should be considered \"white\".")
356141cc406Sopenharmony_ci
357141cc406Sopenharmony_ci#define SANE_DESC_SHADOW \
358141cc406Sopenharmony_ciSANE_I18N("Selects what radiance level should be considered \"black\".")
359141cc406Sopenharmony_ci#define SANE_DESC_SHADOW_R \
360141cc406Sopenharmony_ciSANE_I18N("Selects what red radiance level should be considered \"black\".")
361141cc406Sopenharmony_ci#define SANE_DESC_SHADOW_G \
362141cc406Sopenharmony_ciSANE_I18N("Selects what green radiance level should be considered \"black\".")
363141cc406Sopenharmony_ci#define SANE_DESC_SHADOW_B \
364141cc406Sopenharmony_ciSANE_I18N("Selects what blue radiance level should be considered \"black\".")
365141cc406Sopenharmony_ci
366141cc406Sopenharmony_ci#define SANE_DESC_HIGHLIGHT \
367141cc406Sopenharmony_ciSANE_I18N("Selects what radiance level should be considered \"white\".")
368141cc406Sopenharmony_ci#define SANE_DESC_HIGHLIGHT_R \
369141cc406Sopenharmony_ciSANE_I18N("Selects what red radiance level should be considered \"full red\".")
370141cc406Sopenharmony_ci#define SANE_DESC_HIGHLIGHT_G \
371141cc406Sopenharmony_ciSANE_I18N("Selects what green radiance level should be considered \"full " \
372141cc406Sopenharmony_ci"green\".")
373141cc406Sopenharmony_ci#define SANE_DESC_HIGHLIGHT_B \
374141cc406Sopenharmony_ciSANE_I18N("Selects what blue radiance level should be considered \"full " \
375141cc406Sopenharmony_ci"blue\".")
376141cc406Sopenharmony_ci
377141cc406Sopenharmony_ci#define SANE_DESC_HUE \
378141cc406Sopenharmony_ciSANE_I18N("Controls the \"hue\" (blue-level) of the acquired image.")
379141cc406Sopenharmony_ci
380141cc406Sopenharmony_ci#define SANE_DESC_SATURATION \
381141cc406Sopenharmony_ciSANE_I18N("The saturation level controls the amount of \"blooming\" that " \
382141cc406Sopenharmony_ci"occurs when acquiring an image with a camera. Larger values cause more " \
383141cc406Sopenharmony_ci"blooming.")
384141cc406Sopenharmony_ci
385141cc406Sopenharmony_ci#define SANE_DESC_FILE \
386141cc406Sopenharmony_ciSANE_I18N("The filename of the image to be loaded.")
387141cc406Sopenharmony_ci
388141cc406Sopenharmony_ci#define SANE_DESC_HALFTONE_DIMENSION \
389141cc406Sopenharmony_ciSANE_I18N("Sets the size of the halftoning (dithering) pattern used when " \
390141cc406Sopenharmony_ci"scanning halftoned images.")
391141cc406Sopenharmony_ci
392141cc406Sopenharmony_ci#define SANE_DESC_HALFTONE_PATTERN \
393141cc406Sopenharmony_ciSANE_I18N("Defines the halftoning (dithering) pattern for scanning " \
394141cc406Sopenharmony_ci"halftoned images.")
395141cc406Sopenharmony_ci
396141cc406Sopenharmony_ci#define SANE_DESC_RESOLUTION_BIND \
397141cc406Sopenharmony_ciSANE_I18N("Use same values for X and Y resolution")
398141cc406Sopenharmony_ci#define SANE_DESC_NEGATIVE \
399141cc406Sopenharmony_ciSANE_I18N("Swap black and white")
400141cc406Sopenharmony_ci#define SANE_DESC_QUALITY_CAL \
401141cc406Sopenharmony_ciSANE_I18N("Do a quality white-calibration")
402141cc406Sopenharmony_ci#define SANE_DESC_DOR \
403141cc406Sopenharmony_ciSANE_I18N("Use lens that doubles optical resolution")
404141cc406Sopenharmony_ci#define SANE_DESC_RGB_BIND \
405141cc406Sopenharmony_ciSANE_I18N("In RGB-mode use same values for each color")
406141cc406Sopenharmony_ci#define SANE_DESC_THRESHOLD \
407141cc406Sopenharmony_ciSANE_I18N("Select minimum-brightness to get a white point")
408141cc406Sopenharmony_ci#define SANE_DESC_ANALOG_GAMMA \
409141cc406Sopenharmony_ciSANE_I18N("Analog gamma-correction")
410141cc406Sopenharmony_ci#define SANE_DESC_ANALOG_GAMMA_R \
411141cc406Sopenharmony_ciSANE_I18N("Analog gamma-correction for red")
412141cc406Sopenharmony_ci#define SANE_DESC_ANALOG_GAMMA_G \
413141cc406Sopenharmony_ciSANE_I18N("Analog gamma-correction for green")
414141cc406Sopenharmony_ci#define SANE_DESC_ANALOG_GAMMA_B \
415141cc406Sopenharmony_ciSANE_I18N("Analog gamma-correction for blue")
416141cc406Sopenharmony_ci#define SANE_DESC_ANALOG_GAMMA_BIND \
417141cc406Sopenharmony_ciSANE_I18N("In RGB-mode use same values for each color")
418141cc406Sopenharmony_ci#define SANE_DESC_WARMUP \
419141cc406Sopenharmony_ciSANE_I18N("Warm up lamp before scanning")
420141cc406Sopenharmony_ci#define SANE_DESC_CAL_EXPOS_TIME \
421141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for calibration")
422141cc406Sopenharmony_ci#define SANE_DESC_CAL_EXPOS_TIME_R \
423141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for red calibration")
424141cc406Sopenharmony_ci#define SANE_DESC_CAL_EXPOS_TIME_G \
425141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for green calibration")
426141cc406Sopenharmony_ci#define SANE_DESC_CAL_EXPOS_TIME_B \
427141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for blue calibration")
428141cc406Sopenharmony_ci#define SANE_DESC_SCAN_EXPOS_TIME \
429141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for scan")
430141cc406Sopenharmony_ci#define SANE_DESC_SCAN_EXPOS_TIME_R \
431141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for red scan")
432141cc406Sopenharmony_ci#define SANE_DESC_SCAN_EXPOS_TIME_G \
433141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for green scan")
434141cc406Sopenharmony_ci#define SANE_DESC_SCAN_EXPOS_TIME_B \
435141cc406Sopenharmony_ciSANE_I18N("Define exposure-time for blue scan")
436141cc406Sopenharmony_ci#define SANE_DESC_SELECT_EXPOSURE_TIME \
437141cc406Sopenharmony_ciSANE_I18N("Enable selection of exposure-time")
438141cc406Sopenharmony_ci#define SANE_DESC_CAL_LAMP_DEN \
439141cc406Sopenharmony_ciSANE_I18N("Define lamp density for calibration")
440141cc406Sopenharmony_ci#define SANE_DESC_SCAN_LAMP_DEN \
441141cc406Sopenharmony_ciSANE_I18N("Define lamp density for scan")
442141cc406Sopenharmony_ci#define SANE_DESC_SELECT_LAMP_DENSITY \
443141cc406Sopenharmony_ciSANE_I18N("Enable selection of lamp density")
444141cc406Sopenharmony_ci#define SANE_DESC_LAMP_OFF_AT_EXIT \
445141cc406Sopenharmony_ciSANE_I18N("Turn off lamp when program exits")
446141cc406Sopenharmony_ci#define SANE_DESC_FOCUS \
447141cc406Sopenharmony_ciSANE_I18N("Focus position for manual focus")
448141cc406Sopenharmony_ci#define SANE_DESC_AUTOFOCUS \
449141cc406Sopenharmony_ciSANE_I18N("Perform autofocus before scan")
450141cc406Sopenharmony_ci
451141cc406Sopenharmony_ci/* well known options from 'SENSORS' group*/
452141cc406Sopenharmony_ci#define SANE_DESC_SCAN		SANE_I18N("Scan button")
453141cc406Sopenharmony_ci#define SANE_DESC_EMAIL		SANE_I18N("Email button")
454141cc406Sopenharmony_ci#define SANE_DESC_FAX		SANE_I18N("Fax button")
455141cc406Sopenharmony_ci#define SANE_DESC_COPY		SANE_I18N("Copy button")
456141cc406Sopenharmony_ci#define SANE_DESC_PDF		SANE_I18N("PDF button")
457141cc406Sopenharmony_ci#define SANE_DESC_CANCEL	SANE_I18N("Cancel button")
458141cc406Sopenharmony_ci#define SANE_DESC_PAGE_LOADED	SANE_I18N("Page loaded")
459141cc406Sopenharmony_ci#define SANE_DESC_COVER_OPEN	SANE_I18N("Cover open")
460141cc406Sopenharmony_ci
461141cc406Sopenharmony_ci/* Typical values for stringlists (to keep the backends consistent) */
462141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_COLOR		SANE_I18N("Color")
463141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_COLOR_LINEART	SANE_I18N("Color Lineart")
464141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_COLOR_HALFTONE     SANE_I18N("Color Halftone")
465141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_GRAY		SANE_I18N("Gray")
466141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_HALFTONE           SANE_I18N("Halftone")
467141cc406Sopenharmony_ci#define SANE_VALUE_SCAN_MODE_LINEART		SANE_I18N("Lineart")
468141cc406Sopenharmony_ci
469141cc406Sopenharmony_ci#endif /* saneopts_h */
470