advertisement
javaboutique
Search Tips
Articles  |   Tutorials  |   Reviews  |   Tools  |   by Category  |   by Date  |   by Name  |   Submit  |   Source  |   Forums  |  
javaboutique
Browse DevX


Partners & Affiliates











advertisement

Tutorials : Using Rasters for Image Processing, Part 1 :

Scanline, Pixel Stride, Scanline Stride, and Band Offsets

Before you can create a DataBuffer and a SampleModel, you'll need understand a few things about the representation of samples in DataBuffers:
  • Scanline: This defines a row of pixels from the image region that you want to process.
  • Pixel stride: This defines the distance, represented in DataBuffer elements, between the samples of two pixels, where the samples are on the same scanline and belong to the same band.
  • Scanline stride: This defines the distance, represented in DataBuffer elements, between a sample on a scanline and the sample on the next scanline but on the same column. The scanline stride value can be smaller or bigger than the scanline value, but in general they are equal (as shown in Figure 5).
  • Bands offsets: This defines the distance, represented in DataBuffer elements, from the beginning of a block to the first sample from a band.
Figures 5 represents the architectures for the PixelInterleavedSampleModel and SinglePixelPackedSampleModel classes. Obviously, their interpretation depends on the storage model.


Figure 5. Class Architectures: The image shows the architectures for PixelInterleavedSampleModel and SinglePixelPackedSampleModel.

Creating a DataBuffer Object

To create a DataBuffer object, first obtain an instance of one of the DataBufferXXX classes. You will learn how to do that for the DataBufferByte class and the principle is the same for the other DataBufferXXX. The constructors of the DataBufferByte class are:
  • public DataBufferByte(int size): This creates a data buffer object containing only one block. The dimension of this block is specified by the size argument.
  • public DataBufferByte(int size, int blocks): This creates a data buffer object containing a blocks number of blocks, the dimensions of which are specified by the size argument.
  • public DataBufferByte(byte[] array, int size): This creates a data buffer object containing only one block, using the byte array array. The dimension of the block is specified by the size argument. Obviously, the array must contain at least size elements.
  • public DataBufferByte(byte[] array,int size, int offset): This creates a data buffer object containing only one block, using the byte array. The dimension of the block is specified by the size argument. The offset argument represents the offset of the array. Obviously, the byte array must contain at least offset+size elements.
  • public DataBufferByte(byte[][] arrays, int size): This creates a data buffer object that containing arrays.length blocks. The dimensions of the blocks are specified by the size argument. Obviously, each array must have at least size elements.
  • public DataBufferByte(byte[][] arrays,int size, int[] offsets): This creates a data buffer object that containing arrays.length blocks. The dimensions of the blocks are specified by the size argument and the offsets array represent the offsets into each byte array. Obviously, each array must have at least size+offset elements.


Figure 6. A DataBuffer Object: The image shows the architecture for a DataBuffer object.

The following code illustrates how to create a DataBufferByte object without offset:



int z=50;

byte[] pixels = new byte[z];

DataBufferByte DB=new DataBufferByte(pixels,z);

And with offset=10:


int offset=10;

int z=50+offset;

byte[] pixels = new byte[z];

DataBufferByte DB=new DataBufferByte(pixels,z,offset);

Common Methods in All DataBufferXXX Classes

To extract one or more arrays from a data buffer, use the following methods in all DataBufferXXX classes:
    public data_type[] getData(): This returns the array for the first block (block 0).
  • public data_type[] getData(int block): This returns the array corresponding to the specified block.
  • public data_type[][] getBankData(): This returns the arrays of all existing blocks.
Where data_type[]/data_type[][] can be byte[]/byte[][], int[]/int[][], short[]/short[][], float[]/float[][], or double[]/double[][] depending of the DataBufferXXX class. This affirmation is valid for all the above methods.

To extract an integer value from a DataBuffer, use the following methods in all DataBufferXXX classes:

  • public int getElem(int i): This returns from the first block an integer value from the i index.
  • public int getElem(int block, int i): This returns from the specified block an integer value from the i index.
