daft.functions.image_file_metadata#

def image_file_metadata(
    file_expr: Expression,
) -> Expression:
    """Extract image metadata (width, height, format, mode) from a File column.

    Args:
        file_expr (File Expression): The file expression to extract metadata from.

    Returns:
        Expression (Struct Expression): A struct containing:
            - width: uint32 - Image width in pixels
            - height: uint32 - Image height in pixels
            - format: str - Image format (e.g. "png", "jpeg")
            - mode: str - Image mode (e.g. "RGB", "RGBA", "L")
    """
    from daft.expressions import Expression

    return Expression._call_builtin_scalar_fn("image_file_metadata", file_expr)