当前位置：首页 > news >正文

Bmp格式详解

news 2026/8/11 0:50:10

将为播放器添加完整的BMP截图功能，支持四种位图格式。

BMP截图功能头文件

/** * @file screenshot_manager.h * @brief BMP截图管理器头文件 - 支持四种位图格式 * @details 实现线画稿、灰度图像、索引图像、真彩色图像的BMP截图功能 */  #ifndef SCREENSHOT_MANAGER_H #define SCREENSHOT_MANAGER_H  #include <stdint.h> #include <stdbool.h> #include <stdio.h>  /* BMP文件类型定义 */ #define BMP_FILE_TYPE 0x4D42 // "BM" 小端序  /* 位图类型定义 */ typedef enum { BMP_TYPE_MONOCHROME = 1, ///< 线画稿(单色) - 1位每像素 BMP_TYPE_GRAYSCALE = 8, ///< 灰度图像 - 8位每像素 BMP_TYPE_INDEXED = 8, ///< 索引图像 - 8位每像素(使用调色板) BMP_TYPE_TRUECOLOR = 24 ///< 真彩色图像 - 24位每像素 } BitmapType;  /* 压缩类型定义 */ typedef enum { BMP_COMPRESSION_NONE = 0, ///< 不压缩 BMP_COMPRESSION_RLE8 = 1, ///< RLE8压缩 BMP_COMPRESSION_RLE4 = 2 ///< RLE4压缩 } CompressionType;  /* BMP文件头结构体 - 严格按照Windows BMP格式 */ #pragma pack(push, 1) // 1字节对齐，确保结构体大小准确 typedef struct { uint16_t bfType; ///< 文件类型，必须为"BM" uint32_t bfSize; ///< 文件大小，以字节为单位 uint16_t bfReserved1; ///< 保留字，必须为0 uint16_t bfReserved2; ///< 保留字，必须为0 uint32_t bfOffBits; ///< 位图数据起始位置偏移量 } BITMAPFILEHEADER;  /* BMP信息头结构体 */ typedef struct { uint32_t biSize; ///< 本结构体大小，40字节 int32_t biWidth; ///< 位图宽度，以像素为单位 int32_t biHeight; ///< 位图高度，以像素为单位 uint16_t biPlanes; ///< 目标设备平面数，必须为1 uint16_t biBitCount; ///< 每像素位数 uint32_t biCompression; ///< 压缩类型 uint32_t biSizeImage; ///< 位图数据大小，以字节为单位 int32_t biXPelsPerMeter; ///< 水平分辨率，像素/米 int32_t biYPelsPerMeter; ///< 垂直分辨率，像素/米 uint32_t biClrUsed; ///< 实际使用的颜色数 uint32_t biClrImportant; ///< 重要颜色数 } BITMAPINFOHEADER;  /* RGB颜色表结构体 */ typedef struct { uint8_t rgbBlue; ///< 蓝色分量 (0-255) uint8_t rgbGreen; ///< 绿色分量 (0-255) uint8_t rgbRed; ///< 红色分量 (0-255) uint8_t rgbReserved; ///< 保留，必须为0 } RGBQUAD;  /* BMP信息结构体 */ typedef struct { BITMAPINFOHEADER bmiHeader; ///< 位图信息头 RGBQUAD bmiColors[256]; ///< 颜色表(调色板) } BITMAPINFO; #pragma pack(pop) // 恢复默认对齐  /* 截图配置结构体 */ typedef struct { BitmapType bitmap_type; ///< 位图类型 uint32_t width; ///< 截图宽度 uint32_t height; ///< 截图高度 const char *filename; ///< 输出文件名 bool with_timestamp; ///< 是否在文件名中添加时间戳 uint32_t quality; ///< 图像质量(1-100) } ScreenshotConfig;  /* 帧缓冲区信息 */ typedef struct { uint8_t *data; ///< 帧数据指针 uint32_t width; ///< 帧宽度 uint32_t height; ///< 帧高度 uint32_t stride; ///< 每行字节数 uint32_t format; ///< 像素格式 } FrameBuffer;  /* 截图管理器上下文 */ typedef struct { ScreenshotConfig config; ///< 截图配置 uint32_t screenshot_count; ///< 截图计数 char base_filename[256]; ///< 基础文件名 } ScreenshotManager;  /* 函数声明 */ bool screenshot_manager_init(ScreenshotManager *manager, const ScreenshotConfig *config); void screenshot_manager_deinit(ScreenshotManager *manager); bool capture_screenshot(ScreenshotManager *manager, const FrameBuffer *framebuffer); bool capture_screenshot_from_data(ScreenshotManager *manager, const uint8_t *data, uint32_t width, uint32_t height, uint32_t format); bool save_bmp_monochrome(const char *filename, const uint8_t *data, uint32_t width, uint32_t height); bool save_bmp_grayscale(const char *filename, const uint8_t *data, uint32_t width, uint32_t height); bool save_bmp_indexed(const char *filename, const uint8_t *data, uint32_t width, uint32_t height, const RGBQUAD *palette); bool save_bmp_truecolor(const char *filename, const uint8_t *data, uint32_t width, uint32_t height); uint32_t calculate_stride(uint32_t width, uint16_t bit_count); const char* get_bitmap_type_string(BitmapType type);  #endif /* SCREENSHOT_MANAGER_H */

