【花雕动手做】CanMV K230 AI视觉识别模块之摄像头图像垂直翻转 简单

#【花雕动手做】CanMV K230 AI视觉识别模块之摄像头图像垂直翻转
"""
Camera preview demo
摄像头预览演示

This script initializes camera sensor, displays preview and handles cleanup
本脚本初始化摄像头传感器、显示预览并处理清理工作
"""

import sys
import uos as os  # 导入操作系统接口模块，重命名为os
import time
from media.sensor import *  # 导入传感器模块
from media.display import *  # 导入显示模块
from media.media import *   # 导入媒体管理模块

def init_sensor():
    """
    Initialize camera sensor with specified configuration
    使用指定配置初始化摄像头传感器
    
    功能：配置摄像头参数并返回传感器对象
    关键配置：设置垂直翻转为True，实现图像上下翻转
    """
    sensor = Sensor()  # 创建传感器实例
    
    # Reset sensor to default state
    # 将传感器重置为默认状态
    # 作用：清除之前的配置，确保从干净状态开始
    sensor.reset()

    # Configure channel 1 output format to 640x480 RGB565
    # 配置通道1输出格式为640x480 RGB565
    # 参数说明：
    # width=640, height=480 - 设置图像分辨率
    # chn=CAM_CHN_ID_1 - 指定使用通道1
    sensor.set_framesize(width=640, height=480, chn=CAM_CHN_ID_1)
    
    # 设置像素格式为RGB565
    # RGB565特点：每个像素16位（5位红+6位绿+5位蓝），节省内存
    sensor.set_pixformat(Sensor.RGB565, chn=CAM_CHN_ID_1)

    # 关键功能：启用垂直翻转（上下翻转）
    # 设置为True时，图像会上下翻转
    # 应用场景：摄像头倒置安装、特殊显示需求
    sensor.set_vflip(True)
    
    return sensor  # 返回配置好的传感器对象

def main():
    """
    Main function to run camera preview
    运行摄像头预览的主函数
    
    功能：主程序流程，包含初始化、运行和清理
    """
    sensor = None  # 初始化传感器变量，便于异常处理
    
    try:
        # Initialize camera sensor
        # 初始化摄像头传感器
        sensor = init_sensor()  # 调用初始化函数获取传感器对象
        
        # Initialize virtual display with 640x480 resolution
        # 初始化640x480分辨率的虚拟显示
        # 参数说明：
        # Display.ST7701 - 显示屏驱动型号
        # width=640, height=480 - 显示分辨率，与摄像头分辨率匹配
        # to_ide=True - 同时输出到IDE，便于调试和观察
        Display.init(Display.ST7701, width=640, height=480, to_ide=True)

        # Initialize media management
        # 初始化媒体管理
        # 作用：分配和管理媒体处理所需的系统资源
        MediaManager.init()
        
        # Start sensor operation
        # 启动传感器运行
        # 作用：开始摄像头数据采集流程
        sensor.run()

        # Main loop to capture and display frames
        # 捕获和显示帧的主循环
        # 功能：持续捕获图像并显示，形成实时预览
        while True:
            # Capture frame from channel 1
            # 从通道1捕获帧
            # 返回值img：包含图像数据的对象
            img = sensor.snapshot(chn=CAM_CHN_ID_1)
            
            # Display captured frame
            # 显示捕获的帧
            # 作用：将图像数据发送到显示设备
            Display.show_image(img)
            
    except KeyboardInterrupt:
        # 处理键盘中断（Ctrl+C）
        print("User interrupted the program")
        print("用户中断了程序")
        
    except Exception as e:
        # 处理其他所有异常
        print(f"An error occurred: {str(e)}")
        print(f"发生错误: {str(e)}")
        
    finally:
        # Cleanup section
        # 清理部分 - 无论是否发生异常都会执行
        
        # Stop sensor if initialized
        # 如果传感器已初始化则停止
        # 作用：安全停止摄像头采集，释放硬件资源
        if isinstance(sensor, Sensor):
            sensor.stop()
            
        # Deinitialize display
        # 反初始化显示
        # 作用：关闭显示驱动，释放显示资源
        Display.deinit()

        # Enable sleep mode
        # 启用睡眠模式
        # 作用：允许系统进入低功耗状态
        os.exitpoint(os.EXITPOINT_ENABLE_SLEEP)
        time.sleep_ms(100)  # 短暂延时确保资源完全释放
        
        # Release media resources
        # 释放媒体资源
        # 作用：清理媒体管理器分配的所有资源
        MediaManager.deinit()

if __name__ == "__main__":
    # 程序入口点
    main()  # 调用主函数启动程序