WriteableBitmap クラス

定義

public ref class WriteableBitmap sealed : System::Windows::Media::Imaging::BitmapSource

public sealed class WriteableBitmap : System.Windows.Media.Imaging.BitmapSource

type WriteableBitmap = class
    inherit BitmapSource

Public NotInheritable Class WriteableBitmap
Inherits BitmapSource

継承

Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource

WriteableBitmap

例

次の例では、 を WriteableBitmap のソースとして使用して、マウスの Image 移動時にピクセルを描画する方法を示します。

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Input;

namespace WriteableBitmapDemo
{
    class Program
    {
        static WriteableBitmap writeableBitmap;
        static Window w;
        static Image i;

        [STAThread]
        static void Main(string[] args)
        {
            i = new Image();
            RenderOptions.SetBitmapScalingMode(i, BitmapScalingMode.NearestNeighbor);
            RenderOptions.SetEdgeMode(i, EdgeMode.Aliased);
           
            w = new Window();
            w.Content = i;
            w.Show();

            writeableBitmap = new WriteableBitmap(
                (int)w.ActualWidth, 
                (int)w.ActualHeight, 
                96, 
                96, 
                PixelFormats.Bgr32, 
                null);

            i.Source = writeableBitmap;

            i.Stretch = Stretch.None;
            i.HorizontalAlignment = HorizontalAlignment.Left;
            i.VerticalAlignment = VerticalAlignment.Top;

            i.MouseMove += new MouseEventHandler(i_MouseMove);
            i.MouseLeftButtonDown += 
                new MouseButtonEventHandler(i_MouseLeftButtonDown);
            i.MouseRightButtonDown += 
                new MouseButtonEventHandler(i_MouseRightButtonDown);

            w.MouseWheel += new MouseWheelEventHandler(w_MouseWheel);

            Application app = new Application();
            app.Run();
        }

        // The DrawPixel method updates the WriteableBitmap by using
        // unsafe code to write a pixel into the back buffer.
        static void DrawPixel(MouseEventArgs e)
        {
            int column = (int)e.GetPosition(i).X;
            int row = (int)e.GetPosition(i).Y;

            try{
                // Reserve the back buffer for updates.
                writeableBitmap.Lock();

                unsafe
                {
                    // Get a pointer to the back buffer.
                    IntPtr pBackBuffer = writeableBitmap.BackBuffer;

                    // Find the address of the pixel to draw.
                    pBackBuffer += row * writeableBitmap.BackBufferStride;
                    pBackBuffer += column * 4;

                    // Compute the pixel's color.
                    int color_data = 255 << 16; // R
                    color_data |= 128 << 8;   // G
                    color_data |= 255 << 0;   // B

                    // Assign the color data to the pixel.
                    *((int*) pBackBuffer) = color_data;
                }
    
                // Specify the area of the bitmap that changed.
                writeableBitmap.AddDirtyRect(new Int32Rect(column, row, 1, 1));
            }
            finally{
                // Release the back buffer and make it available for display.
                writeableBitmap.Unlock();
            }
        }

        static void ErasePixel(MouseEventArgs e)
        {
            byte[] ColorData = { 0, 0, 0, 0 }; // B G R

            Int32Rect rect = new Int32Rect(
                    (int)(e.GetPosition(i).X), 
                    (int)(e.GetPosition(i).Y), 
                    1, 
                    1);

            writeableBitmap.WritePixels( rect, ColorData, 4, 0);
        }

        static void i_MouseRightButtonDown(object sender, MouseButtonEventArgs e)
        {
            ErasePixel(e);
        }

        static void i_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
        {
            DrawPixel(e);
        }

        static void i_MouseMove(object sender, MouseEventArgs e)
        {
            if (e.LeftButton == MouseButtonState.Pressed)
            {
                DrawPixel(e);
            }
            else if (e.RightButton == MouseButtonState.Pressed)
            {
                ErasePixel(e);
            }
        }

        static void w_MouseWheel(object sender, MouseWheelEventArgs e)
        {
            System.Windows.Media.Matrix m = i.RenderTransform.Value;

            if (e.Delta > 0)
            {
                m.ScaleAt(
                    1.5, 
                    1.5, 
                    e.GetPosition(w).X, 
                    e.GetPosition(w).Y);
            }
            else
            {
                m.ScaleAt(
                    1.0 / 1.5, 
                    1.0 / 1.5, 
                    e.GetPosition(w).X, 
                    e.GetPosition(w).Y);
            }

            i.RenderTransform = new MatrixTransform(m);
        }
    }
}

注釈

クラスを WriteableBitmap 使用して、フレームごとにビットマップを更新およびレンダリングします。 これは、フラクタル画像などのアルゴリズムコンテンツを生成する場合や、音楽ビジュアライザーなどのデータ視覚化に役立ちます。

クラスは WriteableBitmap 2 つのバッファーを使用します。 バック バッファーはシステム メモリに割り当てられ、現在表示されていないコンテンツが蓄積されます。 フロント バッファーはシステム メモリに割り当てられ、現在表示されているコンテンツが含まれています。 レンダリング システムは、表示のためにフロント バッファーをビデオ メモリにコピーします。

2 つのスレッドでこれらのバッファーが使用されます。 ユーザー インターフェイス (UI) スレッドによって UI が生成されますが、画面には表示されません。 UI スレッドは、ユーザー入力、タイマー、およびその他のイベントに応答します。 アプリケーションには複数の UI スレッドを含めることができます。 レンダリング スレッドは、UI スレッドから変更を作成してレンダリングします。 アプリケーションごとにレンダリング スレッドは 1 つだけです。

UI スレッドは、コンテンツをバック バッファーに書き込みます。 レンダー スレッドは、フロント バッファーからコンテンツを読み取り、ビデオ メモリにコピーします。 バック バッファーへの変更は、変更された四角形領域で追跡されます。

いずれかのオーバーロードを WritePixels 呼び出して、バック バッファー内のコンテンツを自動的に更新して表示します。

更新をより細かく制御し、バック バッファーへのマルチスレッド アクセスを行う場合は、次のワークフローを使用します。

1. メソッドを Lock 呼び出して、更新プログラムのバック バッファーを予約します。

2. プロパティにアクセスして、バック バッファーへのポインターを BackBuffer 取得します。

3. バック バッファーに変更を書き込みます。 がロックされている場合、他のスレッドがバック バッファーに変更を WriteableBitmap 書き込む場合があります。

4. メソッドを AddDirtyRect 呼び出して、変更された領域を示します。

5. メソッドを Unlock 呼び出してバック バッファーを解放し、画面へのプレゼンテーションを許可します。

更新がレンダリング スレッドに送信されると、レンダリング スレッドは、変更された四角形をバック バッファーからフロント バッファーにコピーします。 レンダリング システムは、デッドロックを回避し、"ティアリング" などの成果物を再描画するために、この交換を制御します。

コンストラクター

プロパティ

メソッド

イベント

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• BitmapSource