العمل مع الصور

Aspose.Words يسمح للمستخدمين بالعمل مع الصور بطريقة مرنة للغاية. في هذه المقالة، يمكنك استكشاف بعض إمكانيات العمل مع الصور فقط.

كيفية استخراج الصور من مستند

يتم تخزين جميع الصور داخل Shape العقد في مستند. لاستخراج جميع الصور أو الصور التي لها نوع معين من المستند، اتبع الخطوات التالية:

• استخدم طريقة getChildNodes لتحديد جميع عقد الشكل.
• كرر من خلال مجموعات العقدة الناتجة.
• تحقق من خاصية hasImage المنطقية.
• استخراج بيانات الصورة باستخدام خاصية ImageData.
• حفظ بيانات الصورة إلى ملف.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ExtractImagesToFiles.class);

Document doc = new Document(dataDir + "Image.SampleImages.doc");

NodeCollection<Shape> shapes = (NodeCollection<Shape>) doc.getChildNodes(NodeType.SHAPE, true);
int imageIndex = 0;
for (Shape shape : shapes
        ) {
    if (shape.hasImage()) {
        String imageFileName = String.format(
                "Image.ExportImages.{0}_out_{1}", imageIndex, FileFormatUtil.imageTypeToExtension(shape.getImageData().getImageType()));
        shape.getImageData().save(dataDir + imageFileName);
        imageIndex++;
    }
}

كيفية إدراج الباركود في كل صفحة وثيقة

يتيح لك هذا المثال إضافة نفس الرموز الشريطية أو مختلفة على كل الصفحات أو صفحات معينة من مستند ورد. لا توجد طريقة مباشرة لإضافة الرموز الشريطية على جميع صفحات المستند ولكن يمكنك استخدام طرق moveToSection و moveToHeaderFooter و insertImage للانتقال إلى أي قسم أو رؤوس/تذييلات وإدراج صور الباركود كما ترى في الكود التالي.

يوضح مثال الكود التالي كيفية إدراج صورة رمز شريطي في كل صفحة من المستند:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(InsertBarcodeImage.class);

Document doc = new Document(dataDir + "Image.SampleImages.doc");
DocumentBuilder builder = new DocumentBuilder(doc);

// The number of pages the document should have.
int numPages = 4;
// The document starts with one section, insert the barcode into this existing section.
InsertBarcodeIntoFooter(builder, doc.getFirstSection(), 1, HeaderFooterType.FOOTER_PRIMARY);
InsertBarcodeIntoFooter(builder, doc.getFirstSection(), 1, HeaderFooterType.FOOTER_PRIMARY);

for (int i = 1; i < numPages; i++) {
    // Clone the first section and add it into the end of the document.
    Section cloneSection = (Section) doc.getFirstSection().deepClone(false);
    // cloneSection.getPageSetup().getSectionStart() = SectionStart.NEW_PAGE;
    doc.appendChild(cloneSection);

    // Insert the barcode and other information into the footer of the section.
    InsertBarcodeIntoFooter(builder, cloneSection, i, HeaderFooterType.FOOTER_PRIMARY);
}

dataDir = dataDir + "Document_out_.docx";
// Save the document as a PDF to disk. You can also save this directly to a stream.
doc.save(dataDir);

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
private static void InsertBarcodeIntoFooter(DocumentBuilder builder, Section section, int pageId, int footerType) {
    // Move to the footer type in the specific section.
    try {
        builder.moveToSection(section.getDocument().indexOf(section));
        builder.moveToHeaderFooter(footerType);

        String dataDir = Utils.getDataDir(InsertBarcodeImage.class);

        // Insert the barcode, then move to the next line and insert the ID along with the page number.
        // Use pageId if you need to insert a different barcode on each page. 0 = First page, 1 = Second page etc.
        builder.insertImage(dataDir + "Barcode1.png");
        builder.writeln();
        builder.write("1234567890");
        builder.insertField("PAGE");

        // Create a right aligned tab at the right margin.
        double tabPos = section.getPageSetup().getPageWidth() - section.getPageSetup().getRightMargin() - section.getPageSetup().getLeftMargin();
        builder.getCurrentParagraph().getParagraphFormat().getTabStops().add(new TabStop(tabPos, TabAlignment.RIGHT, TabLeader.NONE));

        // Move to the right hand side of the page and insert the page and page total.
        builder.write(ControlChar.TAB);
        builder.insertField("PAGE");
        builder.write(" of ");
        builder.insertField("NUMPAGES");
    } catch (Exception x) {

    }
}

