index.html

---
layout: withcc
title: pixels[] | reference
---
<table cellpadding="0" cellspacing="0" border="0" class="ref-item">
	<tr>
		<th scope="row">Class</th>
		<td>PImage</td>
	</tr>
	<tr class="name-row">
		<th scope="row">Name</th>
		<td><h3>pixels[]</h3></td>
	</tr>

	<tr class="">
		<th scope="row">Examples</th>
		<td><div class="example"><img src="/reference/PImage_pixels.jpg" alt="example pic" /><pre class="margin">// @pjs preload must be used to preload the image
/* @pjs preload="tower.jpg"; */
PImage img = loadImage("tower.jpg");
int dimension = (img.width*img.height);
img.loadPixels();
for (int i=0; i < dimension; i+=2) { 
  img.pixels[i] = color(0, 0, 0); 
} 
img.updatePixels();
image(img, 0, 0);</pre></div></td>
	</tr>

	<tr class="">
		<th scope="row">Description</th>
		<td>Array containing the values for all the pixels in the image. These values are of the color datatype. 
		This array is the size of the image, meaning if the image is 100x100 pixels, there will be 10000 values and if the window is 200x300 pixels, there will be 60000 values. 
		The <b>index</b> value defines the position of a value within the array. For example, the statement <b>color b = img.pixels[230]</b> will set the variable b equal to the value at that 
		location in the array. Before accessing this array, the data must loaded with the <b>loadPixels()</b> method. After the array data has been modified, 
		the <b>updatePixels()</b> method must be run to update the changes. Without <b>loadPixels()</b>, running the code may (or will in future releases) result in a NullPointerException.</td>
	</tr>
	<tr class="">
		<th scope="row">Syntax</th>
		<td><pre><kbd>img</kbd>.pixels[<kbd>index</kbd>]</pre></td>
	</tr>
	
	<tr class="">
		<th scope="row">Parameters</th>
		<td>
		<table cellpadding="0" cellspacing="0" border="0">
			<tr class="">
				<th scope="row">img</th>
				<td>PImage: any variable of type PImage</td>
			</tr>
			<tr class="">
				<th scope="row">index</th>
				<td>int: must not exceed the size of the array</td>
			</tr>
		</table>
		</td>
	</tr>
	<tr class="">
		<th scope="row">Usage</th>
		<td>Web & Application</td>

	</tr>
	<tr class="">

		<th scope="row">Related</th>
		<td><a href="/reference/get_">get()</a><br />
		<a href="/reference/set_">set()</a><br />
		<a href="/reference/blend_">blend()</a><br />
		<a href="/reference/copy_">copy()</a><br /></td>
	</tr>
	</table>