Nomad changes

docs/snippets/php/extraction/image_extraction.php

@@ -0,0 +1,159 @@
+```php title="image_extraction.php"
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Image Extraction from Documents
+ *
+ * Extract embedded images from PDFs, Office documents, and other formats.
+ * Optionally perform OCR on extracted images.
+ */
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use Kreuzberg\Kreuzberg;
+use Kreuzberg\Config\ExtractionConfig;
+use Kreuzberg\Config\ImageExtractionConfig;
+use Kreuzberg\Config\OcrConfig;
+
+$config = new ExtractionConfig(
+    imageExtraction: new ImageExtractionConfig(
+        extractImages: true,
+        minWidth: 100,      
+        minHeight: 100
+    ),
+    extractImages: true
+);
+
+$kreuzberg = new Kreuzberg($config);
+$result = $kreuzberg->extractFile('presentation.pptx');
+
+echo "Image Extraction Results:\n";
+echo str_repeat('=', 60) . "\n";
+echo "Images found: " . count($result->images ?? []) . "\n\n";
+
+foreach ($result->images ?? [] as $image) {
+    $filename = sprintf(
+        'extracted_p%d_i%d_%dx%d.%s',
+        $image->pageNumber,
+        $image->imageIndex,
+        $image->width,
+        $image->height,
+        $image->format
+    );
+
+    file_put_contents($filename, $image->data);
+    echo "Saved: $filename\n";
+    echo "  Size: {$image->width}x{$image->height} pixels\n";
+    echo "  Format: {$image->format}\n";
+    echo "  Data: " . number_format(strlen($image->data)) . " bytes\n\n";
+}
+
+$ocrConfig = new ExtractionConfig(
+    imageExtraction: new ImageExtractionConfig(
+        extractImages: true,
+        performOcr: true,
+        minWidth: 200,
+        minHeight: 100
+    ),
+    ocr: new OcrConfig(
+        backend: 'tesseract',
+        language: 'eng'
+    )
+);
+
+$kreuzberg = new Kreuzberg($ocrConfig);
+$result = $kreuzberg->extractFile('scanned_images.pdf');
+
+echo "Images with OCR:\n";
+echo str_repeat('=', 60) . "\n";
+
+foreach ($result->images ?? [] as $image) {
+    echo "Image {$image->imageIndex} from page {$image->pageNumber}:\n";
+
+    if ($image->ocrResult !== null) {
+        echo "  OCR Text: " . substr($image->ocrResult->content, 0, 100) . "...\n";
+        echo "  OCR Length: " . strlen($image->ocrResult->content) . " chars\n";
+    } else {
+        echo "  No OCR result\n";
+    }
+    echo "\n";
+}
+
+$largeImageConfig = new ExtractionConfig(
+    imageExtraction: new ImageExtractionConfig(
+        extractImages: true,
+        minWidth: 500,      
+        minHeight: 500
+    ),
+    extractImages: true
+);
+
+$kreuzberg = new Kreuzberg($largeImageConfig);
+$result = $kreuzberg->extractFile('photo_album.pdf');
+
+echo "Large images (>500x500):\n";
+foreach ($result->images ?? [] as $image) {
+    $filename = "large_image_{$image->imageIndex}.{$image->format}";
+    file_put_contents($filename, $image->data);
+    echo "Saved: $filename ({$image->width}x{$image->height})\n";
+}
+
+$result = $kreuzberg->extractFile('document.pdf');
+
+$imageTypes = [];
+foreach ($result->images ?? [] as $image) {
+    if (!isset($imageTypes[$image->format])) {
+        $imageTypes[$image->format] = [];
+    }
+    $imageTypes[$image->format][] = $image;
+}
+
+echo "\nImages by format:\n";
+foreach ($imageTypes as $format => $images) {
+    echo "  $format: " . count($images) . " images\n";
+
+    $dir = "images_$format";
+    if (!is_dir($dir)) {
+        mkdir($dir, 0755, true);
+    }
+
+    foreach ($images as $index => $image) {
+        $filename = "$dir/image_$index.$format";
+        file_put_contents($filename, $image->data);
+    }
+    echo "    Saved to: $dir/\n";
+}
+
+if (extension_loaded('gd')) {
+    foreach ($result->images ?? [] as $image) {
+        if ($image->format === 'png' || $image->format === 'jpg') {
+            $gdImage = imagecreatefromstring($image->data);
+
+            if ($gdImage !== false) {
+                $width = imagesx($gdImage);
+                $height = imagesy($gdImage);
+                $thumbWidth = 200;
+                $thumbHeight = (int)(($height / $width) * $thumbWidth);
+
+                $thumb = imagecreatetruecolor($thumbWidth, $thumbHeight);
+                imagecopyresampled($thumb, $gdImage, 0, 0, 0, 0,
+                    $thumbWidth, $thumbHeight, $width, $height);
+
+                $thumbFile = "thumb_{$image->imageIndex}.{$image->format}";
+                if ($image->format === 'png') {
+                    imagepng($thumb, $thumbFile);
+                } else {
+                    imagejpeg($thumb, $thumbFile, 85);
+                }
+
+                echo "Created thumbnail: $thumbFile\n";
+
+                imagedestroy($gdImage);
+                imagedestroy($thumb);
+            }
+        }
+    }
+}
+```