【入門編】【上級者向け】VB.NETのWPFにおけるWriteableBitmapとImageコントロールを駆使した超高速カスタム画像・図面描画 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク
スポンサーリンク

【極限の知見】WPF描画の限界を突破する:WriteableBitmapによる超高速ピクセル操作術

こんにちは。プログラミングの深淵へようこそ。

これまで、あなたはVisual Basic (VB.NET) を使って、ボタンを配置したり、テキストボックスに値を表示したりする「標準的なUI」を構築してきたことでしょう。それは素晴らしい第一歩です。しかし、もしあなたが「センサーから送られてくる毎秒数千件の波形データをリアルタイムに表示したい」とか、「数万個の粒子が飛び交うシミュレーションを作りたい」と考えたとき、一つの壁にぶつかるはずです。

それは、「標準の図形(Shape)コントロールでは、描画が追いつかずに画面が固まってしまう」という問題です。

今日は、その壁を軽々と飛び越えるための、伝説的なテクニックを伝授します。キーワードは `WriteableBitmap`。オブジェクトを一つずつ描くのではなく、メモリ上の「ピクセル(点)」を直接書き換える、プロフェッショナルな描画手法の世界へご案内しましょう。

1. なぜ標準の「Shape」では遅いのか?

まず、なぜ `Rectangle` や `Ellipse` を大量に並べると重くなるのか、その本質を理解しましょう。

WPFの標準的な図形コントロールは、「リテインモード(保持モード)」という仕組みで動いています。これは、「図形という『オブジェクト』をメモリ上に保持し、その状態(色や位置)を管理する」方式です。

  • 図形を1つ増やすたびに: メモリを消費し、WPFの管理リストが長くなります。
  • 図形を動かすたびに: WPFは「どの図形が、どの図形と重なっているか?」という計算(ヒットテストやレイアウト計算)を膨大な回数行います。

数千、数万という図形を扱うと、この「管理コスト」が爆発し、CPUとメモリが悲鳴を上げるのです。

一方、今回紹介する `WriteableBitmap` を使った手法は、「即時モード(インダイレクトなピクセル操作)」に近いです。「図形」という概念を捨て、単なる「色のついた点の集合体(ビットマップ)」として扱います。WPFに対して「この画像を表示して」と一度伝えるだけで、あとはメモリ上の数値を書き換えるだけ。この圧倒的な軽さこそが、超高速描画の正体です。

2. 実装の全体像:戦略を立てる

いきなりコードを書く前に、設計図を確認しましょう。

1. XAML側: 描画用の「キャンバス」として、`Image` コントロールを1つだけ置きます。
2. VB.NET側:

  • 描画領域となる `WriteableBitmap` オブジェクトを生成します。
  • その `WriteableBitmap` を `Image` コントロールに紐付けます。
  • ここが肝: 描画が必要なとき、`WriteableBitmap` の「バックバッファ(メモリ領域)」に直接アクセスし、ピクセルの色情報を書き込みます。
  • 書き込みが終わったら「書き換えたよ!」と通知して、画面を更新します。

3. 【実践】超高速描画エンジンの構築

それでは、実際に動くコードを見ていきましょう。今回は、画面上に「ランダムな色のピクセルを高速に散布する」サンプルを作成します。

XAML (MainWindow.xaml)

まずは、表示するための器を用意します。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="High-Speed Drawing Engine" Height="450" Width="800">
    <Grid>
        <!-- 描画の舞台となるImageコントロール。これ1つで全てを描画します -->
        <Image x:Name="TargetImage" Stretch="None" HorizontalAlignment="Left" VerticalAlignment="Top" />
        
        <!-- 操作用ボタン -->
        <StackPanel VerticalAlignment="Bottom" HorizontalAlignment="Right" Margin="10">
            <Button x:Name="BtnStart" Content="描画開始" Click="BtnStart_Click" Width="100" Margin="5"/>
            <Button x:Name="BtnStop" Content="停止" Click="BtnStop_Click" Width="100" Margin="5"/>
        </StackPanel>
    </Grid>
</Window>

VB.NET (MainWindow.xaml.vb)

ここが心臓部です。丁寧にコメントを添えました。

Imports System.Windows
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Windows.Threading

