diff --git a/EnvelopeGenerator.Application/Common/Dto/AnnotationDto.cs b/EnvelopeGenerator.Application/Common/Dto/AnnotationDto.cs index e20769b5..320d1895 100644 --- a/EnvelopeGenerator.Application/Common/Dto/AnnotationDto.cs +++ b/EnvelopeGenerator.Application/Common/Dto/AnnotationDto.cs @@ -35,12 +35,28 @@ public record AnnotationCreateDto public string Type { get; init; } = string.Empty; /// - /// + /// Horizontal position of the signature field on the page. + ///

+ /// DevExpress unit: Hundredths of an inch (1/100 inch ≈ 2.83 PDF points), origin at the top-left corner of the page, X increases to the right. + ///
+ /// Difference from PSPDFKit: PSPDFKit also uses top-left origin but measures in PDF points (1/72 inch). + /// To convert: xDevExpress = xPsPdfKit * (100.0 / 72.0) + ///
+ /// Difference from GDPicture: GDPicture uses PDF points with bottom-left origin (standard PDF coordinate system). + /// The X axis is the same direction, only unit conversion is needed: xDevExpress = xGdPicture * (100.0 / 72.0) ///
public double? X { get; init; } /// - /// + /// Vertical position of the signature field on the page. + ///

+ /// DevExpress unit: Hundredths of an inch (1/100 inch ≈ 2.83 PDF points), origin at the top-left corner of the page, Y increases downward. + ///
+ /// Difference from PSPDFKit: PSPDFKit also uses top-left origin and Y increases downward, but measures in PDF points (1/72 inch). + /// To convert: yDevExpress = yPsPdfKit * (100.0 / 72.0) + ///
+ /// Difference from GDPicture: GDPicture uses PDF points with bottom-left origin, so Y increases upward (PDF standard). + /// To convert: yDevExpress = (pageHeightInPt - yGdPicture - elementHeightInPt) * (100.0 / 72.0) ///
public double? Y { get; init; }