Introduction

The Fill method sets the entire ImageData to be the same color. For example, to make the entire ImageData black, use the following call:

imageDataInstance.Fill(Color.Black);

Performance

Keep in mind that filling an ImageData is much slower than rendering to a texture. If you are working with large ImageDatas, avoid calling Fill on them frequently for performance reasons.

Introduction

The ImageData class represents modifiable data that can be created from a Texture2D, or be used to construct a Texture2D. The ImageData class can be used to easily interact with the Texture2D class, and also provides a cross-platform way of creating and modifying textures.

Creating Textures

Add the following using statements:

using Texture2D = Microsoft.Xna.Framework.Graphics.Texture2D;
using Color = Microsoft.Xna.Framework.Graphics.Color;
using FlatRedBall.Graphics.Texture;

Add the following to Initialize after initializing FlatRedBall:

ImageData imageData = new ImageData(32, 32);

imageData.Fill(Color.Blue);

// let's plot some random pixels:

for (int i = 0; i < 50; i++)
{
    int randomX = FlatRedBallServices.Random.Next(
        imageData.Width);
    int randomY = FlatRedBallServices.Random.Next(
        imageData.Height);

    imageData.SetPixel(randomX, randomY, Color.Yellow);
}

// Create the texture
Texture2D texture2D = imageData.ToTexture2D();
// Give it a name.  Make sure this is unique!
texture2D.Name = "MyDynamicTexture";

// We will want to associate the created Texture2D with a
// ContentManager.  If you're in a Screen, use the Screen's
// ContentManager.  Here we'll just make one up:
FlatRedBallServices.AddDisposable(
    texture2D.Name,
    texture2D,
    "MyContentManager");

// Finally, let's use this Texture so we can actually see it
Sprite sprite = SpriteManager.AddSprite(texture2D);

// Set these numbers higher if using FSB or if you're in pixel
// pixel coordinates:
sprite.ScaleX = 10;
sprite.ScaleY = 10;

Note: This code uses the Color and Texture2D classes. Remember, if you are using a version of FlatRedBall other than FlatRedBall XNA, your using statements will be different. For more information, see:

• Microsoft.Xna.Framework.Graphics.Texture2D

• Microsoft.Xna.Framework.Graphics.Color

Additional Information

• Fog of war using ImageData with source and in-browser FSB demo.

ImageData Members

• FlatRedBall.Graphics.Texture.ImageData.ApplyColorOperation

• FlatRedBall.Graphics.Texture.ImageData.Fill

Did this article leave any questions unanswered? Post any question in our forums for a rapid response.

Introduction

FromTexture2D creates an ImageData object, filled with data from a Texture2D instance. It's important to note that the ImageData is a copy of the Texture2D, so making changes to the ImageData will not change the source Texture2D.

Code Example

The following code shows how to create an ImageData instance from a Texture2D instance, then loop through each pixel:

Introduction

ApplyColorOperation is a method which can be used to modify an ImageData using the same ColorOperation and Red,Green,Blue values that are present in the interface which is implemented by common FlatRedball objects such as and . ApplyColorOperation modifies the data stored in an ImageData permanently - it cannot be undone.

Code Example

ApplyColorOperation can be used to modify a texture so that when rendered normally, it will appear the same as a Sprite with the same ColorOperation and Red/Green/Blue values. The following code shows a texture being rendered using a Modulate color operation: