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 두 개의 버퍼를 사용합니다. 백 버퍼는 시스템 메모리에 할당되며 현재 표시되지 않는 콘텐츠를 누적합니다. 프런트 버퍼는 시스템 메모리에 할당되며 현재 표시되는 콘텐츠를 포함합니다. 렌더링 시스템은 디스플레이를 위해 전면 버퍼를 비디오 메모리에 복사합니다.

두 스레드는 이러한 버퍼를 사용합니다. UI(사용자 인터페이스) 스레드는 UI를 생성하지만 화면에는 표시되지 않습니다. UI 스레드는 사용자 입력, 타이머 및 기타 이벤트에 응답합니다. 애플리케이션이 여러 UI 스레드를 가질 수 있습니다. 렌더링 스레드는 UI 스레드의 변경 내용을 작성하고 렌더링합니다. 애플리케이션당 하나만 렌더링 스레드에 있습니다.

UI 스레드는 콘텐츠를 백 버퍼에 씁니다. 렌더링 스레드는 전면 버퍼에서 콘텐츠를 읽고 비디오 메모리에 복사합니다. 백 버퍼에 대한 변경 내용은 변경된 사각형 영역으로 추적됩니다.

오버로드 중 WritePixels 하나를 호출하여 백 버퍼의 콘텐츠를 자동으로 업데이트하고 표시합니다.

업데이트를 보다 세분화하고 백 버퍼에 대한 다중 스레드 액세스의 경우 다음 워크플로를 사용합니다.

1. 메서드를 Lock 호출하여 업데이트를 위해 백 버퍼를 예약합니다.

2. 속성에 액세스하여 백 버퍼에 대한 포인터를 BackBuffer 가져옵니다.

3. 백 버퍼에 변경 내용을 씁니다. 다른 스레드는 가 잠겨 있을 때 WriteableBitmap 백 버퍼에 변경 내용을 쓸 수 있습니다.

4. 메서드를 AddDirtyRect 호출하여 변경된 영역을 나타냅니다.

5. 메서드를 Unlock 호출하여 백 버퍼를 해제하고 화면에 프레젠테이션을 허용합니다.

업데이트가 렌더링 스레드로 전송되면 렌더링 스레드는 변경된 사각형을 백 버퍼에서 전면 버퍼로 복사합니다. 렌더링 시스템은 교착 상태를 방지하고 아티팩트(예: "찢어짐")를 다시 그리기 위해 이 교환을 제어합니다.

생성자

속성

메서드

이벤트

명시적 인터페이스 구현

적용 대상

추가 정보

• BitmapSource