<< Chapter < Page Chapter >> Page >

Listing 5. check for size problems.

//Display error message in place of image if the // image won't fit in the display window.if(img.width>width){ text("--Image too wide--",10,20);text("Image width: " + img.width,10,40); text("Display width: " + width,10,60);}else if(img.height>height){ text("--Image too tall--",10,20);text("Image height: " + img.height,10,40); text("Display height: " + height,10,60);}else{ //Copy pixel colors from the input image to the// display image.
Listing 5. Check for size problems.

Copy from input to output

If the image will fit in the display window, the code in Listing 6 is executed to begin the process of copying the pixel colors from the input image to the display image.

Listing 6. copy from input to output.

for(int cnt = 0;cnt<img.pixels.length;cnt++){ //Get and save RGB color values for current pixel.reD = red(img.pixels[cnt]);greeN = green(img.pixels[cnt]);bluE = blue(img.pixels[cnt]);//Normally some sort of image processing algorithm// would be implemented here.//Construct output pixel color color c = color(reD, greeN, bluE);
Listing 6. Copy from input to output.

An object of the PImage class

Although the syntax is unconventional, the call to the loadImage method in Listing 2 instantiates an object of the class named PImage and stores the object's reference in an instance variable named img . That object contains the pixel data extracted from the image file.

An object of the PImage class provides several methods that can be used to manipulate the image. In addition, an object of the PImage class contains fields for the width and height of the image, as well as an array named pixels[] that contains the values for every pixel in the image.

The arrays named pixels

The array containing the pixel data for the input image in this sketch can be accessed as img.pixels[] .

There is a similar pixel array that contains the pixel data for the output display window. That array can be accessed simply as pixels[] .

The data stored in the elements of these arrays is of the Processing primitive type color .

One-dimensional arrays

Although the pixels in an image can be thought of as a residing on a two-dimensional grid, the pixels are stored in these one-dimensional arrays row-by-row. In otherwords, the array element that is accessed as pixels[0] contains color data for the upper leftmost pixel in the image. The last element in the array contains color data for the bottom rightmost pixel in the image.

Extracting RGB color component values

The Pr0120a class inherits method named red , green , and blue .. These methods expect to receive a single parameter of type color , and return the value of the corresponding RGB component as type float . By default, the color component values range between 0.0 and 255.0.

The property named length and a for loop

Every array object in Java has a property named length whose value is equal to the number of elements in the array. This value is very usefulin the conditional clause of loops that are used to traverse an entire array.

Listing 6 shows the beginning of a for loop that

  • Extracts color component values from every pixel in the input image.
  • Uses those values to construct color values and insert them into the elements of the array containing the pixel data for the output display.

This process is complicated somewhat by the fact that the actual output image may be wider than the input image. This is indicated by the white space on the rightside of Image 1 . In other words, it is necessary to take this into account when computing the index of the output array element that isto receive the color from an input array element.

Store colors in the output array

The code that accomplishes that is shown in Listing 7 .

Listing 7. store colors in the output array.

if(width>= img.width){ if((cnt % img.width == 0)&&(cnt != 0)){ //Compensate for excess display width by// increasing the output counter. ctr += (width - img.width);}//end if //Store the pixel in the output pixel array// and increment the output counter. pixels[ctr]= c; ctr++;}//end if }//end for loopupdatePixels();//required}//end else
Listing 7. Store colors in the output array.

Get Jobilize Job Search Mobile App in your pocket Now!

Get it on Google Play Download on the App Store Now




Source:  OpenStax, The processing programming environment. OpenStax CNX. Feb 26, 2013 Download for free at http://cnx.org/content/col11492/1.5
Google Play and the Google Play logo are trademarks of Google Inc.

Notification Switch

Would you like to follow the 'The processing programming environment' conversation and receive update notifications?

Ask