チラつき解消も！Python wxPythonで美しい描画を実現するwx.PaintEvent活用術

導入：なぜwx.PaintEventが描画の要なのか？

PythonでGUIアプリケーションを作成できるライブラリ、wxPython（バージョン3.0以降のPhoenixを推奨）を使って、カスタムな描画やグラフ表示に挑戦したいと考えている方は多いでしょう。しかし、実際に描画を始めると、「いつ、どこでコードを書けばいいのか」「なぜか描画がちらつく」といった問題に直面しがちです。

結論から言うと、wxPythonでの描画処理は、**wx.PaintEvent**という特定のイベントを中心に回っています。

この記事を読むことで、あなたは以下のことを解決し、wxPythonで美しいカスタム描画を実現できるようになります。

• wx.PaintEventの役割と発生タイミングを完全に理解できる。
• 描画に必要な**wx.PaintDC**と他のDC（Device Context）との違いを把握し、正しく使い分けられる。
• 最も厄介な描画の**「チラつき」を解消する**、ダブルバッファリングの実装方法を学べる。

wxPythonで自作コンポーネントを描画する極意を、基本から実践まで見ていきましょう。

本記事で解説するwx.PaintEventについての公式ドキュメントはこちらです。

2. wx.PaintEventの基本と発生タイミング

wxPythonでは、描画は必要になったときだけ行われる仕組みになっています。その「必要になった」という信号をプログラムに伝えるのが、**wx.PaintEvent**の役割です。

描画処理は、このイベントを受信したとき、つまりイベントハンドラ内でのみ行うのがwxPythonの基本的なルールです。このルールを守ることが、正しく描画を行うための第一歩となります。

2.1. wx.PaintEventの発生条件（いつ呼ばれるのか）

wx.PaintEvent（イベント定数: wx.EVT_PAINT）は、主に以下のタイミングでOSやwxPythonのフレームワークによって自動的に発行されます。

1. ウィンドウが最初に表示されるとき: アプリケーション起動時や、パネルが表示される初期段階。
2. ウィンドウの一部または全体が再表示されるとき:
   • ウィンドウが他のウィンドウに隠され、再び手前に表示されたとき。
   • ウィンドウがサイズ変更されたとき（リサイズ）。
3. プログラムから再描画が指示されたとき:
   • wx.Windowクラスのメソッドである**Refresh()やUpdate()**が呼ばれたとき。

特に、描画内容を更新したい場合は、手動で**Refresh()**メソッドを呼び出し、wx.PaintEventを発生させる必要があります。

2.2. イベントハンドラ（EVT_PAINT）の登録方法

カスタム描画を行うパネルクラス（wx.Panelを継承したもの）内で、wx.EVT_PAINTを処理するメソッド（ここでは慣習的にon_paintとします）を関連付けます。

import wx

class CustomDrawPanel(wx.Panel):
    def __init__(self, parent):
        super().__init__(parent)
        # wx.EVT_PAINT を self.on_paint メソッドに関連付ける
        self.Bind(wx.EVT_PAINT, self.on_paint)

    def on_paint(self, event):
        # 描画コードはここに記述する
        # 必ずこのイベントハンドラ内で wx.PaintDC を使用する
        dc = wx.PaintDC(self)
        dc.DrawText("Hello, wxPython!", 10, 10)
        # DCオブジェクトは、コンストラクタ内でBegin/End処理を自動で行うため、
        # 明示的な終了処理（dc.EndDrawing()など）は通常不要です。

3. 描画の主役！DC（Device Context）の役割と種類

wxPythonで線や文字を描くとき、「どこに描くか」「どういうスタイルで描くか」を指定する必要があります。この「描画先の情報」と「描画機能」をまとめて提供してくれるのが、**DC（Device Context：デバイスコンテキスト）**と呼ばれるクラス群です。

DCは、ペン（wx.Pen）やブラシ（wx.Brush）といったリソースを設定する機能も持っています。

3.1. wx.PaintDC：wx.PaintEvent専用のDC

wx.PaintEventハンドラ内で描画を行う場合、必ずwx.PaintDCクラスを使用しなければなりません。

他のイベント（例：ボタンクリックやマウス移動）で描画しようとすると、OSが管理する描画状態とズレが生じ、予期せぬ動作につながるため注意が必要です。

3.2. その他のDCとの違い（wx.ClientDCなど）

描画処理は基本的にwx.PaintEventに任せるべきですが、例外的に「即時描画」を行いたい場合があります。

wx.ClientDCで描画した内容は永続的ではありません。ウィンドウが再描画される（例：最小化から復帰）と消えてしまうため、永続的な描画は必ずwx.PaintEventとwx.PaintDCで行う必要があります。

4. 実践！wx.PaintEventを使ったカスタム描画の実装手順

