AddInkAnnotation

Chú thích và liên kết điểm nóng

Mô tả

Thêm một chú thích markup nét tay (PDF /Subtype /Ink) biểu diễn một hoặc nhiều nét viết tay, nét tự do hay bản phác tay vẽ trên trang. Mục dictionary /InkList chứa một mảng các nét; mỗi nét là một mảng tọa độ x/y xen kẽ biểu diễn đường đi của thiết bị trỏ giữa các sự kiện nhấn bút và nhả bút. Các thành phần màu và độ mờ tính theo thang 0–1; Transparency tính theo thang 0–100 (0 = đặc hoàn toàn, 100 = trong suốt hoàn toàn). Vì entry point này phát khóa độ mờ chú thích /CA của PDF 1.4, thư viện nâng các tài liệu chưa khóa thấp hơn lên PDF 1.4 trước khi lưu; các đích thấp hơn đã bị khóa bị cổng tương thích từ chối. Định nghĩa tại ISO 32000-1 §12.5.6.13

Cú pháp

Delphi

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

Tham số

InkPaths — Một hoặc nhiều nét được encode thành một chuỗi duy nhất. Các nét phân tách bằng '|' hoặc bằng ký tự xuống dòng (CR / LF / CRLF). Trong mỗi nét, các cặp tọa độ dùng cùng quy ước dấu phân tách với AddPolygonAnnotation: các giá trị x/y xen kẽ phân tách bằng khoảng trắng, dấu phẩy, chấm phẩy hay tab. Ví dụ: "100 100 110 105 120 110 | 200 200 210 205" mô tả hai nét riêng biệt. Mỗi nét phải chứa ít nhất hai cặp tọa độ (bốn số) và tổng số giá trị phải chẵn, nếu không lời gọi trả về 0

BorderWidth — Độ rộng nét của nét vẽ tay (ink), theo đơn vị hiện tại

InkRed, InkGreen, InkBlue — Các thành phần RGB (0–1) của màu nét vẽ tay, ghi vào /C

Title — Tên tác giả ghi vào mục /T của chú thích. Truyền chuỗi rỗng để bỏ qua

Contents — Nội dung của popup gắn với chú thích. Truyền chuỗi rỗng để bỏ qua

Transparency — Độ mờ tính theo phần trăm trong suốt (0–100). Thư viện quy đổi thành PDF /CA = 1 - Transparency/100 rồi giới hạn về khoảng hợp lệ

Giá trị trả về

1 khi thành công, 0 nếu không có tài liệu nào đang chọn, chuỗi ink parse không ra danh sách nét hợp lệ, hoặc không tạo được chú thích

Ghi chú

Mục /Rect của chú thích được tính tự động từ phạm vi gộp của mọi nét cộng thêm một phần đệm nhỏ tỷ lệ với độ rộng viền để các nét khi render nằm gọn trong bounding box của chú thích

Entry point này phù hợp cả với nét viết tay đã số hóa bắt từ thiết bị cảm ứng / bút và với các hình vẽ tay lập trình như chữ ký nguệch ngoạc hay chú thích import từ công cụ khác. Muốn ghi đè màu nét, viền, nội dung hay hình chữ nhật sau khi tạo, dùng SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents và SetAnnotRect