Arbeiten mit Bildern

Aspose.Words ermöglicht es Benutzern, sehr flexibel mit Bildern zu arbeiten. In diesem Artikel können Sie nur einige der Möglichkeiten der Arbeit mit Bildern erkunden.

So extrahieren Sie Bilder aus einem Dokument

Alle Bilder werden in Shape Knoten in einem Dokument gespeichert. Gehen Sie folgendermaßen vor, um alle Bilder oder Bilder mit einem bestimmten Typ aus dem Dokument zu extrahieren:

• Verwenden Sie die Methode getChildNodes, um alle Formknoten auszuwählen.
• Durchlaufen Sie die resultierenden Knotensammlungen.
• Überprüfen Sie die boolesche Eigenschaft hasImage.
• Extrahieren Sie Bilddaten mit der Eigenschaft ImageData.
• Speichern Sie Bilddaten in einer Datei.

// 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++;
    }
}

So fügen Sie einen Barcode auf jeder Dokumentseite ein

In diesem Beispiel können Sie auf allen oder bestimmten Seiten eines Word-Dokuments dieselben oder verschiedene Barcodes hinzufügen. Es gibt keine direkte Möglichkeit, Barcodes auf allen Seiten eines Dokuments hinzuzufügen, aber Sie können die Methoden moveToSection, moveToHeaderFooter und insertImage verwenden, um zu einem beliebigen Abschnitt oder Kopf- / Fußzeilen zu wechseln und die Barcode-Bilder einzufügen, wie Sie sehen können im folgenden Code.

Das folgende Codebeispiel zeigt, wie Sie auf jeder Seite eines Dokuments ein Barcode-Bild einfügen:

// 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) {

    }
}

Seitenverhältnis des Bildes sperren

Das Seitenverhältnis einer geometrischen Form ist das Verhältnis ihrer Größen in verschiedenen Dimensionen. Sie können das Seitenverhältnis eines Bildes mit AspectRatioLocked sperren. Der Standardwert für das Seitenverhältnis der Form hängt von ShapeType ab. Es ist wahr für ShapeType.Image und falsch für andere Formtypen.

Das folgende Codebeispiel zeigt, wie Sie mit dem Seitenverhältnis arbeiten:

// 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");

So erhalten Sie die tatsächlichen Formgrenzen in Punkten

Wenn Sie den tatsächlichen Begrenzungsrahmen der Form wie auf der Seite gerendert haben möchten, können Sie dies mithilfe der Eigenschaft BoundsInPoints erreichen.

Das folgende Codebeispiel zeigt, wie diese Eigenschaft verwendet wird:

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

Bilder zuschneiden

Das Zuschneiden eines Bildes bezieht sich normalerweise auf das Entfernen der unerwünschten äußeren Teile eines Bildes, um den Rahmen zu verbessern. Es wird auch zum Entfernen einiger Teile eines Bildes verwendet, um den Fokus auf einen bestimmten Bereich zu erhöhen.

Das folgende Codebeispiel zeigt, wie dies mit Aspose.Words API erreicht wird:

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

Speichern von Bildern als WMF

Aspose.Words bietet Funktionen zum Speichern aller verfügbaren Bilder in einem Dokument in WMFformatieren Sie beim Konvertieren von DOCX in RTF.

Das folgende Codebeispiel zeigt, wie Bilder als WMF mit RTF Speicheroptionen gespeichert werden:

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