Các bước để trích xuất hình ảnh từ tài liệu PDF trong C#

1. Upload PDF to GroupDocs Cloud storage: Sử dụng StorageApi.UploadFile để đặt tệp PDF nguồn lên đám mây.

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

Lệnh này đảm bảo tệp có thể truy cập để phân tích.

2. Yêu cầu hình ảnh tài liệu: Gọi ParserApi.GetDocumentImages với một GetDocumentImagesRequest.

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

Phản hồi chứa một tập hợp các đối tượng ImageInfo, mỗi đối tượng chứa dữ liệu Base64 và siêu dữ liệu. Xem Tham chiếu API để biết chi tiết đầy đủ.

3. Giải mã và lưu mỗi hình ảnh: Duyệt qua imagesResult.Images, chuyển chuỗi Base64 thành mảng byte và ghi tệp ra đĩa.

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);
}

Bảng điều khiển ghi lại tên tệp đã lưu, kích thước và DPI để xác minh.

4. (Tùy chọn) Dọn dẹp PDF từ xa: Sau khi trích xuất, bạn có thể xóa tệp đã tải lên để giữ cho bộ nhớ sạch sẽ.

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

Bước này được bọc trong khối try‑catch để bỏ qua bất kỳ lỗi dọn dẹp nào.

5. Xem lại đầu ra: Bảng điều khiển sẽ hiển thị một bản tóm tắt như Total images extracted: 12, xác nhận việc trích xuất thành công.

Ví dụ mã hoàn chỉnh: Trích xuất hình ảnh từ tài liệu PDF bằng GroupDocs.Parser

Ví dụ sau đây trình bày quy trình làm việc đầy đủ đã mô tả ở trên. Nó bao gồm cấu hình, tải lên, trích xuất hình ảnh, lưu và dọn dẹp tùy chọn.

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
                }
            }
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Trích xuất hình ảnh qua REST API bằng cURL

Các thao tác tương tự có thể được thực hiện bằng các cuộc gọi REST trực tiếp. Dưới đây là quy trình cURL tối thiểu.

