Updated for Aspose.Imaging for Java 22.5

Author: Evgeniy Sidenko

Examples/pom.xml

@@ -3,7 +3,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.aspose</groupId>
     <artifactId>imaging-java-examples</artifactId>
-    <version>22.3</version>
+    <version>22.5</version>
     <packaging>jar</packaging>
     <properties>
         <maven.compiler.source>1.8</maven.compiler.source>
@@ -15,7 +15,7 @@
 		<dependency>
             <groupId>com.aspose</groupId>
             <artifactId>aspose-imaging</artifactId>
-            <version>22.3</version>
+            <version>22.5</version>
             <classifier>jdk16</classifier>
             <type>jar</type>
         </dependency>

Examples/src/main/java/com/aspose/imaging/examples/ModifyingImages/dicom/SupportStoringXmpTags.java

@@ -0,0 +1,61 @@
+package com.aspose.imaging.examples.ModifyingImages.dicom;
+
+import com.aspose.imaging.Image;
+import com.aspose.imaging.examples.Logger;
+import com.aspose.imaging.examples.Utils;
+import com.aspose.imaging.fileformats.dicom.DicomImage;
+import com.aspose.imaging.imageoptions.DicomOptions;
+import com.aspose.imaging.xmp.XmpPacketWrapper;
+import com.aspose.imaging.xmp.schemas.dicom.DicomPackage;
+
+import java.util.List;
+
+public class SupportStoringXmpTags
+{
+    public static void main(String[] args)
+    {
+        Logger.startExample();
+        // The path to the documents' directory.
+        String dataDir = Utils.getSharedDataDir() + "dicom/";
+        String outDir = Utils.getOutDir();
+
+        try (DicomImage image = (DicomImage) Image.load(dataDir + "file.dcm"))
+        {
+            XmpPacketWrapper xmpPacketWrapper = new XmpPacketWrapper();
+            DicomPackage dicomPackage = new DicomPackage();
+
+            dicomPackage.setEquipmentInstitution("Test Institution");
+            dicomPackage.setEquipmentManufacturer("Test Manufacturer");
+            dicomPackage.setPatientBirthDate("19010101");
+            dicomPackage.setPatientId("010101");
+            dicomPackage.setPatientName("Test Name");
+            dicomPackage.setPatientSex("M");
+            dicomPackage.setSeriesDateTime("19020202");
+            dicomPackage.setSeriesDescription("Test Series Description");
+            dicomPackage.setSeriesModality("Test Modality");
+            dicomPackage.setSeriesNumber("01");
+            dicomPackage.setStudyDateTime("19030303");
+            dicomPackage.setStudyDescription("Test Study Description");
+            dicomPackage.setStudyId("02");
+            dicomPackage.setStudyPhysician("Test Physician");
+
+            xmpPacketWrapper.addPackage(dicomPackage);
+            String outputFile = outDir + "output.dcm";
+
+            image.save(outputFile, new DicomOptions() {{ setXmpData(xmpPacketWrapper); }});
+
+
+            try (DicomImage imageSaved = (DicomImage)Image.load(outputFile))
+            {
+                List<String> originalDicomInfo = image.getFileInfo().getDicomInfo();
+                List<String> imageSavedDicomInfo = imageSaved.getFileInfo().getDicomInfo();
+                int tagsCountDiff = Math.abs(imageSavedDicomInfo.size() - originalDicomInfo.size());
+                Logger.println("The difference between info of two dicom files: ", tagsCountDiff);
+            }
+
+            new java.io.File(outputFile).delete();
+        }
+
+        Logger.endExample();
+    }
+}

Examples/src/main/java/com/aspose/imaging/examples/RunExamples.java

@@ -26,6 +26,7 @@
 import com.aspose.imaging.examples.ModifyingImages.dicom.DicomCompression;
 import com.aspose.imaging.examples.ModifyingImages.dicom.DicomToPngExample;
 import com.aspose.imaging.examples.ModifyingImages.dicom.ExportToDicom;
+import com.aspose.imaging.examples.ModifyingImages.dicom.SupportStoringXmpTags;
 import com.aspose.imaging.examples.ModifyingImages.dxf.ExportToDxf;
 import com.aspose.imaging.examples.ModifyingImages.eps.ExportEps;
 import com.aspose.imaging.examples.ModifyingImages.gif.CreateGifUsingAddPage;
@@ -280,7 +281,7 @@ public static void main(String[] args) throws IOException, InterruptedException,
 		////                        DICOM
 		//// =====================================================
 		//// =====================================================
-
+		SupportStoringXmpTags.main(args);
 		DicomCompression.main(args);
 		DicomToPngExample.main(args);
 		AdjustBrightnessDICOM.main(args);

Examples/src/main/resources/ModifyingImages/sample1.tif

