package ij; import java.awt.*; import java.awt.image.*; import ij.process.*; /** This class represents an expandable array of images. @see ImagePlus */ public class ImageStack { static final int INITIAL_SIZE = 25; static final String outOfRange = "Argument out of range: "; private int nSlices = 0; private Object[] stack; private String[] label; private int width, height; private Rectangle roi; private ColorModel cm; private double min=Double.MAX_VALUE; private double max; private float[] cTable; /** Default constructor. */ public ImageStack() { } /** Creates a new, empty image stack. */ public ImageStack(int width, int height) { this(width, height, null); } /** Creates a new image stack with a capacity of 'size'. */ public ImageStack(int width, int height, int size) { this.width = width; this.height = height; stack = new Object[size]; label = new String[size]; nSlices = size; } /** Creates a new, empty image stack. */ public ImageStack(int width, int height, ColorModel cm) { this.width = width; this.height = height; this.cm = cm; stack = new Object[INITIAL_SIZE]; label = new String[INITIAL_SIZE]; nSlices = 0; } /** Adds an image in the forma of a pixel array to the end of the stack. */ public void addSlice(String sliceLabel, Object pixels) { if (pixels==null) throw new IllegalArgumentException("'pixels' is null!"); if (!pixels.getClass().isArray()) throw new IllegalArgumentException("'pixels' is not an array"); nSlices++; if (nSlices==stack.length) { Object[] tmp1 = new Object[nSlices*2]; System.arraycopy(stack, 0, tmp1, 0, nSlices); stack = tmp1; String[] tmp2 = new String[nSlices*2]; System.arraycopy(label, 0, tmp2, 0, nSlices); label = tmp2; } stack[nSlices-1] = pixels; this.label[nSlices-1] = sliceLabel; } /** Obsolete. Short images are always unsigned. */ public void addUnsignedShortSlice(String sliceLabel, Object pixels) { addSlice(sliceLabel, pixels); } /** Adds the image in 'ip' to the end of the stack. */ public void addSlice(String sliceLabel, ImageProcessor ip) { if (ip.getWidth()!=width || ip.getHeight()!=height) throw new IllegalArgumentException("Dimensions do not match"); if (nSlices==0) { cm = ip.getColorModel(); min = ip.getMin(); max = ip.getMax(); } addSlice(sliceLabel, ip.getPixels()); } /** Adds the image in 'ip' to the stack following slice 'n'. Adds the slice to the beginning of the stack if 'n' is zero. */ public void addSlice(String sliceLabel, ImageProcessor ip, int n) { if (n<0 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); addSlice(sliceLabel, ip); Object tempSlice = stack[nSlices-1]; String tempLabel = label[nSlices-1]; int first = n>0?n:1; for (int i=nSlices-1; i>=first; i--) { stack[i] = stack[i-1]; label[i] = label[i-1]; } stack[n] = tempSlice; label[n] = tempLabel; } /** Deletes the specified slice, were 1<=n<=nslices. */ public void deleteSlice(int n) { if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); if (nSlices<1) return; for (int i=n; i0) deleteSlice(nSlices); } public int getWidth() { return width; } public int getHeight() { return height; } public void setRoi(Rectangle roi) { this.roi = roi; } public Rectangle getRoi() { return(this.roi); } /** Updates this stack so its attributes, such as min, max, calibration table and color model, are the same as 'ip'. */ public void update(ImageProcessor ip) { if (ip!=null) { min = ip.getMin(); max = ip.getMax(); cTable = ip.getCalibrationTable(); cm = ip.getColorModel(); } } /** Returns the pixel array for the specified slice, were 1<=n<=nslices. */ public Object getPixels(int n) { if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); return stack[n-1]; } /** Assigns a pixel array to the specified slice, were 1<=n<=nslices. */ public void setPixels(Object pixels, int n) { if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); stack[n-1] = pixels; } /** Returns the stack as an array of 1D pixel arrays. Note that the size of the returned array may be greater than the number of slices currently in the stack, with unused elements set to null. */ public Object[] getImageArray() { return stack; } /** Returns the number of slices in this stack. */ public int getSize() { return nSlices; } /** Returns the slice labels as an array of Strings. Note that the size of the returned array may be greater than the number of slices currently in the stack. Returns null if the stack is empty or the label of the first slice is null. */ public String[] getSliceLabels() { if (nSlices==0) return null; else return label; } /** Returns the label of the specified slice, were 1<=n<=nslices. Returns null if the slice does not have a label. For DICOM and FITS stacks, labels may contain header information. */ public String getSliceLabel(int n) { if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); return label[n-1]; } /** Returns a shortened version (up to the first 60 characters or first newline and suffix removed) of the label of the specified slice. Returns null if the slice does not have a label. */ public String getShortSliceLabel(int n) { String shortLabel = getSliceLabel(n); if (shortLabel==null) return null; int newline = shortLabel.indexOf('\n'); if (newline==0) return null; if (newline>0) shortLabel = shortLabel.substring(0, newline); int len = shortLabel.length(); if (len>4 && shortLabel.charAt(len-4)=='.' && !Character.isDigit(shortLabel.charAt(len-1))) shortLabel = shortLabel.substring(0,len-4); if (shortLabel.length()>60) shortLabel = shortLabel.substring(0, 60); return shortLabel; } /** Sets the label of the specified slice, were 1<=n<=nslices. */ public void setSliceLabel(String label, int n) { if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); this.label[n-1] = label; } /** Returns an ImageProcessor for the specified slice, were 1<=n<=nslices. Returns null if the stack is empty. */ public ImageProcessor getProcessor(int n) { ImageProcessor ip; if (n<1 || n>nSlices) throw new IllegalArgumentException(outOfRange+n); if (nSlices==0) return null; if (stack[0] instanceof byte[]) ip = new ByteProcessor(width, height, null, cm); else if (stack[0] instanceof short[]) ip = new ShortProcessor(width, height, null, cm); else if (stack[0] instanceof int[]) ip = new ColorProcessor(width, height, null); else if (stack[0] instanceof float[]) ip = new FloatProcessor(width, height, null, cm); else throw new IllegalArgumentException("Unknown stack type"); ip.setPixels(stack[n-1]); if (min!=Double.MAX_VALUE && ip!=null && !(ip instanceof ColorProcessor)) ip.setMinAndMax(min, max); if (cTable!=null) ip.setCalibrationTable(cTable); return ip; } /** Assigns a new color model to this stack. */ public void setColorModel(ColorModel cm) { this.cm = cm; } /** Returns this stack's color model. May return null. */ public ColorModel getColorModel() { return cm; } /** Returns true if this is a 3-slice RGB stack. */ public boolean isRGB() { if (nSlices==3 && (stack[0] instanceof byte[]) && getSliceLabel(1)!=null && getSliceLabel(1).equals("Red")) return true; else return false; } /** Returns true if this is a 3-slice HSB stack. */ public boolean isHSB() { if (nSlices==3 && getSliceLabel(1)!=null && getSliceLabel(1).equals("Hue")) return true; else return false; } /** Returns true if this is a virtual (disk resident) stack. This method is overridden by the VirtualStack subclass. */ public boolean isVirtual() { return false; } /** Frees memory by deleting a few slices from the end of the stack. */ public void trim() { int n = (int)Math.round(Math.log(nSlices)+1.0); for (int i=0; i