Merge branch 'hotfix/hotfix-v31.2.2' into 983389-Autofit

Author: Mohan2401

Document-Processing-toc.html

@@ -2612,7 +2612,7 @@
 												<a href="/document-processing/pdf/conversions/html-to-pdf/net/Convert-HTML-to-PDF-in-GCP">Google Cloud Platform (GCP)</a>
 												<ul>
 													<li>
-														<a href="/document-processing/pdf/pdf-library/net/Convert-HTML-to-PDF-in-Google-App-Engine">Google App Engine</a>
+														<a href="/document-processing/pdf/conversions/html-to-pdf/net/Convert-HTML-to-PDF-in-Google-App-Engine">Google App Engine</a>
 													</li>
 												</ul>
 											</li>
@@ -4326,6 +4326,9 @@
 									</li>
 								</ul>
 							</li>
+							<li>
+						        <a href="/document-processing/word/word-library/net/Performance-metrics">Performance Metrics</a>
+					        </li>
 							<li>
 								<a href="/document-processing/word/word-library/net/Supported-and-Unsupported-Features">Supported and Unsupported Features</a>
 							</li>
@@ -4475,6 +4478,9 @@
 									<li>
 										<a href="/document-processing/word/conversions/word-to-pdf/net/Fallback-fonts-word-to-pdf">Fallback Fonts</a>
 									</li>
+									<li>
+										<a href="/document-processing/word/conversions/word-to-pdf/net/Performance-metrics">Performance Metrics</a>
+									</li>
 									<li>
 										<a href="/document-processing/word/conversions/word-to-pdf/net/Unsupported-elements-word-to-pdf">Unsupported Features</a>
 									</li>
@@ -4593,6 +4599,9 @@
 									<li>
 										<a href="/document-processing/word/conversions/word-to-image/net/Fallback-fonts-word-to-image">Fallback Fonts</a>
 									</li>
+									<li>
+										<a href="/document-processing/word/conversions/word-to-image/net/Performance-metrics">Performance Metrics</a>
+									</li>
 									<li>
 										<a href="/document-processing/word/conversions/word-to-image/net/Unsupported-elements-word-to-image">Unsupported Features</a>
 									</li>
@@ -7026,7 +7035,9 @@
 				<ul>
 					<li>
 						Weekly Nuget Release
-						<ul><li><a href="/document-processing/release-notes/v31.2.4">v31.2.4</a></li>
+						<ul>
+							<li><a href="/document-processing/release-notes/v31.2.5">v31.2.5</a></li>
+							<li><a href="/document-processing/release-notes/v31.2.4">v31.2.4</a></li>
 							<li><a href="/document-processing/release-notes/v31.2.3">v31.2.3</a></li>
 							<li><a href="/document-processing/release-notes/v31.1.22">v31.1.22</a></li>
 							<li><a href="/document-processing/release-notes/v31.1.21">v31.1.21</a></li>

Document-Processing/PDF/PDF-Library/NET/Working-with-HyperLinks.md

@@ -9,6 +9,9 @@ documentation: UG
 
 In PDF, hyperlinks can be added to allow the users to navigate to another part of PDF file, web page or any other external content. Essential<sup>&reg;</sup> PDF provides support for all these types of hyperlink.
 
+To quickly get started with working with hyperlinks in PDF documents using the Syncfusion<sup>&reg;</sup> PDF library for .NET, refer to this video tutorial:
+{% youtube "https://youtu.be/g6HhVg2Fbd8?si=1WFL_6RCfRQvZhKb" %}
+
 ## Working with Web navigation
                                      
 You can navigate to specified URL from a PDF document by using the [PdfTextWebLink](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfTextWebLink.html) class.

Document-Processing/PDF/PDF-Library/NET/Working-with-Images.md

@@ -618,6 +618,136 @@ doc.Close(True)
 
 You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Paginate-an-image-in-PDF-document). 
 
