/* Copyright 2012 Mozilla Foundation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import { AnnotationActionEventType, AnnotationBorderStyleType, AnnotationFieldFlag, AnnotationFlag, AnnotationReplyType, AnnotationType, assert, escapeString, getModificationDate, isArrayEqual, isAscii, isString, OPS, shadow, stringToPDFString, stringToUTF16BEString, unreachable, Util, warn, } from "../shared/util.js"; import { Catalog, FileSpec, ObjectLoader } from "./obj.js"; import { collectActions, getInheritableProperty } from "./core_utils.js"; import { createDefaultAppearance, parseDefaultAppearance, } from "./default_appearance.js"; import { Dict, isDict, isName, isRef, isStream, Name, RefSet, } from "./primitives.js"; import { ColorSpace } from "./colorspace.js"; import { OperatorList } from "./operator_list.js"; import { StringStream } from "./stream.js"; import { writeDict } from "./writer.js"; class AnnotationFactory { /** * Create an `Annotation` object of the correct type for the given reference * to an annotation dictionary. This yields a promise that is resolved when * the `Annotation` object is constructed. * * @param {XRef} xref * @param {Object} ref * @param {PDFManager} pdfManager * @param {Object} idFactory * @param {boolean} collectFields * @returns {Promise} A promise that is resolved with an {Annotation} * instance. */ static create(xref, ref, pdfManager, idFactory, collectFields) { return pdfManager.ensureCatalog("acroForm").then(acroForm => { return pdfManager.ensure(this, "_create", [ xref, ref, pdfManager, idFactory, acroForm, collectFields, ]); }); } /** * @private */ static _create(xref, ref, pdfManager, idFactory, acroForm, collectFields) { const dict = xref.fetchIfRef(ref); if (!isDict(dict)) { return undefined; } const id = isRef(ref) ? ref.toString() : `annot_${idFactory.createObjId()}`; // Determine the annotation's subtype. let subtype = dict.get("Subtype"); subtype = isName(subtype) ? subtype.name : null; // Return the right annotation object based on the subtype and field type. const parameters = { xref, ref, dict, subtype, id, pdfManager, acroForm: acroForm instanceof Dict ? acroForm : Dict.empty, collectFields, }; switch (subtype) { case "Link": return new LinkAnnotation(parameters); case "Text": return new TextAnnotation(parameters); case "Widget": let fieldType = getInheritableProperty({ dict, key: "FT" }); fieldType = isName(fieldType) ? fieldType.name : null; switch (fieldType) { case "Tx": return new TextWidgetAnnotation(parameters); case "Btn": return new ButtonWidgetAnnotation(parameters); case "Ch": return new ChoiceWidgetAnnotation(parameters); case "Sig": return new SignatureWidgetAnnotation(parameters); } warn( `Unimplemented widget field type "${fieldType}", ` + "falling back to base field type." ); return new WidgetAnnotation(parameters); case "Popup": return new PopupAnnotation(parameters); case "FreeText": return new FreeTextAnnotation(parameters); case "Line": return new LineAnnotation(parameters); case "Square": return new SquareAnnotation(parameters); case "Circle": return new CircleAnnotation(parameters); case "PolyLine": return new PolylineAnnotation(parameters); case "Polygon": return new PolygonAnnotation(parameters); case "Caret": return new CaretAnnotation(parameters); case "Ink": return new InkAnnotation(parameters); case "Highlight": return new HighlightAnnotation(parameters); case "Underline": return new UnderlineAnnotation(parameters); case "Squiggly": return new SquigglyAnnotation(parameters); case "StrikeOut": return new StrikeOutAnnotation(parameters); case "Stamp": return new StampAnnotation(parameters); case "FileAttachment": return new FileAttachmentAnnotation(parameters); default: if (!collectFields) { if (!subtype) { warn("Annotation is missing the required /Subtype."); } else { warn( `Unimplemented annotation type "${subtype}", ` + "falling back to base annotation." ); } } return new Annotation(parameters); } } } function getRgbColor(color) { const rgbColor = new Uint8ClampedArray(3); if (!Array.isArray(color)) { return rgbColor; } switch (color.length) { case 0: // Transparent, which we indicate with a null value return null; case 1: // Convert grayscale to RGB ColorSpace.singletons.gray.getRgbItem(color, 0, rgbColor, 0); return rgbColor; case 3: // Convert RGB percentages to RGB ColorSpace.singletons.rgb.getRgbItem(color, 0, rgbColor, 0); return rgbColor; case 4: // Convert CMYK to RGB ColorSpace.singletons.cmyk.getRgbItem(color, 0, rgbColor, 0); return rgbColor; default: return rgbColor; } } function getQuadPoints(dict, rect) { if (!dict.has("QuadPoints")) { return null; } // The region is described as a number of quadrilaterals. // Each quadrilateral must consist of eight coordinates. const quadPoints = dict.getArray("QuadPoints"); if ( !Array.isArray(quadPoints) || quadPoints.length === 0 || quadPoints.length % 8 > 0 ) { return null; } const quadPointsLists = []; for (let i = 0, ii = quadPoints.length / 8; i < ii; i++) { // Each series of eight numbers represents the coordinates for one // quadrilateral in the order [x1, y1, x2, y2, x3, y3, x4, y4]. // Convert this to an array of objects with x and y coordinates. quadPointsLists.push([]); for (let j = i * 8, jj = i * 8 + 8; j < jj; j += 2) { const x = quadPoints[j]; const y = quadPoints[j + 1]; // The quadpoints should be ignored if any coordinate in the array // lies outside the region specified by the rectangle. The rectangle // can be `null` for markup annotations since their rectangle may be // incorrect (fixes bug 1538111). if ( rect !== null && (x < rect[0] || x > rect[2] || y < rect[1] || y > rect[3]) ) { return null; } quadPointsLists[i].push({ x, y }); } } // The PDF specification states in section 12.5.6.10 (figure 64) that the // order of the quadpoints should be bottom left, bottom right, top right // and top left. However, in practice PDF files use a different order, // namely bottom left, bottom right, top left and top right (this is also // mentioned on https://github.com/highkite/pdfAnnotate#QuadPoints), so // this is the actual order we should work with. However, the situation is // even worse since Adobe's own applications and other applications violate // the specification and create annotations with other orders, namely top // left, top right, bottom left and bottom right or even top left, top right, // bottom right and bottom left. To avoid inconsistency and broken rendering, // we normalize all lists to put the quadpoints in the same standard order // (see https://stackoverflow.com/a/10729881). return quadPointsLists.map(quadPointsList => { const [minX, maxX, minY, maxY] = quadPointsList.reduce( ([mX, MX, mY, MY], quadPoint) => [ Math.min(mX, quadPoint.x), Math.max(MX, quadPoint.x), Math.min(mY, quadPoint.y), Math.max(MY, quadPoint.y), ], [Number.MAX_VALUE, Number.MIN_VALUE, Number.MAX_VALUE, Number.MIN_VALUE] ); return [ { x: minX, y: maxY }, { x: maxX, y: maxY }, { x: minX, y: minY }, { x: maxX, y: minY }, ]; }); } function getTransformMatrix(rect, bbox, matrix) { // 12.5.5: Algorithm: Appearance streams const [minX, minY, maxX, maxY] = Util.getAxialAlignedBoundingBox( bbox, matrix ); if (minX === maxX || minY === maxY) { // From real-life file, bbox was [0, 0, 0, 0]. In this case, // just apply the transform for rect return [1, 0, 0, 1, rect[0], rect[1]]; } const xRatio = (rect[2] - rect[0]) / (maxX - minX); const yRatio = (rect[3] - rect[1]) / (maxY - minY); return [ xRatio, 0, 0, yRatio, rect[0] - minX * xRatio, rect[1] - minY * yRatio, ]; } class Annotation { constructor(params) { const dict = params.dict; this.setContents(dict.get("Contents")); this.setModificationDate(dict.get("M")); this.setFlags(dict.get("F")); this.setRectangle(dict.getArray("Rect")); this.setColor(dict.getArray("C")); this.setBorderStyle(dict); this.setAppearance(dict); this._streams = []; if (this.appearance) { this._streams.push(this.appearance); } // Expose public properties using a data object. this.data = { annotationFlags: this.flags, borderStyle: this.borderStyle, color: this.color, contents: this.contents, hasAppearance: !!this.appearance, id: params.id, modificationDate: this.modificationDate, rect: this.rectangle, subtype: params.subtype, }; if (params.collectFields) { // Fields can act as container for other fields and have // some actions even if no Annotation inherit from them. // Those fields can be referenced by CO (calculation order). const kids = dict.get("Kids"); if (Array.isArray(kids)) { const kidIds = []; for (const kid of kids) { if (isRef(kid)) { kidIds.push(kid.toString()); } } if (kidIds.length !== 0) { this.data.kidIds = kidIds; } } this.data.actions = collectActions( params.xref, dict, AnnotationActionEventType ); this.data.fieldName = this._constructFieldName(dict); } this._fallbackFontDict = null; } /** * @private */ _hasFlag(flags, flag) { return !!(flags & flag); } /** * @private */ _isViewable(flags) { return ( !this._hasFlag(flags, AnnotationFlag.INVISIBLE) && !this._hasFlag(flags, AnnotationFlag.NOVIEW) ); } /** * @private */ _isPrintable(flags) { return ( this._hasFlag(flags, AnnotationFlag.PRINT) && !this._hasFlag(flags, AnnotationFlag.INVISIBLE) ); } isHidden(annotationStorage) { const storageEntry = annotationStorage && annotationStorage.get(this.data.id); if (storageEntry && storageEntry.hidden !== undefined) { return storageEntry.hidden; } return this._hasFlag(this.flags, AnnotationFlag.HIDDEN); } /** * @type {boolean} */ get viewable() { if (this.data.quadPoints === null) { return false; } if (this.flags === 0) { return true; } return this._isViewable(this.flags); } /** * @type {boolean} */ get printable() { if (this.data.quadPoints === null) { return false; } if (this.flags === 0) { return false; } return this._isPrintable(this.flags); } /** * Set the contents. * * @public * @memberof Annotation * @param {string} contents - Text to display for the annotation or, if the * type of annotation does not display text, a * description of the annotation's contents */ setContents(contents) { this.contents = stringToPDFString(contents || ""); } /** * Set the modification date. * * @public * @memberof Annotation * @param {string} modificationDate - PDF date string that indicates when the * annotation was last modified */ setModificationDate(modificationDate) { this.modificationDate = isString(modificationDate) ? modificationDate : null; } /** * Set the flags. * * @public * @memberof Annotation * @param {number} flags - Unsigned 32-bit integer specifying annotation * characteristics * @see {@link shared/util.js} */ setFlags(flags) { this.flags = Number.isInteger(flags) && flags > 0 ? flags : 0; } /** * Check if a provided flag is set. * * @public * @memberof Annotation * @param {number} flag - Hexadecimal representation for an annotation * characteristic * @returns {boolean} * @see {@link shared/util.js} */ hasFlag(flag) { return this._hasFlag(this.flags, flag); } /** * Set the rectangle. * * @public * @memberof Annotation * @param {Array} rectangle - The rectangle array with exactly four entries */ setRectangle(rectangle) { if (Array.isArray(rectangle) && rectangle.length === 4) { this.rectangle = Util.normalizeRect(rectangle); } else { this.rectangle = [0, 0, 0, 0]; } } /** * Set the color and take care of color space conversion. * The default value is black, in RGB color space. * * @public * @memberof Annotation * @param {Array} color - The color array containing either 0 * (transparent), 1 (grayscale), 3 (RGB) or * 4 (CMYK) elements */ setColor(color) { this.color = getRgbColor(color); } /** * Set the border style (as AnnotationBorderStyle object). * * @public * @memberof Annotation * @param {Dict} borderStyle - The border style dictionary */ setBorderStyle(borderStyle) { if ( typeof PDFJSDev === "undefined" || PDFJSDev.test("!PRODUCTION || TESTING") ) { assert(this.rectangle, "setRectangle must have been called previously."); } this.borderStyle = new AnnotationBorderStyle(); if (!isDict(borderStyle)) { return; } if (borderStyle.has("BS")) { const dict = borderStyle.get("BS"); const dictType = dict.get("Type"); if (!dictType || isName(dictType, "Border")) { this.borderStyle.setWidth(dict.get("W"), this.rectangle); this.borderStyle.setStyle(dict.get("S")); this.borderStyle.setDashArray(dict.getArray("D")); } } else if (borderStyle.has("Border")) { const array = borderStyle.getArray("Border"); if (Array.isArray(array) && array.length >= 3) { this.borderStyle.setHorizontalCornerRadius(array[0]); this.borderStyle.setVerticalCornerRadius(array[1]); this.borderStyle.setWidth(array[2], this.rectangle); if (array.length === 4) { // Dash array available this.borderStyle.setDashArray(array[3]); } } } else { // There are no border entries in the dictionary. According to the // specification, we should draw a solid border of width 1 in that // case, but Adobe Reader did not implement that part of the // specification and instead draws no border at all, so we do the same. // See also https://github.com/mozilla/pdf.js/issues/6179. this.borderStyle.setWidth(0); } } /** * Set the (normal) appearance. * * @public * @memberof Annotation * @param {Dict} dict - The annotation's data dictionary */ setAppearance(dict) { this.appearance = null; const appearanceStates = dict.get("AP"); if (!isDict(appearanceStates)) { return; } // In case the normal appearance is a stream, then it is used directly. const normalAppearanceState = appearanceStates.get("N"); if (isStream(normalAppearanceState)) { this.appearance = normalAppearanceState; return; } if (!isDict(normalAppearanceState)) { return; } // In case the normal appearance is a dictionary, the `AS` entry provides // the key of the stream in this dictionary. const as = dict.get("AS"); if (!isName(as) || !normalAppearanceState.has(as.name)) { return; } this.appearance = normalAppearanceState.get(as.name); } loadResources(keys) { return this.appearance.dict.getAsync("Resources").then(resources => { if (!resources) { return undefined; } const objectLoader = new ObjectLoader(resources, keys, resources.xref); return objectLoader.load().then(function () { return resources; }); }); } getOperatorList(evaluator, task, renderForms, annotationStorage) { if (!this.appearance) { return Promise.resolve(new OperatorList()); } const appearance = this.appearance; const data = this.data; const appearanceDict = appearance.dict; const resourcesPromise = this.loadResources([ "ExtGState", "ColorSpace", "Pattern", "Shading", "XObject", "Font", ]); const bbox = appearanceDict.getArray("BBox") || [0, 0, 1, 1]; const matrix = appearanceDict.getArray("Matrix") || [1, 0, 0, 1, 0, 0]; const transform = getTransformMatrix(data.rect, bbox, matrix); return resourcesPromise.then(resources => { const opList = new OperatorList(); opList.addOp(OPS.beginAnnotation, [data.rect, transform, matrix]); return evaluator .getOperatorList({ stream: appearance, task, resources, operatorList: opList, fallbackFontDict: this._fallbackFontDict, }) .then(() => { opList.addOp(OPS.endAnnotation, []); this.reset(); return opList; }); }); } async save(evaluator, task, annotationStorage) { return null; } /** * Get field data for usage in JS sandbox. * * Field object is defined here: * https://www.adobe.com/content/dam/acom/en/devnet/acrobat/pdfs/js_api_reference.pdf#page=16 * * @public * @memberof Annotation * @returns {Object | null} */ getFieldObject() { if (this.data.kidIds) { return { id: this.data.id, actions: this.data.actions, name: this.data.fieldName, type: "", kidIds: this.data.kidIds, }; } return null; } /** * Reset the annotation. * * This involves resetting the various streams that are either cached on the * annotation instance or created during its construction. * * @public * @memberof Annotation */ reset() { if ( (typeof PDFJSDev === "undefined" || PDFJSDev.test("!PRODUCTION || TESTING")) && this.appearance && !this._streams.includes(this.appearance) ) { unreachable("The appearance stream should always be reset."); } for (const stream of this._streams) { stream.reset(); } } /** * Construct the (fully qualified) field name from the (partial) field * names of the field and its ancestors. * * @private * @memberof Annotation * @param {Dict} dict - Complete widget annotation dictionary * @returns {string} */ _constructFieldName(dict) { // Both the `Parent` and `T` fields are optional. While at least one of // them should be provided, bad PDF generators may fail to do so. if (!dict.has("T") && !dict.has("Parent")) { warn("Unknown field name, falling back to empty field name."); return ""; } // If no parent exists, the partial and fully qualified names are equal. if (!dict.has("Parent")) { return stringToPDFString(dict.get("T")); } // Form the fully qualified field name by appending the partial name to // the parent's fully qualified name, separated by a period. const fieldName = []; if (dict.has("T")) { fieldName.unshift(stringToPDFString(dict.get("T"))); } let loopDict = dict; const visited = new RefSet(); if (dict.objId) { visited.put(dict.objId); } while (loopDict.has("Parent")) { loopDict = loopDict.get("Parent"); if ( !(loopDict instanceof Dict) || (loopDict.objId && visited.has(loopDict.objId)) ) { // Even though it is not allowed according to the PDF specification, // bad PDF generators may provide a `Parent` entry that is not a // dictionary, but `null` for example (issue 8143). // // If parent has been already visited, it means that we're // in an infinite loop. break; } if (loopDict.objId) { visited.put(loopDict.objId); } if (loopDict.has("T")) { fieldName.unshift(stringToPDFString(loopDict.get("T"))); } } return fieldName.join("."); } } /** * Contains all data regarding an annotation's border style. */ class AnnotationBorderStyle { constructor() { this.width = 1; this.style = AnnotationBorderStyleType.SOLID; this.dashArray = [3]; this.horizontalCornerRadius = 0; this.verticalCornerRadius = 0; } /** * Set the width. * * @public * @memberof AnnotationBorderStyle * @param {number} width - The width. * @param {Array} rect - The annotation `Rect` entry. */ setWidth(width, rect = [0, 0, 0, 0]) { if ( typeof PDFJSDev === "undefined" || PDFJSDev.test("!PRODUCTION || TESTING") ) { assert( Array.isArray(rect) && rect.length === 4, "A valid `rect` parameter must be provided." ); } // Some corrupt PDF generators may provide the width as a `Name`, // rather than as a number (fixes issue 10385). if (isName(width)) { this.width = 0; // This is consistent with the behaviour in Adobe Reader. return; } if (Number.isInteger(width)) { if (width > 0) { const maxWidth = (rect[2] - rect[0]) / 2; const maxHeight = (rect[3] - rect[1]) / 2; // Ignore large `width`s, since they lead to the Annotation overflowing // the size set by the `Rect` entry thus causing the `annotationLayer` // to render it over the surrounding document (fixes bug1552113.pdf). if ( maxWidth > 0 && maxHeight > 0 && (width > maxWidth || width > maxHeight) ) { warn(`AnnotationBorderStyle.setWidth - ignoring width: ${width}`); width = 1; } } this.width = width; } } /** * Set the style. * * @public * @memberof AnnotationBorderStyle * @param {Name} style - The annotation style. * @see {@link shared/util.js} */ setStyle(style) { if (!isName(style)) { return; } switch (style.name) { case "S": this.style = AnnotationBorderStyleType.SOLID; break; case "D": this.style = AnnotationBorderStyleType.DASHED; break; case "B": this.style = AnnotationBorderStyleType.BEVELED; break; case "I": this.style = AnnotationBorderStyleType.INSET; break; case "U": this.style = AnnotationBorderStyleType.UNDERLINE; break; default: break; } } /** * Set the dash array. * * @public * @memberof AnnotationBorderStyle * @param {Array} dashArray - The dash array with at least one element */ setDashArray(dashArray) { // We validate the dash array, but we do not use it because CSS does not // allow us to change spacing of dashes. For more information, visit // http://www.w3.org/TR/css3-background/#the-border-style. if (Array.isArray(dashArray) && dashArray.length > 0) { // According to the PDF specification: the elements in `dashArray` // shall be numbers that are nonnegative and not all equal to zero. let isValid = true; let allZeros = true; for (const element of dashArray) { const validNumber = +element >= 0; if (!validNumber) { isValid = false; break; } else if (element > 0) { allZeros = false; } } if (isValid && !allZeros) { this.dashArray = dashArray; } else { this.width = 0; // Adobe behavior when the array is invalid. } } else if (dashArray) { this.width = 0; // Adobe behavior when the array is invalid. } } /** * Set the horizontal corner radius (from a Border dictionary). * * @public * @memberof AnnotationBorderStyle * @param {number} radius - The horizontal corner radius. */ setHorizontalCornerRadius(radius) { if (Number.isInteger(radius)) { this.horizontalCornerRadius = radius; } } /** * Set the vertical corner radius (from a Border dictionary). * * @public * @memberof AnnotationBorderStyle * @param {number} radius - The vertical corner radius. */ setVerticalCornerRadius(radius) { if (Number.isInteger(radius)) { this.verticalCornerRadius = radius; } } } class MarkupAnnotation extends Annotation { constructor(parameters) { super(parameters); const dict = parameters.dict; if (dict.has("IRT")) { const rawIRT = dict.getRaw("IRT"); this.data.inReplyTo = isRef(rawIRT) ? rawIRT.toString() : null; const rt = dict.get("RT"); this.data.replyType = isName(rt) ? rt.name : AnnotationReplyType.REPLY; } if (this.data.replyType === AnnotationReplyType.GROUP) { // Subordinate annotations in a group should inherit // the group attributes from the primary annotation. const parent = dict.get("IRT"); this.data.title = stringToPDFString(parent.get("T") || ""); this.setContents(parent.get("Contents")); this.data.contents = this.contents; if (!parent.has("CreationDate")) { this.data.creationDate = null; } else { this.setCreationDate(parent.get("CreationDate")); this.data.creationDate = this.creationDate; } if (!parent.has("M")) { this.data.modificationDate = null; } else { this.setModificationDate(parent.get("M")); this.data.modificationDate = this.modificationDate; } this.data.hasPopup = parent.has("Popup"); if (!parent.has("C")) { // Fall back to the default background color. this.data.color = null; } else { this.setColor(parent.getArray("C")); this.data.color = this.color; } } else { this.data.title = stringToPDFString(dict.get("T") || ""); this.setCreationDate(dict.get("CreationDate")); this.data.creationDate = this.creationDate; this.data.hasPopup = dict.has("Popup"); if (!dict.has("C")) { // Fall back to the default background color. this.data.color = null; } } } /** * Set the creation date. * * @public * @memberof MarkupAnnotation * @param {string} creationDate - PDF date string that indicates when the * annotation was originally created */ setCreationDate(creationDate) { this.creationDate = isString(creationDate) ? creationDate : null; } _setDefaultAppearance({ xref, extra, strokeColor, fillColor, blendMode, pointsCallback, }) { let minX = Number.MAX_VALUE; let minY = Number.MAX_VALUE; let maxX = Number.MIN_VALUE; let maxY = Number.MIN_VALUE; const buffer = ["q"]; if (extra) { buffer.push(extra); } if (strokeColor) { buffer.push(`${strokeColor[0]} ${strokeColor[1]} ${strokeColor[2]} RG`); } if (fillColor) { buffer.push(`${fillColor[0]} ${fillColor[1]} ${fillColor[2]} rg`); } let pointsArray = this.data.quadPoints; if (!pointsArray) { // If there are no quadpoints, the rectangle should be used instead. // Convert the rectangle definition to a points array similar to how the // quadpoints are defined. pointsArray = [ [ { x: this.rectangle[0], y: this.rectangle[3] }, { x: this.rectangle[2], y: this.rectangle[3] }, { x: this.rectangle[0], y: this.rectangle[1] }, { x: this.rectangle[2], y: this.rectangle[1] }, ], ]; } for (const points of pointsArray) { const [mX, MX, mY, MY] = pointsCallback(buffer, points); minX = Math.min(minX, mX); maxX = Math.max(maxX, MX); minY = Math.min(minY, mY); maxY = Math.max(maxY, MY); } buffer.push("Q"); const formDict = new Dict(xref); const appearanceStreamDict = new Dict(xref); appearanceStreamDict.set("Subtype", Name.get("Form")); const appearanceStream = new StringStream(buffer.join(" ")); appearanceStream.dict = appearanceStreamDict; formDict.set("Fm0", appearanceStream); const gsDict = new Dict(xref); if (blendMode) { gsDict.set("BM", Name.get(blendMode)); } const stateDict = new Dict(xref); stateDict.set("GS0", gsDict); const resources = new Dict(xref); resources.set("ExtGState", stateDict); resources.set("XObject", formDict); const appearanceDict = new Dict(xref); appearanceDict.set("Resources", resources); const bbox = (this.data.rect = [minX, minY, maxX, maxY]); appearanceDict.set("BBox", bbox); this.appearance = new StringStream("/GS0 gs /Fm0 Do"); this.appearance.dict = appearanceDict; // This method is only called if there is no appearance for the annotation, // so `this.appearance` is not pushed yet in the `Annotation` constructor. this._streams.push(this.appearance, appearanceStream); } } class WidgetAnnotation extends Annotation { constructor(params) { super(params); const dict = params.dict; const data = this.data; this.ref = params.ref; data.annotationType = AnnotationType.WIDGET; if (data.fieldName === undefined) { data.fieldName = this._constructFieldName(dict); } if (data.actions === undefined) { data.actions = collectActions( params.xref, dict, AnnotationActionEventType ); } const fieldValue = getInheritableProperty({ dict, key: "V", getArray: true, }); data.fieldValue = this._decodeFormValue(fieldValue); const defaultFieldValue = getInheritableProperty({ dict, key: "DV", getArray: true, }); data.defaultFieldValue = this._decodeFormValue(defaultFieldValue); data.alternativeText = stringToPDFString(dict.get("TU") || ""); const defaultAppearance = getInheritableProperty({ dict, key: "DA" }) || params.acroForm.get("DA"); this._defaultAppearance = isString(defaultAppearance) ? defaultAppearance : ""; data.defaultAppearanceData = parseDefaultAppearance( this._defaultAppearance ); const fieldType = getInheritableProperty({ dict, key: "FT" }); data.fieldType = isName(fieldType) ? fieldType.name : null; const localResources = getInheritableProperty({ dict, key: "DR" }); const acroFormResources = params.acroForm.get("DR"); const appearanceResources = this.appearance && this.appearance.dict.get("Resources"); this._fieldResources = { localResources, acroFormResources, appearanceResources, mergedResources: Dict.merge({ xref: params.xref, dictArray: [localResources, appearanceResources, acroFormResources], mergeSubDicts: true, }), }; data.fieldFlags = getInheritableProperty({ dict, key: "Ff" }); if (!Number.isInteger(data.fieldFlags) || data.fieldFlags < 0) { data.fieldFlags = 0; } data.readOnly = this.hasFieldFlag(AnnotationFieldFlag.READONLY); data.hidden = this._hasFlag(data.annotationFlags, AnnotationFlag.HIDDEN); } /** * Decode the given form value. * * @private * @memberof WidgetAnnotation * @param {Array|Name|string} formValue - The (possibly encoded) * form value. * @returns {Array|string|null} */ _decodeFormValue(formValue) { if (Array.isArray(formValue)) { return formValue .filter(item => isString(item)) .map(item => stringToPDFString(item)); } else if (isName(formValue)) { return stringToPDFString(formValue.name); } else if (isString(formValue)) { return stringToPDFString(formValue); } return null; } /** * Check if a provided field flag is set. * * @public * @memberof WidgetAnnotation * @param {number} flag - Hexadecimal representation for an annotation * field characteristic * @returns {boolean} * @see {@link shared/util.js} */ hasFieldFlag(flag) { return !!(this.data.fieldFlags & flag); } getOperatorList(evaluator, task, renderForms, annotationStorage) { // Do not render form elements on the canvas when interactive forms are // enabled. The display layer is responsible for rendering them instead. if (renderForms && !(this instanceof SignatureWidgetAnnotation)) { return Promise.resolve(new OperatorList()); } if (!this._hasText) { return super.getOperatorList( evaluator, task, renderForms, annotationStorage ); } return this._getAppearance(evaluator, task, annotationStorage).then( content => { if (this.appearance && content === null) { return super.getOperatorList( evaluator, task, renderForms, annotationStorage ); } const operatorList = new OperatorList(); // Even if there is an appearance stream, ignore it. This is the // behaviour used by Adobe Reader. if (!this._defaultAppearance || content === null) { return operatorList; } const matrix = [1, 0, 0, 1, 0, 0]; const bbox = [ 0, 0, this.data.rect[2] - this.data.rect[0], this.data.rect[3] - this.data.rect[1], ]; const transform = getTransformMatrix(this.data.rect, bbox, matrix); operatorList.addOp(OPS.beginAnnotation, [ this.data.rect, transform, matrix, ]); const stream = new StringStream(content); return evaluator .getOperatorList({ stream, task, resources: this._fieldResources.mergedResources, operatorList, }) .then(function () { operatorList.addOp(OPS.endAnnotation, []); return operatorList; }); } ); } async save(evaluator, task, annotationStorage) { if (!annotationStorage) { return null; } const storageEntry = annotationStorage.get(this.data.id); const value = storageEntry && storageEntry.value; if (value === this.data.fieldValue || value === undefined) { return null; } let appearance = await this._getAppearance( evaluator, task, annotationStorage ); if (appearance === null) { return null; } const { xref } = evaluator; const dict = xref.fetchIfRef(this.ref); if (!isDict(dict)) { return null; } const bbox = [ 0, 0, this.data.rect[2] - this.data.rect[0], this.data.rect[3] - this.data.rect[1], ]; const xfa = { path: stringToPDFString(dict.get("T") || ""), value, }; const newRef = xref.getNewRef(); const AP = new Dict(xref); AP.set("N", newRef); const encrypt = xref.encrypt; let originalTransform = null; let newTransform = null; if (encrypt) { originalTransform = encrypt.createCipherTransform( this.ref.num, this.ref.gen ); newTransform = encrypt.createCipherTransform(newRef.num, newRef.gen); appearance = newTransform.encryptString(appearance); } dict.set("V", isAscii(value) ? value : stringToUTF16BEString(value)); dict.set("AP", AP); dict.set("M", `D:${getModificationDate()}`); const appearanceDict = new Dict(xref); appearanceDict.set("Length", appearance.length); appearanceDict.set("Subtype", Name.get("Form")); appearanceDict.set("Resources", this._getSaveFieldResources(xref)); appearanceDict.set("BBox", bbox); const bufferOriginal = [`${this.ref.num} ${this.ref.gen} obj\n`]; writeDict(dict, bufferOriginal, originalTransform); bufferOriginal.push("\nendobj\n"); const bufferNew = [`${newRef.num} ${newRef.gen} obj\n`]; writeDict(appearanceDict, bufferNew, newTransform); bufferNew.push(" stream\n"); bufferNew.push(appearance); bufferNew.push("\nendstream\nendobj\n"); return [ // data for the original object // V field changed + reference for new AP { ref: this.ref, data: bufferOriginal.join(""), xfa }, // data for the new AP { ref: newRef, data: bufferNew.join(""), xfa: null }, ]; } async _getAppearance(evaluator, task, annotationStorage) { const isPassword = this.hasFieldFlag(AnnotationFieldFlag.PASSWORD); if (!annotationStorage || isPassword) { return null; } const storageEntry = annotationStorage.get(this.data.id); let value = storageEntry && storageEntry.value; if (value === undefined) { // The annotation hasn't been rendered so use the appearance return null; } value = value.trim(); if (value === "") { // the field is empty: nothing to render return ""; } let lineCount = -1; if (this.data.multiLine) { lineCount = value.split(/\r\n|\r|\n/).length; } const defaultPadding = 2; const hPadding = defaultPadding; const totalHeight = this.data.rect[3] - this.data.rect[1]; const totalWidth = this.data.rect[2] - this.data.rect[0]; if (!this._defaultAppearance) { // The DA is required and must be a string. // If there is no font named Helvetica in the resource dictionary, // the evaluator will fall back to a default font. // Doing so prevents exceptions and allows saving/printing // the file as expected. this.data.defaultAppearanceData = parseDefaultAppearance( (this._defaultAppearance = "/Helvetica 0 Tf 0 g") ); } const [defaultAppearance, fontSize] = this._computeFontSize( totalHeight, lineCount ); const font = await this._getFontData(evaluator, task); let descent = font.descent; if (isNaN(descent)) { descent = 0; } const vPadding = defaultPadding + Math.abs(descent) * fontSize; const alignment = this.data.textAlignment; if (this.data.multiLine) { return this._getMultilineAppearance( defaultAppearance, value, font, fontSize, totalWidth, totalHeight, alignment, hPadding, vPadding ); } // TODO: need to handle chars which are not in the font. const encodedString = font.encodeString(value).join(""); if (this.data.comb) { return this._getCombAppearance( defaultAppearance, font, encodedString, totalWidth, hPadding, vPadding ); } if (alignment === 0 || alignment > 2) { // Left alignment: nothing to do return ( "/Tx BMC q BT " + defaultAppearance + ` 1 0 0 1 ${hPadding} ${vPadding} Tm (${escapeString( encodedString )}) Tj` + " ET Q EMC" ); } const renderedText = this._renderText( encodedString, font, fontSize, totalWidth, alignment, hPadding, vPadding ); return ( "/Tx BMC q BT " + defaultAppearance + ` 1 0 0 1 0 0 Tm ${renderedText}` + " ET Q EMC" ); } async _getFontData(evaluator, task) { const operatorList = new OperatorList(); const initialState = { font: null, clone() { return this; }, }; const { fontName, fontSize } = this.data.defaultAppearanceData; await evaluator.handleSetFont( this._fieldResources.mergedResources, [fontName && Name.get(fontName), fontSize], /* fontRef = */ null, operatorList, task, initialState, /* fallbackFontDict = */ null ); return initialState.font; } _computeFontSize(height, lineCount) { let { fontSize } = this.data.defaultAppearanceData; if (!fontSize) { // A zero value for size means that the font shall be auto-sized: // its size shall be computed as a function of the height of the // annotation rectangle (see 12.7.3.3). const roundWithOneDigit = x => Math.round(x * 10) / 10; // Represent the percentage of the font size over the height // of a single-line field. const FONT_FACTOR = 0.8; if (lineCount === -1) { fontSize = roundWithOneDigit(FONT_FACTOR * height); } else { // Hard to guess how many lines there are. // The field may have been sized to have 10 lines // and the user entered only 1 so if we get font size from // height and number of lines then we'll get something too big. // So we compute a fake number of lines based on height and // a font size equal to 10. // Then we'll adjust font size to what we have really. fontSize = 10; let lineHeight = fontSize / FONT_FACTOR; let numberOfLines = Math.round(height / lineHeight); numberOfLines = Math.max(numberOfLines, lineCount); lineHeight = height / numberOfLines; fontSize = roundWithOneDigit(FONT_FACTOR * lineHeight); } const { fontName, fontColor } = this.data.defaultAppearanceData; this._defaultAppearance = createDefaultAppearance({ fontSize, fontName, fontColor, }); } return [this._defaultAppearance, fontSize]; } _renderText(text, font, fontSize, totalWidth, alignment, hPadding, vPadding) { // We need to get the width of the text in order to align it correctly const glyphs = font.charsToGlyphs(text); const scale = fontSize / 1000; let width = 0; for (const glyph of glyphs) { width += glyph.width * scale; } let shift; if (alignment === 1) { // Center shift = (totalWidth - width) / 2; } else if (alignment === 2) { // Right shift = totalWidth - width - hPadding; } else { shift = hPadding; } shift = shift.toFixed(2); vPadding = vPadding.toFixed(2); return `${shift} ${vPadding} Td (${escapeString(text)}) Tj`; } /** * @private */ _getSaveFieldResources(xref) { if ( typeof PDFJSDev === "undefined" || PDFJSDev.test("!PRODUCTION || TESTING") ) { assert( this.data.defaultAppearanceData, "Expected `_defaultAppearanceData` to have been set." ); } const { localResources, appearanceResources, acroFormResources, } = this._fieldResources; const fontName = this.data.defaultAppearanceData && this.data.defaultAppearanceData.fontName; if (!fontName) { return localResources || Dict.empty; } for (const resources of [localResources, appearanceResources]) { if (resources instanceof Dict) { const localFont = resources.get("Font"); if (localFont instanceof Dict && localFont.has(fontName)) { return resources; } } } if (acroFormResources instanceof Dict) { const acroFormFont = acroFormResources.get("Font"); if (acroFormFont instanceof Dict && acroFormFont.has(fontName)) { const subFontDict = new Dict(xref); subFontDict.set(fontName, acroFormFont.getRaw(fontName)); const subResourcesDict = new Dict(xref); subResourcesDict.set("Font", subFontDict); return Dict.merge({ xref, dictArray: [subResourcesDict, localResources], mergeSubDicts: true, }); } } return localResources || Dict.empty; } getFieldObject() { return null; } } class TextWidgetAnnotation extends WidgetAnnotation { constructor(params) { super(params); this._hasText = true; const dict = params.dict; // The field value is always a string. if (!isString(this.data.fieldValue)) { this.data.fieldValue = ""; } // Determine the alignment of text in the field. let alignment = getInheritableProperty({ dict, key: "Q" }); if (!Number.isInteger(alignment) || alignment < 0 || alignment > 2) { alignment = null; } this.data.textAlignment = alignment; // Determine the maximum length of text in the field. let maximumLength = getInheritableProperty({ dict, key: "MaxLen" }); if (!Number.isInteger(maximumLength) || maximumLength < 0) { maximumLength = null; } this.data.maxLen = maximumLength; // Process field flags for the display layer. this.data.multiLine = this.hasFieldFlag(AnnotationFieldFlag.MULTILINE); this.data.comb = this.hasFieldFlag(AnnotationFieldFlag.COMB) && !this.hasFieldFlag(AnnotationFieldFlag.MULTILINE) && !this.hasFieldFlag(AnnotationFieldFlag.PASSWORD) && !this.hasFieldFlag(AnnotationFieldFlag.FILESELECT) && this.data.maxLen !== null; } _getCombAppearance(defaultAppearance, font, text, width, hPadding, vPadding) { const combWidth = (width / this.data.maxLen).toFixed(2); const buf = []; const positions = font.getCharPositions(text); for (const [start, end] of positions) { buf.push(`(${escapeString(text.substring(start, end))}) Tj`); } const renderedComb = buf.join(` ${combWidth} 0 Td `); return ( "/Tx BMC q BT " + defaultAppearance + ` 1 0 0 1 ${hPadding} ${vPadding} Tm ${renderedComb}` + " ET Q EMC" ); } _getMultilineAppearance( defaultAppearance, text, font, fontSize, width, height, alignment, hPadding, vPadding ) { const lines = text.split(/\r\n|\r|\n/); const buf = []; const totalWidth = width - 2 * hPadding; for (const line of lines) { const chunks = this._splitLine(line, font, fontSize, totalWidth); for (const chunk of chunks) { const padding = buf.length === 0 ? hPadding : 0; buf.push( this._renderText( chunk, font, fontSize, width, alignment, padding, -fontSize // <0 because a line is below the previous one ) ); } } const renderedText = buf.join("\n"); return ( "/Tx BMC q BT " + defaultAppearance + ` 1 0 0 1 0 ${height} Tm ${renderedText}` + " ET Q EMC" ); } _splitLine(line, font, fontSize, width) { // TODO: need to handle chars which are not in the font. line = font.encodeString(line).join(""); const glyphs = font.charsToGlyphs(line); if (glyphs.length <= 1) { // Nothing to split return [line]; } const positions = font.getCharPositions(line); const scale = fontSize / 1000; const chunks = []; let lastSpacePosInStringStart = -1, lastSpacePosInStringEnd = -1, lastSpacePos = -1, startChunk = 0, currentWidth = 0; for (let i = 0, ii = glyphs.length; i < ii; i++) { const [start, end] = positions[i]; const glyph = glyphs[i]; const glyphWidth = glyph.width * scale; if (glyph.unicode === " ") { if (currentWidth + glyphWidth > width) { // We can break here chunks.push(line.substring(startChunk, start)); startChunk = start; currentWidth = glyphWidth; lastSpacePosInStringStart = -1; lastSpacePos = -1; } else { currentWidth += glyphWidth; lastSpacePosInStringStart = start; lastSpacePosInStringEnd = end; lastSpacePos = i; } } else { if (currentWidth + glyphWidth > width) { // We must break to the last white position (if available) if (lastSpacePosInStringStart !== -1) { chunks.push(line.substring(startChunk, lastSpacePosInStringEnd)); startChunk = lastSpacePosInStringEnd; i = lastSpacePos + 1; lastSpacePosInStringStart = -1; currentWidth = 0; } else { // Just break in the middle of the word chunks.push(line.substring(startChunk, start)); startChunk = start; currentWidth = glyphWidth; } } else { currentWidth += glyphWidth; } } } if (startChunk < line.length) { chunks.push(line.substring(startChunk, line.length)); } return chunks; } getFieldObject() { return { id: this.data.id, value: this.data.fieldValue, defaultValue: this.data.defaultFieldValue, multiline: this.data.multiLine, password: this.hasFieldFlag(AnnotationFieldFlag.PASSWORD), charLimit: this.data.maxLen, comb: this.data.comb, editable: !this.data.readOnly, hidden: this.data.hidden, name: this.data.fieldName, rect: this.data.rect, actions: this.data.actions, type: "text", }; } } class ButtonWidgetAnnotation extends WidgetAnnotation { constructor(params) { super(params); this.checkedAppearance = null; this.uncheckedAppearance = null; this.data.checkBox = !this.hasFieldFlag(AnnotationFieldFlag.RADIO) && !this.hasFieldFlag(AnnotationFieldFlag.PUSHBUTTON); this.data.radioButton = this.hasFieldFlag(AnnotationFieldFlag.RADIO) && !this.hasFieldFlag(AnnotationFieldFlag.PUSHBUTTON); this.data.pushButton = this.hasFieldFlag(AnnotationFieldFlag.PUSHBUTTON); this.data.isTooltipOnly = false; if (this.data.checkBox) { this._processCheckBox(params); } else if (this.data.radioButton) { this._processRadioButton(params); } else if (this.data.pushButton) { this._processPushButton(params); } else { warn("Invalid field flags for button widget annotation"); } } getOperatorList(evaluator, task, renderForms, annotationStorage) { if (this.data.pushButton) { return super.getOperatorList( evaluator, task, false, // we use normalAppearance to render the button annotationStorage ); } if (annotationStorage) { const storageEntry = annotationStorage.get(this.data.id); const value = storageEntry && storageEntry.value; if (value === undefined) { return super.getOperatorList( evaluator, task, renderForms, annotationStorage ); } let appearance; if (value) { appearance = this.checkedAppearance; } else { appearance = this.uncheckedAppearance; } if (appearance) { const savedAppearance = this.appearance; this.appearance = appearance; const operatorList = super.getOperatorList( evaluator, task, renderForms, annotationStorage ); this.appearance = savedAppearance; return operatorList; } // No appearance return Promise.resolve(new OperatorList()); } return super.getOperatorList( evaluator, task, renderForms, annotationStorage ); } async save(evaluator, task, annotationStorage) { if (this.data.checkBox) { return this._saveCheckbox(evaluator, task, annotationStorage); } if (this.data.radioButton) { return this._saveRadioButton(evaluator, task, annotationStorage); } // Nothing to save return null; } async _saveCheckbox(evaluator, task, annotationStorage) { if (!annotationStorage) { return null; } const storageEntry = annotationStorage.get(this.data.id); const value = storageEntry && storageEntry.value; if (value === undefined) { return null; } const defaultValue = this.data.fieldValue && this.data.fieldValue !== "Off"; if (defaultValue === value) { return null; } const dict = evaluator.xref.fetchIfRef(this.ref); if (!isDict(dict)) { return null; } const xfa = { path: stringToPDFString(dict.get("T") || ""), value: value ? this.data.exportValue : "", }; const name = Name.get(value ? this.data.exportValue : "Off"); dict.set("V", name); dict.set("AS", name); dict.set("M", `D:${getModificationDate()}`); const encrypt = evaluator.xref.encrypt; let originalTransform = null; if (encrypt) { originalTransform = encrypt.createCipherTransform( this.ref.num, this.ref.gen ); } const buffer = [`${this.ref.num} ${this.ref.gen} obj\n`]; writeDict(dict, buffer, originalTransform); buffer.push("\nendobj\n"); return [{ ref: this.ref, data: buffer.join(""), xfa }]; } async _saveRadioButton(evaluator, task, annotationStorage) { if (!annotationStorage) { return null; } const storageEntry = annotationStorage.get(this.data.id); const value = storageEntry && storageEntry.value; if (value === undefined) { return null; } const defaultValue = this.data.fieldValue === this.data.buttonValue; if (defaultValue === value) { return null; } const dict = evaluator.xref.fetchIfRef(this.ref); if (!isDict(dict)) { return null; } const xfa = { path: stringToPDFString(dict.get("T") || ""), value: value ? this.data.buttonValue : "", }; const name = Name.get(value ? this.data.buttonValue : "Off"); let parentBuffer = null; const encrypt = evaluator.xref.encrypt; if (value) { if (isRef(this.parent)) { const parent = evaluator.xref.fetch(this.parent); let parentTransform = null; if (encrypt) { parentTransform = encrypt.createCipherTransform( this.parent.num, this.parent.gen ); } parent.set("V", name); parentBuffer = [`${this.parent.num} ${this.parent.gen} obj\n`]; writeDict(parent, parentBuffer, parentTransform); parentBuffer.push("\nendobj\n"); } else if (isDict(this.parent)) { this.parent.set("V", name); } } dict.set("AS", name); dict.set("M", `D:${getModificationDate()}`); let originalTransform = null; if (encrypt) { originalTransform = encrypt.createCipherTransform( this.ref.num, this.ref.gen ); } const buffer = [`${this.ref.num} ${this.ref.gen} obj\n`]; writeDict(dict, buffer, originalTransform); buffer.push("\nendobj\n"); const newRefs = [{ ref: this.ref, data: buffer.join(""), xfa }]; if (parentBuffer !== null) { newRefs.push({ ref: this.parent, data: parentBuffer.join(""), xfa: null, }); } return newRefs; } _processCheckBox(params) { const customAppearance = params.dict.get("AP"); if (!isDict(customAppearance)) { return; } const normalAppearance = customAppearance.get("N"); if (!isDict(normalAppearance)) { return; } const exportValues = normalAppearance.getKeys(); if (!exportValues.includes("Off")) { // The /Off appearance is optional. exportValues.push("Off"); } if (exportValues.length !== 2) { return; } this.data.exportValue = exportValues[0] === "Off" ? exportValues[1] : exportValues[0]; this.checkedAppearance = normalAppearance.get(this.data.exportValue); this.uncheckedAppearance = normalAppearance.get("Off") || null; this._streams.push(this.checkedAppearance); if (this.uncheckedAppearance) { this._streams.push(this.uncheckedAppearance); } this._fallbackFontDict = this.fallbackFontDict; } _processRadioButton(params) { this.data.fieldValue = this.data.buttonValue = null; // The parent field's `V` entry holds a `Name` object with the appearance // state of whichever child field is currently in the "on" state. const fieldParent = params.dict.get("Parent"); if (isDict(fieldParent)) { this.parent = params.dict.getRaw("Parent"); const fieldParentValue = fieldParent.get("V"); if (isName(fieldParentValue)) { this.data.fieldValue = this._decodeFormValue(fieldParentValue); } } // The button's value corresponds to its appearance state. const appearanceStates = params.dict.get("AP"); if (!isDict(appearanceStates)) { return; } const normalAppearance = appearanceStates.get("N"); if (!isDict(normalAppearance)) { return; } for (const key of normalAppearance.getKeys()) { if (key !== "Off") { this.data.buttonValue = this._decodeFormValue(key); break; } } this.checkedAppearance = normalAppearance.get(this.data.buttonValue); this.uncheckedAppearance = normalAppearance.get("Off") || null; this._streams.push(this.checkedAppearance); if (this.uncheckedAppearance) { this._streams.push(this.uncheckedAppearance); } this._fallbackFontDict = this.fallbackFontDict; } _processPushButton(params) { if ( !params.dict.has("A") && !params.dict.has("AA") && !this.data.alternativeText ) { warn("Push buttons without action dictionaries are not supported"); return; } this.data.isTooltipOnly = !params.dict.has("A") && !params.dict.has("AA"); Catalog.parseDestDictionary({ destDict: params.dict, resultObj: this.data, docBaseUrl: params.pdfManager.docBaseUrl, }); } getFieldObject() { let type = "button"; let exportValues; if (this.data.checkBox) { type = "checkbox"; exportValues = this.data.exportValue; } else if (this.data.radioButton) { type = "radiobutton"; exportValues = this.data.buttonValue; } return { id: this.data.id, value: this.data.fieldValue || "Off", defaultValue: this.data.defaultFieldValue, exportValues, editable: !this.data.readOnly, name: this.data.fieldName, rect: this.data.rect, hidden: this.data.hidden, actions: this.data.actions, type, }; } get fallbackFontDict() { const dict = new Dict(); dict.set("BaseFont", Name.get("ZapfDingbats")); dict.set("Type", Name.get("FallbackType")); dict.set("Subtype", Name.get("FallbackType")); dict.set("Encoding", Name.get("ZapfDingbatsEncoding")); return shadow(this, "fallbackFontDict", dict); } } class ChoiceWidgetAnnotation extends WidgetAnnotation { constructor(params) { super(params); // Determine the options. The options array may consist of strings or // arrays. If the array consists of arrays, then the first element of // each array is the export value and the second element of each array is // the display value. If the array consists of strings, then these // represent both the export and display value. In this case, we convert // it to an array of arrays as well for convenience in the display layer. // Note that the specification does not state that the `Opt` field is // inheritable, but in practice PDF generators do make annotations // inherit the options from a parent annotation (issue 8094). this.data.options = []; const options = getInheritableProperty({ dict: params.dict, key: "Opt" }); if (Array.isArray(options)) { const xref = params.xref; for (let i = 0, ii = options.length; i < ii; i++) { const option = xref.fetchIfRef(options[i]); const isOptionArray = Array.isArray(option); this.data.options[i] = { exportValue: this._decodeFormValue( isOptionArray ? xref.fetchIfRef(option[0]) : option ), displayValue: this._decodeFormValue( isOptionArray ? xref.fetchIfRef(option[1]) : option ), }; } } // The field value can be `null` if no item is selected, a string if one // item is selected or an array of strings if multiple items are selected. // For consistency in the API and convenience in the display layer, we // always make the field value an array with zero, one or multiple items. if (isString(this.data.fieldValue)) { this.data.fieldValue = [this.data.fieldValue]; } else if (!this.data.fieldValue) { this.data.fieldValue = []; } // Process field flags for the display layer. this.data.combo = this.hasFieldFlag(AnnotationFieldFlag.COMBO); this.data.multiSelect = this.hasFieldFlag(AnnotationFieldFlag.MULTISELECT); this._hasText = true; } getFieldObject() { const type = this.data.combo ? "combobox" : "listbox"; const value = this.data.fieldValue.length > 0 ? this.data.fieldValue[0] : null; return { id: this.data.id, value, defaultValue: this.data.defaultFieldValue, editable: !this.data.readOnly, name: this.data.fieldName, rect: this.data.rect, numItems: this.data.fieldValue.length, multipleSelection: this.data.multiSelect, hidden: this.data.hidden, actions: this.data.actions, items: this.data.options, type, }; } } class SignatureWidgetAnnotation extends WidgetAnnotation { constructor(params) { super(params); // Unset the fieldValue since it's (most likely) a `Dict` which is // non-serializable and will thus cause errors when sending annotations // to the main-thread (issue 10347). this.data.fieldValue = null; } getFieldObject() { return { id: this.data.id, value: null, type: "signature", }; } } class TextAnnotation extends MarkupAnnotation { constructor(parameters) { const DEFAULT_ICON_SIZE = 22; // px super(parameters); const dict = parameters.dict; this.data.annotationType = AnnotationType.TEXT; if (this.data.hasAppearance) { this.data.name = "NoIcon"; } else { this.data.rect[1] = this.data.rect[3] - DEFAULT_ICON_SIZE; this.data.rect[2] = this.data.rect[0] + DEFAULT_ICON_SIZE; this.data.name = dict.has("Name") ? dict.get("Name").name : "Note"; } if (dict.has("State")) { this.data.state = dict.get("State") || null; this.data.stateModel = dict.get("StateModel") || null; } else { this.data.state = null; this.data.stateModel = null; } } } class LinkAnnotation extends Annotation { constructor(params) { super(params); this.data.annotationType = AnnotationType.LINK; const quadPoints = getQuadPoints(params.dict, this.rectangle); if (quadPoints) { this.data.quadPoints = quadPoints; } Catalog.parseDestDictionary({ destDict: params.dict, resultObj: this.data, docBaseUrl: params.pdfManager.docBaseUrl, }); } } class PopupAnnotation extends Annotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.POPUP; let parentItem = parameters.dict.get("Parent"); if (!parentItem) { warn("Popup annotation has a missing or invalid parent annotation."); return; } const parentSubtype = parentItem.get("Subtype"); this.data.parentType = isName(parentSubtype) ? parentSubtype.name : null; const rawParent = parameters.dict.getRaw("Parent"); this.data.parentId = isRef(rawParent) ? rawParent.toString() : null; const parentRect = parentItem.getArray("Rect"); if (Array.isArray(parentRect) && parentRect.length === 4) { this.data.parentRect = Util.normalizeRect(parentRect); } else { this.data.parentRect = [0, 0, 0, 0]; } const rt = parentItem.get("RT"); if (isName(rt, AnnotationReplyType.GROUP)) { // Subordinate annotations in a group should inherit // the group attributes from the primary annotation. parentItem = parentItem.get("IRT"); } if (!parentItem.has("M")) { this.data.modificationDate = null; } else { this.setModificationDate(parentItem.get("M")); this.data.modificationDate = this.modificationDate; } if (!parentItem.has("C")) { // Fall back to the default background color. this.data.color = null; } else { this.setColor(parentItem.getArray("C")); this.data.color = this.color; } // If the Popup annotation is not viewable, but the parent annotation is, // that is most likely a bug. Fallback to inherit the flags from the parent // annotation (this is consistent with the behaviour in Adobe Reader). if (!this.viewable) { const parentFlags = parentItem.get("F"); if (this._isViewable(parentFlags)) { this.setFlags(parentFlags); } } this.data.title = stringToPDFString(parentItem.get("T") || ""); this.data.contents = stringToPDFString(parentItem.get("Contents") || ""); } } class FreeTextAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.FREETEXT; } } class LineAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.LINE; const lineCoordinates = parameters.dict.getArray("L"); this.data.lineCoordinates = Util.normalizeRect(lineCoordinates); if (!this.appearance) { // The default stroke color is black. const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; const borderWidth = this.borderStyle.width; // If the /Rect-entry is empty, create a fallback rectangle such that we // get similar rendering/highlighting behaviour as in Adobe Reader. if (isArrayEqual(this.rectangle, [0, 0, 0, 0])) { this.rectangle = [ this.data.lineCoordinates[0] - 2 * borderWidth, this.data.lineCoordinates[1] - 2 * borderWidth, this.data.lineCoordinates[2] + 2 * borderWidth, this.data.lineCoordinates[3] + 2 * borderWidth, ]; } this._setDefaultAppearance({ xref: parameters.xref, extra: `${borderWidth} w`, strokeColor, pointsCallback: (buffer, points) => { buffer.push(`${lineCoordinates[0]} ${lineCoordinates[1]} m`); buffer.push(`${lineCoordinates[2]} ${lineCoordinates[3]} l`); buffer.push("S"); return [ points[0].x - borderWidth, points[1].x + borderWidth, points[3].y - borderWidth, points[1].y + borderWidth, ]; }, }); } } } class SquareAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.SQUARE; if (!this.appearance) { // The default stroke color is black. const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; // The default fill color is transparent. let fillColor = null; let interiorColor = parameters.dict.getArray("IC"); if (interiorColor) { interiorColor = getRgbColor(interiorColor); fillColor = interiorColor ? Array.from(interiorColor).map(c => c / 255) : null; } this._setDefaultAppearance({ xref: parameters.xref, extra: `${this.borderStyle.width} w`, strokeColor, fillColor, pointsCallback: (buffer, points) => { const x = points[2].x + this.borderStyle.width / 2; const y = points[2].y + this.borderStyle.width / 2; const width = points[3].x - points[2].x - this.borderStyle.width; const height = points[1].y - points[3].y - this.borderStyle.width; buffer.push(`${x} ${y} ${width} ${height} re`); if (fillColor) { buffer.push("B"); } else { buffer.push("S"); } return [points[0].x, points[1].x, points[3].y, points[1].y]; }, }); } } } class CircleAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.CIRCLE; if (!this.appearance) { // The default stroke color is black. const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; // The default fill color is transparent. let fillColor = null; let interiorColor = parameters.dict.getArray("IC"); if (interiorColor) { interiorColor = getRgbColor(interiorColor); fillColor = interiorColor ? Array.from(interiorColor).map(c => c / 255) : null; } // Circles are approximated by Bézier curves with four segments since // there is no circle primitive in the PDF specification. For the control // points distance, see https://stackoverflow.com/a/27863181. const controlPointsDistance = (4 / 3) * Math.tan(Math.PI / (2 * 4)); this._setDefaultAppearance({ xref: parameters.xref, extra: `${this.borderStyle.width} w`, strokeColor, fillColor, pointsCallback: (buffer, points) => { const x0 = points[0].x + this.borderStyle.width / 2; const y0 = points[0].y - this.borderStyle.width / 2; const x1 = points[3].x - this.borderStyle.width / 2; const y1 = points[3].y + this.borderStyle.width / 2; const xMid = x0 + (x1 - x0) / 2; const yMid = y0 + (y1 - y0) / 2; const xOffset = ((x1 - x0) / 2) * controlPointsDistance; const yOffset = ((y1 - y0) / 2) * controlPointsDistance; buffer.push(`${xMid} ${y1} m`); buffer.push( `${xMid + xOffset} ${y1} ${x1} ${yMid + yOffset} ${x1} ${yMid} c` ); buffer.push( `${x1} ${yMid - yOffset} ${xMid + xOffset} ${y0} ${xMid} ${y0} c` ); buffer.push( `${xMid - xOffset} ${y0} ${x0} ${yMid - yOffset} ${x0} ${yMid} c` ); buffer.push( `${x0} ${yMid + yOffset} ${xMid - xOffset} ${y1} ${xMid} ${y1} c` ); buffer.push("h"); if (fillColor) { buffer.push("B"); } else { buffer.push("S"); } return [points[0].x, points[1].x, points[3].y, points[1].y]; }, }); } } } class PolylineAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.POLYLINE; this.data.vertices = []; // The vertices array is an array of numbers representing the alternating // horizontal and vertical coordinates, respectively, of each vertex. // Convert this to an array of objects with x and y coordinates. const rawVertices = parameters.dict.getArray("Vertices"); if (!Array.isArray(rawVertices)) { return; } for (let i = 0, ii = rawVertices.length; i < ii; i += 2) { this.data.vertices.push({ x: rawVertices[i], y: rawVertices[i + 1], }); } } } class PolygonAnnotation extends PolylineAnnotation { constructor(parameters) { // Polygons are specific forms of polylines, so reuse their logic. super(parameters); this.data.annotationType = AnnotationType.POLYGON; } } class CaretAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.CARET; } } class InkAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.INK; this.data.inkLists = []; const rawInkLists = parameters.dict.getArray("InkList"); if (!Array.isArray(rawInkLists)) { return; } const xref = parameters.xref; for (let i = 0, ii = rawInkLists.length; i < ii; ++i) { // The raw ink lists array contains arrays of numbers representing // the alternating horizontal and vertical coordinates, respectively, // of each vertex. Convert this to an array of objects with x and y // coordinates. this.data.inkLists.push([]); for (let j = 0, jj = rawInkLists[i].length; j < jj; j += 2) { this.data.inkLists[i].push({ x: xref.fetchIfRef(rawInkLists[i][j]), y: xref.fetchIfRef(rawInkLists[i][j + 1]), }); } } } } class HighlightAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.HIGHLIGHT; const quadPoints = (this.data.quadPoints = getQuadPoints( parameters.dict, null )); if (quadPoints) { if (!this.appearance) { // Default color is yellow in Acrobat Reader const fillColor = this.color ? Array.from(this.color).map(c => c / 255) : [1, 1, 0]; this._setDefaultAppearance({ xref: parameters.xref, fillColor, blendMode: "Multiply", pointsCallback: (buffer, points) => { buffer.push(`${points[0].x} ${points[0].y} m`); buffer.push(`${points[1].x} ${points[1].y} l`); buffer.push(`${points[3].x} ${points[3].y} l`); buffer.push(`${points[2].x} ${points[2].y} l`); buffer.push("f"); return [points[0].x, points[1].x, points[3].y, points[1].y]; }, }); } } else { this.data.hasPopup = false; } } } class UnderlineAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.UNDERLINE; const quadPoints = (this.data.quadPoints = getQuadPoints( parameters.dict, null )); if (quadPoints) { if (!this.appearance) { // Default color is black const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; this._setDefaultAppearance({ xref: parameters.xref, extra: "[] 0 d 1 w", strokeColor, pointsCallback: (buffer, points) => { buffer.push(`${points[2].x} ${points[2].y} m`); buffer.push(`${points[3].x} ${points[3].y} l`); buffer.push("S"); return [points[0].x, points[1].x, points[3].y, points[1].y]; }, }); } } else { this.data.hasPopup = false; } } } class SquigglyAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.SQUIGGLY; const quadPoints = (this.data.quadPoints = getQuadPoints( parameters.dict, null )); if (quadPoints) { if (!this.appearance) { // Default color is black const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; this._setDefaultAppearance({ xref: parameters.xref, extra: "[] 0 d 1 w", strokeColor, pointsCallback: (buffer, points) => { const dy = (points[0].y - points[2].y) / 6; let shift = dy; let x = points[2].x; const y = points[2].y; const xEnd = points[3].x; buffer.push(`${x} ${y + shift} m`); do { x += 2; shift = shift === 0 ? dy : 0; buffer.push(`${x} ${y + shift} l`); } while (x < xEnd); buffer.push("S"); return [points[2].x, xEnd, y - 2 * dy, y + 2 * dy]; }, }); } } else { this.data.hasPopup = false; } } } class StrikeOutAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.STRIKEOUT; const quadPoints = (this.data.quadPoints = getQuadPoints( parameters.dict, null )); if (quadPoints) { if (!this.appearance) { // Default color is black const strokeColor = this.color ? Array.from(this.color).map(c => c / 255) : [0, 0, 0]; this._setDefaultAppearance({ xref: parameters.xref, extra: "[] 0 d 1 w", strokeColor, pointsCallback: (buffer, points) => { buffer.push( `${(points[0].x + points[2].x) / 2}` + ` ${(points[0].y + points[2].y) / 2} m` ); buffer.push( `${(points[1].x + points[3].x) / 2}` + ` ${(points[1].y + points[3].y) / 2} l` ); buffer.push("S"); return [points[0].x, points[1].x, points[3].y, points[1].y]; }, }); } } else { this.data.hasPopup = false; } } } class StampAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); this.data.annotationType = AnnotationType.STAMP; } } class FileAttachmentAnnotation extends MarkupAnnotation { constructor(parameters) { super(parameters); const file = new FileSpec(parameters.dict.get("FS"), parameters.xref); this.data.annotationType = AnnotationType.FILEATTACHMENT; this.data.file = file.serializable; } } export { Annotation, AnnotationBorderStyle, AnnotationFactory, getQuadPoints, MarkupAnnotation, };