웹 접근성 표준(WCAG 2.1)과 전자정부 UI 색상 대비율 0초 진단: ZeliColor의 Win32 GDI 스포이드, 상대 휘도(Luminance) 연산, 및 온디바이스 색 공간 변환 아키텍처

[DllImport("user32.dll")]
private static extern IntPtr GetDC(IntPtr hwnd);

[DllImport("user32.dll")]
private static extern int ReleaseDC(IntPtr hwnd, IntPtr hdc);

[DllImport("gdi32.dll")]
private static extern uint GetPixel(IntPtr hdc, int x, int y);

[DllImport("user32.dll")]
private static extern bool GetCursorPos(out POINT lpPoint);

[DllImport("user32.dll")]
private static extern short GetAsyncKeyState(int vKey);

[StructLayout(LayoutKind.Sequential)]
private struct POINT { public int X; public int Y; }

private const int VK_LBUTTON = 0x01;
private const int VK_ESCAPE = 0x1B;

// OLE COLORREF는 하위 바이트부터 R, G, B 순으로 정렬됨 (0x00BBGGRR)
byte r = (byte)(raw & 0xFF);          // 비트 0~7: Red
byte g = (byte)((raw >> 8) & 0xFF);   // 비트 8~15: Green
byte b = (byte)((raw >> 16) & 0xFF);  // 비트 16~23: Blue

// 표준 16진수 문자열 직렬화 (#RRGGBB)
string hex = $"#{r:X2}{g:X2}{b:X2}";

private void EyedropperTimer_Tick(object sender, object e)
{
    if (!_isEyedropping) { StopEyedropper(); return; }

    // 1. ESC 키를 누르면 스포이드 즉시 취소
    if ((GetAsyncKeyState(VK_ESCAPE) & 0x8000) != 0)
    {
        StopEyedropper();
        TxtEyedropperStatus.Text = Loc.Get("Color_EyedropperCancelled");
        return;
    }

    // 2. 마우스 좌클릭 감지 시 확정 샘플링 및 종료
    if ((GetAsyncKeyState(VK_LBUTTON) & 0x8000) != 0)
    {
        GetCursorPos(out POINT pt);
        IntPtr hdc = GetDC(IntPtr.Zero);
        uint raw = GetPixel(hdc, pt.X, pt.Y);
        ReleaseDC(IntPtr.Zero, hdc); // ★ 원자적 즉시 반환 (누수 차단)

        byte r = (byte)(raw & 0xFF);
        byte g = (byte)((raw >> 8) & 0xFF);
        byte b = (byte)((raw >> 16) & 0xFF);

        CommitPickedColor(r, g, b, pt);
        StopEyedropper();
        return;
    }

    // 3. 실시간 커서 하단 색상 프리뷰 (50ms마다 단발성 DC 오픈 및 즉시 릴리즈)
    GetCursorPos(out POINT curPt);
    IntPtr hdcPreview = GetDC(IntPtr.Zero);
    uint rawPreview = GetPixel(hdcPreview, curPt.X, curPt.Y);
    ReleaseDC(IntPtr.Zero, hdcPreview); // ★ 프리뷰에서도 즉시 반환

    byte pr = (byte)(rawPreview & 0xFF);
    byte pg = (byte)((rawPreview >> 8) & 0xFF);
    byte pb = (byte)((rawPreview >> 16) & 0xFF);

    TxtEyedropperStatus.Text = string.Format(
        Loc.Get("Color_CursorPosition"), curPt.X, curPt.Y, $"#{pr:X2}{pg:X2}{pb:X2}");
}

/// <summary>
/// ZeliColor에서 추출된 픽셀 RGB 데이터를 기반으로 
/// W3C WCAG 2.1 / KWCAG 2.2 명도 대비율을 산출하는 표준 검증 알고리즘
/// </summary>
public static class WcagContrastCalculator
{
    // 1. sRGB 채널 감마 역보정 (비선형 ➔ 물리적 선형 광자 강도 복원)
    private static double Linearize(double channel)
    {
        double c = channel / 255.0;
        return c <= 0.04045 ? c / 12.92 : Math.Pow((c + 0.055) / 1.055, 2.4);
    }

    // 2. ITU-R BT.709 표준 상대 휘도(Relative Luminance) 연산
    public static double GetRelativeLuminance(byte r, byte g, byte b)
    {
        double rLin = Linearize(r);
        double gLin = Linearize(g);
        double bLin = Linearize(b);
        return 0.2126 * rLin + 0.7152 * gLin + 0.0722 * bLin;
    }

