Initial import of sane-backends version 1.0.24-1.2

1 files changed, 1166 insertions, 0 deletions

diff --git a/japi/Jscanimage.java b/japi/Jscanimage.java
new file mode 100644
index 0000000..d3ab32d
--- /dev/null
+++ b/japi/Jscanimage.java
@@ -0,0 +1,1166 @@
+/* sane - Scanner Access Now Easy.
+   Copyright (C) 1997 Jeffrey S. Freedman
+   This file is part of the SANE package.
+
+   This program 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.
+
+   This program 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 this program; if not, write to the Free Software
+   Foundation, Inc., 59 Temple Place - Suite 330, Boston,
+   MA 02111-1307, USA.
+
+   As a special exception, the authors of SANE give permission for
+   additional uses of the libraries contained in this release of SANE.
+
+   The exception is that, if you link a SANE library with other files
+   to produce an executable, this does not by itself cause the
+   resulting executable to be covered by the GNU General Public
+   License.  Your use of that executable is in no way restricted on
+   account of linking the SANE library code into it.
+
+   This exception does not, however, invalidate any other reasons why
+   the executable file might be covered by the GNU General Public
+   License.
+
+   If you submit changes to SANE to the maintainers to be included in
+   a subsequent release, you agree by submitting the changes that
+   those changes may be distributed with this exception intact.
+
+   If you write modifications of your own for SANE, it is your choice
+   whether to permit this exception to apply to your modifications.
+   If you do not wish that, delete this exception notice.  */
+
+/**
+ **	Jscanimage.java - Java scanner program using SANE.
+ **
+ **	Written: 10/31/97 - JSF
+ **/
+
+import java.awt.*;
+import java.awt.event.*;
+import java.util.*;
+import java.awt.image.ImageConsumer;
+import java.awt.image.ColorModel;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.text.NumberFormat;
+import javax.swing.*;
+import javax.swing.border.*;
+import javax.swing.event.*;
+
+/*
+ *	Main program.
+ */
+public class Jscanimage extends Frame implements WindowListener,
+			ActionListener, ItemListener, ImageCanvasClient
+    {
+    //
+    //	Static data.
+    //
+    private static Sane sane;		// The main class.
+    private static SaneDevice devList[];// List of devices.
+    //
+    //	Instance data.
+    //
+    private Font font;			// For dialog items.
+    private int saneHandle;		// Handle of open device.
+    private ScanIt scanIt = null;	// Does the actual scan.
+					// File to output to.
+    private FileOutputStream outFile = null;
+    private String outDir = null;	// Stores dir. for output dialog.
+    private Vector controls;		// Dialog components for SANE controls.
+    private double unitLength = 1;	// # of mm for units to display
+					//    (mm = 1, cm = 10, in = 25.4).
+    private ImageCanvas imageDisplay = null;
+					// "Scan", "Preview" buttons.
+    private JButton scanButton, previewButton;
+    private JButton browseButton;	// For choosing output filename.
+    private JTextField outputField;	// Field for output filename.
+    private MenuItem exitMenuItem;	// Menu items.
+    private CheckboxMenuItem toolTipsMenuItem;
+    private CheckboxMenuItem mmMenuItem;
+    private CheckboxMenuItem cmMenuItem;
+    private CheckboxMenuItem inMenuItem;
+
+	/*
+	 *	Main program.
+	 */
+    public static void main(String args[])
+	{
+	if (!initSane())		// Initialize SANE.
+		return;
+	Jscanimage prog = new Jscanimage();
+	prog.pack();
+	prog.show();
+	}
+
+	/*
+	 *	Create main window.
+	 */
+    public Jscanimage()
+	{
+	super("SANE Scanimage");
+	addWindowListener(this);
+					// Open SANE device.
+	saneHandle = initSaneDevice(devList[0].name);
+	if (saneHandle == 0)
+		System.exit(-1);
+					// Create scanner class.
+	scanIt = new ScanIt(sane, saneHandle);
+	init();
+	}
+
+	/*
+	 *	Clean up.
+	 */
+    public void finalize()
+	{
+	if (sane != null)
+		{
+		if (saneHandle != 0)
+			sane.close(saneHandle);
+		sane.exit();
+		sane = null;
+		}
+	saneHandle = 0;
+	if (outFile != null)
+		{
+		try
+			{
+			outFile.close();
+			}
+		catch (IOException e)
+			{ }
+		outFile = null;
+		}
+	System.out.println("In finalize()");
+	}
+
+	/*
+	 *	Return info.
+	 */
+    public Sane getSane()
+	{ return sane; }
+    public int getSaneHandle()
+	{ return saneHandle; }
+    public double getUnitLength()
+	{ return unitLength; }
+
+	/*
+	 *	Initialize SANE.
+	 */
+    private static boolean initSane()
+	{
+	sane = new Sane();
+	int version[] = new int[1];	// Array to get version #.
+	int status = sane.init(version);
+	if (status != Sane.STATUS_GOOD)
+		{
+		System.out.println("getDevices() failed.  Status= " + status);
+		return (false);
+		}
+					// Get list of devices.
+					// Allocate room for 50.
+	devList = new SaneDevice[50];
+	status = sane.getDevices(devList, false);
+	if (status != Sane.STATUS_GOOD)
+		{
+		System.out.println("getDevices() failed.  Status= " + status);
+		return (false);
+		}
+	for (int i = 0; i < 50 && devList[i] != null; i++)
+		{
+		System.out.println("Device '" + devList[i].name + "' is a " +
+			devList[i].vendor + " " + devList[i].model + " " +
+			devList[i].type);
+		}
+	return (true);
+	}
+
+	/*
+	 *	Open device.
+	 *
+	 *	Output:	Handle, or 0 if error.
+	 */
+    private int initSaneDevice(String name)
+	{
+	int handle[] = new int[1];
+					// Open 1st device, for now.
+	int status = sane.open(name, handle);
+	if (status != Sane.STATUS_GOOD)
+		{
+		System.out.println("open() failed.  Status= " + status);
+		return (0);
+		}
+	setTitle("SANE - " + name);
+	System.out.println("Open handle=" + handle[0]);
+	return (handle[0]);
+	}
+
+	/*
+	 *	Add a labeled option to the main dialog.
+	 */
+    private void addLabeledOption(JPanel group, String title, Component opt,
+						GridBagConstraints c)
+	{
+	JLabel label = new JLabel(title);
+	c.gridwidth = GridBagConstraints.RELATIVE;
+	c.fill = GridBagConstraints.NONE;
+	c.anchor = GridBagConstraints.WEST;
+	c.weightx = .1;
+	group.add(label, c);
+	c.gridwidth = GridBagConstraints.REMAINDER;
+	c.fill = GridBagConstraints.HORIZONTAL;
+	c.weightx = .4;
+	group.add(opt, c);
+	}
+
+	/*
+	 *	Get options for device.
+	 */
+    private boolean initSaneOptions()
+	{
+	JPanel group = null;
+	GridBagConstraints c = new GridBagConstraints();
+	c.weightx = .4;
+	c.weighty = .4;
+					// Get # of device options.
+	int numDevOptions[] = new int[1];
+	int status = sane.getControlOption(saneHandle, 0, numDevOptions, null);
+	if (status != Sane.STATUS_GOOD)
+		{
+		System.out.println("controlOption() failed.  Status= " 
+								+ status);
+		return (false);
+		}
+	System.out.println("Number of device options=" + numDevOptions[0]);
+					// Do each option.
+	for (int i = 0; i < numDevOptions[0]; i++)
+		{
+		SaneOption opt = sane.getOptionDescriptor(saneHandle, i);
+		if (opt == null)
+			{
+			System.out.println("getOptionDescriptor() failed for "
+						+ i);
+			continue;
+			}
+/*
+		System.out.println("Option title: " + opt.title);
+		System.out.println("Option desc:  " + opt.desc);
+		System.out.println("Option type:  " + opt.type);
+ */
+		String title;		// Set up title.
+		if (opt.unit == SaneOption.UNIT_NONE)
+			title = opt.title;
+		else			// Show units.
+			title = opt.title + " [" + 
+					opt.unitString(unitLength) + ']';
+		switch (opt.type)
+			{
+		case SaneOption.TYPE_GROUP:
+					// Group for a set of options.
+			group = new JPanel(new GridBagLayout());
+			c.gridwidth = GridBagConstraints.REMAINDER;
+			c.fill = GridBagConstraints.BOTH;
+			c.anchor = GridBagConstraints.CENTER;
+			add(group, c);
+			group.setBorder(new TitledBorder(title));
+			break;
+		case SaneOption.TYPE_BOOL:
+					// A checkbox.
+			SaneCheckBox cbox = new SaneCheckBox(opt.title,
+						this, i, opt.desc);
+			c.gridwidth = GridBagConstraints.REMAINDER;
+			c.fill = GridBagConstraints.NONE;
+			c.anchor = GridBagConstraints.WEST;
+			if (group != null)
+				group.add(cbox, c);
+			addControl(cbox);
+			break;
+		case SaneOption.TYPE_FIXED:
+					// Fixed-point value.
+			if (opt.size != 4)
+				break;	// Not sure about this.
+			switch (opt.constraintType)
+				{
+			case SaneOption.CONSTRAINT_RANGE:
+					// A scale.
+				SaneSlider slider = new FixedSaneSlider(
+						opt.rangeConstraint.min, 
+						opt.rangeConstraint.max,
+						opt.unit == SaneOption.UNIT_MM,
+						this, i, opt.desc);
+				addLabeledOption(group, title, slider, c);
+				addControl(slider);
+				break;
+			case SaneOption.CONSTRAINT_WORD_LIST:
+					// Select from a list.
+				SaneFixedBox list = new SaneFixedBox(
+							this, i, opt.desc);
+				addLabeledOption(group, title, list, c);
+				addControl(list);
+				break;
+				}
+			break;
+		case SaneOption.TYPE_INT:
+					// Integer value.
+			if (opt.size != 4)
+				break;	// Not sure about this.
+			switch (opt.constraintType)
+				{
+			case SaneOption.CONSTRAINT_RANGE:
+					// A scale.
+				SaneSlider slider = new SaneSlider(
+						opt.rangeConstraint.min, 
+						opt.rangeConstraint.max,
+						this, i, opt.desc);
+				addLabeledOption(group, title, slider, c);
+				addControl(slider);
+				break;
+			case SaneOption.CONSTRAINT_WORD_LIST:
+					// Select from a list.
+				SaneIntBox list = new SaneIntBox(
+							this, i, opt.desc);
+				addLabeledOption(group, title, list, c);
+				addControl(list);
+				break;
+				}
+			break;
+		case SaneOption.TYPE_STRING:
+					// Text entry or choice box.
+			switch (opt.constraintType)
+				{
+			case SaneOption.CONSTRAINT_STRING_LIST:
+					// Make a list.
+				SaneStringBox list = new SaneStringBox(
+							this, i, opt.desc);
+				addLabeledOption(group, title, list, c);
+				addControl(list);
+				break;
+			case SaneOption.CONSTRAINT_NONE:
+				SaneTextField tfield = new SaneTextField(16, 
+							this, i, opt.desc);
+				addLabeledOption(group, title, tfield, c);
+				addControl(tfield);
+				break;
+				}
+			break;
+		case SaneOption.TYPE_BUTTON:
+			c.gridwidth = GridBagConstraints.REMAINDER;
+			c.fill = GridBagConstraints.HORIZONTAL;
+			c.anchor = GridBagConstraints.CENTER;
+			c.insets = new Insets(8, 4, 4, 4);
+			JButton btn = new SaneButton(title, this, i, opt.desc);
+			group.add(btn, c);
+			c.insets = null;
+			break;
+		default:
+			break;
+			}
+		}
+	return (true);
+	}
+
+	/*
+	 *	Set up "Output" panel.
+	 */
+    private JPanel initOutputPanel()
+	{
+	JPanel panel = new JPanel(new GridBagLayout());
+	GridBagConstraints c = new GridBagConstraints();
+					// Want 1 row.
+	c.gridx = GridBagConstraints.RELATIVE;
+	c.gridy = 0;
+	c.anchor = GridBagConstraints.WEST;
+//	c.fill = GridBagConstraints.HORIZONTAL;
+	c.weightx = .4;
+	c.weighty = .4;
+	panel.setBorder(new TitledBorder("Output"));
+	panel.add(new Label("Filename"), c);
+	outputField = new JTextField("out.pnm", 16);
+	panel.add(outputField, c);
+	c.insets = new Insets(0, 8, 0, 0);
+	browseButton = new JButton("Browse");
+	browseButton.addActionListener(this);
+	panel.add(browseButton, c);
+	return (panel);
+	}
+
+	/*
+	 *	Initialize main window.
+	 */
+    private void init()
+	{
+	controls = new Vector();	// List of SaneComponent's.
+					// Try a light blue:
+	setBackground(new Color(140, 200, 255));
+					// And a larger font.
+	font = new Font("Helvetica", Font.PLAIN, 12);
+	setFont(font);
+	initMenu();
+					// Main panel will be 1 column.
+	setLayout(new GridBagLayout());
+	GridBagConstraints c = new GridBagConstraints();
+	c.gridwidth = GridBagConstraints.REMAINDER;
+	c.fill = GridBagConstraints.BOTH;
+	c.weightx = .4;
+	c.weighty = .4;
+					// Panel for output:
+	JPanel outputPanel = initOutputPanel();
+	add(outputPanel, c);
+	initSaneOptions();		// Get SANE options, set up dialog.
+	initButtons();			// Put buttons at bottom.
+	}
+
+	/*
+	 *	Add a control to the dialog and set its initial value.
+	 */
+    private void addControl(SaneComponent comp)
+	{
+	controls.addElement(comp);
+	comp.setFromControl();		// Get initial value.
+	}
+
+	/*
+	 *	Reinitialize components from SANE controls.
+	 */
+    private void reinit()
+	{
+	Enumeration ctrls = controls.elements();
+	while (ctrls.hasMoreElements())	// Do each control.
+		{
+		SaneComponent comp = (SaneComponent) ctrls.nextElement();
+		comp.setFromControl();
+		}
+	}
+
+	/*
+	 *	Set up the menubar.
+	 */
+    private void initMenu()
+	{
+	MenuBar mbar = new MenuBar();
+	Menu file = new Menu("File");
+	mbar.add(file);
+	exitMenuItem = new MenuItem("Exit");
+	exitMenuItem.addActionListener(this);
+	file.add(exitMenuItem);
+	Menu pref = new Menu("Preferences");
+	mbar.add(pref);
+	toolTipsMenuItem = new CheckboxMenuItem("Show tooltips", true);
+	toolTipsMenuItem.addItemListener(this);
+	pref.add(toolTipsMenuItem);
+	Menu units = new Menu("Length unit");
+	pref.add(units);
+	mmMenuItem = new CheckboxMenuItem("millimeters", true);
+	mmMenuItem.addItemListener(this);
+	units.add(mmMenuItem);
+	cmMenuItem = new CheckboxMenuItem("centimeters", false);
+	cmMenuItem.addItemListener(this);
+	units.add(cmMenuItem);
+	inMenuItem = new CheckboxMenuItem("inches", false);
+	inMenuItem.addItemListener(this);
+	units.add(inMenuItem);
+	setMenuBar(mbar);
+	}
+
+	/*
+	 *	Set up buttons panel at very bottom.
+	 */
+    private void initButtons()
+	{
+					// Buttons are at bottom.
+	JPanel bottomPanel = new JPanel(new GridBagLayout());
+					// Indent around buttons.
+	GridBagConstraints c = new GridBagConstraints();
+	c.gridwidth = GridBagConstraints.REMAINDER;
+	c.insets = new Insets(8, 8, 8, 8);
+	c.weightx = .4;
+	c.weighty = .2;
+	c.fill = GridBagConstraints.HORIZONTAL;
+	add(bottomPanel, c);
+	c.weighty = c.weightx = .4;
+	c.fill = GridBagConstraints.BOTH;
+	c.gridwidth = c.gridheight = 1;
+					// Create image display box.
+	imageDisplay = new ImageCanvas();
+	bottomPanel.add(imageDisplay, c);
+					// Put btns. to right in 1 column.
+	JPanel buttonsPanel = new JPanel(new GridLayout(0, 1, 8, 8));
+	bottomPanel.add(buttonsPanel, c);
+	scanButton = new JButton("Scan");
+	buttonsPanel.add(scanButton);
+	scanButton.addActionListener(this);
+	previewButton = new JButton("Preview Window");
+	buttonsPanel.add(previewButton);
+	previewButton.addActionListener(this);
+	}
+
+	/*
+	 *	Set a SANE integer option.
+	 */
+    public void setControlOption(int optNum, int val)
+	{
+	int [] info = new int[1];
+	if (sane.setControlOption(saneHandle, optNum, 
+			SaneOption.ACTION_SET_VALUE, val, info) 
+							!= Sane.STATUS_GOOD)
+		System.out.println("setControlOption() failed.");
+	checkOptionInfo(info[0]);
+	}
+
+	/*
+	 *	Set a SANE text option.
+	 */
+    public void setControlOption(int optNum, String val)
+	{
+	int [] info = new int[1];
+	if (sane.setControlOption(saneHandle, optNum, 
+			SaneOption.ACTION_SET_VALUE, val, info) 
+							!= Sane.STATUS_GOOD)
+		System.out.println("setControlOption() failed.");
+	checkOptionInfo(info[0]);
+	}
+
+	/*
+	 *	Check the 'info' word returned from setControlOption().
+	 */
+    private void checkOptionInfo(int info)
+	{
+					// Does everything completely change?
+	if ((info & SaneOption.INFO_RELOAD_OPTIONS) != 0)
+		reinit();
+					// Need to update status line?
+	if ((info & SaneOption.INFO_RELOAD_PARAMS) != 0)
+		;			// ++++++++FILL IN.
+	}
+
+	/*
+	 *	Handle a user action.
+	 */
+    public void actionPerformed(ActionEvent e)
+	{
+	if (e.getSource() == scanButton)
+		{
+		System.out.println("Rescanning");
+					// Get file name.
+		String fname = outputField.getText();
+		if (fname == null || fname.length() == 0)
+			fname = "out.pnm";
+		try
+			{
+			outFile = new FileOutputStream(fname);
+			}
+		catch (IOException oe)
+			{
+			System.out.println("Error creating file:  " + fname);
+			outFile = null;
+			return;
+			}
+					// Disable "Scan" button.
+		scanButton.setEnabled(false);
+		scanIt.setOutputFile(outFile);
+		imageDisplay.setImage(scanIt, this);
+		}
+	else if (e.getSource() == browseButton)
+		{
+		File file;		// For working with names.
+		FileDialog dlg = new FileDialog(this, "Output Filename",
+						FileDialog.SAVE);
+		if (outDir != null)	// Set to last directory.
+			dlg.setDirectory(outDir);
+					// Get current name.
+		String fname = outputField.getText();
+		if (fname != null)
+			{
+			file = new File(fname);
+			dlg.setFile(file.getName());
+			String dname = file.getParent();
+			if (dname != null)
+				dlg.setDirectory(outDir);
+			}
+		dlg.show();		// Wait for result.
+		fname = dlg.getFile();
+					// Store dir. for next time.
+		outDir = dlg.getDirectory();
+		if (fname != null)
+			{
+			file = new File(outDir, fname);
+			String curDir;
+			String fullName;
+			try
+				{
+				curDir = (new File(".")).getCanonicalPath();
+				fullName = file.getCanonicalPath();
+					// Not in current directory?
+				if (!curDir.equals(
+					(new File(fullName)).getParent()))
+					fname = fullName;
+				}
+			catch (IOException ex)
+				{ curDir = "."; fname = file.getName(); }
+			outputField.setText(fname);
+			}
+		}
+	else if (e.getSource() == exitMenuItem)
+		{
+		finalize();		// Just to be safe.
+		System.exit(0);
+		}
+	}
+
+	/*
+	 *	Handle checkable menu items.
+	 */
+    public void itemStateChanged(ItemEvent e)
+	{
+	if (e.getSource() == mmMenuItem)
+		{			// Wants mm.
+		unitLength = 1;
+		if (e.getStateChange() == ItemEvent.SELECTED)
+			{
+			cmMenuItem.setState(false);
+			inMenuItem.setState(false);
+			reinit();	// Re-display controls.
+			}
+		else			// Don't let him deselect.
+			mmMenuItem.setState(true);
+		}
+	if (e.getSource() == cmMenuItem)
+		{			// Wants cm.
+		unitLength = 10;
+		if (e.getStateChange() == ItemEvent.SELECTED)
+			{
+			mmMenuItem.setState(false);
+			inMenuItem.setState(false);
+			reinit();	// Re-display controls.
+			}
+		else
+			cmMenuItem.setState(true);
+		}
+	if (e.getSource() == inMenuItem)
+		{			// Wants inches.
+		unitLength = 25.4;
+		if (e.getStateChange() == ItemEvent.SELECTED)
+			{
+			mmMenuItem.setState(false);
+			cmMenuItem.setState(false);
+			reinit();	// Re-display controls.
+			}
+		else			// Don't let him deselect.
+			inMenuItem.setState(true);
+		}
+	}
+
+	/*
+	 *	Scan is complete.
+	 */
+    public void imageDone(boolean error)
+	{
+	if (error)
+		System.out.println("Scanning error.");
+	if (outFile != null)		// Close file.
+		try
+			{
+			outFile.close();
+			}
+		catch (IOException e)
+			{ }
+	scanButton.setEnabled(true);	// Can scan again.
+	}
+
+	/*
+	 *	Default window event handlers.
+	 */
+    public void windowClosed(WindowEvent event)
+	{
+	finalize();			// Just to be safe.
+	}
+    public void windowDeiconified(WindowEvent event) { }
+    public void windowIconified(WindowEvent event) { }
+    public void windowActivated(WindowEvent event) { }
+    public void windowDeactivated(WindowEvent event) { }
+    public void windowOpened(WindowEvent event) { }
+					// Handle closing event.
+    public void windowClosing(WindowEvent event)
+	{
+	finalize();			// Just to be safe.
+	System.exit(0);
+	}
+    }
+
+/*
+ *	Interface for our dialog controls.
+ */
+interface SaneComponent
+    {
+    public void setFromControl();	// Ask SANE control for current value.
+    }
+
+/*
+ *	A checkbox in our dialog.
+ */
+class SaneCheckBox extends JCheckBox implements ActionListener,
+					SaneComponent
+    {
+    private Jscanimage dialog;		// That which created us.
+    private int optNum;			// Option #.
+
+	/*
+	 *	Create with given state.
+	 */
+    public SaneCheckBox(String title, Jscanimage dlg, int opt, String tip)
+	{
+	super(title, false);
+	dialog = dlg;
+	optNum = opt;
+					// Set tool tip.
+	if (tip != null && tip.length() != 0)
+		super.setToolTipText(tip);
+	addActionListener(this);	// Listen to ourself.
+	}
+
+	/*
+	 *	Update Sane device option with current setting.
+	 */
+    public void actionPerformed(ActionEvent e)
+	{
+	System.out.println("In SaneCheckBox::actionPerformed()");
+	int val = isSelected() ? 1 : 0;
+	dialog.setControlOption(optNum, val);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+	int [] val = new int[1];
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, val, null)
+						== Sane.STATUS_GOOD)
+		setSelected(val[0] != 0);
+	}
+    }
+
+/*
+ *	A slider in our dialog.  This base class handles integer ranges.
+ *	It consists of a slider and a label which shows the current value.
+ */
+class SaneSlider extends JPanel implements SaneComponent, ChangeListener
+    {
+    protected Jscanimage dialog;	// That which created us.
+    protected int optNum;		// Option #.
+    protected JSlider slider;		// The slider itself.
+    protected JLabel label;		// Shows current value.
+
+	/*
+	 *	Create with given state.
+	 */
+    public SaneSlider(int min, int max, Jscanimage dlg, int opt, String tip)
+	{
+	super(new GridBagLayout());	// Create panel.
+	dialog = dlg;
+	optNum = opt;
+	GridBagConstraints c = new GridBagConstraints();
+					// Want 1 row.
+	c.gridx = GridBagConstraints.RELATIVE;
+	c.gridy = 0;
+	c.anchor = GridBagConstraints.CENTER;
+	c.fill = GridBagConstraints.HORIZONTAL;
+	c.weighty = .8;
+	c.weightx = .2;			// Give less weight to value label.
+	label = new JLabel("00", SwingConstants.RIGHT);
+	add(label, c);
+	c.weightx = .8;			// Give most weight to slider.
+	c.fill = GridBagConstraints.HORIZONTAL;
+	slider = new JSlider(JSlider.HORIZONTAL, min, max, 
+							min + (max - min)/2);
+	add(slider, c);
+					// Set tool tip.
+	if (tip != null && tip.length() != 0)
+		super.setToolTipText(tip);
+	slider.addChangeListener(this);	// Listen to ourself.
+	}
+
+	/*
+	 *	Update Sane device option.
+	 */
+    public void stateChanged(ChangeEvent e)
+	{
+	int val = slider.getValue();
+	label.setText(String.valueOf(val));
+	dialog.setControlOption(optNum, val);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+	int [] val = new int[1];	// Get current SANE control value.
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, val, null)
+						== Sane.STATUS_GOOD)
+		{
+		slider.setValue(val[0]);
+		label.setText(String.valueOf(val[0]));
+		}
+	}
+    }
+
+/*
+ *	A slider with fixed-point values:
+ */
+class FixedSaneSlider extends SaneSlider
+    {
+    private static final int SCALE_MIN = -32000;
+    private static final int SCALE_MAX = 32000;
+    double min, max;			// Min, max in floating-point.
+    boolean optMM;			// Option is in millimeters, so should
+					//   be scaled to user's pref.
+    private NumberFormat format;	// For printing label.
+	/*
+	 *	Create with given fixed-point range.
+	 */
+    public FixedSaneSlider(int fixed_min, int fixed_max, boolean mm,
+					Jscanimage dlg, int opt, String tip)
+	{
+					// Create with large integer range.
+	super(SCALE_MIN, SCALE_MAX, dlg, opt, tip);
+	format = NumberFormat.getInstance();
+					// For now, show 1 decimal point.
+	format.setMinimumFractionDigits(1);
+	format.setMaximumFractionDigits(1);
+					// Store actual range.
+	min = dlg.getSane().unfix(fixed_min);
+	max = dlg.getSane().unfix(fixed_max);
+	optMM = mm;
+	}
+
+	/*
+	 *	Update Sane device option.
+	 */
+    public void stateChanged(ChangeEvent e)
+	{
+	double val = (double) slider.getValue();
+					// Convert to actual control scale.
+	val = min + ((val - SCALE_MIN)/(SCALE_MAX - SCALE_MIN)) * (max - min);
+	label.setText(format.format(optMM ? 
+					val/dialog.getUnitLength() : val));
+	dialog.setControlOption(optNum, dialog.getSane().fix(val));
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+	int [] ival = new int[1];	// Get current SANE control value.
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, ival, null)
+						== Sane.STATUS_GOOD)
+		{
+		double val = dialog.getSane().unfix(ival[0]);
+					// Show value with user's pref.
+		label.setText(format.format(optMM ? 
+					val/dialog.getUnitLength() : val));
+		val = SCALE_MIN + ((val - min)/(max - min)) * 
+						(SCALE_MAX - SCALE_MIN);
+		slider.setValue((int) val);
+		}
+	}
+    }
+
+/*
+ *	A Button in our dialog.
+ */
+class SaneButton extends JButton implements ActionListener
+    {
+    private Jscanimage dialog;		// That which created us.
+    private int optNum;			// Option #.
+
+	/*
+	 *	Create with given state.
+	 */
+    public SaneButton(String title, Jscanimage dlg, int opt, String tip)
+	{
+	super(title);
+	dialog = dlg;
+	optNum = opt;
+					// Set tool tip.
+	if (tip != null && tip.length() != 0)
+		super.setToolTipText(tip);
+	addActionListener(this);	// Listen to ourself.
+	}
+
+	/*
+	 *	Update Sane device option.
+	 */
+    public void actionPerformed(ActionEvent e)
+	{
+	dialog.setControlOption(optNum, 0);
+	System.out.println("In SaneButton::actionPerformed()");
+	}
+    }
+
+/*
+ *	A combo-box for showing a list of items.
+ */
+abstract class SaneComboBox extends JComboBox 
+				implements SaneComponent, ItemListener
+    {
+    protected Jscanimage dialog;	// That which created us.
+    protected int optNum;		// Option #.
+
+	/*
+	 *	Create it.
+	 */
+    public SaneComboBox(Jscanimage dlg, int opt, String tip)
+	{
+	dialog = dlg;
+	optNum = opt;
+					// Set tool tip.
+	if (tip != null && tip.length() != 0)
+		super.setToolTipText(tip);
+	addItemListener(this);
+	}
+
+	/*
+	 *	Select desired item by its text.
+	 */
+    protected void select(String text)
+	{
+	int cnt = getItemCount();
+	for (int i = 0; i < cnt; i++)
+		if (text.equals(getItemAt(i)))
+			{
+			setSelectedIndex(i);
+			break;
+			}
+	}
+
+    abstract public void setFromControl();
+    abstract public void itemStateChanged(ItemEvent e);
+    }
+
+/*
+ *	A list of strings.
+ */
+class SaneStringBox extends SaneComboBox
+    {
+
+	/*
+	 *	Create it.
+	 */
+    public SaneStringBox(Jscanimage dlg, int opt, String tip)
+	{
+	super(dlg, opt, tip);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+					// Let's get the whole list.
+	SaneOption opt = dialog.getSane().getOptionDescriptor(
+					dialog.getSaneHandle(), optNum);
+	if (opt == null)
+		return;
+	removeAllItems();		// Clear list.
+					// Go through list from option.
+	for (int i = 0; opt.stringListConstraint[i] != null; i++)
+		addItem(opt.stringListConstraint[i]);
+					// Get value.
+	byte buf[] = new byte[opt.size + 1];
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, buf, null)
+						== Sane.STATUS_GOOD)
+		select(new String(buf));
+	}
+
+	/*
+	 *	An item was selected.
+	 */
+    public void itemStateChanged(ItemEvent e)
+	{
+				// Get current selection.
+	String val = (String) getSelectedItem();
+	if (val != null)
+		dialog.setControlOption(optNum, val);
+	}
+    }
+
+/*
+ *	A list of integers.
+ */
+class SaneIntBox extends SaneComboBox
+    {
+
+	/*
+	 *	Create it.
+	 */
+    public SaneIntBox(Jscanimage dlg, int opt, String tip)
+	{
+	super(dlg, opt, tip);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+					// Let's get the whole list.
+	SaneOption opt = dialog.getSane().getOptionDescriptor(
+					dialog.getSaneHandle(), optNum);
+	if (opt == null)
+		return;
+	removeAllItems();		// Clear list.
+					// Go through list from option.
+	int cnt = opt.wordListConstraint[0];
+	for (int i = 0; i < cnt; i++)
+		addItem(String.valueOf(opt.wordListConstraint[i + 1]));
+					// Get value.
+	int [] val = new int[1];	// Get current SANE control value.
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, val, null)
+						== Sane.STATUS_GOOD)
+		select(String.valueOf(val[0]));
+	}
+
+	/*
+	 *	An item was selected.
+	 */
+    public void itemStateChanged(ItemEvent e)
+	{
+				// Get current selection.
+	String val = (String) getSelectedItem();
+	if (val != null)
+		try
+			{
+			Integer v = Integer.valueOf(val);
+			dialog.setControlOption(optNum, v.intValue());
+			}
+		catch (NumberFormatException ex) {  }
+	}
+    }
+
+/*
+ *	A list of fixed-point floating point numbers.
+ */
+class SaneFixedBox extends SaneComboBox
+    {
+
+	/*
+	 *	Create it.
+	 */
+    public SaneFixedBox(Jscanimage dlg, int opt, String tip)
+	{
+	super(dlg, opt, tip);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+					// Let's get the whole list.
+	SaneOption opt = dialog.getSane().getOptionDescriptor(
+					dialog.getSaneHandle(), optNum);
+	if (opt == null)
+		return;
+	removeAllItems();		// Clear list.
+					// Go through list from option.
+	int cnt = opt.wordListConstraint[0];
+	for (int i = 0; i < cnt; i++)
+		addItem(String.valueOf(dialog.getSane().unfix(
+					opt.wordListConstraint[i + 1])));
+					// Get value.
+	int [] val = new int[1];	// Get current SANE control value.
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, val, null)
+						== Sane.STATUS_GOOD)
+		select(String.valueOf(dialog.getSane().unfix(val[0])));
+	}
+
+	/*
+	 *	An item was selected.
+	 */
+    public void itemStateChanged(ItemEvent e)
+	{
+				// Get current selection.
+	String val = (String) getSelectedItem();
+	if (val != null)
+		try
+			{
+			Double v = Double.valueOf(val);
+			dialog.setControlOption(optNum,
+					dialog.getSane().fix(v.doubleValue()));
+			}
+		catch (NumberFormatException ex) {  }
+	}
+    }
+
+/*
+ *	A text-entry field in our dialog.
+ */
+class SaneTextField extends JTextField implements SaneComponent
+    {
+    private Jscanimage dialog;		// That which created us.
+    private int optNum;			// Option #.
+
+	/*
+	 *	Create with given state.
+	 */
+    public SaneTextField(int width, Jscanimage dlg, int opt, String tip)
+	{
+	super(width);			// Set initial text, # chars.
+	dialog = dlg;
+	optNum = opt;
+					// Set tool tip.
+	if (tip != null && tip.length() != 0)
+		super.setToolTipText(tip);
+	}
+
+	/*
+	 *	Update Sane device option with current setting when user types.
+	 */
+    public void processKeyEvent(KeyEvent e)
+	{
+	super.processKeyEvent(e);	// Handle it normally.
+	if (e.getID() != KeyEvent.KEY_TYPED)
+		return;			// Just do it after keystroke.
+	String userText = getText();	// Get what's there, & save copy.
+	String newText = new String(userText);
+	dialog.setControlOption(optNum, newText);
+	if (!newText.equals(userText))	// Backend may have changed it.
+		setText(newText);
+	}
+
+	/*
+	 *	Update from Sane control's value.
+	 */
+    public void setFromControl()
+	{
+	byte buf[] = new byte[1024];
+	if (dialog.getSane().getControlOption(
+			dialog.getSaneHandle(), optNum, buf, null)
+						== Sane.STATUS_GOOD)
+		{
+		String text = new String(buf);
+		System.out.println("SaneTextField::setFromControl: " + text);
+		setText(text);		// Set text in field.
+		setScrollOffset(0);
+		}
+	}
+    }