# pyheic_struct/heic_file.py import os import math # 1. 导入新的库 import pillow_heif from io import BytesIO from dataclasses import dataclass from PIL import Image from base import Box from parser import parse_boxes from heic_types import ( ItemLocationBox, PrimaryItemBox, ItemInfoBox, ItemPropertiesBox, ImageSpatialExtentsBox, ItemReferenceBox ) from handlers.base_handler import VendorHandler from handlers.apple_handler import AppleHandler from handlers.samsung_handler import SamsungHandler @dataclass class Grid: rows: int columns: int output_width: int output_height: int class HEICFile: def __init__(self, filepath: str): self.filepath = filepath # 注册 HEIF/HEIC 文件格式解码器 pillow_heif.register_heif_opener() self._iloc_box: ItemLocationBox | None = None self._ftyp_box: Box | None = None self._iinf_box: ItemInfoBox | None = None self._pitm_box: PrimaryItemBox | None = None self._iprp_box: ItemPropertiesBox | None = None self._iref_box: ItemReferenceBox | None = None self.handler: VendorHandler | None = None with open(self.filepath, 'rb') as f: file_size = os.fstat(f.fileno()).st_size self.boxes = parse_boxes(f, file_size) self._find_essential_boxes(self.boxes) self._detect_vendor() def _find_essential_boxes(self, boxes: list[Box]): for box in boxes: if isinstance(box, ItemLocationBox): self._iloc_box = box if isinstance(box, ItemInfoBox): self._iinf_box = box if isinstance(box, PrimaryItemBox): self._pitm_box = box if isinstance(box, ItemPropertiesBox): self._iprp_box = box if isinstance(box, ItemReferenceBox): self._iref_box = box if box.type == 'ftyp': self._ftyp_box = box if box.children: self._find_essential_boxes(box.children) # --- 2. 使用 pillow-heif 大大简化的图像重建方法 --- def reconstruct_primary_image(self) -> Image.Image | None: """ 使用 pillow-heif 重建主图像,它能自动处理网格图像。 """ try: print("Reconstructing primary image using pillow-heif...") # pillow-heif 让我们能像打开普通图片一样直接打开 HEIC 文件 image = Image.open(self.filepath) # 确保图像数据被加载 image.load() print("Successfully reconstructed image.") return image except Exception as e: print(f"Failed to reconstruct image with pillow-heif: {e}") return None def get_primary_image_grid(self) -> Grid | None: primary_id = self.get_primary_item_id() if not primary_id: return None full_size = self.get_image_size(primary_id) if not full_size: return None full_width, full_height = full_size grid_tiles = self.get_grid_layout() if not grid_tiles: return None first_tile_id = grid_tiles[0] tile_size = self.get_image_size(first_tile_id) if not tile_size: return None tile_width, tile_height = tile_size if tile_width == 0 or tile_height == 0: return None columns = math.ceil(full_width / tile_width) rows = math.ceil(full_height / tile_height) return Grid(rows=rows, columns=columns, output_width=full_width, output_height=full_height) def get_grid_layout(self) -> list[int] | None: primary_id = self.get_primary_item_id() if not primary_id: return None if not self._iref_box: return None # 'dimg' (derived image) 是网格布局的标准引用类型 if 'dimg' in self._iref_box.references: return self._iref_box.references['dimg'].get(primary_id) return None def get_image_size(self, item_id: int) -> tuple[int, int] | None: if not (self._iprp_box and self._iprp_box.ipma and self._iprp_box.ipco): return None if item_id not in self._iprp_box.ipma.entries: return None item_associations = self._iprp_box.ipma.entries[item_id].associations for assoc in item_associations: property_index = assoc - 1 if 0 <= property_index < len(self._iprp_box.ipco.children): prop = self._iprp_box.ipco.children[property_index] if isinstance(prop, ImageSpatialExtentsBox): return (prop.image_width, prop.image_height) return None def get_primary_item_id(self) -> int | None: if not self._pitm_box: return None return self._pitm_box.item_id def list_items(self): if not self._iinf_box: return print("Available items in HEIC file:") for entry in self._iinf_box.entries: print(f" - {entry}") def _detect_vendor(self): if self._ftyp_box: compatible_brands = self._ftyp_box.raw_data[4:].decode('ascii', errors='ignore') if 'samsung' in compatible_brands.lower(): self.handler = SamsungHandler() elif 'apple' in compatible_brands.lower() or 'MiHB' in compatible_brands: self.handler = AppleHandler() else: self.handler = VendorHandler() else: self.handler = VendorHandler() def get_item_data(self, item_id: int) -> bytes | None: if not self._iloc_box: print("Error: 'iloc' box not found.") return None location = next((loc for loc in self._iloc_box.locations if loc.item_id == item_id), None) if not location: print(f"Error: Item with ID {item_id} not found in 'iloc' box.") return None if not location.extents: print(f"Warning: Item with ID {item_id} has no extents.") return b'' data_chunks = [] with open(self.filepath, 'rb') as f: for offset, length in location.extents: f.seek(offset) data_chunks.append(f.read(length)) return b''.join(data_chunks) def get_motion_photo_data(self) -> bytes | None: if not self.handler: self._detect_vendor() offset = self.handler.find_motion_photo_offset(self) if offset is not None: with open(self.filepath, 'rb') as f: f.seek(offset) return f.read() return None def get_thumbnail_data(self) -> bytes | None: """ 查找并提取缩略图图像数据 (如果存在)。 它会查找一个 'iref' 盒子,其中包含 'thmb' (thumbnail) 引用。 """ print("Attempting to extract thumbnail data...") primary_id = self.get_primary_item_id() if not primary_id: print("Error: Could not determine primary item ID.") return None if not self._iref_box: print("Info: No 'iref' box found, cannot search for thumbnail.") return None # 检查 'thmb' (thumbnail) 引用类型是否存在 if 'thmb' not in self._iref_box.references: print("Info: No 'thmb' references found in 'iref' box.") return None # 检查主图像是否有与之关联的缩略图 if primary_id not in self._iref_box.references['thmb']: print(f"Info: Primary item ID {primary_id} has no 'thmb' reference.") return None thumbnail_ids = self._iref_box.references['thmb'][primary_id] if not thumbnail_ids: print(f"Info: Primary item ID {primary_id} has 'thmb' reference, but no target IDs.") return None # 获取第一个缩略图 ID thumbnail_id = thumbnail_ids[0] print(f"Found thumbnail reference: Primary ID {primary_id} -> Thumbnail ID {thumbnail_id}") # 使用现有的 get_item_data 来提取它 thumbnail_data = self.get_item_data(thumbnail_id) if thumbnail_data: print(f"Successfully extracted thumbnail data (Item ID {thumbnail_id}).") return thumbnail_data else: print(f"Error: Failed to get data for thumbnail item ID {thumbnail_id}.") return None