blob: 9cb23966e740d9e6d3f2a1def99800412d4ae312 [file] [log] [blame]
// Copyright 2017 PDFium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "public/fpdf_annot.h"
#include <memory>
#include <sstream>
#include <utility>
#include <vector>
#include "constants/annotation_common.h"
#include "core/fpdfapi/edit/cpdf_pagecontentgenerator.h"
#include "core/fpdfapi/page/cpdf_annotcontext.h"
#include "core/fpdfapi/page/cpdf_form.h"
#include "core/fpdfapi/page/cpdf_page.h"
#include "core/fpdfapi/page/cpdf_pageobject.h"
#include "core/fpdfapi/parser/cpdf_array.h"
#include "core/fpdfapi/parser/cpdf_boolean.h"
#include "core/fpdfapi/parser/cpdf_dictionary.h"
#include "core/fpdfapi/parser/cpdf_document.h"
#include "core/fpdfapi/parser/cpdf_name.h"
#include "core/fpdfapi/parser/cpdf_number.h"
#include "core/fpdfapi/parser/cpdf_reference.h"
#include "core/fpdfapi/parser/cpdf_stream.h"
#include "core/fpdfapi/parser/cpdf_string.h"
#include "core/fpdfapi/parser/fpdf_parser_utility.h"
#include "core/fpdfdoc/cpdf_annot.h"
#include "core/fpdfdoc/cpdf_color_utils.h"
#include "core/fpdfdoc/cpdf_formfield.h"
#include "core/fpdfdoc/cpdf_generateap.h"
#include "core/fpdfdoc/cpdf_interactiveform.h"
#include "core/fxcrt/fx_safe_types.h"
#include "core/fxcrt/fx_string_wrappers.h"
#include "core/fxcrt/stl_util.h"
#include "core/fxge/cfx_color.h"
#include "fpdfsdk/cpdfsdk_formfillenvironment.h"
#include "fpdfsdk/cpdfsdk_helpers.h"
#include "fpdfsdk/cpdfsdk_interactiveform.h"
#include "third_party/base/check.h"
#include "third_party/base/numerics/safe_conversions.h"
#include "third_party/base/ptr_util.h"
namespace {
// These checks ensure the consistency of annotation subtype values across core/
// and public.
static_assert(static_cast<int>(CPDF_Annot::Subtype::UNKNOWN) ==
FPDF_ANNOT_UNKNOWN,
"CPDF_Annot::UNKNOWN value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::TEXT) == FPDF_ANNOT_TEXT,
"CPDF_Annot::TEXT value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::LINK) == FPDF_ANNOT_LINK,
"CPDF_Annot::LINK value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::FREETEXT) ==
FPDF_ANNOT_FREETEXT,
"CPDF_Annot::FREETEXT value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::LINE) == FPDF_ANNOT_LINE,
"CPDF_Annot::LINE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::SQUARE) ==
FPDF_ANNOT_SQUARE,
"CPDF_Annot::SQUARE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::CIRCLE) ==
FPDF_ANNOT_CIRCLE,
"CPDF_Annot::CIRCLE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::POLYGON) ==
FPDF_ANNOT_POLYGON,
"CPDF_Annot::POLYGON value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::POLYLINE) ==
FPDF_ANNOT_POLYLINE,
"CPDF_Annot::POLYLINE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::HIGHLIGHT) ==
FPDF_ANNOT_HIGHLIGHT,
"CPDF_Annot::HIGHLIGHT value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::UNDERLINE) ==
FPDF_ANNOT_UNDERLINE,
"CPDF_Annot::UNDERLINE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::SQUIGGLY) ==
FPDF_ANNOT_SQUIGGLY,
"CPDF_Annot::SQUIGGLY value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::STRIKEOUT) ==
FPDF_ANNOT_STRIKEOUT,
"CPDF_Annot::STRIKEOUT value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::STAMP) == FPDF_ANNOT_STAMP,
"CPDF_Annot::STAMP value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::CARET) == FPDF_ANNOT_CARET,
"CPDF_Annot::CARET value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::INK) == FPDF_ANNOT_INK,
"CPDF_Annot::INK value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::POPUP) == FPDF_ANNOT_POPUP,
"CPDF_Annot::POPUP value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::FILEATTACHMENT) ==
FPDF_ANNOT_FILEATTACHMENT,
"CPDF_Annot::FILEATTACHMENT value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::SOUND) == FPDF_ANNOT_SOUND,
"CPDF_Annot::SOUND value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::MOVIE) == FPDF_ANNOT_MOVIE,
"CPDF_Annot::MOVIE value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::WIDGET) ==
FPDF_ANNOT_WIDGET,
"CPDF_Annot::WIDGET value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::SCREEN) ==
FPDF_ANNOT_SCREEN,
"CPDF_Annot::SCREEN value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::PRINTERMARK) ==
FPDF_ANNOT_PRINTERMARK,
"CPDF_Annot::PRINTERMARK value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::TRAPNET) ==
FPDF_ANNOT_TRAPNET,
"CPDF_Annot::TRAPNET value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::WATERMARK) ==
FPDF_ANNOT_WATERMARK,
"CPDF_Annot::WATERMARK value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::THREED) ==
FPDF_ANNOT_THREED,
"CPDF_Annot::THREED value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::RICHMEDIA) ==
FPDF_ANNOT_RICHMEDIA,
"CPDF_Annot::RICHMEDIA value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::XFAWIDGET) ==
FPDF_ANNOT_XFAWIDGET,
"CPDF_Annot::XFAWIDGET value mismatch");
static_assert(static_cast<int>(CPDF_Annot::Subtype::REDACT) ==
FPDF_ANNOT_REDACT,
"CPDF_Annot::REDACT value mismatch");
// These checks ensure the consistency of annotation appearance mode values
// across core/ and public.
static_assert(static_cast<int>(CPDF_Annot::AppearanceMode::kNormal) ==
FPDF_ANNOT_APPEARANCEMODE_NORMAL,
"CPDF_Annot::AppearanceMode::Normal value mismatch");
static_assert(static_cast<int>(CPDF_Annot::AppearanceMode::kRollover) ==
FPDF_ANNOT_APPEARANCEMODE_ROLLOVER,
"CPDF_Annot::AppearanceMode::Rollover value mismatch");
static_assert(static_cast<int>(CPDF_Annot::AppearanceMode::kDown) ==
FPDF_ANNOT_APPEARANCEMODE_DOWN,
"CPDF_Annot::AppearanceMode::Down value mismatch");
// These checks ensure the consistency of dictionary value types across core/
// and public/.
static_assert(static_cast<int>(CPDF_Object::Type::kBoolean) ==
FPDF_OBJECT_BOOLEAN,
"CPDF_Object::kBoolean value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kNumber) ==
FPDF_OBJECT_NUMBER,
"CPDF_Object::kNumber value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kString) ==
FPDF_OBJECT_STRING,
"CPDF_Object::kString value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kName) == FPDF_OBJECT_NAME,
"CPDF_Object::kName value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kArray) == FPDF_OBJECT_ARRAY,
"CPDF_Object::kArray value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kDictionary) ==
FPDF_OBJECT_DICTIONARY,
"CPDF_Object::kDictionary value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kStream) ==
FPDF_OBJECT_STREAM,
"CPDF_Object::kStream value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kNullobj) ==
FPDF_OBJECT_NULLOBJ,
"CPDF_Object::kNullobj value mismatch");
static_assert(static_cast<int>(CPDF_Object::Type::kReference) ==
FPDF_OBJECT_REFERENCE,
"CPDF_Object::kReference value mismatch");
bool HasAPStream(CPDF_Dictionary* pAnnotDict) {
return !!GetAnnotAP(pAnnotDict, CPDF_Annot::AppearanceMode::kNormal);
}
void UpdateContentStream(CPDF_Form* pForm, CPDF_Stream* pStream) {
DCHECK(pForm);
DCHECK(pStream);
CPDF_PageContentGenerator generator(pForm);
fxcrt::ostringstream buf;
generator.ProcessPageObjects(&buf);
pStream->SetDataFromStringstreamAndRemoveFilter(&buf);
}
void SetQuadPointsAtIndex(CPDF_Array* array,
size_t quad_index,
const FS_QUADPOINTSF* quad_points) {
DCHECK(array);
DCHECK(quad_points);
DCHECK(IsValidQuadPointsIndex(array, quad_index));
size_t nIndex = quad_index * 8;
array->SetNewAt<CPDF_Number>(nIndex, quad_points->x1);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->y1);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->x2);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->y2);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->x3);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->y3);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->x4);
array->SetNewAt<CPDF_Number>(++nIndex, quad_points->y4);
}
void AppendQuadPoints(CPDF_Array* array, const FS_QUADPOINTSF* quad_points) {
DCHECK(quad_points);
DCHECK(array);
array->AppendNew<CPDF_Number>(quad_points->x1);
array->AppendNew<CPDF_Number>(quad_points->y1);
array->AppendNew<CPDF_Number>(quad_points->x2);
array->AppendNew<CPDF_Number>(quad_points->y2);
array->AppendNew<CPDF_Number>(quad_points->x3);
array->AppendNew<CPDF_Number>(quad_points->y3);
array->AppendNew<CPDF_Number>(quad_points->x4);
array->AppendNew<CPDF_Number>(quad_points->y4);
}
void UpdateBBox(CPDF_Dictionary* annot_dict) {
DCHECK(annot_dict);
// Update BBox entry in appearance stream based on the bounding rectangle
// of the annotation's quadpoints.
CPDF_Stream* pStream =
GetAnnotAP(annot_dict, CPDF_Annot::AppearanceMode::kNormal);
if (pStream) {
CFX_FloatRect boundingRect =
CPDF_Annot::BoundingRectFromQuadPoints(annot_dict);
if (boundingRect.Contains(pStream->GetDict()->GetRectFor("BBox")))
pStream->GetDict()->SetRectFor("BBox", boundingRect);
}
}
CPDF_Dictionary* GetAnnotDictFromFPDFAnnotation(FPDF_ANNOTATION annot) {
CPDF_AnnotContext* context = CPDFAnnotContextFromFPDFAnnotation(annot);
return context ? context->GetAnnotDict() : nullptr;
}
RetainPtr<CPDF_Dictionary> SetExtGStateInResourceDict(
CPDF_Document* pDoc,
const CPDF_Dictionary* pAnnotDict,
const ByteString& sBlendMode) {
auto pGSDict =
pdfium::MakeRetain<CPDF_Dictionary>(pAnnotDict->GetByteStringPool());
// ExtGState represents a graphics state parameter dictionary.
pGSDict->SetNewFor<CPDF_Name>("Type", "ExtGState");
// CA respresents current stroking alpha specifying constant opacity
// value that should be used in transparent imaging model.
float fOpacity = pAnnotDict->GetNumberFor("CA");
pGSDict->SetNewFor<CPDF_Number>("CA", fOpacity);
// ca represents fill color alpha specifying constant opacity
// value that should be used in transparent imaging model.
pGSDict->SetNewFor<CPDF_Number>("ca", fOpacity);
// AIS represents alpha source flag specifying whether current alpha
// constant shall be interpreted as shape value (true) or opacity value
// (false).
pGSDict->SetNewFor<CPDF_Boolean>("AIS", false);
// BM represents Blend Mode
pGSDict->SetNewFor<CPDF_Name>("BM", sBlendMode);
auto pExtGStateDict =
pdfium::MakeRetain<CPDF_Dictionary>(pAnnotDict->GetByteStringPool());
pExtGStateDict->SetFor("GS", pGSDict);
auto pResourceDict = pDoc->New<CPDF_Dictionary>();
pResourceDict->SetFor("ExtGState", pExtGStateDict);
return pResourceDict;
}
CPDF_FormField* GetFormField(FPDF_FORMHANDLE hHandle, FPDF_ANNOTATION annot) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return nullptr;
CPDFSDK_InteractiveForm* pForm = FormHandleToInteractiveForm(hHandle);
if (!pForm)
return nullptr;
CPDF_InteractiveForm* pPDFForm = pForm->GetInteractiveForm();
return pPDFForm->GetFieldByDict(pAnnotDict);
}
const CPDFSDK_Widget* GetRadioButtonOrCheckBoxWidget(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return nullptr;
CPDFSDK_InteractiveForm* pForm = FormHandleToInteractiveForm(hHandle);
if (!pForm)
return nullptr;
CPDF_InteractiveForm* pPDFForm = pForm->GetInteractiveForm();
CPDF_FormField* pFormField = pPDFForm->GetFieldByDict(pAnnotDict);
if (!pFormField || (pFormField->GetType() != CPDF_FormField::kCheckBox &&
pFormField->GetType() != CPDF_FormField::kRadioButton)) {
return nullptr;
}
CPDF_FormControl* pFormControl = pPDFForm->GetControlByDict(pAnnotDict);
return pFormControl ? pForm->GetWidget(pFormControl) : nullptr;
}
const CPDF_Array* GetInkList(FPDF_ANNOTATION annot) {
FPDF_ANNOTATION_SUBTYPE subtype = FPDFAnnot_GetSubtype(annot);
if (subtype != FPDF_ANNOT_INK)
return nullptr;
const CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
return annot_dict ? annot_dict->GetArrayFor(pdfium::annotation::kInkList)
: nullptr;
}
} // namespace
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_IsSupportedSubtype(FPDF_ANNOTATION_SUBTYPE subtype) {
// The supported subtypes must also be communicated in the user doc.
switch (subtype) {
case FPDF_ANNOT_CIRCLE:
case FPDF_ANNOT_FREETEXT:
case FPDF_ANNOT_HIGHLIGHT:
case FPDF_ANNOT_INK:
case FPDF_ANNOT_LINK:
case FPDF_ANNOT_POPUP:
case FPDF_ANNOT_SQUARE:
case FPDF_ANNOT_SQUIGGLY:
case FPDF_ANNOT_STAMP:
case FPDF_ANNOT_STRIKEOUT:
case FPDF_ANNOT_TEXT:
case FPDF_ANNOT_UNDERLINE:
return true;
default:
return false;
}
}
FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV
FPDFPage_CreateAnnot(FPDF_PAGE page, FPDF_ANNOTATION_SUBTYPE subtype) {
CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage || !FPDFAnnot_IsSupportedSubtype(subtype))
return nullptr;
auto pDict = pPage->GetDocument()->New<CPDF_Dictionary>();
pDict->SetNewFor<CPDF_Name>(pdfium::annotation::kType, "Annot");
pDict->SetNewFor<CPDF_Name>(pdfium::annotation::kSubtype,
CPDF_Annot::AnnotSubtypeToString(
static_cast<CPDF_Annot::Subtype>(subtype)));
auto pNewAnnot = std::make_unique<CPDF_AnnotContext>(
pDict.Get(), IPDFPageFromFPDFPage(page));
CPDF_Array* pAnnotList = GetOrCreateArray(pPage->GetDict(), "Annots");
pAnnotList->Append(pDict);
// Caller takes ownership.
return FPDFAnnotationFromCPDFAnnotContext(pNewAnnot.release());
}
FPDF_EXPORT int FPDF_CALLCONV FPDFPage_GetAnnotCount(FPDF_PAGE page) {
const CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage)
return 0;
const CPDF_Array* pAnnots = pPage->GetDict()->GetArrayFor("Annots");
return pAnnots ? fxcrt::CollectionSize<int>(*pAnnots) : 0;
}
FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV FPDFPage_GetAnnot(FPDF_PAGE page,
int index) {
CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage || index < 0)
return nullptr;
CPDF_Array* pAnnots = pPage->GetDict()->GetArrayFor("Annots");
if (!pAnnots || static_cast<size_t>(index) >= pAnnots->size())
return nullptr;
RetainPtr<CPDF_Dictionary> pDict =
ToDictionary(pAnnots->GetMutableDirectObjectAt(index));
if (!pDict)
return nullptr;
auto pNewAnnot = std::make_unique<CPDF_AnnotContext>(
pDict.Get(), IPDFPageFromFPDFPage(page));
// Caller takes ownership.
return FPDFAnnotationFromCPDFAnnotContext(pNewAnnot.release());
}
FPDF_EXPORT int FPDF_CALLCONV FPDFPage_GetAnnotIndex(FPDF_PAGE page,
FPDF_ANNOTATION annot) {
const CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage)
return -1;
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return -1;
const CPDF_Array* pAnnots = pPage->GetDict()->GetArrayFor("Annots");
if (!pAnnots)
return -1;
CPDF_ArrayLocker locker(pAnnots);
auto it = std::find_if(locker.begin(), locker.end(),
[pAnnotDict](const RetainPtr<CPDF_Object>& candidate) {
return candidate->GetDirect() == pAnnotDict;
});
if (it == locker.end())
return -1;
return pdfium::base::checked_cast<int>(it - locker.begin());
}
FPDF_EXPORT void FPDF_CALLCONV FPDFPage_CloseAnnot(FPDF_ANNOTATION annot) {
delete CPDFAnnotContextFromFPDFAnnotation(annot);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFPage_RemoveAnnot(FPDF_PAGE page,
int index) {
CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage || index < 0)
return false;
CPDF_Array* pAnnots = pPage->GetDict()->GetArrayFor("Annots");
if (!pAnnots || static_cast<size_t>(index) >= pAnnots->size())
return false;
pAnnots->RemoveAt(index);
return true;
}
FPDF_EXPORT FPDF_ANNOTATION_SUBTYPE FPDF_CALLCONV
FPDFAnnot_GetSubtype(FPDF_ANNOTATION annot) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return FPDF_ANNOT_UNKNOWN;
return static_cast<FPDF_ANNOTATION_SUBTYPE>(CPDF_Annot::StringToAnnotSubtype(
pAnnotDict->GetNameFor(pdfium::annotation::kSubtype)));
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_IsObjectSupportedSubtype(FPDF_ANNOTATION_SUBTYPE subtype) {
// The supported subtypes must also be communicated in the user doc.
return subtype == FPDF_ANNOT_INK || subtype == FPDF_ANNOT_STAMP;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_UpdateObject(FPDF_ANNOTATION annot, FPDF_PAGEOBJECT obj) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
CPDF_PageObject* pObj = CPDFPageObjectFromFPDFPageObject(obj);
if (!pAnnot || !pAnnot->HasForm() || !pObj)
return false;
// Check that the annotation type is supported by this method.
if (!FPDFAnnot_IsObjectSupportedSubtype(FPDFAnnot_GetSubtype(annot)))
return false;
// Check that the annotation already has an appearance stream, since an
// existing object is to be updated.
CPDF_Stream* pStream =
GetAnnotAP(pAnnot->GetAnnotDict(), CPDF_Annot::AppearanceMode::kNormal);
if (!pStream)
return false;
// Check that the object is already in this annotation's object list.
CPDF_Form* pForm = pAnnot->GetForm();
auto it =
std::find_if(pForm->begin(), pForm->end(),
[pObj](const std::unique_ptr<CPDF_PageObject>& candidate) {
return candidate.get() == pObj;
});
if (it == pForm->end())
return false;
// Update the content stream data in the annotation's AP stream.
UpdateContentStream(pForm, pStream);
return true;
}
FPDF_EXPORT int FPDF_CALLCONV FPDFAnnot_AddInkStroke(FPDF_ANNOTATION annot,
const FS_POINTF* points,
size_t point_count) {
if (FPDFAnnot_GetSubtype(annot) != FPDF_ANNOT_INK || !points ||
point_count == 0 ||
!pdfium::base::IsValueInRangeForNumericType<int32_t>(point_count)) {
return -1;
}
CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
CPDF_Array* inklist = GetOrCreateArray(annot_dict, "InkList");
FX_SAFE_SIZE_T safe_ink_size = inklist->size();
safe_ink_size += 1;
if (!safe_ink_size.IsValid<int32_t>())
return -1;
CPDF_Array* ink_coord_list = inklist->AppendNew<CPDF_Array>();
for (size_t i = 0; i < point_count; i++) {
ink_coord_list->AppendNew<CPDF_Number>(points[i].x);
ink_coord_list->AppendNew<CPDF_Number>(points[i].y);
}
return static_cast<int>(inklist->size() - 1);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_RemoveInkList(FPDF_ANNOTATION annot) {
if (FPDFAnnot_GetSubtype(annot) != FPDF_ANNOT_INK)
return false;
CPDF_Dictionary* annot_dict =
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict();
annot_dict->RemoveFor("InkList");
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_AppendObject(FPDF_ANNOTATION annot, FPDF_PAGEOBJECT obj) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
CPDF_PageObject* pObj = CPDFPageObjectFromFPDFPageObject(obj);
if (!pAnnot || !pObj)
return false;
// Check that the annotation type is supported by this method.
if (!FPDFAnnot_IsObjectSupportedSubtype(FPDFAnnot_GetSubtype(annot)))
return false;
// If the annotation does not have an AP stream yet, generate and set it.
CPDF_Dictionary* pAnnotDict = pAnnot->GetAnnotDict();
CPDF_Stream* pStream =
GetAnnotAP(pAnnotDict, CPDF_Annot::AppearanceMode::kNormal);
if (!pStream) {
CPDF_GenerateAP::GenerateEmptyAP(pAnnot->GetPage()->GetDocument(),
pAnnotDict);
pStream = GetAnnotAP(pAnnotDict, CPDF_Annot::AppearanceMode::kNormal);
if (!pStream)
return false;
}
// Get the annotation's corresponding form object for parsing its AP stream.
if (!pAnnot->HasForm())
pAnnot->SetForm(pStream);
// Check that the object did not come from the same annotation. If this check
// succeeds, then it is assumed that the object came from
// FPDFPageObj_CreateNew{Path|Rect}() or FPDFPageObj_New{Text|Image}Obj().
// Note that an object that came from a different annotation must not be
// passed here, since an object cannot belong to more than one annotation.
CPDF_Form* pForm = pAnnot->GetForm();
auto it =
std::find_if(pForm->begin(), pForm->end(),
[pObj](const std::unique_ptr<CPDF_PageObject>& candidate) {
return candidate.get() == pObj;
});
if (it != pForm->end())
return false;
// Append the object to the object list.
pForm->AppendPageObject(pdfium::WrapUnique(pObj));
// Set the content stream data in the annotation's AP stream.
UpdateContentStream(pForm, pStream);
return true;
}
FPDF_EXPORT int FPDF_CALLCONV FPDFAnnot_GetObjectCount(FPDF_ANNOTATION annot) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
if (!pAnnot)
return 0;
if (!pAnnot->HasForm()) {
CPDF_Stream* pStream =
GetAnnotAP(pAnnot->GetAnnotDict(), CPDF_Annot::AppearanceMode::kNormal);
if (!pStream)
return 0;
pAnnot->SetForm(pStream);
}
return pdfium::base::checked_cast<int>(
pAnnot->GetForm()->GetPageObjectCount());
}
FPDF_EXPORT FPDF_PAGEOBJECT FPDF_CALLCONV
FPDFAnnot_GetObject(FPDF_ANNOTATION annot, int index) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
if (!pAnnot || index < 0)
return nullptr;
if (!pAnnot->HasForm()) {
CPDF_Stream* pStream =
GetAnnotAP(pAnnot->GetAnnotDict(), CPDF_Annot::AppearanceMode::kNormal);
if (!pStream)
return nullptr;
pAnnot->SetForm(pStream);
}
return FPDFPageObjectFromCPDFPageObject(
pAnnot->GetForm()->GetPageObjectByIndex(index));
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_RemoveObject(FPDF_ANNOTATION annot, int index) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
if (!pAnnot || !pAnnot->HasForm() || index < 0)
return false;
// Check that the annotation type is supported by this method.
if (!FPDFAnnot_IsObjectSupportedSubtype(FPDFAnnot_GetSubtype(annot)))
return false;
// Check that the annotation already has an appearance stream, since an
// existing object is to be deleted.
CPDF_Stream* pStream =
GetAnnotAP(pAnnot->GetAnnotDict(), CPDF_Annot::AppearanceMode::kNormal);
if (!pStream)
return false;
if (!pAnnot->GetForm()->ErasePageObjectAtIndex(index))
return false;
UpdateContentStream(pAnnot->GetForm(), pStream);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_SetColor(FPDF_ANNOTATION annot,
FPDFANNOT_COLORTYPE type,
unsigned int R,
unsigned int G,
unsigned int B,
unsigned int A) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict || R > 255 || G > 255 || B > 255 || A > 255)
return false;
// For annotations with their appearance streams already defined, the path
// stream's own color definitions take priority over the annotation color
// definitions set by this method, hence this method will simply fail.
if (HasAPStream(pAnnotDict))
return false;
// Set the opacity of the annotation.
pAnnotDict->SetNewFor<CPDF_Number>("CA", A / 255.f);
// Set the color of the annotation.
ByteString key = type == FPDFANNOT_COLORTYPE_InteriorColor ? "IC" : "C";
CPDF_Array* pColor = pAnnotDict->GetArrayFor(key);
if (pColor)
pColor->Clear();
else
pColor = pAnnotDict->SetNewFor<CPDF_Array>(key);
pColor->AppendNew<CPDF_Number>(R / 255.f);
pColor->AppendNew<CPDF_Number>(G / 255.f);
pColor->AppendNew<CPDF_Number>(B / 255.f);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_GetColor(FPDF_ANNOTATION annot,
FPDFANNOT_COLORTYPE type,
unsigned int* R,
unsigned int* G,
unsigned int* B,
unsigned int* A) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict || !R || !G || !B || !A)
return false;
// For annotations with their appearance streams already defined, the path
// stream's own color definitions take priority over the annotation color
// definitions retrieved by this method, hence this method will simply fail.
if (HasAPStream(pAnnotDict))
return false;
const CPDF_Array* pColor = pAnnotDict->GetArrayFor(
type == FPDFANNOT_COLORTYPE_InteriorColor ? "IC" : "C");
*A =
(pAnnotDict->KeyExist("CA") ? pAnnotDict->GetNumberFor("CA") : 1) * 255.f;
if (!pColor) {
// Use default color. The default colors must be consistent with the ones
// used to generate AP. See calls to GetColorStringWithDefault() in
// CPDF_GenerateAP::Generate*AP().
if (pAnnotDict->GetNameFor(pdfium::annotation::kSubtype) == "Highlight") {
*R = 255;
*G = 255;
*B = 0;
} else {
*R = 0;
*G = 0;
*B = 0;
}
return true;
}
CFX_Color color = fpdfdoc::CFXColorFromArray(*pColor);
switch (color.nColorType) {
case CFX_Color::Type::kRGB:
*R = color.fColor1 * 255.f;
*G = color.fColor2 * 255.f;
*B = color.fColor3 * 255.f;
break;
case CFX_Color::Type::kGray:
*R = 255.f * color.fColor1;
*G = 255.f * color.fColor1;
*B = 255.f * color.fColor1;
break;
case CFX_Color::Type::kCMYK:
*R = 255.f * (1 - color.fColor1) * (1 - color.fColor4);
*G = 255.f * (1 - color.fColor2) * (1 - color.fColor4);
*B = 255.f * (1 - color.fColor3) * (1 - color.fColor4);
break;
case CFX_Color::Type::kTransparent:
*R = 0;
*G = 0;
*B = 0;
break;
}
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_HasAttachmentPoints(FPDF_ANNOTATION annot) {
if (!annot)
return false;
FPDF_ANNOTATION_SUBTYPE subtype = FPDFAnnot_GetSubtype(annot);
return subtype == FPDF_ANNOT_LINK || subtype == FPDF_ANNOT_HIGHLIGHT ||
subtype == FPDF_ANNOT_UNDERLINE || subtype == FPDF_ANNOT_SQUIGGLY ||
subtype == FPDF_ANNOT_STRIKEOUT;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_SetAttachmentPoints(FPDF_ANNOTATION annot,
size_t quad_index,
const FS_QUADPOINTSF* quad_points) {
if (!FPDFAnnot_HasAttachmentPoints(annot) || !quad_points)
return false;
CPDF_Dictionary* pAnnotDict =
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict();
CPDF_Array* pQuadPointsArray = GetQuadPointsArrayFromDictionary(pAnnotDict);
if (!IsValidQuadPointsIndex(pQuadPointsArray, quad_index))
return false;
SetQuadPointsAtIndex(pQuadPointsArray, quad_index, quad_points);
UpdateBBox(pAnnotDict);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_AppendAttachmentPoints(FPDF_ANNOTATION annot,
const FS_QUADPOINTSF* quad_points) {
if (!FPDFAnnot_HasAttachmentPoints(annot) || !quad_points)
return false;
CPDF_Dictionary* pAnnotDict =
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict();
CPDF_Array* pQuadPointsArray = GetQuadPointsArrayFromDictionary(pAnnotDict);
if (!pQuadPointsArray)
pQuadPointsArray = AddQuadPointsArrayToDictionary(pAnnotDict);
AppendQuadPoints(pQuadPointsArray, quad_points);
UpdateBBox(pAnnotDict);
return true;
}
FPDF_EXPORT size_t FPDF_CALLCONV
FPDFAnnot_CountAttachmentPoints(FPDF_ANNOTATION annot) {
if (!FPDFAnnot_HasAttachmentPoints(annot))
return 0;
const CPDF_Dictionary* pAnnotDict =
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict();
const CPDF_Array* pArray = GetQuadPointsArrayFromDictionary(pAnnotDict);
return pArray ? pArray->size() / 8 : 0;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_GetAttachmentPoints(FPDF_ANNOTATION annot,
size_t quad_index,
FS_QUADPOINTSF* quad_points) {
if (!FPDFAnnot_HasAttachmentPoints(annot) || !quad_points)
return false;
const CPDF_Dictionary* pAnnotDict =
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict();
const CPDF_Array* pArray = GetQuadPointsArrayFromDictionary(pAnnotDict);
if (!pArray)
return false;
return GetQuadPointsAtIndex(pArray, quad_index, quad_points);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_SetRect(FPDF_ANNOTATION annot,
const FS_RECTF* rect) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict || !rect)
return false;
CFX_FloatRect newRect = CFXFloatRectFromFSRectF(*rect);
// Update the "Rect" entry in the annotation dictionary.
pAnnotDict->SetRectFor(pdfium::annotation::kRect, newRect);
// If the annotation's appearance stream is defined, the annotation is of a
// type that does not have quadpoints, and the new rectangle is bigger than
// the current bounding box, then update the "BBox" entry in the AP
// dictionary too, since its "BBox" entry comes from annotation dictionary's
// "Rect" entry.
if (FPDFAnnot_HasAttachmentPoints(annot))
return true;
CPDF_Stream* pStream =
GetAnnotAP(pAnnotDict, CPDF_Annot::AppearanceMode::kNormal);
if (pStream && newRect.Contains(pStream->GetDict()->GetRectFor("BBox")))
pStream->GetDict()->SetRectFor("BBox", newRect);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_GetRect(FPDF_ANNOTATION annot,
FS_RECTF* rect) {
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict || !rect)
return false;
*rect = FSRectFFromCFXFloatRect(
pAnnotDict->GetRectFor(pdfium::annotation::kRect));
return true;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetVertices(FPDF_ANNOTATION annot,
FS_POINTF* buffer,
unsigned long length) {
FPDF_ANNOTATION_SUBTYPE subtype = FPDFAnnot_GetSubtype(annot);
if (subtype != FPDF_ANNOT_POLYGON && subtype != FPDF_ANNOT_POLYLINE)
return 0;
const CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
if (!annot_dict)
return 0;
const CPDF_Array* vertices =
annot_dict->GetArrayFor(pdfium::annotation::kVertices);
if (!vertices)
return 0;
// Truncate to an even number.
const unsigned long points_len =
fxcrt::CollectionSize<unsigned long>(*vertices) / 2;
if (buffer && length >= points_len) {
for (unsigned long i = 0; i < points_len; ++i) {
buffer[i].x = vertices->GetNumberAt(i * 2);
buffer[i].y = vertices->GetNumberAt(i * 2 + 1);
}
}
return points_len;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetInkListCount(FPDF_ANNOTATION annot) {
const CPDF_Array* ink_list = GetInkList(annot);
return ink_list ? fxcrt::CollectionSize<unsigned long>(*ink_list) : 0;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetInkListPath(FPDF_ANNOTATION annot,
unsigned long path_index,
FS_POINTF* buffer,
unsigned long length) {
const CPDF_Array* ink_list = GetInkList(annot);
if (!ink_list)
return 0;
const CPDF_Array* path = ink_list->GetArrayAt(path_index);
if (!path)
return 0;
// Truncate to an even number.
const unsigned long points_len =
fxcrt::CollectionSize<unsigned long>(*path) / 2;
if (buffer && length >= points_len) {
for (unsigned long i = 0; i < points_len; ++i) {
buffer[i].x = path->GetNumberAt(i * 2);
buffer[i].y = path->GetNumberAt(i * 2 + 1);
}
}
return points_len;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_GetLine(FPDF_ANNOTATION annot,
FS_POINTF* start,
FS_POINTF* end) {
if (!start || !end)
return false;
FPDF_ANNOTATION_SUBTYPE subtype = FPDFAnnot_GetSubtype(annot);
if (subtype != FPDF_ANNOT_LINE)
return false;
const CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
if (!annot_dict)
return false;
const CPDF_Array* line = annot_dict->GetArrayFor(pdfium::annotation::kL);
if (!line || line->size() < 4)
return false;
start->x = line->GetNumberAt(0);
start->y = line->GetNumberAt(1);
end->x = line->GetNumberAt(2);
end->y = line->GetNumberAt(3);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_SetBorder(FPDF_ANNOTATION annot,
float horizontal_radius,
float vertical_radius,
float border_width) {
CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
if (!annot_dict)
return false;
// Remove the appearance stream. Otherwise PDF viewers will render that and
// not use the border values.
annot_dict->RemoveFor(pdfium::annotation::kAP);
CPDF_Array* border =
annot_dict->SetNewFor<CPDF_Array>(pdfium::annotation::kBorder);
border->AppendNew<CPDF_Number>(horizontal_radius);
border->AppendNew<CPDF_Number>(vertical_radius);
border->AppendNew<CPDF_Number>(border_width);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_GetBorder(FPDF_ANNOTATION annot,
float* horizontal_radius,
float* vertical_radius,
float* border_width) {
if (!horizontal_radius || !vertical_radius || !border_width)
return false;
const CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
if (!annot_dict)
return false;
const CPDF_Array* border =
annot_dict->GetArrayFor(pdfium::annotation::kBorder);
if (!border || border->size() < 3)
return false;
*horizontal_radius = border->GetNumberAt(0);
*vertical_radius = border->GetNumberAt(1);
*border_width = border->GetNumberAt(2);
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_HasKey(FPDF_ANNOTATION annot,
FPDF_BYTESTRING key) {
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
return pAnnotDict && pAnnotDict->KeyExist(key);
}
FPDF_EXPORT FPDF_OBJECT_TYPE FPDF_CALLCONV
FPDFAnnot_GetValueType(FPDF_ANNOTATION annot, FPDF_BYTESTRING key) {
if (!FPDFAnnot_HasKey(annot, key))
return FPDF_OBJECT_UNKNOWN;
const CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
const CPDF_Object* pObj = pAnnot->GetAnnotDict()->GetObjectFor(key);
return pObj ? pObj->GetType() : FPDF_OBJECT_UNKNOWN;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_SetStringValue(FPDF_ANNOTATION annot,
FPDF_BYTESTRING key,
FPDF_WIDESTRING value) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return false;
pAnnotDict->SetNewFor<CPDF_String>(
key, WideStringFromFPDFWideString(value).AsStringView());
return true;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetStringValue(FPDF_ANNOTATION annot,
FPDF_BYTESTRING key,
FPDF_WCHAR* buffer,
unsigned long buflen) {
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return 0;
return Utf16EncodeMaybeCopyAndReturnLength(pAnnotDict->GetUnicodeTextFor(key),
buffer, buflen);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_GetNumberValue(FPDF_ANNOTATION annot,
FPDF_BYTESTRING key,
float* value) {
if (!value)
return false;
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return false;
const CPDF_Object* p = pAnnotDict->GetObjectFor(key);
if (!p || p->GetType() != FPDF_OBJECT_NUMBER)
return false;
*value = p->GetNumber();
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_SetAP(FPDF_ANNOTATION annot,
FPDF_ANNOT_APPEARANCEMODE appearanceMode,
FPDF_WIDESTRING value) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return false;
if (appearanceMode < 0 || appearanceMode >= FPDF_ANNOT_APPEARANCEMODE_COUNT)
return false;
static constexpr const char* kModeKeyForMode[] = {"N", "R", "D"};
static_assert(std::size(kModeKeyForMode) == FPDF_ANNOT_APPEARANCEMODE_COUNT,
"length of kModeKeyForMode should be equal to "
"FPDF_ANNOT_APPEARANCEMODE_COUNT");
const char* modeKey = kModeKeyForMode[appearanceMode];
CPDF_Dictionary* pApDict = pAnnotDict->GetDictFor(pdfium::annotation::kAP);
// If value is null, we're in remove mode. Otherwise, we're in add/update
// mode.
if (value) {
// Annotation object's non-empty bounding rect will be used as the /BBox
// for the associated /XObject object
CFX_FloatRect rect = pAnnotDict->GetRectFor(pdfium::annotation::kRect);
constexpr float kMinSize = 0.000001f;
if (rect.Width() < kMinSize || rect.Height() < kMinSize)
return false;
CPDF_AnnotContext* pAnnotContext =
CPDFAnnotContextFromFPDFAnnotation(annot);
CPDF_Document* pDoc = pAnnotContext->GetPage()->GetDocument();
if (!pDoc)
return false;
CPDF_Stream* pNewIndirectStream = pDoc->NewIndirect<CPDF_Stream>();
ByteString newAPStream =
PDF_EncodeText(WideStringFromFPDFWideString(value).AsStringView());
pNewIndirectStream->SetData(newAPStream.raw_span());
CPDF_Dictionary* pStreamDict = pNewIndirectStream->GetDict();
pStreamDict->SetNewFor<CPDF_Name>(pdfium::annotation::kType, "XObject");
pStreamDict->SetNewFor<CPDF_Name>(pdfium::annotation::kSubtype, "Form");
pStreamDict->SetRectFor("BBox", rect);
// Transparency values are specified in range [0.0f, 1.0f]. We are strictly
// checking for value < 1 and not <= 1 so that the output PDF size does not
// unnecessarily bloat up by creating a new dictionary in case of solid
// color.
if (pAnnotDict->KeyExist("CA") && pAnnotDict->GetNumberFor("CA") < 1.0f) {
RetainPtr<CPDF_Dictionary> pResourceDict =
SetExtGStateInResourceDict(pDoc, pAnnotDict, "Normal");
pStreamDict->SetFor("Resources", pResourceDict);
}
// Storing reference to indirect object in annotation's AP
if (!pApDict)
pApDict = pAnnotDict->SetNewFor<CPDF_Dictionary>(pdfium::annotation::kAP);
pApDict->SetNewFor<CPDF_Reference>(modeKey, pDoc,
pNewIndirectStream->GetObjNum());
} else {
if (pApDict) {
if (appearanceMode == FPDF_ANNOT_APPEARANCEMODE_NORMAL)
pAnnotDict->RemoveFor(pdfium::annotation::kAP);
else
pApDict->RemoveFor(modeKey);
}
}
return true;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetAP(FPDF_ANNOTATION annot,
FPDF_ANNOT_APPEARANCEMODE appearanceMode,
FPDF_WCHAR* buffer,
unsigned long buflen) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return 0;
if (appearanceMode < 0 || appearanceMode >= FPDF_ANNOT_APPEARANCEMODE_COUNT)
return 0;
CPDF_Annot::AppearanceMode mode =
static_cast<CPDF_Annot::AppearanceMode>(appearanceMode);
CPDF_Stream* pStream = GetAnnotAPNoFallback(pAnnotDict, mode);
return Utf16EncodeMaybeCopyAndReturnLength(
pStream ? pStream->GetUnicodeText() : WideString(), buffer, buflen);
}
FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV
FPDFAnnot_GetLinkedAnnot(FPDF_ANNOTATION annot, FPDF_BYTESTRING key) {
CPDF_AnnotContext* pAnnot = CPDFAnnotContextFromFPDFAnnotation(annot);
if (!pAnnot)
return nullptr;
CPDF_Dictionary* pLinkedDict = pAnnot->GetAnnotDict()->GetDictFor(key);
if (!pLinkedDict || pLinkedDict->GetNameFor("Type") != "Annot")
return nullptr;
auto pLinkedAnnot =
std::make_unique<CPDF_AnnotContext>(pLinkedDict, pAnnot->GetPage());
// Caller takes ownership.
return FPDFAnnotationFromCPDFAnnotContext(pLinkedAnnot.release());
}
FPDF_EXPORT int FPDF_CALLCONV FPDFAnnot_GetFlags(FPDF_ANNOTATION annot) {
const CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
return pAnnotDict ? pAnnotDict->GetIntegerFor(pdfium::annotation::kF)
: FPDF_ANNOT_FLAG_NONE;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_SetFlags(FPDF_ANNOTATION annot,
int flags) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return false;
pAnnotDict->SetNewFor<CPDF_Number>(pdfium::annotation::kF, flags);
return true;
}
FPDF_EXPORT int FPDF_CALLCONV
FPDFAnnot_GetFormFieldFlags(FPDF_FORMHANDLE hHandle, FPDF_ANNOTATION annot) {
CPDF_FormField* pFormField = GetFormField(hHandle, annot);
return pFormField ? pFormField->GetFieldFlags() : FPDF_FORMFLAG_NONE;
}
FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV
FPDFAnnot_GetFormFieldAtPoint(FPDF_FORMHANDLE hHandle,
FPDF_PAGE page,
const FS_POINTF* point) {
if (!point)
return nullptr;
const CPDFSDK_InteractiveForm* pForm = FormHandleToInteractiveForm(hHandle);
if (!pForm)
return nullptr;
const CPDF_Page* pPage = CPDFPageFromFPDFPage(page);
if (!pPage)
return nullptr;
const CPDF_InteractiveForm* pPDFForm = pForm->GetInteractiveForm();
int annot_index = -1;
const CPDF_FormControl* pFormCtrl = pPDFForm->GetControlAtPoint(
pPage, CFXPointFFromFSPointF(*point), &annot_index);
if (!pFormCtrl || annot_index == -1)
return nullptr;
return FPDFPage_GetAnnot(page, annot_index);
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetFormFieldName(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot,
FPDF_WCHAR* buffer,
unsigned long buflen) {
const CPDF_FormField* pFormField = GetFormField(hHandle, annot);
if (!pFormField)
return 0;
return Utf16EncodeMaybeCopyAndReturnLength(pFormField->GetFullName(), buffer,
buflen);
}
FPDF_EXPORT int FPDF_CALLCONV
FPDFAnnot_GetFormFieldType(FPDF_FORMHANDLE hHandle, FPDF_ANNOTATION annot) {
const CPDF_FormField* pFormField = GetFormField(hHandle, annot);
return pFormField ? static_cast<int>(pFormField->GetFieldType()) : -1;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetFormFieldValue(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot,
FPDF_WCHAR* buffer,
unsigned long buflen) {
const CPDF_FormField* pFormField = GetFormField(hHandle, annot);
if (!pFormField)
return 0;
return Utf16EncodeMaybeCopyAndReturnLength(pFormField->GetValue(), buffer,
buflen);
}
FPDF_EXPORT int FPDF_CALLCONV FPDFAnnot_GetOptionCount(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot) {
const CPDF_FormField* pFormField = GetFormField(hHandle, annot);
return pFormField ? pFormField->CountOptions() : -1;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetOptionLabel(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot,
int index,
FPDF_WCHAR* buffer,
unsigned long buflen) {
if (index < 0)
return 0;
const CPDF_FormField* pFormField = GetFormField(hHandle, annot);
if (!pFormField || index >= pFormField->CountOptions())
return 0;
WideString ws = pFormField->GetOptionLabel(index);
return Utf16EncodeMaybeCopyAndReturnLength(ws, buffer, buflen);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_IsOptionSelected(FPDF_FORMHANDLE handle,
FPDF_ANNOTATION annot,
int index) {
if (index < 0)
return false;
const CPDF_FormField* form_field = GetFormField(handle, annot);
if (!form_field || index >= form_field->CountOptions())
return false;
if (form_field->GetFieldType() != FormFieldType::kComboBox &&
form_field->GetFieldType() != FormFieldType::kListBox) {
return false;
}
return form_field->IsItemSelected(index);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_GetFontSize(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot,
float* value) {
if (!value)
return false;
CPDFSDK_InteractiveForm* pForm = FormHandleToInteractiveForm(hHandle);
if (!pForm)
return false;
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return false;
CPDF_InteractiveForm* pPDFForm = pForm->GetInteractiveForm();
CPDF_FormControl* pFormControl = pPDFForm->GetControlByDict(pAnnotDict);
if (!pFormControl)
return false;
CPDFSDK_Widget* pWidget = pForm->GetWidget(pFormControl);
if (!pWidget)
return false;
*value = pWidget->GetFontSize();
return true;
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_IsChecked(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot) {
const CPDFSDK_Widget* pWidget =
GetRadioButtonOrCheckBoxWidget(hHandle, annot);
return pWidget && pWidget->IsChecked();
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_SetFocusableSubtypes(FPDF_FORMHANDLE hHandle,
const FPDF_ANNOTATION_SUBTYPE* subtypes,
size_t count) {
CPDFSDK_FormFillEnvironment* pFormFillEnv =
CPDFSDKFormFillEnvironmentFromFPDFFormHandle(hHandle);
if (!pFormFillEnv)
return false;
if (count > 0 && !subtypes)
return false;
std::vector<CPDF_Annot::Subtype> focusable_annot_types;
focusable_annot_types.reserve(count);
for (size_t i = 0; i < count; ++i) {
focusable_annot_types.push_back(
static_cast<CPDF_Annot::Subtype>(subtypes[i]));
}
pFormFillEnv->SetFocusableAnnotSubtypes(focusable_annot_types);
return true;
}
FPDF_EXPORT int FPDF_CALLCONV
FPDFAnnot_GetFocusableSubtypesCount(FPDF_FORMHANDLE hHandle) {
CPDFSDK_FormFillEnvironment* pFormFillEnv =
CPDFSDKFormFillEnvironmentFromFPDFFormHandle(hHandle);
if (!pFormFillEnv)
return -1;
return fxcrt::CollectionSize<int>(pFormFillEnv->GetFocusableAnnotSubtypes());
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
FPDFAnnot_GetFocusableSubtypes(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION_SUBTYPE* subtypes,
size_t count) {
CPDFSDK_FormFillEnvironment* pFormFillEnv =
CPDFSDKFormFillEnvironmentFromFPDFFormHandle(hHandle);
if (!pFormFillEnv)
return false;
if (!subtypes)
return false;
const std::vector<CPDF_Annot::Subtype>& focusable_annot_types =
pFormFillEnv->GetFocusableAnnotSubtypes();
// Host should allocate enough memory to get the list of currently supported
// focusable subtypes.
if (count < focusable_annot_types.size())
return false;
for (size_t i = 0; i < focusable_annot_types.size(); ++i) {
subtypes[i] =
static_cast<FPDF_ANNOTATION_SUBTYPE>(focusable_annot_types[i]);
}
return true;
}
FPDF_EXPORT FPDF_LINK FPDF_CALLCONV FPDFAnnot_GetLink(FPDF_ANNOTATION annot) {
if (FPDFAnnot_GetSubtype(annot) != FPDF_ANNOT_LINK)
return nullptr;
return FPDFLinkFromCPDFDictionary(
CPDFAnnotContextFromFPDFAnnotation(annot)->GetAnnotDict());
}
FPDF_EXPORT int FPDF_CALLCONV
FPDFAnnot_GetFormControlCount(FPDF_FORMHANDLE hHandle, FPDF_ANNOTATION annot) {
CPDF_FormField* pFormField = GetFormField(hHandle, annot);
return pFormField ? pFormField->CountControls() : -1;
}
FPDF_EXPORT int FPDF_CALLCONV
FPDFAnnot_GetFormControlIndex(FPDF_FORMHANDLE hHandle, FPDF_ANNOTATION annot) {
CPDF_Dictionary* pAnnotDict = GetAnnotDictFromFPDFAnnotation(annot);
if (!pAnnotDict)
return -1;
CPDFSDK_InteractiveForm* pForm = FormHandleToInteractiveForm(hHandle);
if (!pForm)
return -1;
CPDF_InteractiveForm* pPDFForm = pForm->GetInteractiveForm();
CPDF_FormField* pFormField = pPDFForm->GetFieldByDict(pAnnotDict);
CPDF_FormControl* pFormControl = pPDFForm->GetControlByDict(pAnnotDict);
return pFormField ? pFormField->GetControlIndex(pFormControl) : -1;
}
FPDF_EXPORT unsigned long FPDF_CALLCONV
FPDFAnnot_GetFormFieldExportValue(FPDF_FORMHANDLE hHandle,
FPDF_ANNOTATION annot,
FPDF_WCHAR* buffer,
unsigned long buflen) {
const CPDFSDK_Widget* pWidget =
GetRadioButtonOrCheckBoxWidget(hHandle, annot);
if (!pWidget)
return 0;
return Utf16EncodeMaybeCopyAndReturnLength(pWidget->GetExportValue(), buffer,
buflen);
}
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_SetURI(FPDF_ANNOTATION annot,
const char* uri) {
if (!uri || FPDFAnnot_GetSubtype(annot) != FPDF_ANNOT_LINK)
return false;
CPDF_Dictionary* annot_dict = GetAnnotDictFromFPDFAnnotation(annot);
CPDF_Dictionary* action = annot_dict->SetNewFor<CPDF_Dictionary>("A");
action->SetNewFor<CPDF_Name>("Type", "Action");
action->SetNewFor<CPDF_Name>("S", "URI");
action->SetNewFor<CPDF_String>("URI", uri, /*bHex=*/false);
return true;
}