إضافة صورة إلى PDF باستخدام Java

يدعم Aspose.PDF for Java كل من وضع الصور على مستوى عالٍ والرسم القائم على المشغلات ذات المستوى المنخفض.

إضافة صورة باستخدام إحداثيات الصفحة

استخدم هذا المثال عندما تحتاج إلى وضع صورة في موضع ثابت على صفحة PDF.

  1. أنشئ مستند PDF جديدًا باستخدام Document وأضف صفحة.
  2. استدعِ page.addImage() مع مسار الصورة المصدر والمستطيل الهدف.
  3. احفظ ملف PDF المُولَّد.
public static void addImage(Path imageFile, Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.addImage(imageFile.toString(), new Rectangle(20, 730, 120, 830, true));
        document.save(outputFile.toString());
    }
}

إضافة صورة باستخدام مشغلات الصفحة

استخدم هذا المثال عندما تحتاج إلى التحكم منخفض المستوى في موضع الصورة وتكبيرها/تصغيرها عبر عوامل تشغيل الصفحة.

  1. أنشئ مستند PDF جديدًا باستخدام Document وافتح تدفق صورة المصدر.
  2. أضف الصورة إلى موارد الصفحة واحسب المستطيل الهدف.
  3. اكتب عوامل تشغيل الرسومات المطلوبة واحفظ المستند.
public static void addImageUsingOperators(Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document();
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().add();
        page.setPageSize(842, 595);

        XImageCollection resourcesImages = page.getResources().getImages();
        String imageId = resourcesImages.add(imageStream);
        XImage xImage = resourcesImages.get_Item(resourcesImages.size());

        Rectangle rectangle = new Rectangle(
                0,
                0,
                page.getMediaBox().getWidth(),
                (page.getMediaBox().getWidth() * xImage.getHeight()) / xImage.getWidth(),
                true);

        page.getContents().add(new GSave());

        Matrix matrix = new Matrix(
                rectangle.getURX() - rectangle.getLLX(),
                0,
                0,
                rectangle.getURY() - rectangle.getLLY(),
                rectangle.getLLX(),
                rectangle.getLLX() + (page.getMediaBox().getHeight() - rectangle.getHeight()) / 2);
        page.getContents().add(new ConcatenateMatrix(matrix));
        page.getContents().add(new Do(imageId));
        page.getContents().add(new GRestore());

        document.save(outputFile.toString());
    }
}

إضافة صورة وتحديد نص بديلًا

استخدم هذا المثال عندما ينبغي أن تتضمن الصورة بيانات ميتا للوصول لقراء الشاشة.

  1. أنشئ مستند PDF جديدًا باستخدام Document وأضف الصورة إلى الصفحة.
  2. احصل على العنصر المُدرَج XImage من موارد الصفحة.
  3. عيّن النص البديل واحفظ ملف PDF..
public static void addImageSetAlternativeTextForImage(Path imageFile, Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.setPageSize(842, 595);

        page.addImage(imageFile.toString(), new Rectangle(0, 0, 842, 595, true));

        XImage xImage = page.getResources().getImages().get_Item(1);
        boolean result = xImage.trySetAlternativeText("Alternative text for image", page);
        if (result) {
            System.out.println("Text has been added successfuly");
        }
        document.save(outputFile.toString());
    }
}

إضافة صورة باستخدام ضغط Flate

استخدم هذا المثال عندما تريد تضمين بيانات الصورة باستخدام ضغط Flate.

  1. أنشئ مستند PDF جديدًا باستخدام Document وفتح تدفق الصورة.
  2. أضف الصورة إلى موارد الصفحة باستخدام ImageFilterType.Flate.
  3. ارسم الصورة عبر عمليات الصفحة واحفظ النتيجة.
public static void addImageToPdfWithFlateCompression(Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document();
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().add();
        XImageCollection resourcesImages = page.getResources().getImages();
        String imageId = resourcesImages.add(imageStream, ImageFilterType.Flate);

        page.getContents().add(new GSave());

        Rectangle rectangle = new Rectangle(0, 0, 600, 600, true);
        Matrix matrix = new Matrix(
                rectangle.getURX() - rectangle.getLLX(),
                0,
                0,
                rectangle.getURY() - rectangle.getLLY(),
                rectangle.getLLX(),
                rectangle.getLLY());

        page.getContents().add(new ConcatenateMatrix(matrix));
        page.getContents().add(new Do(imageId));
        page.getContents().add(new GRestore());

        document.save(outputFile.toString());
    }
}