// ScreenPreview.h
// 屏幕预览：抓主屏 → 等比缩放 → JPEG 编码，供 COMMAND_SCREEN_PREVIEW_REQ 响应使用。
#pragma once

#include <vector>

// 抓取主屏并编码成 JPEG。
//   maxWidth   服务端期望的宽度；客户端按源屏宽度等比缩放，不会强制放大
//   quality    JPEG 质量 1..100（建议 40..85）
//   out        编码后的 JPEG 字节流
//   outWidth   实际编码图宽
//   outHeight  实际编码图高
// 返回 0 表示成功；非 0 见 ScreenPreviewStatus（枚举在 commands.h）
int CaptureAndEncodePreview(int maxWidth, int quality,
                            std::vector<unsigned char>& out,
                            int& outWidth, int& outHeight);