5.4 画面キャプチャツール

# pahooSnap 開発記録

## 作成条件

- 新規作成（配布用）、バージョン 1.0.0
- Windows 10以上、64ビット、C# / WPF / .NET 10
- 通知領域へ常駐し、右クリックメニューとグローバルホットキーから起動
- 右クリックメニューは標準Windows形式とし、機能アイコン、区切り線、アクセスキーを表示
- メニューから保存先フォルダーの表示とホットキーの一時的な有効／無効切替が可能
- メニューの「画像ファイルに保存」「クリップボードにコピー」を個別に選択可能とし、少なくとも一方を必須とする
- PrintScreenを含む特殊キーを単独またはキーコンビネーションでホットキー登録可能
- デスクトップ全体、トップレベルウィンドウ、指定ウィンドウ、指定範囲を保存
- BMP、JPEG、PNG、WebP画像に対応
- 保存先、ファイル名、ホットキーを永続化
- 外部通信およびサーバー技術は使用しない
- ローカルHTMLヘルプ、バージョン情報、技術情報サイトへのリンクを用意
- 未処理例外は詳細表示後に安全に終了
- .NET 10 Release / win-x64、警告・エラー0件、自己テスト3件を合格条件とする
- WiX 4による64ビットMSIを作成する

## 補足

WebPエンコードにはMIT LicenseのSkiaSharpを使用し、他形式では読み込まない。
ファイル名初期値は psnap-YYYYMMDD_hhmmss とする。
待機中はタイマーやポーリングを使用せず、Windowsメッセージによるイベント駆動とする。
アイコン原稿は resourceICON/pahooSnap.png、生成ICOは pahooSnap.ico とする。

public MainWindow()
{
    _settings = SnapSettings.Load();
    _handle = new WindowInteropHelper(this).EnsureHandle();
    _source = HwndSource.FromHwnd(_handle);
    _source.AddHook(WndProc);
    Closing += (_, e) =>
    {
        if (!_allowClose) { e.Cancel = true; Hide(); }
    };
}

public void InitializeTray()
{
    _tray = new Forms.NotifyIcon
    {
        Icon = new Icon(iconPath),
        Text = "pahooSnap - 画面スナップショットツール",
        Visible = true,
        ContextMenuStrip = BuildTrayMenu()
    };
    _tray.DoubleClick += (_, _) => ShowSettings();
}

private void EnsureSettingsUi()
{
    if (_settingsUiInitialized) return;
    InitializeComponent();
    _settingsUiInitialized = true;
}

private void RegisterHotkeys(SnapSettings settings)
{
    string[] values = [settings.DesktopHotkey, settings.ActiveHotkey,
                        settings.WindowHotkey, settings.RegionHotkey];
    for (int i = 0; i < values.Length; i++)
    {
        var (modifiers, key) = ParseHotkey(values[i]);
        NativeMethods.RegisterHotKey(_handle, i + 1, modifiers, key);
    }
}

private nint WndProc(nint hwnd, int message, nint wParam, nint lParam, ref bool handled)
{
    if (message != NativeMethods.WmHotkey) return 0;
    handled = true;
    _ = ((int)wParam) switch
    {
        1 => CaptureDesktopAsync(),
        2 => CaptureActiveWindowAsync(),
        3 => CaptureSelectedAsync(SelectionMode.Window),
        4 => CaptureSelectedAsync(SelectionMode.Region),
        _ => Task.CompletedTask
    };
    return 0;
}

private void HotkeyBox_PreviewKeyUp(object sender, KeyEventArgs e)
{
    Key key = e.Key == Key.System ? e.SystemKey : e.Key;
    if (key != Key.Snapshot) return;
    e.Handled = true;
    SetCapturedHotkey(sender, key);
}

internal static partial class NativeMethods
{
    [LibraryImport("user32.dll")]
    [return: MarshalAs(UnmanagedType.Bool)]
    internal static partial bool RegisterHotKey(nint hWnd, int id, uint fsModifiers, uint vk);
    
[LibraryImport("user32.dll")]
    internal static partial nint GetForegroundWindow();
    
[LibraryImport("dwmapi.dll")]
    internal static partial int DwmGetWindowAttribute(nint hwnd, int attribute, out Rect rect, int size);
}

internal static bool TryGetWindowBounds(nint hwnd, out Rectangle rectangle)
{
    if (DwmGetWindowAttribute(hwnd, DwmwaExtendedFrameBounds, out Rect dwmRect, ...) == 0)
        rectangle = dwmRect.ToRectangle();
    else if (GetWindowRect(hwnd, out Rect rect))
        rectangle = rect.ToRectangle();
    return rectangle.Width > 0 && rectangle.Height > 0;
}

internal static Bitmap CaptureBitmap(Rectangle bounds)
{
    var bitmap = new Bitmap(bounds.Width, bounds.Height, PixelFormat.Format32bppArgb);
    using (Graphics graphics = Graphics.FromImage(bitmap))
        graphics.CopyFromScreen(bounds.Location, Point.Empty, bounds.Size,
                                 CopyPixelOperation.SourceCopy);
    return bitmap;
}

<Window x:Class="PahooSnap.SelectionOverlay"
        WindowStyle="None" AllowsTransparency="True" Background="#55000000"
        Topmost="True" ShowInTaskbar="False" Cursor="Cross" ResizeMode="NoResize">
  <Canvas x:Name="Surface">
    <Rectangle x:Name="Outline" Stroke="#FF24A0ED" StrokeThickness="3"
               Fill="#22FFFFFF" Visibility="Collapsed"/>
    <Border Canvas.Left="16" Canvas.Top="16" Background="#DD202020" CornerRadius="5">
      <TextBlock x:Name="GuideText" Foreground="White"/>
    </Border>
  </Canvas>
