// Copyright 2014 The PDFium Authors // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com #include "public/fpdf_doc.h" #include #include #include #include "constants/form_fields.h" #include "core/fpdfapi/page/cpdf_annotcontext.h" #include "core/fpdfapi/page/cpdf_page.h" #include "core/fpdfapi/parser/cpdf_array.h" #include "core/fpdfapi/parser/cpdf_dictionary.h" #include "core/fpdfapi/parser/cpdf_document.h" #include "core/fpdfapi/parser/cpdf_number.h" #include "core/fpdfapi/parser/cpdf_string.h" #include "core/fpdfapi/parser/fpdf_parser_decode.h" #include "core/fpdfdoc/cpdf_aaction.h" #include "core/fpdfdoc/cpdf_bookmark.h" #include "core/fpdfdoc/cpdf_bookmarktree.h" #include "core/fpdfdoc/cpdf_dest.h" #include "core/fpdfdoc/cpdf_linklist.h" #include "core/fpdfdoc/cpdf_pagelabel.h" #include "fpdfsdk/cpdfsdk_helpers.h" #include "public/fpdf_formfill.h" #include "third_party/base/check.h" #include "third_party/base/containers/contains.h" #include "third_party/base/numerics/safe_conversions.h" namespace { CPDF_Bookmark FindBookmark(const CPDF_BookmarkTree& tree, CPDF_Bookmark bookmark, const WideString& title, std::set* visited) { // Return if already checked to avoid circular calling. if (pdfium::Contains(*visited, bookmark.GetDict())) return CPDF_Bookmark(); visited->insert(bookmark.GetDict()); if (bookmark.GetDict() && bookmark.GetTitle().CompareNoCase(title.c_str()) == 0) { // First check this item. return bookmark; } // Go into children items. CPDF_Bookmark child = tree.GetFirstChild(bookmark); while (child.GetDict() && !pdfium::Contains(*visited, child.GetDict())) { // Check this item and its children. CPDF_Bookmark found = FindBookmark(tree, child, title, visited); if (found.GetDict()) return found; child = tree.GetNextSibling(child); } return CPDF_Bookmark(); } CPDF_LinkList* GetLinkList(CPDF_Page* page) { CPDF_Document* pDoc = page->GetDocument(); auto* pList = static_cast(pDoc->GetLinksContext()); if (pList) return pList; auto pNewList = std::make_unique(); pList = pNewList.get(); pDoc->SetLinksContext(std::move(pNewList)); return pList; } } // namespace FPDF_EXPORT FPDF_BOOKMARK FPDF_CALLCONV FPDFBookmark_GetFirstChild(FPDF_DOCUMENT document, FPDF_BOOKMARK bookmark) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; CPDF_BookmarkTree tree(pDoc); CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); return FPDFBookmarkFromCPDFDictionary( tree.GetFirstChild(cBookmark).GetDict()); } FPDF_EXPORT FPDF_BOOKMARK FPDF_CALLCONV FPDFBookmark_GetNextSibling(FPDF_DOCUMENT document, FPDF_BOOKMARK bookmark) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; if (!bookmark) return nullptr; CPDF_BookmarkTree tree(pDoc); CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); return FPDFBookmarkFromCPDFDictionary( tree.GetNextSibling(cBookmark).GetDict()); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDFBookmark_GetTitle(FPDF_BOOKMARK bookmark, void* buffer, unsigned long buflen) { if (!bookmark) return 0; CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); WideString title = cBookmark.GetTitle(); return Utf16EncodeMaybeCopyAndReturnLength(title, buffer, buflen); } FPDF_EXPORT int FPDF_CALLCONV FPDFBookmark_GetCount(FPDF_BOOKMARK bookmark) { if (!bookmark) return 0; CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); return cBookmark.GetCount(); } FPDF_EXPORT FPDF_BOOKMARK FPDF_CALLCONV FPDFBookmark_Find(FPDF_DOCUMENT document, FPDF_WIDESTRING title) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; WideString encodedTitle = WideStringFromFPDFWideString(title); if (encodedTitle.IsEmpty()) return nullptr; CPDF_BookmarkTree tree(pDoc); std::set visited; return FPDFBookmarkFromCPDFDictionary( FindBookmark(tree, CPDF_Bookmark(), encodedTitle, &visited).GetDict()); } FPDF_EXPORT FPDF_DEST FPDF_CALLCONV FPDFBookmark_GetDest(FPDF_DOCUMENT document, FPDF_BOOKMARK bookmark) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; if (!bookmark) return nullptr; CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); CPDF_Dest dest = cBookmark.GetDest(pDoc); if (dest.GetArray()) return FPDFDestFromCPDFArray(dest.GetArray()); // If this bookmark is not directly associated with a dest, we try to get // action CPDF_Action action = cBookmark.GetAction(); if (!action.HasDict()) return nullptr; return FPDFDestFromCPDFArray(action.GetDest(pDoc).GetArray()); } FPDF_EXPORT FPDF_ACTION FPDF_CALLCONV FPDFBookmark_GetAction(FPDF_BOOKMARK bookmark) { if (!bookmark) return nullptr; CPDF_Bookmark cBookmark( pdfium::WrapRetain(CPDFDictionaryFromFPDFBookmark(bookmark))); return FPDFActionFromCPDFDictionary(cBookmark.GetAction().GetDict()); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDFAction_GetType(FPDF_ACTION action) { if (!action) return PDFACTION_UNSUPPORTED; CPDF_Action cAction(pdfium::WrapRetain(CPDFDictionaryFromFPDFAction(action))); switch (cAction.GetType()) { case CPDF_Action::Type::kGoTo: return PDFACTION_GOTO; case CPDF_Action::Type::kGoToR: return PDFACTION_REMOTEGOTO; case CPDF_Action::Type::kGoToE: return PDFACTION_EMBEDDEDGOTO; case CPDF_Action::Type::kURI: return PDFACTION_URI; case CPDF_Action::Type::kLaunch: return PDFACTION_LAUNCH; default: return PDFACTION_UNSUPPORTED; } } FPDF_EXPORT FPDF_DEST FPDF_CALLCONV FPDFAction_GetDest(FPDF_DOCUMENT document, FPDF_ACTION action) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; unsigned long type = FPDFAction_GetType(action); if (type != PDFACTION_GOTO && type != PDFACTION_REMOTEGOTO && type != PDFACTION_EMBEDDEDGOTO) { return nullptr; } CPDF_Action cAction(pdfium::WrapRetain(CPDFDictionaryFromFPDFAction(action))); return FPDFDestFromCPDFArray(cAction.GetDest(pDoc).GetArray()); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDFAction_GetFilePath(FPDF_ACTION action, void* buffer, unsigned long buflen) { unsigned long type = FPDFAction_GetType(action); if (type != PDFACTION_REMOTEGOTO && type != PDFACTION_EMBEDDEDGOTO && type != PDFACTION_LAUNCH) { return 0; } CPDF_Action cAction(pdfium::WrapRetain(CPDFDictionaryFromFPDFAction(action))); ByteString path = cAction.GetFilePath().ToUTF8(); return NulTerminateMaybeCopyAndReturnLength(path, buffer, buflen); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDFAction_GetURIPath(FPDF_DOCUMENT document, FPDF_ACTION action, void* buffer, unsigned long buflen) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return 0; unsigned long type = FPDFAction_GetType(action); if (type != PDFACTION_URI) return 0; CPDF_Action cAction(pdfium::WrapRetain(CPDFDictionaryFromFPDFAction(action))); ByteString path = cAction.GetURI(pDoc); const unsigned long len = pdfium::base::checked_cast(path.GetLength() + 1); if (buffer && len <= buflen) memcpy(buffer, path.c_str(), len); return len; } FPDF_EXPORT int FPDF_CALLCONV FPDFDest_GetDestPageIndex(FPDF_DOCUMENT document, FPDF_DEST dest) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return -1; if (!dest) return -1; CPDF_Dest destination(pdfium::WrapRetain(CPDFArrayFromFPDFDest(dest))); return destination.GetDestPageIndex(pDoc); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDFDest_GetView(FPDF_DEST dest, unsigned long* pNumParams, FS_FLOAT* pParams) { if (!dest) { *pNumParams = 0; return 0; } CPDF_Dest destination(pdfium::WrapRetain(CPDFArrayFromFPDFDest(dest))); const unsigned long nParams = pdfium::base::checked_cast(destination.GetNumParams()); DCHECK(nParams <= 4); *pNumParams = nParams; for (unsigned long i = 0; i < nParams; ++i) pParams[i] = destination.GetParam(i); return destination.GetZoomMode(); } FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFDest_GetLocationInPage(FPDF_DEST dest, FPDF_BOOL* hasXVal, FPDF_BOOL* hasYVal, FPDF_BOOL* hasZoomVal, FS_FLOAT* x, FS_FLOAT* y, FS_FLOAT* zoom) { if (!dest) return false; CPDF_Dest destination(pdfium::WrapRetain(CPDFArrayFromFPDFDest(dest))); // FPDF_BOOL is an int, GetXYZ expects bools. bool bHasX; bool bHasY; bool bHasZoom; if (!destination.GetXYZ(&bHasX, &bHasY, &bHasZoom, x, y, zoom)) return false; *hasXVal = bHasX; *hasYVal = bHasY; *hasZoomVal = bHasZoom; return true; } FPDF_EXPORT FPDF_LINK FPDF_CALLCONV FPDFLink_GetLinkAtPoint(FPDF_PAGE page, double x, double y) { CPDF_Page* pPage = CPDFPageFromFPDFPage(page); if (!pPage) return nullptr; CPDF_LinkList* pLinkList = GetLinkList(pPage); if (!pLinkList) return nullptr; CPDF_Link link = pLinkList->GetLinkAtPoint( pPage, CFX_PointF(static_cast(x), static_cast(y)), nullptr); // Unretained reference in public API. NOLINTNEXTLINE return FPDFLinkFromCPDFDictionary(link.GetMutableDict()); } FPDF_EXPORT int FPDF_CALLCONV FPDFLink_GetLinkZOrderAtPoint(FPDF_PAGE page, double x, double y) { CPDF_Page* pPage = CPDFPageFromFPDFPage(page); if (!pPage) return -1; CPDF_LinkList* pLinkList = GetLinkList(pPage); if (!pLinkList) return -1; int z_order = -1; pLinkList->GetLinkAtPoint( pPage, CFX_PointF(static_cast(x), static_cast(y)), &z_order); return z_order; } FPDF_EXPORT FPDF_DEST FPDF_CALLCONV FPDFLink_GetDest(FPDF_DOCUMENT document, FPDF_LINK link) { if (!link) return nullptr; CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return nullptr; CPDF_Link cLink(pdfium::WrapRetain(CPDFDictionaryFromFPDFLink(link))); FPDF_DEST dest = FPDFDestFromCPDFArray(cLink.GetDest(pDoc).GetArray()); if (dest) return dest; // If this link is not directly associated with a dest, we try to get action CPDF_Action action = cLink.GetAction(); if (!action.HasDict()) return nullptr; return FPDFDestFromCPDFArray(action.GetDest(pDoc).GetArray()); } FPDF_EXPORT FPDF_ACTION FPDF_CALLCONV FPDFLink_GetAction(FPDF_LINK link) { if (!link) return nullptr; CPDF_Link cLink(pdfium::WrapRetain(CPDFDictionaryFromFPDFLink(link))); return FPDFActionFromCPDFDictionary(cLink.GetAction().GetDict()); } FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFLink_Enumerate(FPDF_PAGE page, int* start_pos, FPDF_LINK* link_annot) { if (!start_pos || !link_annot) return false; CPDF_Page* pPage = CPDFPageFromFPDFPage(page); if (!pPage) return false; RetainPtr pAnnots = pPage->GetMutableAnnotsArray(); if (!pAnnots) return false; for (size_t i = *start_pos; i < pAnnots->size(); i++) { RetainPtr pDict = ToDictionary(pAnnots->GetMutableDirectObjectAt(i)); if (!pDict) continue; if (pDict->GetByteStringFor("Subtype") == "Link") { *start_pos = static_cast(i + 1); *link_annot = FPDFLinkFromCPDFDictionary(pDict.Get()); return true; } } return false; } FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV FPDFLink_GetAnnot(FPDF_PAGE page, FPDF_LINK link_annot) { CPDF_Page* pPage = CPDFPageFromFPDFPage(page); RetainPtr pAnnotDict(CPDFDictionaryFromFPDFLink(link_annot)); if (!pPage || !pAnnotDict) return nullptr; auto pAnnotContext = std::make_unique( std::move(pAnnotDict), IPDFPageFromFPDFPage(page)); // Caller takes the ownership of the object. return FPDFAnnotationFromCPDFAnnotContext(pAnnotContext.release()); } FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFLink_GetAnnotRect(FPDF_LINK link_annot, FS_RECTF* rect) { if (!link_annot || !rect) return false; CPDF_Dictionary* pAnnotDict = CPDFDictionaryFromFPDFLink(link_annot); *rect = FSRectFFromCFXFloatRect(pAnnotDict->GetRectFor("Rect")); return true; } FPDF_EXPORT int FPDF_CALLCONV FPDFLink_CountQuadPoints(FPDF_LINK link_annot) { RetainPtr pArray = GetQuadPointsArrayFromDictionary(CPDFDictionaryFromFPDFLink(link_annot)); return pArray ? static_cast(pArray->size() / 8) : 0; } FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFLink_GetQuadPoints(FPDF_LINK link_annot, int quad_index, FS_QUADPOINTSF* quad_points) { if (!quad_points || quad_index < 0) return false; const CPDF_Dictionary* pLinkDict = CPDFDictionaryFromFPDFLink(link_annot); if (!pLinkDict) return false; RetainPtr pArray = GetQuadPointsArrayFromDictionary(pLinkDict); if (!pArray) return false; return GetQuadPointsAtIndex(std::move(pArray), static_cast(quad_index), quad_points); } FPDF_EXPORT FPDF_ACTION FPDF_CALLCONV FPDF_GetPageAAction(FPDF_PAGE page, int aa_type) { CPDF_Page* pdf_page = CPDFPageFromFPDFPage(page); if (!pdf_page) return nullptr; CPDF_AAction aa(pdf_page->GetDict()->GetDictFor(pdfium::form_fields::kAA)); CPDF_AAction::AActionType type; if (aa_type == FPDFPAGE_AACTION_OPEN) type = CPDF_AAction::kOpenPage; else if (aa_type == FPDFPAGE_AACTION_CLOSE) type = CPDF_AAction::kClosePage; else return nullptr; if (!aa.ActionExist(type)) return nullptr; CPDF_Action action = aa.GetAction(type); return FPDFActionFromCPDFDictionary(action.GetDict()); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDF_GetFileIdentifier(FPDF_DOCUMENT document, FPDF_FILEIDTYPE id_type, void* buffer, unsigned long buflen) { CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return 0; // Check if |id_type| is valid. if (id_type != FILEIDTYPE_PERMANENT && id_type != FILEIDTYPE_CHANGING) return 0; RetainPtr pFileId = pDoc->GetFileIdentifier(); if (!pFileId) return 0; size_t nIndex = id_type == FILEIDTYPE_PERMANENT ? 0 : 1; RetainPtr pValue = ToString(pFileId->GetDirectObjectAt(nIndex)); if (!pValue) return 0; return NulTerminateMaybeCopyAndReturnLength(pValue->GetString(), buffer, buflen); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDF_GetMetaText(FPDF_DOCUMENT document, FPDF_BYTESTRING tag, void* buffer, unsigned long buflen) { if (!tag) return 0; CPDF_Document* pDoc = CPDFDocumentFromFPDFDocument(document); if (!pDoc) return 0; RetainPtr pInfo = pDoc->GetInfo(); if (!pInfo) return 0; WideString text = pInfo->GetUnicodeTextFor(tag); return Utf16EncodeMaybeCopyAndReturnLength(text, buffer, buflen); } FPDF_EXPORT unsigned long FPDF_CALLCONV FPDF_GetPageLabel(FPDF_DOCUMENT document, int page_index, void* buffer, unsigned long buflen) { if (page_index < 0) return 0; // CPDF_PageLabel can deal with NULL |document|. CPDF_PageLabel label(CPDFDocumentFromFPDFDocument(document)); absl::optional str = label.GetLabel(page_index); return str.has_value() ? Utf16EncodeMaybeCopyAndReturnLength(str.value(), buffer, buflen) : 0; }