BMP截图功能实现

/** * @file screenshot_manager.c * @brief BMP截图管理器实现 - 支持四种位图格式 * @details 实现完整的BMP文件生成，包括文件头、信息头、颜色表和位图数据 */  #include "screenshot_manager.h" #include <stdlib.h> #include <string.h> #include <time.h>  /** * @brief 初始化截图管理器 * @param manager 截图管理器指针 * @param config 截图配置 * @return bool 初始化成功返回true，失败返回false * @note 采用工厂模式创建截图管理器实例 */ bool screenshot_manager_init(ScreenshotManager *manager, const ScreenshotConfig *config) { if (!manager || !config) { printf("Screenshot manager: Invalid parameters\n"); return false; } if (!config->filename) { printf("Screenshot manager: Invalid filename\n"); return false; } /* 初始化管理器上下文 - 单例模式初始化 */ memset(manager, 0, sizeof(ScreenshotManager)); manager->config = *config; manager->screenshot_count = 0; /* 保存基础文件名 - 用于时间戳生成 */ strncpy(manager->base_filename, config->filename, sizeof(manager->base_filename) - 1); printf("Screenshot manager initialized: type=%s, size=%dx%d, file=%s\n", get_bitmap_type_string(config->bitmap_type), config->width, config->height, config->filename); return true; }  /** * @brief 反初始化截图管理器 * @param manager 截图管理器指针 * @note 采用RAII模式确保资源清理 */ void screenshot_manager_deinit(ScreenshotManager *manager) { if (!manager) return; printf("Screenshot manager deinitialized: total screenshots=%u\n", manager->screenshot_count); memset(manager, 0, sizeof(ScreenshotManager)); }  /** * @brief 计算每行字节数(必须4字节对齐) * @param width 图像宽度 * @param bit_count 每像素位数 * @return uint32_t 对齐后的每行字节数 * @note Windows BMP格式要求每行字节数必须是4的倍数 */ uint32_t calculate_stride(uint32_t width, uint16_t bit_count) { /* 计算未对齐的每行字节数 */ uint32_t raw_stride = (width * bit_count + 7) / 8; /* 对齐到4字节边界 */ uint32_t aligned_stride = (raw_stride + 3) & ~3; printf("Stride calculation: width=%u, bpp=%u -> raw=%u, aligned=%u\n", width, bit_count, raw_stride, aligned_stride); return aligned_stride; }  /** * @brief 生成带时间戳的文件名 * @param base_name 基础文件名 * @param buffer 输出缓冲区 * @param buffer_size 缓冲区大小 * @note 采用装饰器模式为文件名添加时间戳信息 */ static void generate_timestamp_filename(const char *base_name, char *buffer, size_t buffer_size) { time_t now = time(NULL); struct tm *timeinfo = localtime(&now); /* 提取文件名和扩展名 - 解析器模式分析文件名 */ const char *dot = strrchr(base_name, '.'); const char *ext = dot ? dot : ""; size_t name_len = dot ? (dot - base_name) : strlen(base_name); /* 生成带时间戳的文件名 - 建造者模式构建文件名 */ snprintf(buffer, buffer_size, "%.*s_%04d%02d%02d_%02d%02d%02d%s", (int)name_len, base_name, timeinfo->tm_year + 1900, timeinfo->tm_mon + 1, timeinfo->tm_mday, timeinfo->tm_hour, timeinfo->tm_min, timeinfo->tm_sec, ext); }  /** * @brief 创建灰度调色板 * @param palette 调色板数组 * @param entries 调色板条目数 * @note 采用工厂模式生成标准的256级灰度调色板 */ static void create_grayscale_palette(RGBQUAD *palette, uint32_t entries) { for (uint32_t i = 0; i < entries; i++) { palette[i].rgbRed = palette[i].rgbGreen = palette[i].rgbBlue = (uint8_t)i; palette[i].rgbReserved = 0; } printf("Created grayscale palette with %u entries\n", entries); }  /** * @brief 创建默认调色板(16色VGA) * @param palette 调色板数组 * @note 采用策略模式生成不同的调色板方案 */ static void create_default_palette(RGBQUAD *palette) { /* VGA 16色标准调色板 */ const uint32_t vga_colors[16] = { 0x000000, 0x0000AA, 0x00AA00, 0x00AAAA, // 黑、蓝、绿、青 0xAA0000, 0xAA00AA, 0xAA5500, 0xAAAAAA, // 红、紫、棕、灰 0x555555, 0x5555FF, 0x55FF55, 0x55FFFF, // 深灰、亮蓝、亮绿、亮青 0xFF5555, 0xFF55FF, 0xFFFF55, 0xFFFFFF // 亮红、亮紫、黄、白 }; for (int i = 0; i < 16; i++) { palette[i].rgbRed = (vga_colors[i] >> 16) & 0xFF; palette[i].rgbGreen = (vga_colors[i] >> 8) & 0xFF; palette[i].rgbBlue = vga_colors[i] & 0xFF; palette[i].rgbReserved = 0; } printf("Created default 16-color VGA palette\n"); }  /** * @brief 保存单色位图(线画稿) * @param filename 文件名 * @param data 图像数据 * @param width 图像宽度 * @param height 图像高度 * @return bool 保存成功返回true，失败返回false * @note 每个像素用1位表示，8个像素占1个字节 */ bool save_bmp_monochrome(const char *filename, const uint8_t *data, uint32_t width, uint32_t height) { if (!filename || !data || width == 0 || height == 0) { printf("Save monochrome BMP: Invalid parameters\n"); return false; } printf("Saving monochrome BMP: %s, size=%dx%d\n", filename, width, height); FILE *file = fopen(filename, "wb"); if (!file) { printf("Save monochrome BMP: Failed to create file %s\n", filename); return false; } /* 计算对齐后的每行字节数 */ uint32_t stride = calculate_stride(width, 1); uint32_t image_size = stride * height; /* 创建文件头 - 建造者模式构建文件头 */ BITMAPFILEHEADER file_header = { .bfType = BMP_FILE_TYPE, .bfSize = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 8 + image_size, .bfReserved1 = 0, .bfReserved2 = 0, .bfOffBits = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 8 }; /* 创建信息头 - 建造者模式构建信息头 */ BITMAPINFOHEADER info_header = { .biSize = sizeof(BITMAPINFOHEADER), .biWidth = width, .biHeight = height, .biPlanes = 1, .biBitCount = 1, .biCompression = BMP_COMPRESSION_NONE, .biSizeImage = image_size, .biXPelsPerMeter = 2835, // 72 DPI .biYPelsPerMeter = 2835, .biClrUsed = 2, .biClrImportant = 2 }; /* 创建颜色表(黑白) - 工厂模式生成调色板 */ RGBQUAD palette[2] = { {0x00, 0x00, 0x00, 0x00}, // 黑色 {0xFF, 0xFF, 0xFF, 0x00} // 白色 }; /* 写入文件头 */ if (fwrite(&file_header, sizeof(file_header), 1, file) != 1) { printf("Save monochrome BMP: Failed to write file header\n"); fclose(file); return false; } /* 写入信息头 */ if (fwrite(&info_header, sizeof(info_header), 1, file) != 1) { printf("Save monochrome BMP: Failed to write info header\n"); fclose(file); return false; } /* 写入颜色表 */ if (fwrite(palette, sizeof(palette), 1, file) != 1) { printf("Save monochrome BMP: Failed to write palette\n"); fclose(file); return false; } /* 写入位图数据(从下到上) */ for (int32_t y = height - 1; y >= 0; y--) { const uint8_t *scanline = data + y * stride; if (fwrite(scanline, stride, 1, file) != 1) { printf("Save monochrome BMP: Failed to write scanline %d\n", y); fclose(file); return false; } } fclose(file); printf("Monochrome BMP saved successfully: %s\n", filename); return true; }  /** * @brief 保存灰度位图 * @param filename 文件名 * @param data 图像数据 * @param width 图像宽度 * @param height 图像高度 * @return bool 保存成功返回true，失败返回false * @note 每个像素用8位表示，256级灰度 */ bool save_bmp_grayscale(const char *filename, const uint8_t *data, uint32_t width, uint32_t height) { if (!filename || !data || width == 0 || height == 0) { printf("Save grayscale BMP: Invalid parameters\n"); return false; } printf("Saving grayscale BMP: %s, size=%dx%d\n", filename, width, height); FILE *file = fopen(filename, "wb"); if (!file) { printf("Save grayscale BMP: Failed to create file %s\n", filename); return false; } /* 计算对齐后的每行字节数 */ uint32_t stride = calculate_stride(width, 8); uint32_t image_size = stride * height; /* 创建文件头 */ BITMAPFILEHEADER file_header = { .bfType = BMP_FILE_TYPE, .bfSize = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 1024 + image_size, .bfReserved1 = 0, .bfReserved2 = 0, .bfOffBits = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 1024 }; /* 创建信息头 */ BITMAPINFOHEADER info_header = { .biSize = sizeof(BITMAPINFOHEADER), .biWidth = width, .biHeight = height, .biPlanes = 1, .biBitCount = 8, .biCompression = BMP_COMPRESSION_NONE, .biSizeImage = image_size, .biXPelsPerMeter = 2835, .biYPelsPerMeter = 2835, .biClrUsed = 256, .biClrImportant = 256 }; /* 创建灰度调色板 */ RGBQUAD palette[256]; create_grayscale_palette(palette, 256); /* 写入文件头 */ if (fwrite(&file_header, sizeof(file_header), 1, file) != 1) { printf("Save grayscale BMP: Failed to write file header\n"); fclose(file); return false; } /* 写入信息头 */ if (fwrite(&info_header, sizeof(info_header), 1, file) != 1) { printf("Save grayscale BMP: Failed to write info header\n"); fclose(file); return false; } /* 写入颜色表 */ if (fwrite(palette, sizeof(palette), 1, file) != 1) { printf("Save grayscale BMP: Failed to write palette\n"); fclose(file); return false; } /* 写入位图数据(从下到上) */ for (int32_t y = height - 1; y >= 0; y--) { const uint8_t *scanline = data + y * stride; if (fwrite(scanline, stride, 1, file) != 1) { printf("Save grayscale BMP: Failed to write scanline %d\n", y); fclose(file); return false; } } fclose(file); printf("Grayscale BMP saved successfully: %s\n", filename); return true; }  /** * @brief 保存索引位图 * @param filename 文件名 * @param data 图像数据 * @param width 图像宽度 * @param height 图像高度 * @param palette 调色板 * @return bool 保存成功返回true，失败返回false * @note 每个像素用8位表示，指向调色板中的颜色索引 */ bool save_bmp_indexed(const char *filename, const uint8_t *data, uint32_t width, uint32_t height, const RGBQUAD *palette) { if (!filename || !data || width == 0 || height == 0) { printf("Save indexed BMP: Invalid parameters\n"); return false; } printf("Saving indexed BMP: %s, size=%dx%d\n", filename, width, height); FILE *file = fopen(filename, "wb"); if (!file) { printf("Save indexed BMP: Failed to create file %s\n", filename); return false; } /* 计算对齐后的每行字节数 */ uint32_t stride = calculate_stride(width, 8); uint32_t image_size = stride * height; /* 创建文件头 */ BITMAPFILEHEADER file_header = { .bfType = BMP_FILE_TYPE, .bfSize = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 1024 + image_size, .bfReserved1 = 0, .bfReserved2 = 0, .bfOffBits = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + 1024 }; /* 创建信息头 */ BITMAPINFOHEADER info_header = { .biSize = sizeof(BITMAPINFOHEADER), .biWidth = width, .biHeight = height, .biPlanes = 1, .biBitCount = 8, .biCompression = BMP_COMPRESSION_NONE, .biSizeImage = image_size, .biXPelsPerMeter = 2835, .biYPelsPerMeter = 2835, .biClrUsed = 256, .biClrImportant = 256 }; /* 写入文件头 */ if (fwrite(&file_header, sizeof(file_header), 1, file) != 1) { printf("Save indexed BMP: Failed to write file header\n"); fclose(file); return false; } /* 写入信息头 */ if (fwrite(&info_header, sizeof(info_header), 1, file) != 1) { printf("Save indexed BMP: Failed to write info header\n"); fclose(file); return false; } /* 写入颜色表 */ if (fwrite(palette, sizeof(RGBQUAD) * 256, 1, file) != 1) { printf("Save indexed BMP: Failed to write palette\n"); fclose(file); return false; } /* 写入位图数据(从下到上) */ for (int32_t y = height - 1; y >= 0; y--) { const uint8_t *scanline = data + y * stride; if (fwrite(scanline, stride, 1, file) != 1) { printf("Save indexed BMP: Failed to write scanline %d\n", y); fclose(file); return false; } } fclose(file); printf("Indexed BMP saved successfully: %s\n", filename); return true; }  /** * @brief 保存真彩色位图 * @param filename 文件名 * @param data 图像数据 * @param width 图像宽度 * @param height 图像高度 * @return bool 保存成功返回true，失败返回false * @note 每个像素用24位表示(RGB各8位)，无颜色表 */ bool save_bmp_truecolor(const char *filename, const uint8_t *data, uint32_t width, uint32_t height) { if (!filename || !data || width == 0 || height == 0) { printf("Save truecolor BMP: Invalid parameters\n"); return false; } printf("Saving truecolor BMP: %s, size=%dx%d\n", filename, width, height); FILE *file = fopen(filename, "wb"); if (!file) { printf("Save truecolor BMP: Failed to create file %s\n", filename); return false; } /* 计算对齐后的每行字节数 */ uint32_t stride = calculate_stride(width, 24); uint32_t image_size = stride * height; /* 创建文件头 */ BITMAPFILEHEADER file_header = { .bfType = BMP_FILE_TYPE, .bfSize = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) + image_size, .bfReserved1 = 0, .bfReserved2 = 0, .bfOffBits = sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER) }; /* 创建信息头 */ BITMAPINFOHEADER info_header = { .biSize = sizeof(BITMAPINFOHEADER), .biWidth = width, .biHeight = height, .biPlanes = 1, .biBitCount = 24, .biCompression = BMP_COMPRESSION_NONE, .biSizeImage = image_size, .biXPelsPerMeter = 2835, .biYPelsPerMeter = 2835, .biClrUsed = 0, .biClrImportant = 0 }; /* 写入文件头 */ if (fwrite(&file_header, sizeof(file_header), 1, file) != 1) { printf("Save truecolor BMP: Failed to write file header\n"); fclose(file); return false; } /* 写入信息头 */ if (fwrite(&info_header, sizeof(info_header), 1, file) != 1) { printf("Save truecolor BMP: Failed to write info header\n"); fclose(file); return false; } /* 写入位图数据(从下到上，BGR顺序) */ for (int32_t y = height - 1; y >= 0; y--) { const uint8_t *scanline = data + y * stride; if (fwrite(scanline, stride, 1, file) != 1) { printf("Save truecolor BMP: Failed to write scanline %d\n", y); fclose(file); return false; } } fclose(file); printf("Truecolor BMP saved successfully: %s\n", filename); return true; }  /** * @brief 从帧缓冲区捕获截图 * @param manager 截图管理器 * @param framebuffer 帧缓冲区 * @return bool 捕获成功返回true，失败返回false * @note 采用策略模式根据配置选择不同的保存方法 */ bool capture_screenshot(ScreenshotManager *manager, const FrameBuffer *framebuffer) { if (!manager || !framebuffer || !framebuffer->data) { printf("Capture screenshot: Invalid parameters\n"); return false; } /* 生成最终文件名 - 装饰器模式添加时间戳 */ char final_filename[512]; if (manager->config.with_timestamp) { generate_timestamp_filename(manager->base_filename, final_filename, sizeof(final_filename)); } else { snprintf(final_filename, sizeof(final_filename), "%s_%04d.bmp", manager->base_filename, manager->screenshot_count); } printf("Capturing screenshot: %s, format=%u\n", final_filename, framebuffer->format); bool result = false; /* 根据位图类型选择保存策略 - 策略模式应用 */ switch (manager->config.bitmap_type) { case BMP_TYPE_MONOCHROME: result = save_bmp_monochrome(final_filename, framebuffer->data, framebuffer->width, framebuffer->height); break; case BMP_TYPE_GRAYSCALE: result = save_bmp_grayscale(final_filename, framebuffer->data, framebuffer->width, framebuffer->height); break; case BMP_TYPE_INDEXED: { RGBQUAD palette[256]; create_default_palette(palette); result = save_bmp_indexed(final_filename, framebuffer->data, framebuffer->width, framebuffer->height, palette); break; } case BMP_TYPE_TRUECOLOR: result = save_bmp_truecolor(final_filename, framebuffer->data, framebuffer->width, framebuffer->height); break; default: printf("Capture screenshot: Unknown bitmap type %d\n", manager->config.bitmap_type); return false; } if (result) { manager->screenshot_count++; printf("Screenshot captured successfully: %s (total=%u)\n", final_filename, manager->screenshot_count); } else { printf("Screenshot capture failed: %s\n", final_filename); } return result; }  /** * @brief 从原始数据捕获截图 * @param manager 截图管理器 * @param data 图像数据 * @param width 图像宽度 * @param height 图像高度 * @param format 像素格式 * @return bool 捕获成功返回true，失败返回false * @note 采用适配器模式适配不同的数据格式 */ bool capture_screenshot_from_data(ScreenshotManager *manager, const uint8_t *data, uint32_t width, uint32_t height, uint32_t format) { if (!manager || !data || width == 0 || height == 0) { printf("Capture screenshot from data: Invalid parameters\n"); return false; } /* 创建临时帧缓冲区 - 适配器模式适配数据格式 */ FrameBuffer framebuffer = { .data = (uint8_t*)data, .width = width, .height = height, .stride = width * 3, // 假设RGB24格式 .format = format }; return capture_screenshot(manager, &framebuffer); }  /** * @brief 获取位图类型字符串描述 * @param type 位图类型 * @return const char* 类型描述字符串 */ const char* get_bitmap_type_string(BitmapType type) { switch (type) { case BMP_TYPE_MONOCHROME: return "Monochrome"; case BMP_TYPE_GRAYSCALE: return "Grayscale"; case BMP_TYPE_INDEXED: return "Indexed"; case BMP_TYPE_TRUECOLOR: return "TrueColor"; default: return "Unknown"; } }

