GDI+ 區域操作進階：使用 GetDataSize 與 GetData 獲取區域數據

在 GDI+ 開發中，區域 是一個強大的概念，可用於裁剪、命中測試以及複雜形狀的構建。本文將深入探討如何通過 GetDataSize 和 GetData 方法獲取區域的內部數據，並演示如何利用這些數據創建新的區域對象。

背景與挑戰

原本的示例旨在獲取區域的詳細信息，但遺憾的是該版本的 GDI+ 頭文件中缺少 TRegionData 類的定義。不過這並不影響我們的目標，因為 GetRegionScans 函數同樣能完成提取區域矩形數據的任務。

效果展示

核心代碼實現

以下是完整的 Delphi 實現代碼，展示了如何獲取區域數據並創建副本：

unit Unit1;

interface

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
  Dialogs, StdCtrls;

type
  TForm1 = class(TForm)
    procedure FormPaint(Sender: TObject);
  end;

var
  Form1: TForm1;

implementation

{$R *.dfm}
uses GDIPOBJ, GDIPAPI;

procedure TForm1.FormPaint(Sender: TObject);
var
  g: TGPGraphics;
  p: TGPPen;
  b: TGPSolidBrush;
  path: TGPGraphicsPath;
  rgn1, rgn2: TGPRegion;
  RgnData: PByte;
  rt: TGPRect;
begin
  g := TGPGraphics.Create(Canvas.Handle);
  p := TGPPen.Create(aclRed);
  b := TGPSolidBrush.Create(MakeColor(50, 0, 0, 255));

  {建立並填充第一個區域}
  path := TGPGraphicsPath.Create;
  path.AddEllipse(MakeRect(20, 20, ClientWidth - 40, ClientHeight - 40));
  rgn1 := TGPRegion.Create(path);
  g.FillRegion(b, rgn1);

  {根據第一個區域的數據創建第二個區域}
  GetMem(RgnData, rgn1.GetDataSize); {分配內存空間}
  rgn1.GetData(RgnData, rgn1.GetDataSize); {獲取區域二進制數據}
  rgn2 := TGPRegion.Create(RgnData, rgn1.GetDataSize); {根據數據創建新區域}
  rgn2.GetBounds(rt, g); {獲取新區域的邊界矩形}
  g.DrawRectangle(p, rt); {繪製邊界矩形}
  FreeMem(RgnData); {釋放內存}

  {若僅為複製區域，以下三行可替代上述六行}
  // rgn2 := rgn1.Clone;
  // rgn2.GetBounds(rt, g);
  // g.DrawRectangle(p, rt);

  rgn1.Free;
  rgn2.Free;
  path.Free;
  b.Free;
  p.Free;
  g.Free;
end;

end.

窗體設計文件

object Form1: TForm1
  Left = 0
  Top = 0
  Caption = 'Form1'
  ClientHeight = 171
  ClientWidth = 243
  Color = clBtnFace
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWindowText
  Font.Height = -11
  Font.Name = 'Tahoma'
  Font.Style = []
  OldCreateOrder = False
  Position = poDesktopCenter
  OnPaint = FormPaint
  PixelsPerInch = 96
  TextHeight = 13
end

關鍵點解析

• GetDataSize：返回存儲區域數據所需的緩衝區大小（字節數）。
• GetData：將區域的內部表示（矩形掃描數據）複製到預分配的緩衝區中。
• 利用這兩個方法可實現區域的序列化、跨上下文傳遞或深度複製。
• 實際開發中，Clone 方法提供了更簡便的區域複製方式。

掌握區域數據的獲取與重建，對於實現複雜的圖形操作、撤銷/重做功能以及圖形數據的持久化存儲具有重要價值。