ここでは、実際にカスタムパネルを作成し、wx.PaintEventを利用して図形を描画する基本的な手順を見ていきましょう。

4.1. 基本的なカスタムパネルの作成

描画を行うためのクラス**MyCanvasを、基底クラスであるwx.Panelを継承して作成します。描画リソースであるwx.Penとwx.Brush**も準備します。

import wx
import random

class MyCanvas(wx.Panel):
    def __init__(self, parent):
        super().__init__(parent, size=(400, 300))
        self.SetBackgroundColour("WHITE")
        self.Bind(wx.EVT_PAINT, self.on_paint)
        
        # 描画リソースの準備
        # 赤い実線のペン (太さ3)
        self.pen = wx.Pen("RED", 3)
        # 緑色の塗りつぶしブラシ
        self.brush = wx.Brush("GREEN")
        
    # ... (on_paintメソッドは次項で実装)

4.2. on_paintメソッドの実装と描画コード

on_paintメソッド内で**wx.PaintDC**をインスタンス化し、描画メソッドを呼び出します。

    def on_paint(self, event):
        # 描画コンテキストの作成 (wx.PaintEvent専用)
        dc = wx.PaintDC(self)
        
        # 描画リソースの設定
        dc.SetPen(self.pen)
        dc.SetBrush(self.brush)
        
        # 1. 四角形を描画 (塗りつぶしあり)
        dc.DrawRectangle(50, 50, 100, 100)

        # 2. ペンを変更して線を描画
        dc.SetPen(wx.Pen("BLUE", 2, wx.PENSTYLE_DOT))
        dc.DrawLine(200, 50, 350, 150)
        
        # 3. テキストを描画
        dc.SetTextForeground("BLACK")
        dc.DrawText("カスタム描画のテスト", 50, 180)

これで、パネルの表示時やリサイズ時に、設定した図形が自動的に描画されるようになりました。

5. 【重要】描画の「チラつき」を解消するダブルバッファリング

カスタム描画を行う際、ウィンドウのリサイズや頻繁な再描画（例：アニメーション）によって、図形がチカチカと点滅する現象が起きることがあります。これが「チラつき」です。

5.1. なぜ描画はチラつくのか？原因の理解

チラつきの主な原因は、描画の過程が画面に逐一表示されてしまうことにあります。

1. 古い描画内容が消去（背景色で塗りつぶし）される。
2. 新しい描画内容が、線や図形ごとに少しずつ画面に描かれていく。

この1と2の間にわずかな時間差があるため、ユーザーの目には描画途中の状態や、背景が剥き出しになった瞬間が視認され、「チラつき」として認識されます。

5.2. wx.BufferedPaintDCによる簡単な対策

このチラつきを解消する最も簡単な、かつ効果的な手法がダブルバッファリングです。

ダブルバッファリングの仕組みは以下の通りです。

描画処理を画面の「裏側」（メモリ上のビットマップ）で行い、完全に描画が終了してから、その結果を一気に画面に転送する。

wxPythonでは、この面倒な処理を自動で行ってくれる**wx.BufferedPaintDC**クラスが用意されています。

コードの修正は非常にシンプルです。先ほどのon_paintメソッド内で、wx.PaintDCをwx.BufferedPaintDCに置き換えるだけです。

    def on_paint(self, event):
        # *** 変更点: wx.PaintDC の代わりに wx.BufferedPaintDC を使用する ***
        dc = wx.BufferedPaintDC(self)
        
        # チラつきを防ぐため、まず背景色で全体を塗りつぶす
        # (BufferedPaintDCの場合、メモリ上のバッファをクリアする)
        dc.SetBackground(wx.Brush(self.GetBackgroundColour()))
        dc.Clear()
        
        # ここに上記 4.2 で実装した描画コードをすべて記述する
        # ... (dc.SetPen, dc.DrawRectangle など)

これで、複雑なコードを書くことなく、描画のチラつきを大幅に軽減し、ユーザーにとって快適な表示を実現できます。

6. まとめ：wx.PaintEventマスターへの道

この記事では、Python wxPythonで美しいカスタム描画を実現するために必須となるwx.PaintEventの活用術を解説しました。

重要なポイントは、以下の3点です。

1. 描画のトリガーはwx.PaintEvent：描画内容の更新が必要なときは、self.Refresh()を呼び出してこのイベントを発生させる。
2. 描画コンテキストはwx.PaintDC：wx.PaintEventハンドラ内では、専用のwx.PaintDC（またはwx.BufferedPaintDC）を使う。
3. チラつき対策はwx.BufferedPaintDC：描画時のチラつきに悩んだら、wx.PaintDCをwx.BufferedPaintDCに置き換えるだけで解決できる。

これらの基礎知識をマスターすれば、wxPythonを使ったグラフやカスタムウィジェットなど、より高度なGUIアプリケーション開発に自信を持って取り組めるはずです。

補足情報