集成到播放器的截图功能

/** * @file enhanced_player_with_screenshot.c * @brief 增强型播放器集成截图功能 * @details 在原有播放器基础上添加完整的BMP截图功能 */  #include "screenshot_manager.h" #include "memory_manager.h" #include "codec_detector.h" #include "license_manager.h" #include <stdlib.h> #include <string.h>  /* 扩展的播放器上下文 */ typedef struct { MemoryManager memory_manager; ///< 内存管理器 LicenseManager license_manager; ///< 授权管理器 ScreenshotManager screenshot_mgr; ///< 截图管理器 MemoryPoolConfig mem_config; ///< 内存配置 bool initialized; ///< 初始化状态 bool screenshot_enabled; ///< 截图功能使能 } EnhancedPlayerWithScreenshot;  /** * @brief 初始化带截图功能的播放器 * @param player 播放器指针 * @param total_memory 总内存大小 * @param screenshot_config 截图配置 * @return bool 初始化成功返回true，失败返回false * @note 采用外观模式统一初始化所有子系统 */ bool enhanced_player_init_with_screenshot(EnhancedPlayerWithScreenshot *player, uint32_t total_memory, const ScreenshotConfig *screenshot_config) { if (!player || !screenshot_config) { printf("Enhanced player with screenshot: Invalid parameters\n"); return false; } memset(player, 0, sizeof(EnhancedPlayerWithScreenshot)); /* 配置内存池 */ player->mem_config.total_memory = total_memory; player->mem_config.decoder_memory = total_memory * 60 / 100; player->mem_config.frame_buffer_memory = total_memory * 25 / 100; // 减少帧缓冲，为截图留空间 player->mem_config.cache_memory = total_memory * 5 / 100; player->mem_config.reserved_memory = total_memory * 10 / 100; // 增加保留内存 /* 初始化内存管理器 */ if (!memory_manager_init(&player->memory_manager, &player->mem_config)) { printf("Enhanced player with screenshot: Failed to initialize memory manager\n"); return false; } /* 初始化授权管理器 */ if (!license_manager_init(&player->license_manager, "license.key")) { printf("Enhanced player with screenshot: Failed to initialize license manager\n"); memory_manager_deinit(&player->memory_manager); return false; } /* 初始化截图管理器 */ if (!screenshot_manager_init(&player->screenshot_mgr, screenshot_config)) { printf("Enhanced player with screenshot: Failed to initialize screenshot manager\n"); license_manager_deinit(&player->license_manager); memory_manager_deinit(&player->memory_manager); return false; } player->screenshot_enabled = true; player->initialized = true; printf("Enhanced player with screenshot initialized: memory=%uMB, screenshot_type=%s\n", total_memory / (1024 * 1024), get_bitmap_type_string(screenshot_config->bitmap_type)); return true; }  /** * @brief 反初始化播放器 * @param player 播放器指针 */ void enhanced_player_deinit_with_screenshot(EnhancedPlayerWithScreenshot *player) { if (!player || !player->initialized) { return; } /* 反初始化所有子系统 */ screenshot_manager_deinit(&player->screenshot_mgr); license_manager_deinit(&player->license_manager); memory_manager_deinit(&player->memory_manager); player->initialized = false; printf("Enhanced player with screenshot deinitialized\n"); }  /** * @brief 捕获当前帧截图 * @param player 播放器指针 * @param framebuffer 帧缓冲区 * @return bool 捕获成功返回true，失败返回false * @note 采用命令模式执行截图操作 */ bool player_capture_screenshot(EnhancedPlayerWithScreenshot *player, const FrameBuffer *framebuffer) { if (!player || !player->initialized || !player->screenshot_enabled) { printf("Player capture screenshot: Player not ready\n"); return false; } if (!framebuffer || !framebuffer->data) { printf("Player capture screenshot: Invalid framebuffer\n"); return false; } printf("Player capturing screenshot...\n"); return capture_screenshot(&player->screenshot_mgr, framebuffer); }  /** * @brief 设置截图配置 * @param player 播放器指针 * @param config 截图配置 * @return bool 设置成功返回true，失败返回false * @note 采用策略模式动态改变截图行为 */ bool player_set_screenshot_config(EnhancedPlayerWithScreenshot *player, const ScreenshotConfig *config) { if (!player || !player->initialized || !config) { printf("Player set screenshot config: Invalid parameters\n"); return false; } /* 重新初始化截图管理器 */ screenshot_manager_deinit(&player->screenshot_mgr); if (!screenshot_manager_init(&player->screenshot_mgr, config)) { printf("Player set screenshot config: Failed to reinitialize screenshot manager\n"); return false; } printf("Player screenshot config updated: type=%s, size=%dx%d\n", get_bitmap_type_string(config->bitmap_type), config->width, config->height); return true; }  /** * @brief 主函数示例 */ int main(void) { EnhancedPlayerWithScreenshot player; /* 配置截图参数 */ ScreenshotConfig screenshot_config = { .bitmap_type = BMP_TYPE_TRUECOLOR, .width = 1920, .height = 1080, .filename = "screenshot.bmp", .with_timestamp = true, .quality = 100 }; printf("Enhanced Media Player with Screenshot Demo\n"); printf("==========================================\n"); /* 初始化播放器 */ if (!enhanced_player_init_with_screenshot(&player, 64 * 1024 * 1024, &screenshot_config)) { printf("Failed to initialize enhanced player with screenshot\n"); return -1; } /* 模拟帧缓冲区 */ uint8_t *frame_data = malloc(1920 * 1080 * 3); // RGB24格式 if (frame_data) { memset(frame_data, 0x7F, 1920 * 1080 * 3); // 填充灰色 FrameBuffer framebuffer = { .data = frame_data, .width = 1920, .height = 1080, .stride = 1920 * 3, .format = 0 // RGB24 }; /* 捕获截图 */ if (player_capture_screenshot(&player, &framebuffer)) { printf("Screenshot captured successfully\n"); } else { printf("Screenshot capture failed\n"); } free(frame_data); } /* 测试不同格式的截图 */ ScreenshotConfig grayscale_config = { .bitmap_type = BMP_TYPE_GRAYSCALE, .width = 800, .height = 600, .filename = "grayscale.bmp", .with_timestamp = false, .quality = 100 }; player_set_screenshot_config(&player, &grayscale_config); /* 清理资源 */ enhanced_player_deinit_with_screenshot(&player); return 0; }