1. Lấy token truy cập (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"

Phản hồi chứa access_token.

2. Tải lên PDF đến bộ nhớ đám mây.

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. Yêu cầu hình ảnh cho tài liệu đã tải lên.

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

Phản hồi JSON bao gồm một mảng các hình ảnh với base64Data, fileExtension, pageNumber, v.v.

4. Lưu mỗi hình ảnh cục bộ (ví dụ sử dụng jq và 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

Để biết thêm chi tiết về các điểm cuối và tham số, xem tài liệu API chính thức.

Chuẩn bị môi trường

1. Cài đặt thư viện khách hàng .NET thông qua NuGet:

dotnet add package GroupDocs.Parser-Cloud

Gói có sẵn từ trang tải xuống chính thức.

2. Đảm bảo rằng bạn đã cài đặt .NET 6.0 hoặc phiên bản mới hơn và có một tài khoản GroupDocs Cloud hợp lệ với thông tin xác thực client.

3. (Tùy chọn) Sao chép kho mẫu để tham khảo:

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

Điều gì làm cho GroupDocs.Parser phù hợp cho việc trích xuất hình ảnh

• Truy xuất hình ảnh trực tiếp: Lệnh GetDocumentImages trả về hình ảnh ở định dạng gốc mà không cần các bước chuyển đổi bổ sung.
• Cung cấp dưới dạng Base64: Hình ảnh được cung cấp dưới dạng chuỗi Base64, giúp dễ dàng giải mã trong bất kỳ ngôn ngữ nào.
• Siêu dữ liệu cấp trang: Mỗi ImageInfo bao gồm số trang, kích thước, độ phân giải và chỉ mục, giúp tổ chức các tài sản đã trích xuất.
• Hỗ trợ tất cả các định dạng raster phổ biến: PNG, JPEG, BMP, GIF, TIFF và nhiều định dạng khác được giữ nguyên như khi lưu trong PDF.
• Xử lý đám mây có khả năng mở rộng: Các PDF lớn được xử lý trên máy chủ GroupDocs, giảm áp lực bộ nhớ cho ứng dụng của bạn.

Cấu hình tùy chọn trích xuất hình ảnh

Trong khi ví dụ cơ bản hoạt động ngay lập tức, bạn có thể tinh chỉnh yêu cầu:

• Xác định phạm vi trang: Thêm pages = "1-5" vào GetDocumentImagesRequest để giới hạn việc trích xuất.
• Đặt chất lượng hình ảnh: Sử dụng tham số imageQuality (0‑100) nếu bạn cần đầu ra đã nén.
• Lọc theo định dạng: Cung cấp fileExtensions = ["png","jpeg"] để nhận chỉ các định dạng đã chọn.

Các tùy chọn này được ghi lại trong Tham chiếu API.

Kết luận

Việc trích xuất hình ảnh từ tài liệu PDF trong C# trở nên đơn giản và đáng tin cậy khi bạn sử dụng GroupDocs.Parser Cloud SDK for .NET. SDK xử lý việc tải lên, phân tích và chuyển đổi sang Base64, cho phép bạn tập trung vào việc lưu tệp và tích hợp chúng vào quy trình làm việc của mình. Hãy nhớ bảo mật thông tin xác thực client, tuân thủ các điều khoản cấp phép, và cân nhắc sử dụng giấy phép tạm thời để đánh giá tại trang giấy phép tạm thời. Với mã và các ví dụ REST được cung cấp, bạn đã sẵn sàng thêm chức năng trích xuất hình ảnh PDF mạnh mẽ vào bất kỳ ứng dụng .NET nào.

Câu hỏi thường gặp

Làm thế nào để tôi trích xuất hình ảnh từ tài liệu PDF bằng C#?
Sử dụng phương thức GetDocumentImages của Parser API sau khi tải lên PDF bằng StorageApi.UploadFile. Giải mã các chuỗi Base64 trả về và ghi chúng vào đĩa, như được minh họa trong ví dụ mã.

Nếu PDF được bảo vệ bằng mật khẩu thì sao?
Bao gồm mật khẩu trong mô hình yêu cầu. SDK sẽ giải mã tệp trước khi trích xuất hình ảnh. Xem tài liệu để biết tên thuộc tính chính xác.

Tôi có thể giới hạn việc trích xuất chỉ ở các trang cụ thể không?
Có, hãy đặt thuộc tính pages trên GetDocumentImagesRequest thành danh sách hoặc phạm vi phân tách bằng dấu phẩy (ví dụ, "1-3,5"). API sẽ trả về hình ảnh chỉ từ các trang đó.

Có giới hạn kích thước nào cho các hình ảnh đã trích xuất không?
SDK trả về dữ liệu hình ảnh gốc mà không thay đổi kích thước. Nếu bạn cần các tệp nhỏ hơn, hãy xử lý hậu kỳ các hình ảnh đã lưu bằng bất kỳ thư viện xử lý hình ảnh nào.

Read More

• Trích xuất hình ảnh từ PDF trong C# .NET | API Trình trích xuất hình ảnh PDF
• Trích xuất hình ảnh từ tài liệu PDF trong Java
• Trích xuất văn bản từ PDF bằng .NET REST API | Trình chuyển đổi tài liệu sang văn bản

Trích xuất hình ảnh từ tài liệu PDF trong Java trong 5 bước

1. Cấu hình thông tin xác thực API: Tạo một đối tượng Configuration và đặt client ID và client secret của bạn.

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

2. Khởi tạo Parser API: Xây dựng một ApiClient với cấu hình và khởi tạo ParserApi.

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

3. Xây dựng yêu cầu trích xuất hình ảnh: Chỉ định đường dẫn tệp PDF bằng FileInfo và tạo một ExtractImagesRequest.

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

4. Thực hiện trích xuất và lấy các hình ảnh: Gọi extractImages và lấy danh sách các đối tượng Image.

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

5. Lưu mỗi hình ảnh vào bộ nhớ cục bộ: Duyệt qua bộ sưu tập và ghi dữ liệu nhị phân vào các tệp.

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);
}

Để biết thêm chi tiết về mỗi lớp, hãy tham khảo tài liệu API chính thức.

Ví dụ mã đầy đủ: Trích xuất hình ảnh từ tài liệu PDF trong Java bằng GroupDocs.Parser

Ví dụ sau đây trình bày quy trình làm việc đầy đủ từ việc thiết lập thông tin xác thực đến việc lưu ảnh.

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();
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Trích xuất hình ảnh PDF qua cURL và REST API

Bạn có thể đạt được kết quả tương tự mà không cần viết mã Java bằng cách gọi trực tiếp các endpoint REST của GroupDocs.Parser Cloud.

1. Lấy token truy cập

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. Tải lên tệp 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. Yêu cầu trích xuất hình ảnh

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. Tải xuống hình ảnh đã trích xuất (phản hồi chứa dữ liệu base64; bạn có thể giải mã nó cục bộ)

Để xem danh sách đầy đủ các tham số, hãy tham khảo tài liệu API chính thức.

Cài đặt và cấu hình GroupDocs.Parser Cloud SDK for Java

Thêm phụ thuộc Maven vào pom.xml của bạn (hoặc đoạn mã tương đương cho Gradle).

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

