001/*******************************************************************************
002 * This software is provided as a supplement to the authors' textbooks on digital
003 * image processing published by Springer-Verlag in various languages and editions.
004 * Permission to use and distribute this software is granted under the BSD 2-Clause
005 * "Simplified" License (see http://opensource.org/licenses/BSD-2-Clause).
006 * Copyright (c) 2006-2023 Wilhelm Burger, Mark J. Burge. All rights reserved.
007 * Visit https://imagingbook.com for additional details.
008 ******************************************************************************/
009package ImageJ_Demos;
010
011import ij.ImagePlus;
012import ij.plugin.filter.PlugInFilter;
013import ij.process.ByteProcessor;
014import ij.process.ImageProcessor;
015import imagingbook.core.jdoc.JavaDocHelp;
016
017/**
018 * This ImageJ plugin shows how to access the one-dimensional pixel array of a 8-bit (= byte) grayscale image. Each
019 * pixel value is increased by 10 without range limiting, i.e., bright values wrap back to black etc.
020 *
021 * @author WB
022 */
023public class Direct_Byte_Pixel_Access implements PlugInFilter, JavaDocHelp {
024
025        public int setup(String arg, ImagePlus img) {
026                return DOES_8G;         // this plugin accepts 8-bit grayscale images
027        }
028
029        public void run(ImageProcessor ip) {
030                ByteProcessor bp = (ByteProcessor) ip;  // DOES_8G only, thus this must work
031                byte[] pixels = (byte[]) bp.getPixels();
032                int w = bp.getWidth();
033                int h = bp.getHeight();
034
035                for (int v = 0; v < h; v++) {
036                        for (int u = 0; u < w; u++) {
037                                int p = 0xFF & pixels[v * w + u]; // bitmask 0xFF is needed for unsigned values
038                                p = p + 10;
039                                pixels[v * w + u] = (byte) (0xFF & p); 
040                        }
041                }
042        }
043
044}