Add FPDFDest_GetLocationInPage API

public/fpdf_doc.h

Index: public/fpdf_doc.h
diff --git a/public/fpdf_doc.h b/public/fpdf_doc.h
index c3be0e05988218274dd68178067e6ee487558f21..50d6e17d26d34b2e834f7d90aa3129f774951934 100644
--- a/public/fpdf_doc.h
+++ b/public/fpdf_doc.h
@@ -171,6 +171,22 @@ DLLEXPORT unsigned long STDCALL FPDFAction_GetURIPath(FPDF_DOCUMENT document,
 DLLEXPORT unsigned long STDCALL FPDFDest_GetPageIndex(FPDF_DOCUMENT document,
                                                       FPDF_DEST dest);
 
+// Get the (x, y, zoom) location of |dest| in the destination page, if the
+// destination is in [page /XYZ x y zoom] syntax.
+//
+//   dest - handle to the destination.
+//   x    - out parameter; the x coordinate, in the page coordinate system.
+//   y    - out parameter; the y coordinate, in the page coordinate system.
+//   zoom - out parameter; the zoom value.
+// Returns TRUE on success.

[Lei Zhang, 2016/11/07 20:19:20]

Better define "success" ?

[dsinclair, 2016/11/07 21:49:18]

Done.

+DLLEXPORT FPDF_BOOL STDCALL FPDFDest_GetLocationInPage(FPDF_DEST dest,
+                                                       FPDF_BOOL* hasX,

[Lei Zhang, 2016/11/07 20:19:20]

Document.

[dsinclair, 2016/11/07 21:49:18]

Done.

+                                                       FPDF_BOOL* hasY,
+                                                       FPDF_BOOL* hasZoom,
+                                                       FS_FLOAT* x,
+                                                       FS_FLOAT* y,
+                                                       FS_FLOAT* zoom);
+
 // Find a link at point (|x|,|y|) on |page|.
 //
 //   page - handle to the document page.