BMP截图功能架构树形分析

BMP截图功能软件架构树形分析: ├── 文件格式架构 (File Format Architecture) │ ├── BMP文件结构 │ │ ├── 文件头 (BITMAPFILEHEADER) │ │ │ ├→ bfType: 文件类型标识"BM" │ │ │ ├→ bfSize: 文件总大小 │ │ │ ├→ bfReserved: 保留字段 │ │ │ └→ bfOffBits: 位图数据偏移量 │ │ ├── 信息头 (BITMAPINFOHEADER) │ │ │ ├→ biSize: 信息头大小 │ │ │ ├→ biWidth/biHeight: 图像尺寸 │ │ │ ├→ biPlanes: 颜色平面数 │ │ │ ├→ biBitCount: 每像素位数 │ │ │ ├→ biCompression: 压缩类型 │ │ │ ├→ biSizeImage: 图像数据大小 │ │ │ ├→ biXPelsPerMeter/biYPelsPerMeter: 分辨率 │ │ │ └→ biClrUsed/biClrImportant: 颜色信息 │ │ ├── 颜色表 (RGBQUAD数组) │ │ │ ├→ 单色: 2种颜色(黑白) │ │ │ ├→ 灰度: 256级灰度 │ │ │ ├→ 索引: 256种颜色 │ │ │ └→ 真彩色: 无颜色表 │ │ └── 位图数据 │ │ ├→ 扫描行从下到上排列 │ │ ├→ 每行字节数4字节对齐 │ │ ├→ 像素存储顺序 │ │ └→ 填充字节处理 │ │ │ ├── 四种位图类型支持 │ │ ├── 线画稿 (Monochrome) │ │ │ ├→ 1位每像素 │ │ │ ├→ 2色调色板 │ │ │ ├→ 8像素占1字节 │ │ │ └→ 适用于黑白图像 │ │ ├── 灰度图像 (Grayscale) │ │ │ ├→ 8位每像素 │ │ │ ├→ 256级灰度调色板 │ │ │ ├→ 1像素占1字节 │ │ │ └→ 适用于黑白照片 │ │ ├── 索引图像 (Indexed) │ │ │ ├→ 8位每像素 │ │ │ ├→ 256色调色板 │ │ │ ├→ 1像素占1字节 │ │ │ └→ 适用于颜色数量有限的图像 │ │ └── 真彩色图像 (TrueColor) │ │ ├→ 24位每像素 │ │ ├→ 无调色板 │ │ ├→ 1像素占3字节(BGR顺序) │ │ └→ 适用于彩色照片 │ │ │ └── 内存对齐处理 │ ├── 每行字节数计算 │ │ ├→ DataSizePerLine = (width * bit_count + 31) / 8 │ │ └→ DataSizePerLine = (DataSizePerLine + 3) & ~3 │ ├── 填充字节处理 │ ├── 数据对齐优化 │ └── 内存访问效率 │ ├── 设计模式应用架构 (Design Pattern Architecture) │ ├── 创建型模式 │ │ ├── 工厂模式 (Factory Pattern) │ │ │ ├→ 调色板工厂生成 │ │ │ ├→ 文件头工厂创建 │ │ │ └→ 信息头工厂构建 │ │ ├── 建造者模式 (Builder Pattern) │ │ │ ├→ BMP文件建造者 │ │ │ ├→ 文件名建造者 │ │ │ └→ 配置参数建造者 │ │ └── 单例模式 (Singleton Pattern) │ │ └→ 截图管理器单例 │ │ │ ├── 结构型模式 │ │ ├── 适配器模式 (Adapter Pattern) │ │ │ ├→ 帧缓冲区适配器 │ │ │ ├→ 数据格式适配器 │ │ │ └→ 像素格式转换适配器 │ │ ├── 装饰器模式 (Decorator Pattern) │ │ │ ├→ 文件名时间戳装饰器 │ │ │ ├→ 图像质量装饰器 │ │ │ └→ 元数据装饰器 │ │ └── 外观模式 (Facade Pattern) │ │ └→ 截图功能统一接口 │ │ │ └── 行为型模式 │ ├── 策略模式 (Strategy Pattern) │ │ ├→ 位图类型保存策略 │ │ ├→ 调色板生成策略 │ │ ├→ 压缩策略选择 │ │ └→ 质量调整策略 │ ├── 模板方法模式 (Template Method Pattern) │ │ └→ BMP文件生成模板 │ ├── 命令模式 (Command Pattern) │ │ └→ 截图操作命令封装 │ └── 观察者模式 (Observer Pattern) │ └→ 截图完成通知 │ └── 功能特性架构 (Feature Architecture) ├── 灵活的配置系统 │ ├→ 位图类型可配置 │ ├→ 图像尺寸可调整 │ ├→ 文件名模式可选 │ ├→ 时间戳自动添加 │ └→ 图像质量可调节 │ ├── 强大的格式支持 │ ├→ 四种标准BMP格式 │ ├→ 自动内存对齐 │ ├→ 调色板自动生成 │ ├→ 压缩格式支持 │ └→ 分辨率设置 │ ├── 高性能实现 │ ├→ 零拷贝数据访问 │ ├→ 批量文件写入 │ ├→ 内存预分配 │ ├→ 异步截图支持 │ └→ 缓存优化 │ └── 完善的错误处理 ├→ 参数有效性检查 ├→ 文件操作错误处理 ├→ 内存分配失败处理 ├→ 格式兼容性检查 └→ 详细的错误信息

这个完整的BMP截图功能提供了：