AddInkAnnotation

annotationها و hotspot linkها

توضیحات

حاشیه‌نویسی نشانه‌گذاری جوهر (یعنی PDF /Subtype /Ink) را بازنمایی‌کنندهٔ یک یا چند خط دست‌نویس، نشانهٔ آزاد یا اسکچ دست‌آزاد رسم‌شده روی صفحه اضافه می‌کند. مدخل دیکشنری /InkList آرایه‌ای از خطوط را دارد؛ هر خط آرایه‌ای از مختصات متناوب x/y است که مسیر پیموده‌شده توسط دستگاه اشاره‌گر بین رخدادهای پایین‌آمدن قلم و بالا آمدن قلم را بازنمایی می‌کند. مؤلفه‌های رنگ و کدری در مقیاس 0–1 بیان می‌شوند؛ Transparency در مقیاس 0–100 داده می‌شود (0 = کاملاً مات، 100 = کاملاً شفاف). چون این نقطهٔ ورود کلید کدری حاشیه‌نویسی /CA مربوط به PDF 1.4 را صادر می‌کند، کتابخانه اسناد پایین‌ترِ قفل‌نشده را پیش از ذخیره به 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 — یک یا چند stroke که به‌صورت یک رشته واحد encode شده‌اند. strokeها با '|' یا با newline (CR / LF / CRLF) از هم جدا می‌شوند. داخل هر stroke، جفت‌های مختصات از همان قرارداد delimiter مانند AddPolygonAnnotation استفاده می‌کنند: مقدارهای x/y یکی‌درمیان با space، comma، semicolon یا tab از هم جدا می‌شوند. نمونه: "100 100 110 105 120 110 | 200 200 210 205" دو stroke جداگانه را توصیف می‌کند. هر stroke باید دست‌کم دو جفت مختصات (چهار عدد) و تعداد کل زوجی از مقدارها داشته باشد؛ در غیر این صورت فراخوانی 0 برمی‌گرداند

BorderWidth — عرض خط جوهر، در واحدهای جاری

InkRed، InkGreen، InkBlue — مؤلفه‌های RGB (0–1) رنگ جوهر، که در /C نوشته می‌شوند

Title — نام نویسنده‌ای که در مدخل /T حاشیه‌نویسی نوشته می‌شود؛ برای رد کردن، رشتهٔ خالی بدهید

Contents — متن پاپ‌آپ مرتبط با حاشیه‌نویسی؛ برای رد کردن، رشتهٔ خالی بدهید

Transparency — میزان کدری بر حسب درصد شفافیت (0–100)؛ کتابخانه این مقدار را به /CA = 1 - Transparency/100 در PDF تبدیل و به بازه مقید می‌کند

مقدار بازگشتی

در صورت موفقیت 1، و 0 اگر سندی انتخاب نشده باشد، رشتهٔ ink قابل تجزیه به فهرست خط معتبر نباشد یا حاشیه‌نویسی قابل ایجاد نباشد

ملاحظات

مدخل /Rect حاشیه‌نویسی به‌طور خودکار از وسع مجموع همهٔ خطوط به‌علاوهٔ لایی کوچکی متناسب با عرض قاب محاسبه می‌شود تا خطوط رندرشده درون کادر محاطی حاشیه‌نویسی بمانند

این نقطهٔ ورود هم برای دست‌نویس دیجیتالی‌شده ثبت‌شده از دستگاه لمسی / قلم و هم برای شکل‌های دست‌آزاد برنامه‌نویسی‌شده مانند امضاهای خط‌خطی‌شده یا حاشیه‌نویسی‌های واردشده از ابزارهای دیگر مناسب است. برای بازنویسی رنگ جوهر، قاب، محتوا یا مستطیل پس از ساخت از SetAnnotBorderColor، SetAnnotBorderStyle، SetAnnotContents و SetAnnotRect استفاده کنید