萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 使用 GDI+ 繪製太極圖並直接輸出 JPEG 圖片串流

ASP.NET 可利用 `System.Drawing` (GDI+ 封裝) 在伺服端動態繪製圖形並以二進位串流輸出,無需產生實體檔案。本文以繪製太極圖 (陰陽魚) 為例,示範 `Bitmap`、`Graphics`、路徑 (`GraphicsPath`)、漸層/抗鋸齒、高品質 JPEG 編碼輸出的完整流程。

完整程式碼 (Generic Handler .ashx 推薦)

建議使用 `.ashx` 而非 `.aspx`,避免頁面生命週期開銷:

// TaiJiHandler.ashx.cs
public class TaiJiHandler : IHttpHandler {
    public bool IsReusable => true;

    public void ProcessRequest(HttpContext context) {
        int size = 400; // 畫布大小
        int eyeR = size / 20;
        int headD = size / 2;

        using (var bmp = new Bitmap(size, size))
        using (var g = Graphics.FromImage(bmp)) {
            // 高品質設定
            g.SmoothingMode = SmoothingMode.AntiAlias;
            g.InterpolationMode = InterpolationMode.HighQualityBicubic;
            g.CompositingQuality = CompositingQuality.HighQuality;

            // 底色
            g.Clear(Color.White);

            // 筆刷
            var blue = new SolidBrush(Color.FromArgb(30, 144, 255)); // DodgerBlue
            var red = new SolidBrush(Color.FromArgb(220, 20, 60));   // Crimson

            // 1. 整圓藍色 (陰)
            g.FillPie(blue, 0, 0, size, size, 0, 360);

            // 2. 右半邊紅色路徑 (陽)
            var rightPath = new GraphicsPath();
            rightPath.AddArc(0, 0, size, size, 0, -180);           // 右半圓
            rightPath.AddArc(0, headD / 2, headD, headD, 0, -180); // 上小半圓 (內凹)
            rightPath.AddArc(headD, headD / 2, headD, headD, 0, 180); // 下小半圓 (外凸)
            g.FillPath(red, rightPath);

            // 3. 眼睛
            g.FillEllipse(red, headD / 2 - eyeR, headD - eyeR, eyeR * 2, eyeR * 2); // 紅眼 (在藍區)
            g.FillEllipse(blue, headD + headD / 2 - eyeR, headD - eyeR, eyeR * 2, eyeR * 2); // 藍眼 (在紅區)

            // 輸出高品質 JPEG
            context.Response.ContentType = "image/jpeg";
            var encoder = ImageCodecInfo.GetImageEncoders().First(c => c.FormatID == ImageFormat.Jpeg.Guid);
            var params = new EncoderParameters(1) { Param = new[] { new EncoderParameter(Encoder.Quality, 95L) } };
            bmp.Save(context.Response.OutputStream, encoder, params);
        }
    }
}

.ashx 註冊 (web.config)

<system.webServer>
  <handlers>
    <add name="TaiJi" verb="*" path="TaiJi.ashx" type="Namespace.TaiJiHandler" preCondition="integratedMode" />
  </handlers>
</system.webServer>

前端引用

<img src="TaiJi.ashx?size=400" alt="太極圖" />
<!-- 可透過 QueryString 動態調整尺寸 -->

關鍵技術細節

  1. GraphicsPath 建構陰陽魚:三段弧線 (`AddArc`) 組成 S 形曲線,利用 `FillPath` 填滿右側紅色區域。
  2. 座標計算:以畫布中心為基準,`headD = size/2` 為魚頭直徑,小半圓半徑 = `headD/2`,位置對稱。
  3. 抗鋸齒與插值:`SmoothingMode.AntiAlias` + `InterpolationMode.HighQualityBicubic` 讓曲線邊緣平滑。
  4. JPEG 品質參數:`Encoder.Quality` 95L 平衡檔案大小與視覺品質;若需無損改用 PNG (`ImageFormat.Png`)。
  5. 資源釋放:`using` 區塊確保 `Bitmap`、`Graphics`、筆刷、路徑、Encoder 參數及時 `Dispose()`,防止 GDI+ 物件洩漏導致「一般性錯誤」。

擴充:動態參數化

// 從 QueryString 讀取尺寸、顏色
int size = int.TryParse(context.Request["size"], out int s) ? Math.Clamp(s, 50, 2000) : 400;
Color yinColor = ColorTranslator.FromHtml(context.Request["yin"] ?? "#1E90FF");
Color yangColor = ColorTranslator.FromHtml(context.Request["yang"] ?? "#DC143C");

效能與架構建議

  • **快取輸出**:相同參數產生的圖片可快取 (OutputCache / MemoryCache / CDN),避免重複繪製。
  • **非同步處理**:.NET 4.5+ 可實作 `IHttpAsyncHandler` 或改用 ASP.NET Core Middleware。
  • **Docker/Linux 部署**:`System.Drawing.Common` 僅支援 Windows/Linux (需 `libgdiplus`),建議遷移至 `SkiaSharp` 或 `ImageSharp` 取得跨平台一致性。

掌握 GDI+ 伺服端繪圖輸出串流,即可實現驗證碼、圖表、報表圖片、動態水印等多種即時圖像服務。

copyright © 萬盛學電腦網 all rights reserved