To obtain a float value, use the following two methods:
  • public float getElemFloat(int i): This returns from the first block a float value from the i index;.
  • public float getElemFloat(int block, int i): This returns from the specified block a float value from the i index;.
Or, to obtain a double value from a DataBuffer use the following two methods:
  • public double getElemDouble(int i): This returns from the first block a double value from the i index;.
  • public double getElemDouble(int block, int i): This returns from the specified block a double value from the i index;.
The set a DataBuffer element to an integer value, use the following methods in all DataBufferXXX classes:
  • public void setElem(int i, int value): This sets the element from the i position to the specified integer value. The used block is the first one.
  • public void setElem(int block, int i, int value): This sets the element from the i position to the specified integer value. The used block is specified by the block argument.
To set a DataBuffer element to a float value, use the following two methods:
  • public void setElemFloat(int i, float value): This sets the element from the i position to the specified float value. The used block is the first one.
  • public void setElemFloat(int block, int i, float value): This sets the element from the i position to the specified float value. The used block is specified by the block argument.
Or, to set a DataBuffer element to a double value use the following two methods:
  • public void setElemDouble(int i, double value): This sets the element from the i position to the specified double value. The used block is the first one.
  • public void setElemDouble(int block, int i, double value): This sets the element from the i position to the specified double value. The used block is specified by the block argument.
All DataBufferXXX classes inherit a series of methods for obtaining information about data buffers from the DataBuffer superclass. Among these methods are: getOffset, getOffsets, getSize, getNumBanks, getDataTypeSize, and getDataType.


int offset=10;

int z=50+offset;

byte[] pixels = new byte[z];

…

DataBufferByte DB=new DataBufferByte(pixels,z,offset);                 

        int GNB=DB.getNumBanks();

        int GS=DB.getSize();

        int GO=DB.getOffset();

               System.out.println("Number of blocks:"+GNB);

               System.out.println("Blocks dimension:"+GS);

               System.out.println("Offset:"+GO);                  

	      DB.setElem(0,122);

Home / Articles / Using Rasters for Image Processing, Part 1 / 1 / 2 / Next Page

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.

 Avaya Developer Showcase
 MSDN Spotlight
 PHP for Windows Showcase
XML error: undefined entity at line 34
advertisement
Receive Articles via our XML/RSS feed
Receive Articles via our XML/RSS feed

JavaBytes
Internet Cyclone
This powerful, easy-to-use, internet optimizer is for Windows 95, 98, ME, NT, 2000 and XP. It's designed to automatically optimize your Windows settings, boosting your Internet connection up to 200%.

IBM Brings Developers Into the Cloud
Apache at 10: You Can't Buy Us
Microsoft's CodePlex Foundation Moving Forward
Apple Claims 100,000 Apps, Google Analyzes Them
Nokia Latest to Play Opera Mobile 10 Browser
PayPal Opens Up Payment Platform to Devs
Ubuntu Linux 9.10 'Karmic Koala' Starts Its Climb
IBM Links Rational Developer Tools, Tivoli Apps
Libraries Give Vista Apps a Windows 7 Look
Ubuntu: The 'Default Alternative' to Windows?

Delivering Web-based Embedded Fonts in CSS 3
Adobe Helps PHP Developers Create Rich Internet Applications
Java Developers Finding a Home at Adobe Flex
Virtualization Delivers a Dynamic Infrastructure
Consuming XML Web Services in iPhone Applications
Build a More Agile Business with IBM
POJO-Based Solutions for LDAP Access: One Good, One Better
IBM Offers Enhanced Measurement and Management for Energy Usage
IBM Helps Transformation to an Information-Based Enterprise
Top Five Touch UI-Related Design Guidelines

Advertising Info  |   Member Services  |   Contact Us  |   Help  |   Feedback  |   Site Map  |   Network Map  |   About

internet.commediabistro.comJusttechjobs.comGraphics.com

Search:

WebMediaBrands Corporate Info

Legal Notices, Licensing, Reprints, Permissions, Privacy Policy.
Advertise | Newsletters | Shopping | E-mail Offers | Freelance Jobs