Skip to content

test MD file encoding format #4441

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DeepakRajSundar wants to merge 5 commits into
base: hotfix/hotfix-v34.2.2
Choose a base branch
from
Open

test MD file encoding format #4441

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
02494fa
test PR
DeepakRajSundar Aug 19, 2026
b54c078
Update add-save-button-in-toolbar.md with new instructions
DeepakRajSundar Aug 19, 2026
447f747
Update deployment instructions for Document Editor API
DeepakRajSundar Aug 19, 2026
7ed310f
Add files via upload
DeepakRajSundar Aug 20, 2026
ce07376
Merge branch 'hotfix/hotfix-v34.2.2' into DeepakRajSundar-patch-1
DeepakRajSundar Aug 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
300 changes: 150 additions & 150 deletions Document-Processing/PDF/PDF-Viewer/maui/Coordinates-Conversion.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,150 +1,150 @@
---
layout: post
title: Coordinate Conversion in .NET MAUI PDF Viewer | Syncfusion
description: Learn how to convert between PDF page coordinates and viewer coordinates in the Syncfusion<sup>®</sup> .NET MAUI PDF Viewer (SfPdfViewer) control.
platform: document-processing
control: SfPdfViewer
documentation: ug
keywords: .net maui pdf viewer, .net maui view pdf, pdf viewer in .net maui, .net maui open pdf, maui pdf viewer, maui pdf view
---

# Coordinate Conversion in .NET MAUI PDF Viewer

PDF Viewer allows users to obtain the PDF page coordinates relative to the PDF Viewer’s client coordinates and vice versa. It also allows you to obtain the scroll point relative to the PDF page coordinates and bring the given region into view.

## Client rectangle

The [ClientRectangle](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ClientRectangle) in the MAUI PdfViewer control is a rectangular area that represents the dimensions of the client area or viewport. The client area denotes the visible portion of the PDF document within the control. In the MAUI PDF Viewer, this client rectangle is illustrated by the red rectangle in the following figure.

![Client rectangle in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Client-Rectangle.png)

The client rectangle can be obtained by the [ClientRectangle](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ClientRectangle) property of the PDF Viewer. The following code sample explains the same.