</Window>

private bool TryWindowAt(Point point, out Rectangle bounds)
{
    nint hwnd = NativeMethods.GetWindow(_overlayHandle, NativeMethods.GwHwndNext);
    for (int count = 0; hwnd != 0 && count < 512; count++,
        hwnd = NativeMethods.GetWindow(hwnd, NativeMethods.GwHwndNext))
    {
        if (NativeMethods.TryGetWindowBounds(hwnd, out bounds)
            && bounds.Contains(nativePoint)) return true;
    }
    bounds = default;
    return false;
}

<ItemGroup>
  <PackageReference Include="SkiaSharp" Version="4.152.1" />
</ItemGroup>

private static void SaveWebP(Bitmap bitmap, string path)
{
    BitmapData data = bitmap.LockBits(rectangle, ImageLockMode.ReadOnly,
                                       PixelFormat.Format32bppPArgb);
    var info = new SKImageInfo(bitmap.Width, bitmap.Height,
                                SKColorType.Bgra8888, SKAlphaType.Premul);
    using var pixmap = new SKPixmap(info, data.Scan0, data.Stride);
    using var image = SKImage.FromPixels(pixmap);
    using SKData encoded = image.Encode(SKEncodedImageFormat.Webp, 90);
    using FileStream stream = File.Create(path);
    encoded.SaveTo(stream);
}

byte[] header = File.ReadAllBytes(path);
if (Encoding.ASCII.GetString(header, 0, 4) != "RIFF"
    || Encoding.ASCII.GetString(header, 8, 4) != "WEBP")
    throw new InvalidOperationException("WebPシグネチャが不正です。");

private static async Task CopyToClipboardAsync(Bitmap bitmap)
{
    for (int attempt = 1; attempt <= 3; attempt++)
    {
        try { Forms.Clipboard.SetImage(bitmap); return; }
        catch (ExternalException) when (attempt < 3) { await Task.Delay(50); }
    }
}

if (!fileItem.Checked && !clipboardItem.Checked)
{
    clickedItem.Checked = true;
    _tray.ShowBalloonTip(2000);
    return;
}

_mutex = new Mutex(true, "Local\\pahoo.org.pahooSnap", out bool created);
if (!created)
{
    MessageBox.Show("pahooSnap は既に起動しています。");
    Shutdown();
    return;
}

DispatcherUnhandledException += (_, args) =>
{
    MessageBox.Show($"予期しないエラーが発生しました。安全のため終了します。\n\n{args.Exception}");
    args.Handled = true;
    Shutdown(1);
};
AppDomain.CurrentDomain.UnhandledException += (_, args) =>
{
    File.WriteAllText(Path.Combine(Path.GetTempPath(), "pahooSnap-error.txt"),
                       args.ExceptionObject.ToString());
};

# 依頼
pahooSnap に、動作の記録（ログ）をファイルへ書き出す機能を追加してほしい。

# 保存先
- %LOCALAPPDATA%\pahoo.org\pahooSnap\log\ に保存する。
- ファイル名は pahooSnap_yyyyMMdd.log とし、日付ごとに分ける。
- 30日より古いログファイルは、起動時に自動で削除する。

# 記録する内容
- 1行につき「日時 種別 内容」の順に、タブ区切りで書く。
- 種別は INFO（通常）、WARN（注意）、ERROR（異常）の3種類とする。
- 次のできごとを記録する。
  - アプリの起動と終了（バージョン番号も記録する）
  - ホットキーの登録の成功・失敗（失敗した場合はキーの内容）
  - キャプチャの実行（対象の種類、保存先パス、クリップボードの成否）
  - 未処理例外（種別 ERROR で、内容と発生個所）

# 条件
- 外部ライブラリ（NuGetパッケージ）は追加しない。
- ログの書き込みに失敗しても、アプリの動作は止めない。
- 追加後、dotnet build でビルドし、警告とエラーが無いことを確認してほしい。

<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
<NoWarn>CA1416</NoWarn>

<Package Name="pahooSnap画面スナップショットツール" Manufacturer="pahoo.org"
         Version="1.0.0" UpgradeCode="AEFBCCF4-8D39-4B55-A0B6-E1FC1AEE0A63"
         Language="1041" Codepage="932" Scope="perMachine">
  <Icon Id="AppIcon" SourceFile="pahooSnap.ico"/>
  <Property Id="ARPPRODUCTICON" Value="AppIcon"/>
  ...
  <Component Id="MainProgram" ...>
    <File Id="MainExe" Source="publish\pahooSnap.exe" KeyPath="yes"/>
    <File Id="SkiaSharpDll" Source="publish\SkiaSharp.dll"/>
    <File Id="SkiaNativeDll" Source="publish\libSkiaSharp.dll"/>
    ...
  </Component>
  <Directory Id="HelpFolder" Name="help">
    <Component Id="HelpFiles" ...>
      <File Id="HelpHtml" Source="help\index.html" KeyPath="yes"/>
      <File Id="HelpCss" Source="help\style.css"/>
    </Component>
  </Directory>
</Package>

private void OpenHelp()
{
    string path = Path.Combine(AppContext.BaseDirectory, "help", "index.html");
    Process.Start(new ProcessStartInfo(path) { UseShellExecute = true });
}