+## Clipping and graphics state
+
+This example demonstrates how to draw an image in a PDF document and apply a clipping region using the [SetClip](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#methods) method. Clipping restricts drawing to a defined area, allowing partial rendering of content. The code also uses [Save](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#methods) and [Restore](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#methods) methods of [PdfGraphics](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html) to manage the graphics state, enabling temporary clipping and restoring the full drawing area afterward. 
+
+{% tabs %} 
+
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/Images/Clipping-and-graphics-state/.NET/Clipping-and-graphics-state/Program.cs" %} 
+
+using Syncfusion.Drawing;
+using Syncfusion.Pdf;
+using Syncfusion.Pdf.Graphics;
+
+// Create a new PDF document
+using (PdfDocument document = new PdfDocument())
+{
+    // Add a page to the document
+    PdfPage page = document.Pages.Add();
+    // Get the graphics object for the page
+    PdfGraphics graphics = page.Graphics;
+    // Open the image file as a stream
+    using FileStream imageStream = new FileStream(Path.GetFullPath("Input.png"), FileMode.Open, FileAccess.Read);
+    // Load the image from the stream
+    PdfBitmap image = new PdfBitmap(imageStream);
+
+    // Save the current graphics state (to restore later)
+    PdfGraphicsState state = graphics.Save();
+
+    // Define a rectangular clipping region
+    RectangleF clipRect = new RectangleF(50, 50, 200, 100);
+    graphics.SetClip(clipRect);
+
+    // Draw the image — only the part within the clipping region will be visible
+    graphics.DrawImage(image, new RectangleF(40, 60, 150, 80));
+
+    // Restore the graphics state to remove the clipping region
+    graphics.Restore(state);
+    // Draw the image again — this time the full image will be visible
+    graphics.DrawImage(image, new RectangleF(60, 160, 150, 80));
+
+    // Save the PDF document
+    document.Save("Output.pdf");
+}
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+using System.Drawing;
+using Syncfusion.Pdf;
+using Syncfusion.Pdf.Graphics;
+
+// Create a new PDF document
+using (PdfDocument document = new PdfDocument())
+{
+    // Add a page to the document
+    PdfPage page = document.Pages.Add();
+    // Get the graphics object for the page
+    PdfGraphics graphics = page.Graphics;
+    // Open the image file as a stream
+    using FileStream imageStream = new FileStream(Path.GetFullPath("Input.png"), FileMode.Open, FileAccess.Read);
+    // Load the image from the stream
+    PdfBitmap image = new PdfBitmap(imageStream);
+
+    // Save the current graphics state (to restore later)
+    PdfGraphicsState state = graphics.Save();
+
+    // Define a rectangular clipping region
+    RectangleF clipRect = new RectangleF(50, 50, 200, 100);
+    graphics.SetClip(clipRect);
+
+    // Draw the image — only the part within the clipping region will be visible
+    graphics.DrawImage(image, new RectangleF(40, 60, 150, 80));
+
+    // Restore the graphics state to remove the clipping region
+    graphics.Restore(state);
+    // Draw the image again — this time the full image will be visible
+    graphics.DrawImage(image, new RectangleF(60, 160, 150, 80));
+
+    // Save the PDF document
+    document.Save("Output.pdf");
+}
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+Imports System.Drawing
+Imports Syncfusion.Pdf
+Imports Syncfusion.Pdf.Graphics
+
+' Create a new PDF document
+Using document As New PdfDocument()
+' Add a page to the document
+Dim page As PdfPage = document.Pages.Add()
+
+' Get the graphics object for the page
+Dim graphics As PdfGraphics = page.Graphics
+
+' Open the image file as a stream
+Using imageStream As New FileStream(Path.GetFullPath("Input.png"), FileMode.Open, FileAccess.Read)
+' Load the image from the stream
+Dim image As New PdfBitmap(imageStream)
+
+' Save the current graphics state (to restore later)
+Dim state As PdfGraphicsState = graphics.Save()
+
+' Define a rectangular clipping region
+Dim clipRect As New RectangleF(50, 50, 200, 100)
+graphics.SetClip(clipRect)
+
+' Draw the image — only the part within the clipping region will be visible
+graphics.DrawImage(image, New RectangleF(40, 60, 150, 80))
+
+' Restore the graphics state to remove the clipping region
+graphics.Restore(state)
+
+' Draw the image again — this time the full image will be visible
+graphics.DrawImage(image, New RectangleF(60, 160, 150, 80))
+End Using
+
+' Save the PDF document
+document.Save("Output.pdf")
+End Using
+
+{% endhighlight %}
+
+{% endtabs %}  
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Clipping-and-graphics-state/.NET).
+
 ## Applying transparency and rotation to the image
 
 You can add transparency and rotation to the image using [SetTransparency](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#Syncfusion_Pdf_Graphics_PdfGraphics_SetTransparency_System_Single_) and [RotateTransform](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#Syncfusion_Pdf_Graphics_PdfGraphics_RotateTransform_System_Single_) methods of [PdfGraphics](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html) respectively. This is explained in the below code snippet.