AddInkAnnotation

주석 및 핫스폿 링크

설명

페이지에 그린 하나 이상의 손글씨 획, 자유형 표시 또는 프리핸드 스케치를 나타내는 잉크 마크업 주석(PDF /Subtype /Ink)을 추가합니다. /InkList 사전 항목에는 획 배열이 포함되며 각 획은 펜 누름과 펜 떼기 이벤트 사이에서 포인팅 장치가 지나간 경로를 나타내는 x/y 좌표의 교대 배열입니다. 색상 성분과 불투명도는 0–1 척도로 표현되며 Transparency는 0–100 척도로 지정됩니다(0 = 완전 불투명, 100 = 완전 투명). 이 진입점은 PDF 1.4 주석 /CA 불투명도 키를 출력하므로 라이브러리는 잠기지 않은 하위 문서를 저장 전에 PDF 1.4로 올립니다. 잠긴 하위 대상은 호환성 관문에서 거부됩니다. ISO 32000-1 §12.5.6.13에 정의되어 있습니다

구문

Delphi

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

매개변수

InkPaths — 단일 문자열로 인코딩된 하나 이상의 스트로크입니다. 스트로크는 '|' 또는 줄바꿈(CR / LF / CRLF)으로 구분합니다. 각 스트로크 안에서 좌표 쌍은 AddPolygonAnnotation과 같은 구분 기호 규칙을 사용하며 공백, 쉼표, 세미콜론 또는 탭으로 구분된 x/y 값을 번갈아 지정합니다. 예: "100 100 110 105 120 110 | 200 200 210 205"는 별도의 스트로크 두 개를 나타냅니다. 각 스트로크에는 좌표 쌍이 두 개 이상(숫자 네 개) 있어야 하고 전체 값 수가 짝수여야 하며, 그렇지 않으면 호출이 0을 반환합니다

BorderWidth — 현재 단위로 잉크의 스트로크 너비

InkRed, InkGreen, InkBlue — /C에 기록되는 잉크 색상의 RGB 성분(0–1)

Title — 주석'의 /T 항목에 기록되는 작성자 이름입니다. 건너뛰려면 빈 문자열을 전달합니다

Contents — 주석과 연결된 팝업의 본문입니다. 건너뛰려면 빈 문자열을 전달합니다

투명도 — 투명한 비율(0–100)로 나타낸 불투명도입니다 라이브러리는 이를 PDF /CA = 1 - Transparency/100으로 변환하고 범위 내로 제한합니다

반환 값

성공하면 1, 문서를 선택하지 않았거나 잉크 문자열을 유효한 스트로크 목록으로 구문 분석할 수 없거나 주석을 생성할 수 없으면 0

비고

렌더링된 획이 주석 경계 상자 안에 유지되도록 모든 획의 결합 범위에 테두리 너비에 비례하는 작은 여백을 더하여 주석 /Rect를 자동 계산합니다

이 진입점은 터치/펜 장치에서 캡처한 디지털 손글씨와 낙서 서명이나 다른 도구에서 가져온 주석 같은 프로그래밍 방식의 자유형 도형 모두에 적합합니다. 생성 후 잉크 색상, 테두리, 콘텐츠 또는 사각형을 바꾸려면 SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents 및 SetAnnotRect를 사용하십시오