    // 3. 두 색상 간의 명도 대비율 산출 (1.0:1 ~ 21.0:1)
    public static double CalculateContrastRatio(byte r1, byte g1, byte b1, byte r2, byte g2, byte b2)
    {
        double l1 = GetRelativeLuminance(r1, g1, b1);
        double l2 = GetRelativeLuminance(r2, g2, b2);

        double brighter = Math.Max(l1, l2);
        double darker = Math.Min(l1, l2);

        return (brighter + 0.05) / (darker + 0.05);
    }

    // 4. 접근성 적합성 판정 (AA 일반: 4.5:1, AA 대형: 3.0:1, AAA: 7.0:1)
    public static (bool aaNormal, bool aaLarge, bool aaaNormal) EvaluateWcag(double contrastRatio)
    {
        bool aaNormal = contrastRatio >= 4.5;
        bool aaLarge = contrastRatio >= 3.0;
        bool aaaNormal = contrastRatio >= 7.0;
        return (aaNormal, aaLarge, aaaNormal);
    }
}

/// 

/// HSL → RGB 변환 (H: 0~360, S/L: 0~1) — 외부 라이브러리 종속성 0개
/// 
private static void HslToRgb(double h, double s, double l, out byte r, out byte g, out byte b)
{
    h = ((h % 360) + 360) % 360; // 음수 각도 방어
    double c = (1 - Math.Abs(2 * l - 1)) * s;
    double x = c * (1 - Math.Abs((h / 60) % 2 - 1));
    double m = l - c / 2;
    double rd = 0, gd = 0, bd = 0;

    if (h < 60) { rd = c; gd = x; }
    else if (h < 120) { rd = x; gd = c; }
    else if (h < 180) { gd = c; bd = x; }
    else if (h < 240) { gd = x; bd = c; }
    else if (h < 300) { rd = x; bd = c; }
    else { rd = c; bd = x; }

    r = (byte)Math.Clamp(Math.Round((rd + m) * 255), 0, 255);
    g = (byte)Math.Clamp(Math.Round((gd + m) * 255), 0, 255);
    b = (byte)Math.Clamp(Math.Round((bd + m) * 255), 0, 255);
}

private void AddToPalette(byte r, byte g, byte b)
{
    if (PalettePanel == null) return;

    var rect = new Microsoft.UI.Xaml.Shapes.Rectangle
    {
        Width = 28,
        Height = 28,
        RadiusX = 4,
        RadiusY = 4,
        Fill = new SolidColorBrush(Windows.UI.Color.FromArgb(255, r, g, b)),
        Margin = new Thickness(0)
    };

    // 과거 색상 블록 클릭 시 0초 복원 이벤트 바인딩
    byte cr = r, cg = g, cb = b;
    rect.Tapped += (s, e) =>
    {
        _updatingFromSlider = true;
        TxtColorInput.Text = $"#{cr:X2}{cg:X2}{cb:X2}";
        UpdateDisplay(cr, cg, cb);
        SliderR.Value = cr;
        SliderG.Value = cg;
        SliderB.Value = cb;
        _updatingFromSlider = false;
    };

    // 최대 20개 유지 (FIFO 슬라이딩 윈도우)
    if (PalettePanel.Children.Count >= 20)
        PalettePanel.Children.RemoveAt(0);

    PalettePanel.Children.Add(rect);
}

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                        ZeliColor On-Device Color Governance Pipeline                   │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│   [ Desktop Screen Surface ]                                                           │
│              │                                                                         │
│              ▼ GetDC(IntPtr.Zero) + GetCursorPos (50ms Polling Guard)                  │
│   [ Win32 GDI Raw Pixel Engine ] ───► GetPixel(hdc, x, y)                              │
│              │                                                                         │
│              ▼ ReleaseDC(IntPtr.Zero, hdc)  ★ Zero GDI Leak Guarantee                  │
│   [ COLORREF Unpacker ] ───► (raw & 0xFF, (raw>>8) & 0xFF, (raw>>16) & 0xFF)           │
│              │                                                                         │
│              ├───────────────────────────────┬───────────────────────────────┐         │
│              ▼                               ▼                               ▼         │
│    [ Color Space Converter ]      [ WCAG 2.1 Contrast Engine ]     [ UI & Palette ]    │
│    - HEX (#RRGGBB / #RGB)         - sRGB Gamma Linearization       - 20-Slot FIFO Ring │
│    - RGB (rgb(r,g,b))             - Relative Luminance (L)         - Always-on-Top Pin │
│    - HSL (hsl(h,s%,l%))           - CR = (L1+0.05) / (L2+0.05)     - DataPackage Copy  │
│    - CSS Formatter (color: ...)   - AA (4.5:1) / AAA (7:1) Verdict - Instant Restore   │
│              │                               │                               │         │
│              └───────────────────────────────┼───────────────────────────────┘         │
│                                              ▼                                         │
│                      [ Zero-Telemetry WCAG Audit Verified ]                            │
└────────────────────────────────────────────────────────────────────────────────────────┘