Langkah-langkah untuk Mengekstrak Gambar dari Dokumen PDF di C#

1. Upload PDF ke penyimpanan GroupDocs Cloud: Gunakan StorageApi.UploadFile untuk menempatkan PDF sumber di cloud.

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
storageApi.UploadFile(uploadRequest);

Pemanggilan ini memastikan file dapat diakses untuk diparsing.

2. Minta gambar dokumen: Panggil ParserApi.GetDocumentImages dengan GetDocumentImagesRequest.

var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

Respons berisi koleksi objek ImageInfo, masing-masing menyimpan data Base64 dan metadata. Lihat referensi API untuk detail lengkap.

3. Dekode dan simpan setiap gambar: Iterasi melalui imagesResult.Images, konversi string Base64 menjadi array byte, dan tulis file ke disk.

foreach (ImageInfo imgInfo in imagesResult.Images)
{
    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);
    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
    File.WriteAllBytes(fileName, imageBytes);
}

Konsol mencatat nama file yang disimpan, dimensi, dan DPI untuk verifikasi.

4. (Opsional) Bersihkan PDF remote: Setelah ekstraksi, Anda dapat menghapus file yang diunggah untuk menjaga penyimpanan tetap rapi.

var deleteRequest = new DeleteFileRequest(remotePdfPath);
storageApi.DeleteFile(deleteRequest);

Langkah ini dibungkus dalam blok try‑catch untuk mengabaikan kesalahan pembersihan apa pun.

5. Tinjau output: Konsol akan menampilkan ringkasan seperti Total images extracted: 12, mengonfirmasi ekstraksi berhasil.

Contoh Kode Lengkap: Ekstrak Gambar dari Dokumen PDF dengan GroupDocs.Parser

Contoh berikut menunjukkan alur kerja lengkap yang dijelaskan di atas. Ini mencakup konfigurasi, unggah, ekstraksi gambar, penyimpanan, dan pembersihan opsional.

using System;
using System.IO;
using System.Collections.Generic;
using GroupDocs.Parser.Cloud.Sdk.Api;
using GroupDocs.Parser.Cloud.Sdk.Client;
using GroupDocs.Parser.Cloud.Sdk.Model;
using GroupDocs.Parser.Cloud.Sdk.Model.Requests;

namespace ExtractImagesFromPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// APIs
            var storageApi = new StorageApi(config);
            var parserApi = new ParserApi(config);

// Input PDF path (local) and remote name in storage
            const string localPdfPath = "input.pdf";
            const string remotePdfPath = "input.pdf";

try
            {
                // -------------------------------------------------
                // 1. Upload PDF to GroupDocs Cloud storage (if not already there)
                // -------------------------------------------------
                if (!File.Exists(localPdfPath))
                    throw new FileNotFoundException($"Local file not found: {localPdfPath}");

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
                storageApi.UploadFile(uploadRequest);

// -------------------------------------------------
                // 2. Retrieve document images (all pages)
                // -------------------------------------------------
                var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
                ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

// -------------------------------------------------
                // 3. Save each extracted image to disk
                // -------------------------------------------------
                int imageCounter = 0;
                foreach (ImageInfo imgInfo in imagesResult.Images)
                {
                    // Image data is returned as Base64 string
                    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);

// Build a descriptive file name
                    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
                    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
                    File.WriteAllBytes(fileName, imageBytes);

Console.WriteLine($"Saved: {fileName} ({imgInfo.Width}x{imgInfo.Height} px, {imgInfo.Resolution} DPI)");
                    imageCounter++;
                }

