AddInkAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de tinta (PDF /Subtype /Ink) que representa uno o más trazos manuscritos, marcas de forma libre o bocetos a mano alzada dibujados en la página. La entrada de diccionario /InkList contiene una matriz de trazos; cada trazo es una matriz de coordenadas x/y alternadas que representan el recorrido trazado por un dispositivo apuntador entre los eventos de bajar y levantar el lápiz. Los componentes de color y la opacidad se expresan en una escala de 0–1; Transparency se proporciona en una escala de 0–100 (0 = completamente opaco, 100 = completamente transparente). Dado que este punto de entrada emite la clave de opacidad /CA de anotación PDF 1.4, la biblioteca eleva a PDF 1.4 los documentos inferiores no bloqueados antes de guardar; los destinos inferiores bloqueados se rechazan en la compuerta de compatibilidad. Definido en ISO 32000-1 §12.5.6.13

Sintaxis

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parámetros

InkPaths — uno o más trazos codificados como una sola cadena Los trazos se separan mediante '|' o una nueva línea (CR / LF / CRLF) Dentro de cada trazo, los pares de coordenadas usan la misma convención de delimitadores que AddPolygonAnnotation: valores x/y alternados separados por espacios, comas, puntos y comas o tabulaciones Ejemplo: "100 100 110 105 120 110 | 200 200 210 205" describe dos trazos independientes Cada trazo debe contener al menos dos pares de coordenadas (cuatro números) y un número total par de valores; de lo contrario, la llamada devuelve 0

BorderWidth — Ancho de trazo de la tinta, en las unidades actuales

InkRed, InkGreen, InkBlue — componentes RGB (0–1) del color de tinta, escritos en /C

Título — Nombre del autor escrito en la entrada /T de la anotación's. Pase una cadena vacía para omitirlo

Contents — Cuerpo de la ventana emergente asociada con la anotación. Pase una cadena vacía para omitir

Transparencia — Opacidad expresada como porcentaje transparente (0–100) La biblioteca convierte esto a PDF /CA = 1 - Transparencia/100 y lo limita al intervalo

Valor devuelto

1 si se realiza correctamente, 0 si no se seleccionó ningún documento, la cadena de tinta no se analiza como una lista de trazos válida o no se pudo crear la anotación

Observaciones

El /Rect de la anotación se calcula automáticamente a partir de la extensión combinada de todos los trazos, más un pequeño relleno proporcional al ancho del borde, para que los trazos renderizados permanezcan dentro del cuadro delimitador de la anotación

Este punto de entrada es adecuado tanto para escritura a mano digitalizada capturada desde un dispositivo táctil o lápiz como para formas de trazo libre programáticas, como firmas garabateadas o anotaciones importadas de otras herramientas. Para sobrescribir el color de tinta, borde, contenido o rectángulo después de crearlo, use SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents y SetAnnotRect