@@ -1,9 +1,8 @@
 ![GitHub all releases](https://img.shields.io/github/downloads/aspose-imaging/Aspose.imaging-for-Java/total) ![GitHub](https://img.shields.io/github/license/aspose-imaging/Aspose.imaging-for-java)
-# Java API for Image Processing
 
-It is a standalone [Imaging API](https://products.aspose.com/imaging/java) consisting of Java routines that enable your Java applications to draw as well as perform basic to advanced level processing of raster & vector images.
+# Java API for Image Processing
 
-Aspose.Imaging for Java offers robust image compression and high processing speed through native byte access and a range of efficient algorithms. It not only manipulate, export and convert images but also lets you dynamically draw objects using pixel manipulation and Graphics Path.
+[Imaging API](https://products.aspose.com/imaging/java) is a library offering advanced image processing features. Developers can create, edit or convert images in their own application. Also Aspose. Imaging library supports drawing and work with graphic primitives. Image export and conversion (including uniform multi-page image processing) is the one of API core features along with image transformations (resize, crop, flip&rotate, binarization, grayscale, adjust), advanced image manipulation features (filtering, dithering, masking, deskewing) and memory optimization strategies.
 
 Directory | Description
 --------- | -----------
@@ -16,33 +15,42 @@ Directory | Description
   </a>
 </p>
 
+Directory | Description
+--------- | -----------
+[Examples](Examples)  | A collection of Java examples that help you learn the product features.
+[Plugins](Plugins)  | Plugins related to Aspose.Imaging for Java product.
+
+
 ## Imaging API Features
 
-- Draw raster images with graphics.
-- Draw vector images.
-- Converting images to various formats.
+- [Draw raster images with graphics](https://docs.aspose.com/imaging/java/drawing-images-using-graphics/).
+- [Draw vector images](https://docs.aspose.com/imaging/java/drawing-vector-images/).
+- [Convert images to various formats](https://docs.aspose.com/imaging/java/converting-images/).
 - [Apply masking](https://docs.aspose.com/imaging/java/applying-masking-to-images/) as well as [Median & Wiener](https://docs.aspose.com/imaging/java/applying-median-and-wiener-filters/) filters.
-- Crop, rotate & resize images via API.
-- De-skew & transform images.
-- Set image properties.
+- [Crop, rotate & resize images via API](https://docs.aspose.com/imaging/java/crop-rotate-and-resize-images/).
+- [De-skew & transform images](https://docs.aspose.com/imaging/java/deskew-image/).
+- [Set image properties](https://docs.aspose.com/imaging/java/setting-properties-on-images/).
+- [Work with multipage image formats](https://docs.aspose.com/imaging/java/working-with-multipage-image-formats/).
 
-## Read & Write Image Formats
+## Load & Save Image Formats
 
-**Raster Formats:** JPEG2000, JPEG, BMP, TIFF, GIF, PNG, APNG\
-**Metafiles:** EMF, EMZ, WMF, WMZ\
-**Other:** SVG, SVGZ, DICOM
+**Raster Formats:** JPEG2000, JPEG, BMP, TIFF, GIF, PNG, DICOM\
+**Metafiles:** EMF, WMF\
+**Compressed metafiles:** EMZ, WMZ\
+**Other:** WebP, Svg, Svgz (compressed Svg)\
+**Animation:** Apng
 
 ## Save Images As
-
-**Fixed:** PDF\
+**Fixed-layout:** PDF\
 **Photoshop:** PSD\
-**Markup:** HTML5 Canvas
+**Web:** Html5 Canvas
+
+## Load Images
 
-## Read Image Formats
+**Various:** DjVu, DNG, ODG, EPS(raster preview only), CMX, CDR, DIB, OTG, FODG
 
-**Various:** DjVu, DNG, ODG, CMX, CDR, DIB, OTG, FODG, EPS (raster preview only), WEBP
 
-## Supported Operating Systems
+## Platform Independence
 
 Aspose.Imaging for Java can be virtually run in any OS where Java is installed (since JDK 1.6)
 
@@ -59,19 +67,48 @@ Aspose.Imaging works for both x86 and x64 versions of the above listed operating
 
 Aspose hosts all Java APIs at the [Aspose Repository](https://repository.aspose.com/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-imaging). You can easily use Aspose.BarCode for Java API directly in your Maven projects with simple configurations. For the detailed instructions please visit [Installing Aspose.Imaging for Java from Maven Repository](https://docs.aspose.com/imaging/java/installation/) documentation page.
 
-## Crop EMF Image by Rectangle
+## Resize a JPG Image
 
-```java
-try (MetafileImage metaImage = (MetafileImage) Image.load(dataDir + "Picture1.emf"))
+``` java
+try (Image image = Image.load(dir + "template.jpg"))
 {
-	// create an instance of Rectangle class with desired size
-	Rectangle rectangle = new Rectangle(10, 10, 100, 100);
+    image.resize(300, 300);
+    image.save(dir + "output.jpg");
+}
+```
+
+## Create & Manipulate PNG via API
 
-	// perform the crop operation on object of Rectangle class
-	metaImage.crop(rectangle);
+``` java
+// image width and height
+int width = 500;
+int height = 300;
 
-	// save the result in PNG format
-	metaImage.save(dataDir + "CropbyRectangle_out.png", new PngOptions());
+// where created image to store
+String path = "createdImage.png";
+// create options
+try (PngOptions options = new PngOptions())
+{
+	options.setSource(new FileCreateSource(path, false));
+	try (PngImage image = (PngImage)Image.create(options, width, height))
+	{          
+		// create and initialize an instance of Graphics class 
+		// and Clear Graphics surface
+		Graphics graphic = new Graphics(image);
+		graphic.clear(Color.getGreen());
+		// draw line on image
+		graphic.drawLine(new Pen(Color.getBlue()), 9, 9, 90, 90);        
+
+		// resize image
+		int newWidth = 400;
+		image.resizeWidthProportionally(newWidth, ResizeType.LanczosResample);  
+
+		// crop the image to specified area
+		com.aspose.imaging.Rectangle area = new com.aspose.imaging.Rectangle(10,10,200,200);    
+		image.crop(area);
+	   
+		image.save();
+	}
 }
 ```