278 lines
8.1 KiB
PHP
278 lines
8.1 KiB
PHP
|
```php title="image_extraction_config.php"
|
||
|
|
<?php
|
||
|
|
|
||
|
|
declare(strict_types=1);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Image Extraction Configuration
|
||
|
|
*
|
||
|
|
* This example demonstrates how to configure image extraction from documents,
|
||
|
|
* including size filtering and 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;
|
||
|
|
|
||
|
|
echo "Example 1: Basic Image Extraction\n";
|
||
|
|
echo "=================================\n";
|
||
|
|
|
||
|
|
$config1 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$kreuzberg = new Kreuzberg($config1);
|
||
|
|
$result = $kreuzberg->extractFile('presentation.pptx');
|
||
|
|
|
||
|
|
if ($result->images !== null) {
|
||
|
|
echo "Total images extracted: " . count($result->images) . "\n";
|
||
|
|
foreach ($result->images as $i => $image) {
|
||
|
|
echo "\nImage {$i}:\n";
|
||
|
|
echo "- Format: {$image->format}\n";
|
||
|
|
echo "- Size: {$image->width}x{$image->height} pixels\n";
|
||
|
|
echo "- Page: {$image->pageNumber}\n";
|
||
|
|
echo "- Data size: " . strlen($image->data) . " bytes\n";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
echo "\n\n";
|
||
|
|
|
||
|
|
echo "Example 2: Image Extraction with Size Filter\n";
|
||
|
|
echo "============================================\n";
|
||
|
|
|
||
|
|
$config2 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 200,
|
||
|
|
minHeight: 200
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$result2 = (new Kreuzberg($config2))->extractFile('document.pdf');
|
||
|
|
|
||
|
|
echo "Filtering images smaller than 200x200 pixels\n";
|
||
|
|
if ($result2->images !== null) {
|
||
|
|
echo "Filtered images: " . count($result2->images) . "\n";
|
||
|
|
}
|
||
|
|
|
||
|
|
echo "\n\n";
|
||
|
|
|
||
|
|
echo "Example 3: Extract Only Large Images\n";
|
||
|
|
echo "====================================\n";
|
||
|
|
|
||
|
|
$config3 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 800,
|
||
|
|
minHeight: 600
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
echo "Configured to extract images >= 800x600 pixels\n";
|
||
|
|
echo "Good for: Photos, large diagrams, full-page scans\n\n";
|
||
|
|
|
||
|
|
echo "Example 4: Extract All Images (Including Thumbnails)\n";
|
||
|
|
echo "===================================================\n";
|
||
|
|
|
||
|
|
$config4 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 50,
|
||
|
|
minHeight: 50
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
echo "Configured to extract images >= 50x50 pixels\n";
|
||
|
|
echo "Good for: Extracting all images including icons and thumbnails\n\n";
|
||
|
|
|
||
|
|
echo "Example 5: Image Extraction with OCR\n";
|
||
|
|
echo "====================================\n";
|
||
|
|
|
||
|
|
$config5 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
performOcr: true,
|
||
|
|
minWidth: 100,
|
||
|
|
minHeight: 100
|
||
|
|
),
|
||
|
|
ocr: new OcrConfig(
|
||
|
|
backend: 'tesseract',
|
||
|
|
language: 'eng'
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$result5 = (new Kreuzberg($config5))->extractFile('document_with_images.pdf');
|
||
|
|
|
||
|
|
if ($result5->images !== null) {
|
||
|
|
echo "Extracted " . count($result5->images) . " images with OCR:\n\n";
|
||
|
|
|
||
|
|
foreach ($result5->images as $i => $image) {
|
||
|
|
echo "Image {$i} (Page {$image->pageNumber}):\n";
|
||
|
|
echo "- Size: {$image->width}x{$image->height}\n";
|
||
|
|
|
||
|
|
if ($image->ocrResult !== null) {
|
||
|
|
echo "- OCR Text: " . substr($image->ocrResult->content, 0, 100) . "...\n";
|
||
|
|
echo "- OCR Text Length: " . strlen($image->ocrResult->content) . " characters\n";
|
||
|
|
}
|
||
|
|
echo "\n";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
echo "\n\n";
|
||
|
|
|
||
|
|
echo "Example 6: Extract and Save Images to Disk\n";
|
||
|
|
echo "=========================================\n";
|
||
|
|
|
||
|
|
$config6 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 200,
|
||
|
|
minHeight: 200
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$result6 = (new Kreuzberg($config6))->extractFile('presentation.pptx');
|
||
|
|
|
||
|
|
if ($result6->images !== null) {
|
||
|
|
$outputDir = 'extracted_images';
|
||
|
|
if (!is_dir($outputDir)) {
|
||
|
|
mkdir($outputDir, 0755, true);
|
||
|
|
}
|
||
|
|
|
||
|
|
foreach ($result6->images as $i => $image) {
|
||
|
|
$filename = "{$outputDir}/image_{$i}_page_{$image->pageNumber}.{$image->format}";
|
||
|
|
|
||
|
|
$imageData = base64_decode($image->data);
|
||
|
|
file_put_contents($filename, $imageData);
|
||
|
|
|
||
|
|
echo "Saved: {$filename} ({$image->width}x{$image->height})\n";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
echo "\n\n";
|
||
|
|
|
||
|
|
echo "Example 7: File Type-Specific Image Extraction\n";
|
||
|
|
echo "==============================================\n";
|
||
|
|
|
||
|
|
$pdfConfig = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 300,
|
||
|
|
minHeight: 300,
|
||
|
|
performOcr: false
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$pptxConfig = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
minWidth: 100,
|
||
|
|
minHeight: 100,
|
||
|
|
performOcr: false
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$imageConfig = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
performOcr: true,
|
||
|
|
minWidth: 50,
|
||
|
|
minHeight: 50
|
||
|
|
),
|
||
|
|
ocr: new OcrConfig(backend: 'tesseract', language: 'eng')
|
||
|
|
);
|
||
|
|
|
||
|
|
echo "PDF Configuration:\n";
|
||
|
|
echo "- Min size: 300x300 (larger images only)\n";
|
||
|
|
echo "- OCR: Disabled (PDFs have embedded text)\n\n";
|
||
|
|
|
||
|
|
echo "PowerPoint Configuration:\n";
|
||
|
|
echo "- Min size: 100x100 (include icons/logos)\n";
|
||
|
|
echo "- OCR: Disabled\n\n";
|
||
|
|
|
||
|
|
echo "Image File Configuration:\n";
|
||
|
|
echo "- Min size: 50x50 (all images)\n";
|
||
|
|
echo "- OCR: Enabled\n\n";
|
||
|
|
|
||
|
|
echo "Example 8: Complete Image Processing Pipeline\n";
|
||
|
|
echo "=============================================\n";
|
||
|
|
|
||
|
|
$config8 = new ExtractionConfig(
|
||
|
|
imageExtraction: new ImageExtractionConfig(
|
||
|
|
extractImages: true,
|
||
|
|
performOcr: true,
|
||
|
|
minWidth: 200,
|
||
|
|
minHeight: 200
|
||
|
|
),
|
||
|
|
ocr: new OcrConfig(
|
||
|
|
backend: 'tesseract',
|
||
|
|
language: 'eng'
|
||
|
|
)
|
||
|
|
);
|
||
|
|
|
||
|
|
$result8 = (new Kreuzberg($config8))->extractFile('mixed_content.pdf');
|
||
|
|
|
||
|
|
if ($result8->images !== null) {
|
||
|
|
echo "Extracted images: " . count($result8->images) . "\n\n";
|
||
|
|
|
||
|
|
foreach ($result8->images as $i => $image) {
|
||
|
|
echo "Processing Image {$i}:\n";
|
||
|
|
|
||
|
|
$isValid = $image->width >= 200 && $image->height >= 200;
|
||
|
|
echo "- Valid size: " . ($isValid ? 'Yes' : 'No') . "\n";
|
||
|
|
|
||
|
|
$filename = "image_{$i}.{$image->format}";
|
||
|
|
file_put_contents($filename, base64_decode($image->data));
|
||
|
|
echo "- Saved: {$filename}\n";
|
||
|
|
|
||
|
|
if ($image->ocrResult !== null) {
|
||
|
|
$ocrText = trim($image->ocrResult->content);
|
||
|
|
if (!empty($ocrText)) {
|
||
|
|
echo "- OCR text available: " . strlen($ocrText) . " characters\n";
|
||
|
|
file_put_contents("image_{$i}_ocr.txt", $ocrText);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
$metadata = [
|
||
|
|
'format' => $image->format,
|
||
|
|
'width' => $image->width,
|
||
|
|
'height' => $image->height,
|
||
|
|
'page' => $image->pageNumber,
|
||
|
|
'aspect_ratio' => round($image->width / $image->height, 2),
|
||
|
|
];
|
||
|
|
file_put_contents("image_{$i}_metadata.json", json_encode($metadata, JSON_PRETTY_PRINT));
|
||
|
|
|
||
|
|
echo "- Metadata saved\n\n";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
echo "\nImage Extraction Configuration Parameters:\n";
|
||
|
|
echo "==========================================\n";
|
||
|
|
echo "- extractImages: Enable image extraction (default: false)\n";
|
||
|
|
echo "- performOcr: Run OCR on extracted images (default: false)\n";
|
||
|
|
echo "- minWidth: Minimum image width in pixels (default: 100)\n";
|
||
|
|
echo "- minHeight: Minimum image height in pixels (default: 100)\n";
|
||
|
|
|
||
|
|
echo "\n\nBest Practices:\n";
|
||
|
|
echo "===============\n";
|
||
|
|
echo "- Set minWidth/minHeight to filter out unwanted small images\n";
|
||
|
|
echo "- Use 200x200 as a good default for meaningful images\n";
|
||
|
|
echo "- Use 800x600+ for large photos and diagrams only\n";
|
||
|
|
echo "- Use 50x50 to include all images including icons\n";
|
||
|
|
echo "- Enable performOcr only when images contain text\n";
|
||
|
|
echo "- Combine with OCR config for multilingual text in images\n";
|
||
|
|
echo "- Save images to disk for further processing\n";
|
||
|
|
|
||
|
|
echo "\n\nCommon Use Cases:\n";
|
||
|
|
echo "=================\n";
|
||
|
|
echo "1. Extract photos from reports: minWidth=800, minHeight=600\n";
|
||
|
|
echo "2. Extract all graphics: minWidth=100, minHeight=100\n";
|
||
|
|
echo "3. OCR on images: performOcr=true + OcrConfig\n";
|
||
|
|
echo "4. Extract logos/icons: minWidth=50, minHeight=50\n";
|
||
|
|
```
|