ibctprocessor.java

esri的ArcGIS Server超级学习模板程序（for java）

package com.esri.solutions.jitk.web.data.image;

import java.io.IOException;

/**
 * Defines an interface in order to process
 * an image to apply brightness, contrast, and
 * tint.  The {@link #process()} method will
 * be responsible for applying the brightness,
 * contrast, and tint, and then encoding the image
 * back to an input stream to be read by the caller.
 */
public interface IBCTProcessor {

	/**
	 * Processes an image to apply the brightness,
	 * contrast, and tint and returns an encoded 
	 * image stream as an {@link java.io.InputStream} ready
	 * for reading.
	 * 
	 * @return Encoded image stream.
	 * @throws IOException 
	 */
	public java.io.InputStream process () throws IOException;
	
	/**
	 * Sets the brightness to be applied during
	 * processing.  This value will be added
	 * to every color component in each pixel in
	 * the image.
	 * 
	 * @param b  Brightness value.
	 */
	public void setBrightness (byte b);
	
	/**
	 * Sets the contrast to be applied during
	 * processing.  This value must be between
	 * 0 and 10.  Any value outside these bounds
	 * should be clamped.
	 * 
	 * @param b  Contrast value.
	 */
	public void setContrast (byte c);
	
	/**
	 * Sets the tint parameters to be applied
	 * during processing.  The Tint Parameters
	 * object will hold color offsets to be applied
	 * to each color component in each pixel in the
	 * image.
	 * 
	 * @param tint  Tint Parameters.
	 */
	public void setTint (TintParameters tint);
	
}