قفل نسبة العرض إلى الارتفاع للصورة

نسبة العرض إلى الارتفاع للشكل الهندسي هي نسبة أحجامه بأبعاد مختلفة. يمكنك قفل نسبة العرض إلى الارتفاع للصورة باستخدام AspectRatioLocked. تعتمد القيمة الافتراضية لنسبة العرض إلى الارتفاع للشكل على ShapeType. هذا صحيح بالنسبة لـ ShapeType.Image وخطأ لأنواع الأشكال الأخرى.

يوضح مثال الكود التالي كيفية العمل مع نسبة العرض إلى الارتفاع:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(DocumentBuilderSetImageAspectRatioLocked.class);

// Open the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertImage(dataDir + "Test.png");
shape.setAspectRatioLocked(false);

doc.save(dataDir + "output.doc");

كيفية الحصول على الحدود الفعلية للشكل بالنقاط

إذا كنت تريد المربع المحيط الفعلي للشكل كما تم عرضه على الصفحة، فيمكنك تحقيق ذلك باستخدام خاصية BoundsInPoints.

يوضح مثال التعليمات البرمجية التالية كيفية استخدام هذه الخاصية:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertImage(dataDir + "Test.png");
shape.setAspectRatioLocked(false);

System.out.print("\nGets the actual bounds of the shape in points. ");
System.out.println(shape.getShapeRenderer().getBoundsInPoints());

اقتصاص الصور

يشير اقتصاص الصورة عادة إلى إزالة الأجزاء الخارجية غير المرغوب فيها من الصورة للمساعدة في تحسين الإطار. كما أنها تستخدم لإزالة بعض أجزاء الصورة لزيادة التركيز على منطقة معينة.

يوضح مثال الكود التالي كيفية تحقيق ذلك باستخدام Aspose.Words API:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(CropImages.class);
        
String inputPath = dataDir + "ch63_Fig0013.jpg";
String outputPath = dataDir + "cropped-1.jpg";
        
cropImage(inputPath, outputPath, 124, 90, 570, 571);

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
public static void cropImage(String inPath, String outPath, int left, int top, int width, int height) throws Exception {

	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);

	BufferedImage img = ImageIO.read(new File(inPath));

	int effectiveWidth = img.getWidth() - width;
	int effectiveHeight = img.getHeight() - height;

	Shape croppedImage = builder.insertImage(img,
	ConvertUtil.pixelToPoint(img.getWidth() - effectiveWidth),
	ConvertUtil.pixelToPoint(img.getHeight() - effectiveHeight));
	
	double widthRatio = croppedImage.getWidth() / ConvertUtil.pixelToPoint(img.getWidth());
	double heightRatio = croppedImage.getHeight() / ConvertUtil.pixelToPoint(img.getHeight());
	
	if (widthRatio < 1)
	croppedImage.getImageData().setCropRight(1 - widthRatio);
	
	if (heightRatio < 1)
	croppedImage.getImageData().setCropBottom(1 - heightRatio);
	
	float leftToWidth = (float) left / img.getWidth();
	float topToHeight = (float) top / img.getHeight();
	
	croppedImage.getImageData().setCropLeft(leftToWidth);
	croppedImage.getImageData().setCropRight(croppedImage.getImageData().getCropRight() - leftToWidth);
	
	croppedImage.getImageData().setCropTop(topToHeight);
	croppedImage.getImageData().setCropBottom(croppedImage.getImageData().getCropBottom() - topToHeight);
	
	croppedImage.getShapeRenderer().save(outPath, new ImageSaveOptions(SaveFormat.JPEG));
}

حفظ الصور باسم WMF

Aspose.Words يوفر وظيفة لحفظ جميع الصور المتاحة في مستند إلى WMFالتنسيق أثناء التحويل DOCX إلى RTF.

يوضح مثال الكود التالي كيفية حفظ الصور باسم WMF مع RTF خيارات الحفظ:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
String fileName = "TestFile.doc";
Document doc = new Document(dataDir + fileName);

RtfSaveOptions saveOpts = new RtfSaveOptions();
saveOpts.setSaveImagesAsWmf(true);

doc.save(dataDir + "output.rtf", saveOpts);