SDK được cung cấp dưới dạng thư viện đám mây; không cần các tệp nhị phân cục bộ. Tải xuống gói mới nhất từ trang phát hành. Đảm bảo bạn có Java 8 hoặc cao hơn và một tài khoản GroupDocs Cloud hợp lệ với client ID và secret.

GroupDocs.Parser Cloud SDK for Java Các tính năng cho phép truy xuất hình ảnh

• Trích xuất toàn bộ hình ảnh PDF - Truy xuất mọi hình ảnh raster và vector được nhúng trong tài liệu.
• Siêu dữ liệu cho mỗi hình ảnh - Trả về tên tệp, kích thước, định dạng và số trang.
• Hỗ trợ tất cả các định dạng hình ảnh phổ biến - PNG, JPG, BMP, GIF, TIFF, và hơn nữa.
• Tích hợp lưu trữ đám mây - Hoạt động trực tiếp với các tệp được lưu trữ trong GroupDocs Cloud mà không cần tải xuống trước.
• Xử lý dựa trên REST có khả năng mở rộng - Xử lý các PDF lớn và khối lượng công việc cao thông qua API đám mây.

Tinh chỉnh cài đặt trích xuất hình ảnh

Trong khi yêu cầu cơ bản hoạt động ngay lập tức, bạn có thể điều chỉnh các tùy chọn như:

• Bảo vệ bằng mật khẩu - Đặt thuộc tính password trên FileInfo cho các PDF được mã hóa.
• Phạm vi trang - Giới hạn việc trích xuất chỉ các trang cụ thể bằng cách thêm một mảng pages vào JSON yêu cầu.
• Chuyển đổi định dạng hình ảnh - Yêu cầu chuyển đổi sang định dạng khác bằng cách chỉ định loại đầu ra mong muốn trong yêu cầu (tham khảo API reference để biết các trường chính xác).

Ví dụ về việc đặt mật khẩu (trích từ mã chính):

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

Mẹo thực tế để trích xuất hình ảnh PDF một cách hiệu quả

• Xác thực sự tồn tại của tệp trước khi gửi yêu cầu để tránh các cuộc gọi API không cần thiết.
• Xử lý hình ảnh trong luồng khi làm việc với các tệp lớn để giảm tiêu thụ bộ nhớ.
• Sử dụng phân trang nếu bạn chỉ cần hình ảnh từ các trang nhất định; điều này sẽ tăng tốc phản hồi.
• Xử lý giới hạn tốc độ API bằng cách triển khai cơ chế back‑off theo cấp số nhân khi nhận phản hồi HTTP 429.
• Ghi lại tên mỗi tệp đã lưu để đơn giản hoá việc khắc phục sự cố và theo dõi audit.

Kết luận

Việc trích xuất hình ảnh từ tài liệu PDF trong Java trở nên đơn giản và đáng tin cậy khi bạn tận dụng sức mạnh của GroupDocs.Parser Cloud SDK for Java. SDK xử lý việc quản lý chứng thực, tương tác lưu trữ đám mây và giải mã hình ảnh, cho phép bạn tập trung vào logic ứng dụng của mình. Đối với triển khai sản xuất, hãy mua giấy phép phù hợp trên trang giá hoặc nhận giấy phép tạm thời để đánh giá. Với ví dụ mã, hướng dẫn cURL và các khuyến nghị thực tiễn tốt nhất trong bài viết này, bạn đã sẵn sàng tích hợp việc trích xuất hình ảnh PDF vào bất kỳ giải pháp nào dựa trên Java.

FAQs

• Các định dạng nào có thể được trích xuất từ PDF?
  SDK trích xuất các định dạng raster như PNG, JPG, BMP, GIF và TIFF, cũng như đồ họa vector khi chúng được lưu dưới dạng hình ảnh.

• Có cần tải xuống PDF trước khi trích xuất hình ảnh không?
  Không. SDK hoạt động trực tiếp với các tệp được lưu trữ trong GroupDocs Cloud storage, loại bỏ nhu cầu tải xuống cục bộ.

• SDK xử lý các tệp PDF lớn như thế nào?
  Việc trích xuất được thực hiện trên phía máy chủ, do đó mức sử dụng bộ nhớ trên máy của bạn vẫn thấp. Bạn cũng có thể giới hạn việc trích xuất chỉ các trang cụ thể để cải thiện hiệu suất.

• Có cách nào để kiểm tra việc trích xuất mà không cần viết mã không?
  Có, bạn có thể sử dụng các lệnh cURL được cung cấp ở trên hoặc thử bảng điều khiển API tương tác trên trang sản phẩm.

Read More

• Trích xuất hình ảnh từ tệp PDF trong Java bằng REST API
• Trích xuất hình ảnh từ tài liệu Word một cách lập trình trong Java
• Trích xuất hình ảnh từ tài liệu PDF bằng Python