Console.WriteLine($"Total images extracted: {imageCounter}");
            }
            catch (ApiException apiEx)
            {
                Console.Error.WriteLine($"GroupDocs API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.Error.WriteLine($"Unexpected error: {ex.Message}");
            }
            finally
            {
                // -------------------------------------------------
                // 4. Optional cleanup – delete the uploaded PDF from storage
                // -------------------------------------------------
                try
                {
                    var deleteRequest = new DeleteFileRequest(remotePdfPath);
                    storageApi.DeleteFile(deleteRequest);
                }
                catch
                {
                    // Ignored – cleanup is optional
                }
            }
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Ekstrak Gambar melalui REST API Menggunakan cURL

Operasi yang sama dapat dilakukan dengan panggilan REST langsung. Di bawah ini adalah alur kerja cURL minimal.

1. Dapatkan token akses (OAuth 2.0 client credentials grant).

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Respons berisi access_token.

2. Unggah PDF ke penyimpanan cloud.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

3. Minta gambar untuk dokumen yang diunggah.

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Respon JSON mencakup array gambar dengan base64Data, fileExtension, pageNumber, dll.

4. Simpan setiap gambar secara lokal (contoh menggunakan jq dan base64).

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \
     jq -r '.images[] | "\(.pageNumber)_\(.imageIndex).\(.fileExtension) \(.base64Data)"' | \
     while read filename b64; do
         echo "$b64" | base64 -d > "$filename"
     done

Untuk detail lebih lanjut tentang endpoint dan parameter, lihat dokumentasi API resmi.

Menyiapkan Lingkungan

1. Instal pustaka klien .NET melalui NuGet:

dotnet add package GroupDocs.Parser-Cloud

Paket tersedia dari halaman unduhan resmi.

2. Pastikan Anda memiliki .NET 6.0 atau yang lebih baru terinstal serta akun GroupDocs Cloud yang valid dengan kredensial klien.

3. (Opsional) Klon repositori contoh untuk referensi:

   git clone https://github.com/groupdocs-parser-cloud/groupdocs-parser-cloud-dotnet.git
   

Apa yang Membuat GroupDocs.Parser Cocok untuk Ekstraksi Gambar

• Pengambilan gambar langsung: Panggilan GetDocumentImages mengembalikan gambar dalam format aslinya tanpa langkah konversi tambahan.
• Pengiriman Base64: Gambar disediakan sebagai string Base64, memudahkan dekripsi dalam bahasa apa pun.
• Metadata tingkat halaman: Setiap ImageInfo mencakup nomor halaman, dimensi, resolusi, dan indeks, yang membantu mengatur aset yang diekstrak.
• Dukungan untuk semua format raster umum: PNG, JPEG, BMP, GIF, TIFF dan lainnya dipertahankan persis seperti yang disimpan dalam PDF.
• Pemrosesan cloud yang dapat diskalakan: PDF besar diproses di server GroupDocs, mengurangi beban memori pada aplikasi Anda.

Mengonfigurasi Opsi Ekstraksi Gambar

Sementara contoh dasar berfungsi langsung, Anda dapat menyesuaikan permintaan secara detail:

• Tentukan rentang halaman: Tambahkan pages = "1-5" ke GetDocumentImagesRequest untuk membatasi ekstraksi.
• Atur kualitas gambar: Gunakan parameter imageQuality (0‑100) jika Anda memerlukan output compressed.
• Filter berdasarkan format: Berikan fileExtensions = ["png","jpeg"] untuk menerima hanya format yang dipilih.

Opsi-opsi ini didokumentasikan dalam referensi API.

Kesimpulan

Mengekstrak gambar dari dokumen PDF di C# menjadi proses yang sederhana dan andal ketika Anda memanfaatkan GroupDocs.Parser Cloud SDK for .NET. SDK menangani pengunggahan, parsing, dan konversi Base64, memungkinkan Anda fokus pada penyimpanan file dan mengintegrasikannya ke dalam alur kerja Anda. Ingatlah untuk mengamankan kredensial klien Anda, menghormati ketentuan lisensi, dan pertimbangkan lisensi sementara untuk evaluasi di halaman lisensi sementara. Dengan kode dan contoh REST yang disediakan, Anda siap menambahkan ekstraksi gambar PDF yang kuat ke aplikasi .NET apa pun.

FAQs

Bagaimana cara mengekstrak gambar dari dokumen PDF menggunakan C#?
Gunakan metode GetDocumentImages dari Parser API setelah mengunggah PDF dengan StorageApi.UploadFile. Dekode string Base64 yang dikembalikan dan tulis ke disk, seperti yang ditunjukkan dalam contoh kode.

Bagaimana jika PDF dilindungi kata sandi?
Sertakan kata sandi dalam model permintaan. SDK akan mendekripsi file sebelum mengekstrak gambar. Lihat dokumentasi untuk nama properti yang tepat.

Bisakah saya membatasi ekstraksi ke halaman tertentu?
Ya, atur properti pages pada GetDocumentImagesRequest ke daftar yang dipisahkan koma atau rentang (mis., "1-3,5"). API akan mengembalikan gambar hanya dari halaman tersebut.

Apakah ada batas ukuran untuk gambar yang diekstrak?
SDK mengembalikan data gambar asli tanpa mengubah ukuran. Jika Anda membutuhkan file yang lebih kecil, proses lanjutan gambar yang disimpan menggunakan perpustakaan pemrosesan gambar apa pun.

Baca Selengkapnya

• Ekstrak Gambar dari PDF dalam C# .NET | API Ekstraktor Gambar PDF
• Ekstrak Gambar dari Dokumen PDF dalam Java
• Ekstrak Teks dari PDF Menggunakan .NET REST API | Konverter Dokumen ke Teks

Ekstrak Gambar dari Dokumen PDF di Java dalam 5 Langkah

1. Konfigurasikan kredensial API: Buat objek Configuration dan atur client ID serta secret Anda.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

2. Inisialisasi Parser API: Bangun sebuah ApiClient dengan konfigurasi dan buat instance ParserApi.

ApiClient apiClient = new ApiClient(config);
ParserApi parserApi = new ParserApi(apiClient);

3. Bangun permintaan ekstraksi gambar: Tentukan jalur file PDF menggunakan FileInfo dan buat sebuah ExtractImagesRequest.

String inputFilePath = "input.pdf";
ExtractImagesRequest request = new ExtractImagesRequest()
        .setFileInfo(new FileInfo().setFilePath(inputFilePath));

4. Eksekusi ekstraksi dan ambil gambar: Panggil extractImages dan dapatkan daftar objek Image.

ImagesResult imagesResult = parserApi.extractImages(request);
List<Image> images = imagesResult.getImages();

5. Simpan setiap gambar ke penyimpanan lokal: Loop melalui koleksi dan tulis data biner ke file.

for (int i = 0; i < images.size(); i++) {
    Image img = images.get(i);
    String outputFileName = "extracted_image_" + (i + 1) + "_" + img.getFileName();
    try (FileOutputStream fos = new FileOutputStream(outputFileName)) {
        fos.write(img.getData());
    }
    System.out.println("Saved image: " + outputFileName);
}

Untuk detail lebih lanjut tentang setiap kelas, lihat referensi API resmi.

Contoh Kode Lengkap: Ekstrak Gambar dari Dokumen PDF di Java Menggunakan GroupDocs.Parser

Contoh berikut menunjukkan alur kerja lengkap mulai dari penyiapan kredensial hingga penyimpanan gambar.

import com.groupdocs.parser.cloud.ApiClient;
import com.groupdocs.parser.cloud.Configuration;
import com.groupdocs.parser.cloud.api.ParserApi;
import com.groupdocs.parser.cloud.model.FileInfo;
import com.groupdocs.parser.cloud.model.Image;
import com.groupdocs.parser.cloud.model.ImagesResult;
import com.groupdocs.parser.cloud.model.requests.ExtractImagesRequest;

import java.io.FileOutputStream;
import java.util.List;

public class ExtractImagesFromPdf {
    public static void main(String[] args) {
        // Configure API credentials
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        // config.setBaseUrl("https://api.groupdocs.cloud"); // optional, if needed

// Initialize API client and Parser API
        ApiClient apiClient = new ApiClient(config);
        ParserApi parserApi = new ParserApi(apiClient);

// Path to the PDF file stored in GroupDocs Cloud storage
        String inputFilePath = "input.pdf";

// Build request for image extraction
        ExtractImagesRequest request = new ExtractImagesRequest()
                .setFileInfo(new FileInfo().setFilePath(inputFilePath));

try {
            // Perform extraction
            ImagesResult imagesResult = parserApi.extractImages(request);
            List<Image> images = imagesResult.getImages();

// Save each extracted image to local disk
            for (int i = 0; i < images.size(); i++) {
                Image img = images.get(i);
                String outputFileName = "extracted_image_" + (i + 1) + "_" + img.getFileName();
                try (FileOutputStream fos = new FileOutputStream(outputFileName)) {
                    fos.write(img.getData());
                }
                System.out.println("Saved image: " + outputFileName);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terinstal dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Ekstraksi Gambar PDF via cURL dan REST API

Anda dapat mencapai hasil yang sama tanpa menulis kode Java dengan memanggil endpoint REST GroupDocs.Parser Cloud secara langsung.

1. Dapatkan token akses

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

2. Unggah file PDF

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"

3. Minta ekstraksi gambar

curl -X POST "https://api.groupdocs.cloud/v2.0/parser/extractImages" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo": {"filePath": "input.pdf"}}'

4. Unduh gambar yang diekstrak (respons berisi data base64; Anda dapat mendekodenya secara lokal)

Untuk daftar lengkap parameter, lihat dokumentasi API resmi.

Menginstal dan Mengonfigurasi GroupDocs.Parser Cloud SDK for Java

Tambahkan dependensi Maven ke pom.xml Anda (atau potongan Gradle yang setara).

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-parser-cloud</artifactId>
    <version>26.2</version>
</dependency>

SDK disediakan sebagai pustaka cloud; tidak diperlukan binary lokal. Unduh paket terbaru dari halaman rilis. Pastikan Anda memiliki Java 8 atau lebih tinggi dan akun GroupDocs Cloud yang valid dengan client ID dan secret.

GroupDocs.Parser Cloud SDK for Java Fitur yang Memungkinkan Pengambilan Gambar

• Ekstraksi gambar PDF lengkap - Mengambil setiap gambar raster dan vektor yang disematkan dalam dokumen.
• Metadata untuk setiap gambar - Mengembalikan nama file, ukuran, format, dan nomor halaman.
• Dukungan untuk semua format gambar umum - PNG, JPG, BMP, GIF, TIFF, dan lainnya.
• Integrasi penyimpanan cloud - Bekerja langsung dengan file yang disimpan di GroupDocs Cloud tanpa harus mengunduhnya terlebih dahulu.
• Pemrosesan berbasis REST yang dapat diskalakan - Menangani PDF besar dan beban kerja volume tinggi melalui API cloud.

Pengaturan Penyempurnaan Ekstraksi Gambar

Meskipun permintaan dasar sudah berfungsi langsung, Anda dapat menyesuaikan opsi seperti:

• Proteksi kata sandi - Setel properti password pada FileInfo untuk PDF yang terenkripsi.
• Rentang halaman - Batasi ekstraksi ke halaman tertentu dengan menambahkan array pages ke JSON permintaan.
• Konversi format gambar - Minta konversi ke format lain dengan menentukan jenis output yang diinginkan dalam permintaan (lihat referensi API untuk bidang yang tepat).

Contoh mengatur kata sandi (diambil dari kode utama):

FileInfo fileInfo = new FileInfo()
        .setFilePath("protected.pdf")
        .setPassword("mySecret");

Tips Praktis untuk Ekstraksi Gambar PDF yang Efisien

• Validasi keberadaan file sebelum mengirim permintaan untuk menghindari panggilan API yang tidak perlu.
• Proses gambar dalam aliran saat menangani file besar untuk mengurangi konsumsi memori.
• Gunakan paginasi jika Anda hanya membutuhkan gambar dari halaman tertentu; ini mempercepat respons.
• Tangani batas kecepatan API dengan menerapkan penundaan eksponensial pada respons HTTP 429.
• Catat nama setiap file yang disimpan untuk mempermudah pemecahan masalah dan jejak audit.

Kesimpulan

Men­ek­strak gambar dari dokumen PDF di Java menjadi tugas yang sederhana dan dapat diandalkan ketika Anda memanfaatkan kekuatan GroupDocs.Parser Cloud SDK for Java. SDK menangani manajemen kredensial, interaksi penyimpanan cloud, dan decoding gambar, memungkinkan Anda fokus pada logika aplikasi Anda. Untuk penyebaran produksi, beli lisensi yang tepat di halaman harga atau dapatkan lisensi sementara untuk evaluasi. Dengan contoh kode, panduan cURL, dan rekomendasi praktik terbaik dalam artikel ini, Anda siap mengintegrasikan ekstraksi gambar PDF ke dalam solusi berbasis Java apa pun.

FAQ

• Format apa yang dapat diekstrak dari PDF?
  SDK mengekstrak format raster seperti PNG, JPG, BMP, GIF, dan TIFF, serta grafik vektor ketika disimpan sebagai gambar.

• Apakah saya perlu mengunduh PDF sebelum mengekstrak gambar?
  Tidak. SDK bekerja langsung dengan file yang disimpan di penyimpanan GroupDocs Cloud, menghilangkan kebutuhan untuk mengunduh secara lokal.

• Bagaimana SDK menangani PDF besar?
  Ekstraksi dilakukan di sisi server, sehingga penggunaan memori pada mesin Anda tetap rendah. Anda juga dapat membatasi ekstraksi ke halaman tertentu untuk meningkatkan kinerja.

• Apakah ada cara untuk menguji ekstraksi tanpa menulis kode?
  Ya, Anda dapat menggunakan perintah cURL yang disediakan di atas atau mencoba konsol API interaktif di halaman produk.

Baca Selengkapnya

• Ekstrak Gambar dari File PDF di Java menggunakan REST API
• Ekstrak Gambar dari Dokumen Word secara Programatis di Java
• Ekstrak Gambar dari Dokumen PDF menggunakan Python