Class MainWindow
    ' 描画用のビットマップ
    Private _bitmap As WriteableBitmap
    ' 描画ループ用のタイマー
    Private _renderTimer As DispatcherTimer
    ' 描画範囲のサイズ
    Private ReadOnly _width As Integer = 800
    Private ReadOnly _height As Integer = 450

    ''' <summary>
    ''' 初期化処理
    ''' </summary>
    Public Sub New()
        InitializeComponent()

        ' 1. WriteableBitmapの生成
        ' Bgra32は、青(B)・緑(G)・赤(R)・アルファ(A)の順で1ピクセル4バイトで構成される形式です
        _bitmap = New WriteableBitmap(_width, _height, 96, 96, PixelFormats.Bgra32, Nothing)

        ' 2. Imageコントロールにビットマップをセット
        TargetImage.Source = _bitmap

        ' 3. タイマーの設定(描画更新用)
        _renderTimer = New DispatcherTimer()
        _renderTimer.Interval = TimeSpan.FromMilliseconds(16) ' 約60FPSを目指す
        AddHandler _renderTimer.Tick, AddressOf OnRenderTick
    End Sub

    ''' <summary>
    ''' ボタンクリック:描画開始
    ''' </summary>
    Private Sub BtnStart_Click(sender As Object, e As RoutedEventArgs)
        _renderTimer.Start()
    End Sub

    ''' <summary>
    ''' ボタンクリック:停止
    ''' </summary>
    Private Sub BtnStop_Click(sender As Object, e As RoutedEventArgs)
        _renderTimer.Stop()
    End Sub

    ''' <summary>
    ''' 描画ループのメイン処理
    ''' </summary>
    Private Sub OnRenderTick(sender As Object, e As EventArgs)
        ' 高速描画の魔法:Lockメソッドでメモリ領域を確保する
        ' これを行わないと、描画中に他のプロセスがメモリを触ってしまい、クラッシュの原因になります
        _bitmap.Lock()

        Try
            ' バックバッファ(メモリ上の生データ)の先頭アドレスを取得
            ' ここからは「ポインタ」に近い感覚でメモリを直接操作します
            Dim backBuffer As IntPtr = _bitmap.BackBuffer
            Dim stride As Integer = _bitmap.BackBufferStride ' 1行あたりのバイト数

            ' 今回はサンプルとして、ランダムなピクセルを1000個描画してみます
            Dim rng As New Random()
            For i As Integer = 0 To 1000
                Dim x As Integer = rng.Next(0, _width)
                Dim y As Integer = rng.Next(0, _height)

                ' ピクセルの位置を計算する数式:(Y座標 * 1行のバイト数) + (X座標 * 1ピクセルのバイト数)
                ' Bgra32なので、1ピクセルは4バイトです
                Dim pixelIndex As Integer = (y * stride) + (x * 4)

                ' 色の生成 (B, G, R, A)
                Dim b As Byte = CByte(rng.Next(0, 256))
                Dim g As Byte = CByte(rng.Next(0, 256))
                Dim r As Byte = CByte(rng.Next(0, 256))
                Dim a As Byte = 255 ' 不透明

                ' メモリに直接書き込む
                ' ※本来はunsafeコード(ポインタ)を使うのが最速ですが、
                ' ここでは理解しやすさを優先して、バイト配列的な操作をイメージしてください
                ' 実際には、Marshal.WriteByte 等を使用します
                System.Runtime.InteropServices.Marshal.WriteByte(backBuffer, pixelIndex, b)         ' Blue
                System.Runtime.InteropServices.Marshal.WriteByte(backBuffer, pixelIndex + 1, g)     ' Green
                System.Runtime.InteropServices.Marshal.WriteByte(backBuffer, pixelIndex + 2, r)     ' Red
                System.Runtime.InteropServices.Marshal.WriteByte(backBuffer, pixelIndex + 3, a)     ' Alpha
            Next

        Finally
            ' 4. 描画が終わったら必ずUnlock!
            ' これを忘れると、画面が更新されないだけでなく、アプリケーションがフリーズします
            _bitmap.Unlock()
        End Try
    End Sub
End Class

4. ここが重要!エンジニアが陥る「3つの罠」

この手法をマスターするために、私が現場で何度も見てきた「失敗のパターン」を共有しておきます。これを知っているだけで、あなたのデバッグ時間は劇的に減るはずです。

① `Lock` と `Unlock` のペアを忘れない

`_bitmap.Lock()` を呼び出した後、何らかのエラーが発生して `Unlock()` が呼ばれずに処理が終了してしまうと、WPFの描画エンジンは「まだ書き込み中だ」と勘違いし続け、画面が一切更新されなくなります。
対策: 必ず `Try…Finally` ブロックを使い、`Finally` の中で確実に `Unlock()` を実行してください。

② `Stride`(ストライド)を無視しない

コードの中に `stride` という変数が出てきましたね。これは「画像の一行が、メモリ上で何バイト占有しているか」を示す値です。
「画像幅 × 4バイト」だと思われがちですが、コンピュータのメモリ配置の都合上、「4の倍数や8の倍数に切り上げられた値」が入ることがあります。
対策: ピクセルの位置計算には、必ず `_bitmap.BackBufferStride` を使いましょう。これを無視すると、描画が斜めにズレるという厄介なバグに遭遇します。

③ UIスレッドの占有

上記のサンプルでは `DispatcherTimer` を使っています。これはUIスレッド(画面を管理するスレッド)上で動作します。描画処理が重すぎると、ボタン操作すら受け付けない「固まった画面」になってしまいます。
対策: 数十万個のピクセルを計算する場合などは、計算処理自体は「バックグラウンドスレッド」で行い、計算結果のメモリを最後に `WriteableBitmap` にコピーするという戦略をとります。

5. まとめ:次のステップへ

お疲れ様でした。あなたは今、単に「図形を描く」段階から、「メモリを直接操って描画を制御する」という、一段上のエンジニアの領域に足を踏み入れました。

`WriteableBitmap` は、非常に強力です。

  • リアルタイムのオシロスコープ表示
  • 高速なビデオ再生エンジン
  • 複雑なゲームの描画

これらはすべて、この技術の延長線上にあります。

「なぜ動かないのか?」と悩んだときは、常にオブジェクトのライフサイクル(生成・使用・解放)とメモリの構造に立ち返ってください。そこには必ず、答えが眠っています。

ここをクリアすれば、Visual Basic (VB.NET) の基本はバッチリですよ。自信を持って、さらに高度な実装に挑戦していってくださいね。応援しています!

タイトルとURLをコピーしました