AddInkAnnotation

Anotaciones y enlaces de zona activa

Descripción

Añade una anotación de marcado a tinta (PDF /Subtype /Ink) que representa uno o varios trazos manuscritos, marcas de forma libre o bocetos a mano alzada dibujados en la página. La entrada /InkList del diccionario contiene una matriz de trazos; cada trazo es una matriz de coordenadas x/y alternas que representa el recorrido de un dispositivo señalador entre los eventos de apoyar y levantar el lápiz. Los componentes de color y la opacidad se expresan en una escala de 0–1; Transparency se indica en una escala de 0–100 (0 = totalmente opaco, 100 = totalmente transparente). Como este punto de entrada emite la clave de opacidad /CA de anotaciones PDF 1.4, la biblioteca eleva los documentos inferiores no bloqueados a PDF 1.4 antes de guardarlos; la puerta de compatibilidad rechaza los destinos inferiores bloqueados. Se define 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 — Trazos en una cadena separados por '|' o salto. Dentro usan pares x/y como AddPolygonAnnotation. "100 100 110 105 120 110 | 200 200 210 205" son dos trazos. Cada uno requiere dos pares y total par; si no, devuelve 0

BorderWidth — Anchura del trazo de la tinta, en las unidades actuales

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

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

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

Transparency — Opacidad expresada como porcentaje de transparencia (0–100). La biblioteca la convierte en PDF /CA = 1 - Transparency/100 y la limita al intervalo

Valor devuelto

1 si la operación se realiza correctamente; 0 si no hay ningún documento seleccionado, la cadena de tinta no se puede analizar 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 a la anchura del borde, para que los trazos renderizados permanezcan dentro del cuadro delimitador

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