def image_read(self)->np.ndarray:
    """安全讀取中文路徑的圖像，支持單通道、三通道(BGR)、四通道(BGRA)"""
    # 二進(jìn)制讀取 + OpenCV解碼
    source_path = Path(self.source_image_path)
    raw_data = np.fromfile(source_path, dtype=np.uint8)
    return cv2.imdecode(raw_data, cv2.IMREAD_UNCHANGED)  # 保留原始通道信息

def image_write(self, image:np.ndarray, file_extension:str ='.tif')->bool:
    # 根據(jù)不同格式設(shè)置優(yōu)化參數(shù)
    if file_extension in ['.tif', '.tiff']:
        encode_params = [cv2.IMWRITE_TIFF_COMPRESSION, 1]  # 無(wú)壓縮
    elif file_extension in ['.png']:
        encode_params = [cv2.IMWRITE_PNG_COMPRESSION, 0]   # 無(wú)壓縮
    # ... 其他格式處理

# 單個(gè)圖像文件的讀取和保存
source_path = "輸入圖像路徑.tif"
target_path = "輸出圖像路徑.png"

image_io = ImageIO(source_path, target_path)
image = image_io.image_read()  # 讀取圖像
success = image_io.image_write(image, ".png")  # 保存為PNG格式

source_folder = Path("源文件夾")
target_folder = Path("目標(biāo)文件夾")
file_io = FileIO(source_folder, target_folder)

# 獲取所有圖像文件路徑
image_paths = file_io.filter_by_strings(file_io.list_file_paths(True), [".tif", ".jpg"], True)

for image_path in image_paths:
    source_image_path = Path(image_path)
    target_image_path = target_folder / source_image_path.name
    image_io = ImageIO(source_image_path, target_image_path)
    image = image_io.image_read()
    image_io.image_write(image, ".tif")  # 保持原格式或轉(zhuǎn)換為指定格式

from pathlib import Path
import cv2
import numpy as np
from submodule.file_io import FileIO
#ImageIO類只涉及到圖像數(shù)據(jù)的讀取和儲(chǔ)存，不涉及到圖像數(shù)據(jù)的修改
class ImageIO:

    def __init__(self, source_image_path: None | str | Path, target_image_path: None | str | Path) -> None:
        """
        初始化 FileIO 實(shí)例

        Args:
            source_image_path: 讀取圖像路徑。如果提供，會(huì)檢查其是否存在。
            target_image_path: 保存圖像路徑。保存時(shí)必須提供
        """
        # 處理源文件夾：如果提供則轉(zhuǎn)換為Path，并檢查存在性（但不創(chuàng)建）
        self.source_image_path = Path(source_image_path) if source_image_path is not None else None
        if self.source_image_path is not None and not self.source_image_path.exists():
            # 根據(jù)你的需求決定：如果源文件夾必須存在，可以拋出異常
            # raise ValueError(f"源目錄不存在: {self.source_folder}")
            # 或者僅記錄警告，取決于你的業(yè)務(wù)邏輯
            print(f"警告: 源文件可能不存在: {self.source_image_path}")
        self.target_image_path = Path(target_image_path)

    def image_read(self)->np.ndarray:
        """安全讀取中文路徑的圖像，支持單通道、三通道(BGR)、四通道(BGRA)"""
        # 二進(jìn)制讀取 + OpenCV解碼
        source_path = Path(self.source_image_path)
        raw_data = np.fromfile(source_path, dtype=np.uint8)
        return cv2.imdecode(raw_data, cv2.IMREAD_UNCHANGED)  # 保留原始通道信息

    def image_write(self, image:np.ndarray, file_extension:str ='.tif')->bool:
        """安全保存圖像（支持中文路徑），支持多種格式的無(wú)損保存

        Args:
            image: 要保存的圖像數(shù)據(jù)
            file_extension: 文件擴(kuò)展名，支持 '.tif','.tiff', '.png', '.jpg', '.jpeg', '.webp' 等

        Returns:
            bool: 保存成功返回True，否則返回False
        """
        target_image_path= Path(self.target_image_path)


        # 根據(jù)文件擴(kuò)展名設(shè)置不同的無(wú)損保存參數(shù) [1,7,10](@ref)
        file_extension = file_extension.lower()

        if file_extension in ['.tif', '.tiff']:
            # TIFF格式：使用無(wú)壓縮 [7](@ref)
            encode_params = [cv2.IMWRITE_TIFF_COMPRESSION, 1]
        elif file_extension in ['.png']:
            # PNG格式：壓縮級(jí)別0（不壓縮）[7](@ref)
            encode_params = [cv2.IMWRITE_PNG_COMPRESSION, 0]
        elif file_extension in ['.jpg', '.jpeg']:
            # JPEG格式：最高質(zhì)量100（雖然JPEG固有有損，但100是最小損失）[1](@ref)
            encode_params = [cv2.IMWRITE_JPEG_QUALITY, 100]
        elif file_extension in ['.webp']:
            # WebP格式：最高質(zhì)量100 [10](@ref)
            encode_params = [cv2.IMWRITE_WEBP_QUALITY, 100]
        else:
            # 其他格式不使用壓縮參數(shù)
            encode_params = []

        # 使用imencode避免中文路徑問(wèn)題 [8](@ref)
        success, encoded_image = cv2.imencode(file_extension, image, params=encode_params)

        if success:
            encoded_image.tofile(target_image_path)
            return True
        else:
            print(f"圖像保存失敗，格式: {file_extension}")
            return False
if __name__ == "__main__":
    source_folder = Path(r"source")
    target_folder = Path(r"target")
    file_io = FileIO(source_folder, target_folder)#創(chuàng)建FileIO實(shí)例處理文件列表
    file_paths = file_io.list_file_paths(True) #獲取所有文件路徑
    image_paths = file_io.filter_by_strings(file_paths,[".tif"],True)#獲取.tif文件的路徑
    file_io.clear_folder(target_folder)# 清空目標(biāo)文件夾（謹(jǐn)慎使用）
    # 處理每個(gè)圖像
    for image_path in image_paths:
        source_image_path = Path(image_path) #目標(biāo)圖像路徑
        target_image_path = target_folder / source_image_path.name #要保存的圖像路徑，可以修改名稱來(lái)重命名
        image_io = ImageIO(source_image_path,target_image_path) #實(shí)例化ImageIO類
        image = image_io.image_read() #讀取目標(biāo)圖像數(shù)據(jù)，BGR

        # 可在此處添加圖像處理代碼
        # 例如：調(diào)整大小、應(yīng)用濾鏡等

        image_io.image_write(image,file_extension=".tif") #保存圖像數(shù)據(jù)至目標(biāo)文件夾，可以設(shè)置指定格式
        print("成功讀取并保存：", f"{source_image_path} -> {target_image_path}")

raw_data = np.fromfile(source_path, dtype=np.uint8)
image = cv2.imdecode(raw_data, cv2.IMREAD_UNCHANGED)

target_path.parent.mkdir(parents=True, exist_ok=True)

# 將BGR轉(zhuǎn)換為RGB
image_rgb = cv2.cvtColor(image_bgr, cv2.COLOR_BGR2RGB)