{% tabs %}
{% highlight c# %}
//Retrieve the coordinates of the PDF Viewer's client area (viewport)
Rect clientRectangle = PdfViewer.ClientRectangle;
{% endhighlight %}
{% endtabs %}

## Client coordinates

The MAUI PDF Viewer specifies the position of points in the client area (viewport) using client coordinates. The upper-left corner of the client area (viewport) of the control is the origin for client coordinates. The client coordinates in the MAUI PDF Viewer are shown in the following figure.

![Client coordinates in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Client-Coordinates.png)

### Get the page number from a client point

You can obtain the page number of the client point using the [GetPageNumberFromClientPoint(Point clientPoint)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_GetPageNumberFromClientPoint_Microsoft_Maui_Graphics_Point_) method by passing the client point as an input parameter. The following code sample explains how to get the page number from the client point.

{% tabs %}
{% highlight c# %}
//Subscribe to the Tapped event of the PDF Viewer
PdfViewer.Tapped += PdfViewer_Tapped;

// Handle the tapped event.
private void PdfViewer_Tapped(object sender, GestureEventArgs e)
{
//Retrieve the tapped client area position.
Point clientPoint = e.Position;
//Retrieve the page number that corresponds to the client point.
int pageNumber = PdfViewer.GetPageNumberFromClientPoint(clientPoint);
}
{% endhighlight %}
{% endtabs %}

## PDF page coordinates

PDF page coordinates are represented in terms of a device-independent coordinate system called user space, which is independent of the output device that will be used for printing or display. The user space coordinates system is initialized to a default state for each page of a PDF document. The length of a unit is 1/72 inch, which is equivalent to one point (pt). As an example, the dimensions of a letter-sized paper in PDF page coordinates are shown in the diagram below.

![Page coordinates in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Page-Coordinates.png)

## Scroll coordinates

Scroll coordinates in the MAUI PDF Viewer denote pixel-based positions as pages are scrolled. They indicate precise locations within the entire document. The coordinate system originates from the top-left corner of the visible area.

## Convert PDF Viewer's coordinates to PDF page coordinates

You can obtain the PDF page coordinates using the [ConvertClientPointToPagePoint(clientPoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertClientPointToPagePoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the client point and page number as input parameters. The following code sample explains how to convert a tapped client area position to a page point.

{% tabs %}
{% highlight c# %}
//Subscribe to the Tapped event of the PDF Viewer
PdfViewer.Tapped += PdfViewer_Tapped;

// Handle the tapped event.
private void PdfViewer_Tapped(object sender, GestureEventArgs e)
{
//Retrieve the tapped client area position.
Point clientPoint = e.Position;
//Retrieve the page number that corresponds to the client point.
int pageNumber = PdfViewer.GetPageNumberFromClientPoint(clientPoint);
//Retrieve the page point.
Point pagePoint = PdfViewer.ConvertClientPointToPagePoint(clientPoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}

## Convert PDF page coordinates to PDF Viewer's coordinates

You can obtain the PDF Viewer's coordinates using the [ConvertPagePointToClientPoint(pagePoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertPagePointToClientPoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the page point and page number as input parameters. The following code sample explains how to convert a square annotation's position in the page coordinates to a client point.

{% tabs %}
{% highlight c# %}
// Obtain the annotation collection using [SfPdfViewer](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) instance.
ReadOnlyObservableCollection<Annotation> annotations = PdfViewer.Annotations;

// Obtain the first annotation in the annotation collection.
Annotation annotation = annotations[0];

// Type cast to the specific annotation type. Here, the first annotation is a square annotation.
if (annotation is SquareAnnotation squareAnnotation)
{
//Get the annotation's page number.
int pageNumber = squareAnnotation.PageNumber;
//Get the annotation bounds.
RectF annotationBounds = squareAnnotation.Bounds;
//Find the position of the annotation in page coordinates.
Point pagePoint = new Point(annotationBounds.X, annotationBounds.Y);
//Convert the page point to client point.
Point clientPoint = PdfViewer.ConvertPagePointToClientPoint(pagePoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}

## Convert PDF page coordinates to scroll coordinates

You can obtain the PDF Viewer's scroll coordinates using the [ConvertPagePointToScrollPoint(pagePoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertPagePointToScrollPoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the page point and page number as input parameters. The following code example explains how to convert a square annotation's position in the page coordinates to a scroll point.

{% tabs %}
{% highlight c# %}
// Obtain the annotation collection using [SfPdfViewer](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) instance.
ReadOnlyObservableCollection<Annotation> annotations = PdfViewer.Annotations;

// Obtain the first annotation in the annotation collection.
Annotation annotation = annotations[0];

// Type cast to the specific annotation type. Here, the first annotation is a square annotation.
if (annotation is SquareAnnotation squareAnnotation)
{
//Get the annotation bounds.
RectF annotationBounds = squareAnnotation.Bounds;
//Get the annotation's page number.
int pageNumber = squareAnnotation.PageNumber;
//Find the position of the annotation in page coordinates.
Point pagePoint = new Point(annotationBounds.X, annotationBounds.Y);
//Convert the page point to scroll point.
Point scrollPoint = PdfViewer.ConvertPagePointToScrollPoint(pagePoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}

## See Also

- [Annotations Overview](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/annotations-overview)
- [Page Navigation](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/page-navigation)
- [Scrolling](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/scrolling)
- [Add, Remove, and Edit Annotations](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/add-remove-modify-annotations)
- [Annotation Collection](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/annotation-collection)
- [Magnification](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/magnification)

---
layout: post
title: Coordinate Conversion in .NET MAUI PDF Viewer | Syncfusion
description: Learn how to convert between PDF page coordinates and viewer coordinates in the Syncfusion<sup>®</sup> .NET MAUI PDF Viewer (SfPdfViewer) control.
platform: document-processing
control: SfPdfViewer
documentation: ug
keywords: .net maui pdf viewer, .net maui view pdf, pdf viewer in .net maui, .net maui open pdf, maui pdf viewer, maui pdf view
---
# Working with PDF coordinate systems in .NET MAUI PDF Viewer
PDF Viewer allows users to obtain the PDF page coordinates relative to the PDF Viewer’s client coordinates and vice versa. It also allows you to obtain the scroll point relative to the PDF page coordinates and bring the given region into view.
## Client rectangle
The [ClientRectangle](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ClientRectangle) in the MAUI PdfViewer control is a rectangular area that represents the dimensions of the client area or viewport. The client area denotes the visible portion of the PDF document within the control. In the MAUI PDF Viewer, this client rectangle is illustrated by the red rectangle in the following figure.
![Client rectangle in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Client-Rectangle.png)
The client rectangle can be obtained by the [ClientRectangle](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ClientRectangle) property of the PDF Viewer. The following code sample explains the same.
{% tabs %}
{% highlight c# %}
//Retrieve the coordinates of the PDF Viewer's client area (viewport)
Rect clientRectangle = PdfViewer.ClientRectangle;
{% endhighlight %}
{% endtabs %}
## Client coordinates
The MAUI PDF Viewer specifies the position of points in the client area (viewport) using client coordinates. The upper-left corner of the client area (viewport) of the control is the origin for client coordinates. The client coordinates in the MAUI PDF Viewer are shown in the following figure.
![Client coordinates in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Client-Coordinates.png)
### Get the page number from a client point
You can obtain the page number of the client point using the [GetPageNumberFromClientPoint(Point clientPoint)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_GetPageNumberFromClientPoint_Microsoft_Maui_Graphics_Point_) method by passing the client point as an input parameter. The following code sample explains how to get the page number from the client point.
{% tabs %}
{% highlight c# %}
//Subscribe to the Tapped event of the PDF Viewer
PdfViewer.Tapped += PdfViewer_Tapped;
// Handle the tapped event.
private void PdfViewer_Tapped(object sender, GestureEventArgs e)
{
//Retrieve the tapped client area position.
Point clientPoint = e.Position;
//Retrieve the page number that corresponds to the client point.
int pageNumber = PdfViewer.GetPageNumberFromClientPoint(clientPoint);
}
{% endhighlight %}
{% endtabs %}
## PDF page coordinates
PDF page coordinates are represented in terms of a device-independent coordinate system called user space, which is independent of the output device that will be used for printing or display. The user space coordinates system is initialized to a default state for each page of a PDF document. The length of a unit is 1/72 inch, which is equivalent to one point (pt). As an example, the dimensions of a letter-sized paper in PDF page coordinates are shown in the diagram below.
![Page coordinates in .NET MAUI PDF Viewer](Images/Coordinates-Conversion/Page-Coordinates.png)
## Scroll coordinates
Scroll coordinates in the MAUI PDF Viewer denote pixel-based positions as pages are scrolled. They indicate precise locations within the entire document. The coordinate system originates from the top-left corner of the visible area.
## Convert PDF Viewer's coordinates to PDF page coordinates
You can obtain the PDF page coordinates using the [ConvertClientPointToPagePoint(clientPoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertClientPointToPagePoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the client point and page number as input parameters. The following code sample explains how to convert a tapped client area position to a page point.
{% tabs %}
{% highlight c# %}
//Subscribe to the Tapped event of the PDF Viewer
PdfViewer.Tapped += PdfViewer_Tapped;
// Handle the tapped event.
private void PdfViewer_Tapped(object sender, GestureEventArgs e)
{
//Retrieve the tapped client area position.
Point clientPoint = e.Position;
//Retrieve the page number that corresponds to the client point.
int pageNumber = PdfViewer.GetPageNumberFromClientPoint(clientPoint);
//Retrieve the page point.
Point pagePoint = PdfViewer.ConvertClientPointToPagePoint(clientPoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}
## Convert PDF page coordinates to PDF Viewer's coordinates
You can obtain the PDF Viewer's coordinates using the [ConvertPagePointToClientPoint(pagePoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertPagePointToClientPoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the page point and page number as input parameters. The following code sample explains how to convert a square annotation's position in the page coordinates to a client point.
{% tabs %}
{% highlight c# %}
// Obtain the annotation collection using [SfPdfViewer](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) instance.
ReadOnlyObservableCollection<Annotation> annotations = PdfViewer.Annotations;
// Obtain the first annotation in the annotation collection.
Annotation annotation = annotations[0];
// Type cast to the specific annotation type. Here, the first annotation is a square annotation.
if (annotation is SquareAnnotation squareAnnotation)
{
//Get the annotation's page number.
int pageNumber = squareAnnotation.PageNumber;
//Get the annotation bounds.
RectF annotationBounds = squareAnnotation.Bounds;
//Find the position of the annotation in page coordinates.
Point pagePoint = new Point(annotationBounds.X, annotationBounds.Y);
//Convert the page point to client point.
Point clientPoint = PdfViewer.ConvertPagePointToClientPoint(pagePoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}
## Convert PDF page coordinates to scroll coordinates
You can obtain the PDF Viewer's scroll coordinates using the [ConvertPagePointToScrollPoint(pagePoint, pageNumber)](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ConvertPagePointToScrollPoint_Microsoft_Maui_Graphics_Point_System_Int32_) method by passing the page point and page number as input parameters. The following code example explains how to convert a square annotation's position in the page coordinates to a scroll point.
{% tabs %}
{% highlight c# %}
// Obtain the annotation collection using [SfPdfViewer](https://help.syncfusion.com/cr/document-processing/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) instance.
ReadOnlyObservableCollection<Annotation> annotations = PdfViewer.Annotations;
// Obtain the first annotation in the annotation collection.
Annotation annotation = annotations[0];
// Type cast to the specific annotation type. Here, the first annotation is a square annotation.
if (annotation is SquareAnnotation squareAnnotation)
{
//Get the annotation bounds.
RectF annotationBounds = squareAnnotation.Bounds;
//Get the annotation's page number.
int pageNumber = squareAnnotation.PageNumber;
//Find the position of the annotation in page coordinates.
Point pagePoint = new Point(annotationBounds.X, annotationBounds.Y);
//Convert the page point to scroll point.
Point scrollPoint = PdfViewer.ConvertPagePointToScrollPoint(pagePoint, pageNumber);
}
{% endhighlight %}
{% endtabs %}
## See Also
- [Annotations Overview](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/annotations-overview)
- [Page Navigation](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/page-navigation)
- [Scrolling](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/scrolling)
- [Add, Remove, and Edit Annotations](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/add-remove-modify-annotations)
- [Annotation Collection](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/annotation-collection)
- [Magnification](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/maui/magnification)
Loading