تبدیل آفین
AffineTransform از یک ماتریس ۳x۳ با سطر آخر ضمنی [0 0 1] برای تبدیل مختصات مبدا (x,y) به مختصات مقصد (x', y') طبق رابطه زیر استفاده میکند:
[ x'] [ scaleX shearX translateX ] [ x ]
[ y'] = [ shearY scaleY translateY ] [ y ]
[ 1 ] [ 0 0 1 ] [ 1 ]
پس از تحول،
x' = scaleX * x + shearX * y + translateX;
y' = scaleY * y + shearY * x + translateY;
بنابراین، این پیام از این شش عنصر ماتریسی تشکیل شده است.
| نمایش JSON |
|---|
{
"scaleX": number,
"scaleY": number,
"shearX": number,
"shearY": number,
"translateX": number,
"translateY": number,
"unit": enum ( |
| فیلدها | |
|---|---|
scaleX | عنصر مقیاسبندی مختصات X. |
scaleY | عنصر مقیاسبندی مختصات Y. |
shearX | المان برشی مختصات X. |
shearY | عنصر برشی مختصات Y. |
translateX | عنصر انتقال مختصات X. |
translateY | عنصر انتقال مختصات Y. |
unit | واحدهای مربوط به ترجمه عناصر. |
رنگ مات
یک مقدار رنگ ثابت با قابلیت تمبندی.
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
فیلد Union kind . نوع مقدار رنگ. kind فقط میتواند یکی از موارد زیر باشد: | |
rgbColor | یک رنگ RGB مات. |
themeColor | یک رنگ تم مات. |
رنگ RGB
یک رنگ RGB.
| نمایش JSON |
|---|
{ "red": number, "green": number, "blue": number } |
| فیلدها | |
|---|---|
red | جزء قرمز رنگ، از ۰.۰ تا ۱.۰. |
green | جزء سبز رنگ، از ۰.۰ تا ۱.۰. |
blue | جزء آبی رنگ، از ۰.۰ تا ۱.۰. |
نوع رنگ قالب
انواع رنگهای تم
PageProperties حاوی یک ColorScheme است که نگاشت این انواع رنگ تم را به رنگهای مشخص تعریف میکند.
| انومها | |
|---|---|
THEME_COLOR_TYPE_UNSPECIFIED | رنگ قالب نامشخص. این مقدار نباید استفاده شود. |
DARK1 | اولین رنگ تیره را نشان میدهد. |
LIGHT1 | اولین رنگ روشن را نشان میدهد. |
DARK2 | نشان دهنده دومین رنگ تیره است. |
LIGHT2 | نشان دهنده رنگ نور دوم است. |
ACCENT1 | اولین رنگ تاکیدی را نشان میدهد. |
ACCENT2 | نشان دهنده دومین رنگ تاکیدی است. |
ACCENT3 | نشان دهنده سومین رنگ تاکیدی است. |
ACCENT4 | چهارمین رنگ تاکیدی را نشان میدهد. |
ACCENT5 | نشان دهنده پنجمین رنگ تاکیدی است. |
ACCENT6 | نشان دهنده ششمین رنگ تاکیدی است. |
HYPERLINK | رنگی را که برای هایپرلینکها استفاده میشود، نشان میدهد. |
FOLLOWED_HYPERLINK | رنگی را که برای لینکهای بازدید شده استفاده میشود، نشان میدهد. |
TEXT1 | اولین رنگ متن را نشان میدهد. |
BACKGROUND1 | اولین رنگ پس زمینه را نشان میدهد. |
TEXT2 | رنگ دوم متن را نشان میدهد. |
BACKGROUND2 | نشان دهنده رنگ پس زمینه دوم است. |
پیوند
یک پیوند فرامتنی.
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
فیلد Union kind . انواع لینکها. kind میتواند فقط یکی از موارد زیر باشد: | |
url | اگر تنظیم شود، نشان میدهد که این یک پیوند به صفحه وب خارجی در این URL است. |
relativeLink | اگر تنظیم شده باشد، نشان میدهد که این یک پیوند به اسلایدی در این ارائه است که توسط موقعیت آن آدرسدهی شده است. |
pageObjectId | اگر تنظیم شود، نشان میدهد که این یک پیوند به صفحه خاص در این ارائه با این شناسه است. ممکن است صفحهای با این شناسه وجود نداشته باشد. |
slideIndex | اگر تنظیم شود، نشان میدهد که این یک پیوند به اسلاید در این شاخص مبتنی بر صفر در ارائه است. ممکن است اسلایدی در این شاخص وجود نداشته باشد. |
لینک اسلاید نسبی
انواع پیوندهای نسبی
| انومها | |
|---|---|
RELATIVE_SLIDE_LINK_UNSPECIFIED | یک پیوند اسلاید نسبی نامشخص. |
NEXT_SLIDE | لینک به اسلاید بعدی. |
PREVIOUS_SLIDE | لینک به اسلاید قبلی. |
FIRST_SLIDE | پیوندی به اولین اسلاید در ارائه. |
LAST_SLIDE | پیوندی به آخرین اسلاید در ارائه. |
املاک و مستغلات
حالتهای ممکن یک ویژگی.
| انومها | |
|---|---|
RENDERED | اگر وضعیت یک ویژگی RENDERED باشد، آنگاه عنصر هنگام رندر شدن در صفحه، ویژگی مربوطه را دارد. اگر عنصر یک شکل placeholder باشد که توسط فیلد placeholder تعیین میشود و از یک شکل placeholder ارثبری میکند، ممکن است فیلد مربوطه تنظیم نشده باشد، به این معنی که مقدار ویژگی از یک placeholder والد به ارث برده میشود. اگر عنصر ارثبری نکند، فیلد حاوی مقدار رندر شده خواهد بود. این مقدار پیشفرض است. |
NOT_RENDERED | اگر وضعیت یک ویژگی NOT_RENDERED باشد، آنگاه عنصر هنگام رندر شدن در صفحه، ویژگی مربوطه را ندارد. با این حال، میتوان فیلد را همچنان تنظیم کرد تا بتواند توسط اشکال فرزند به ارث برده شود. برای حذف یک ویژگی از یک عنصر رندر شده، وضعیت ویژگی آن را روی NOT_RENDERED تنظیم کنید. |
INHERIT | اگر وضعیت یک ویژگی INHERIT باشد، آنگاه وضعیت ویژگی از مقدار فیلد propertyState مربوطه در شکل والد استفاده میکند. عناصری که ارث نمیبرند، هرگز وضعیت ویژگی INHERIT نخواهند داشت. |
پر کردن جامد
یک رنگ ثابت. صفحه یا عنصر صفحه به طور کامل با مقدار رنگ مشخص شده پر میشود.
اگر فیلدی تنظیم نشده باشد، مقدار آن میتواند از یک متغیر والد (در صورت وجود) به ارث برده شود.
| نمایش JSON |
|---|
{
"color": {
object ( |
| فیلدها | |
|---|---|
color | مقدار رنگ پرکنندهی جامد. |
alpha | کسری از این رنگ پیکسل = آلفا * (رنگ) + (1.0 - آلفا) * (رنگ پس زمینه) این یعنی مقدار ۱.۰ مربوط به یک رنگ ثابت است، در حالی که مقدار ۰.۰ مربوط به یک رنگ کاملاً شفاف است. |
طرح کلی
طرح کلی یک PageElement .
اگر این فیلدها تنظیم نشده باشند، در صورت وجود، میتوانند از یک متغیر والد به ارث برده شوند. اگر والد وجود نداشته باشد، فیلدها به طور پیشفرض به مقداری که برای عناصر صفحه جدید ایجاد شده در ویرایشگر اسلایدها استفاده میشود، وابسته خواهند بود، که ممکن است به نوع عنصر صفحه بستگی داشته باشد.
| نمایش JSON |
|---|
{ "outlineFill": { object ( |
| فیلدها | |
|---|---|
outlineFill | پر کردن طرح کلی. |
weight | ضخامت طرح کلی. |
dashStyle | سبک خط تیره طرح کلی. |
propertyState | وضعیت ویژگی outline. بهروزرسانی outline در یک عنصر صفحه، بهطور ضمنی این فیلد را به |
پر کردن طرح کلی
پر کردن طرح کلی.
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
kind فیلد Union. نوع پر کردن رئوس مطالب. kind میتواند فقط یکی از موارد زیر باشد: | |
solidFill | پر کردن با رنگ ثابت. |
استایل دَش
انواع خط تیرههایی که هندسه خطی را میتوان با آنها نمایش داد. این مقادیر بر اساس نوع ساده "ST_PresetLineDashVal" هستند که در بخش 20.1.10.49 از "قالبهای فایل XML باز آفیس - اصول و مرجع زبان نشانهگذاری"، بخش 1 از ECMA-376 ویرایش پنجم، توضیح داده شده است.
| انومها | |
|---|---|
DASH_STYLE_UNSPECIFIED | سبک خط تیره نامشخص. |
SOLID | خط ممتد. مربوط به مقدار 'solid' در استاندارد ECMA-376 ST_PresetLineDashVal است. این سبک خط تیره پیشفرض است. |
DOT | خط نقطهچین. مربوط به مقدار 'نقطه' در استاندارد ECMA-376 ST_PresetLineDashVal است. |
DASH | خط چین. مربوط به مقدار 'dash' در استاندارد ECMA-376 ST_PresetLineDashVal است. |
DASH_DOT | خط تیره و نقطه متناوب. مربوط به مقدار 'dashDot' در استاندارد ECMA-376 ST_PresetLineDashVal است. |
LONG_DASH | خط با خط تیره بزرگ. مربوط به مقدار 'lgDash' در استاندارد ECMA-376 ST_PresetLineDashVal است. |
LONG_DASH_DOT | خط تیره و نقطههای بزرگ متناوب. مربوط به مقدار 'lgDashDot' در استاندارد ECMA-376 ST_PresetLineDashVal است. |
سایه
ویژگیهای سایه یک عنصر صفحه.
اگر این فیلدها تنظیم نشده باشند، در صورت وجود، میتوانند از یک متغیر والد به ارث برده شوند. اگر والد وجود نداشته باشد، فیلدها به طور پیشفرض به مقداری که برای عناصر صفحه جدید ایجاد شده در ویرایشگر اسلایدها استفاده میشود، وابسته خواهند بود، که ممکن است به نوع عنصر صفحه بستگی داشته باشد.
| نمایش JSON |
|---|
{ "type": enum ( |
| فیلدها | |
|---|---|
type | نوع سایه. این ویژگی فقط خواندنی است. |
transform | تبدیلی که جابجایی، مقیاس و کجی سایه را نسبت به موقعیت ترازبندی کدگذاری میکند. |
alignment | نقطه تراز سایه، که مبدا انتقال، مقیاس و کجی سایه را تعیین میکند. این ویژگی فقط خواندنی است. |
blurRadius | شعاع تاری سایه. هرچه شعاع بزرگتر باشد، سایه پراکندهتر میشود. |
color | مقدار رنگ سایه. |
alpha | آلفای رنگ سایه، از ۰.۰ تا ۱.۰. |
rotateWithShape | اینکه آیا سایه باید با شکل بچرخد یا خیر. این ویژگی فقط خواندنی است. |
propertyState | وضعیت ویژگی سایه. بهروزرسانی سایه روی یک عنصر صفحه، بهطور ضمنی این فیلد را به |
نوع
انواع سایه.
| انومها | |
|---|---|
SHADOW_TYPE_UNSPECIFIED | نوع سایه نامشخص. |
OUTER | سایه بیرونی. |
موقعیت مستطیل
موقعیتهای مرجع را در یک مستطیل تعریف میکند.
| انومها | |
|---|---|
RECTANGLE_POSITION_UNSPECIFIED | نامشخص. |
TOP_LEFT | بالا سمت چپ. |
TOP_CENTER | مرکز بالا. |
TOP_RIGHT | بالا سمت راست. |
LEFT_CENTER | مرکز چپ. |
CENTER | مرکز. |
RIGHT_CENTER | مرکز سمت راست. |
BOTTOM_LEFT | پایین سمت چپ. |
BOTTOM_CENTER | مرکز پایین. |
BOTTOM_RIGHT | پایین سمت راست. |
ترازبندی محتوا
انواع ترازبندی محتوا
مشتق شده از زیرمجموعهای از مقادیر نوع ساده "ST_TextAnchoringType" در بخش 20.1.10.60 از "قالبهای فایل XML باز آفیس - اصول و مرجع زبان نشانهگذاری"، بخش 1 از ECMA-376 ویرایش پنجم .
| انومها | |
|---|---|
CONTENT_ALIGNMENT_UNSPECIFIED | ترازبندی محتوا نامشخص. ترازبندی محتوا در صورت وجود از والد به ارث میرسد. |
CONTENT_ALIGNMENT_UNSUPPORTED | ترازبندی محتوای پشتیبانی نشده. |
TOP | ترازبندیای که محتوا را در بالای نگهدارنده محتوا تراز میکند. مربوط به ECMA-376 ST_TextAnchoringType 't' است. |
MIDDLE | ترازبندیای که محتوا را در وسط نگهدارنده محتوا تراز میکند. مربوط به ECMA-376 ST_TextAnchoringType 'ctr' است. |
BOTTOM | ترازبندیای که محتوا را در پایین نگهدارنده محتوا تراز میکند. مربوط به ECMA-376 ST_TextAnchoringType 'b' است. |
جایگذار
اطلاعات جایگذاری که به طور منحصر به فرد یک شکل جایگذاری را مشخص میکند.
| نمایش JSON |
|---|
{
"type": enum ( |
| فیلدها | |
|---|---|
type | نوع نگهدارندهی مکان. |
index | اندیس مربوط به placeholder. اگر انواع یکسانی از placeholder در یک صفحه وجود داشته باشند، مقادیر اندیس متفاوتی خواهند داشت. |
parentObjectId | شناسه شیءِ جاینگهدار والد این شکل. اگر تنظیم نشود، شکل جاینگهدار والد وجود ندارد، بنابراین شکل ویژگیهای هیچ شکل دیگری را به ارث نمیبرد. |
نوع
نوع شکل حفره یا سوراخ.
بسیاری از این انواع جانگهدار با شناسههای جانگهدار از استاندارد ECMA-376 مطابقت دارند. برای اطلاعات بیشتر، به توضیحات نوع "ST_PlaceholderType" در بخش 19.7.10 از "قالبهای فایل XML باز آفیس - اصول و مرجع زبان نشانهگذاری"، بخش 1 از ECMA-376 ویرایش پنجم مراجعه کنید.
| انومها | |
|---|---|
NONE | مقدار پیشفرض، نشان میدهد که یک placeholder نیست. |
BODY | متن بدنه. |
CHART | نمودار یا گراف. |
CLIP_ART | تصویر کلیپ آرت. |
CENTERED_TITLE | عنوان در مرکز قرار گرفته است. |
DIAGRAM | نمودار. |
DATE_AND_TIME | تاریخ و زمان. |
FOOTER | متن پاورقی. |
HEADER | متن سربرگ. |
MEDIA | چندرسانهای. |
OBJECT | هر نوع محتوایی. |
PICTURE | تصویر. |
SLIDE_NUMBER | شماره اسلاید. |
SUBTITLE | زیرنویس. |
TABLE | میز. |
TITLE | عنوان اسلاید. |
SLIDE_IMAGE | تصویر اسلاید. |
ویژگیهای تصویر
ویژگیهای Image .
| نمایش JSON |
|---|
{ "cropProperties": { object ( |
| فیلدها | |
|---|---|
cropProperties | ویژگیهای برش تصویر. اگر تنظیم نشده باشد، تصویر برش داده نمیشود. این ویژگی فقط خواندنی است. |
transparency | اثر شفافیت تصویر. مقدار باید در بازه [0.0، 1.0] باشد، که در آن 0 به معنی بدون اثر و 1 به معنی کاملاً شفاف است. این ویژگی فقط خواندنی است. |
brightness | اثر روشنایی تصویر. مقدار باید در بازه [-1.0، 1.0] باشد، که در آن 0 به معنای بدون اثر است. این ویژگی فقط خواندنی است. |
contrast | اثر کنتراست تصویر. مقدار باید در بازه [-1.0، 1.0] باشد، که در آن 0 به معنای بدون اثر است. این ویژگی فقط خواندنی است. |
recolor | جلوه تغییر رنگ تصویر. اگر تنظیم نشود، تصویر تغییر رنگ نمیدهد. این ویژگی فقط خواندنی است. |
outline | طرح کلی تصویر. اگر تنظیم نشده باشد، تصویر هیچ طرح کلی ندارد. |
shadow | سایه تصویر. اگر تنظیم نشود، تصویر سایه ندارد. این ویژگی فقط خواندنی است. |
link | مقصد هایپرلینک تصویر. اگر تنظیم نشده باشد، هیچ پیوندی وجود ندارد. |
خواص محصول
ویژگیهای برش یک شیء که در یک ظرف قرار دارد. به عنوان مثال، یک Image .
ویژگیهای برش با جابجایی چهار لبه که یک مستطیل برش را تعریف میکنند، نشان داده میشود. جابجاییها به صورت درصدی از لبههای متناظر مستطیل مرزی اصلی شیء به سمت داخل، نسبت به ابعاد اصلی شیء، اندازهگیری میشوند.
- اگر انحراف در بازه (0، 1) باشد، لبه متناظر مستطیل برش در داخل مستطیل محدودکننده اصلی شیء قرار میگیرد.
- اگر مقدار انحراف منفی یا بزرگتر از ۱ باشد، لبهی مربوط به مستطیل برش، خارج از مستطیل محدودکنندهی اصلی شیء قرار میگیرد.
- اگر لبه چپ مستطیل برش روی سمت راست لبه راست آن باشد، شیء به صورت افقی وارونه میشود.
- اگر لبه بالایی مستطیل برش زیر لبه پایینی آن باشد، شیء به صورت عمودی وارونه میشود.
- اگر همه انحرافات و زاویه چرخش ۰ باشد، شیء برش داده نمیشود.
پس از برش، محتوای موجود در مستطیل برش کشیده میشود تا در ظرف خود جای گیرد.
| نمایش JSON |
|---|
{ "leftOffset": number, "rightOffset": number, "topOffset": number, "bottomOffset": number, "angle": number } |
| فیلدها | |
|---|---|
leftOffset | آفست، لبه چپ مستطیل برش را که در سمت راست لبه چپ مستطیل مرزی اصلی قرار دارد، نسبت به عرض اصلی شیء، مشخص میکند. |
rightOffset | مقدار offset، لبه سمت راست مستطیل برش را که در سمت چپ لبه سمت راست مستطیل مرزی اصلی قرار دارد، نسبت به عرض اصلی شیء، مشخص میکند. |
topOffset | آفست، لبه بالایی مستطیل برش را که در زیر لبه بالایی مستطیل مرزی اصلی قرار دارد، نسبت به ارتفاع اصلی شیء، مشخص میکند. |
bottomOffset | آفست، لبه پایینی مستطیل برش را که بالاتر از لبه پایینی مستطیل مرزی اصلی قرار دارد، نسبت به ارتفاع اصلی شیء، مشخص میکند. |
angle | زاویه چرخش پنجره برش حول مرکز آن، بر حسب رادیان. زاویه چرخش پس از افست اعمال میشود. |
رنگآمیزی مجدد
یک افکت تغییر رنگ که روی یک تصویر اعمال میشود.
| نمایش JSON |
|---|
{ "recolorStops": [ { object ( |
| فیلدها | |
|---|---|
recolorStops[] | افکت تغییر رنگ توسط یک گرادیان نمایش داده میشود که لیستی از نقاط رنگی است. رنگهای موجود در گرادیان، جایگزین رنگهای متناظر در همان موقعیت در پالت رنگ شده و روی تصویر اعمال میشوند. این ویژگی فقط خواندنی است. |
name | نام اثر تغییر رنگ. این نام از |
رنگبند
یک رنگ و موقعیت در یک نوار گرادیان.
| نمایش JSON |
|---|
{
"color": {
object ( |
| فیلدها | |
|---|---|
color | رنگ نقطهی توقف گرادیان. |
alpha | مقدار آلفای این رنگ در نوار گرادیان. پیشفرض ۱.۰، کاملاً مات. |
position | موقعیت نسبی نقطه رنگی در نوار گرادیان که بر حسب درصد اندازهگیری میشود. مقدار باید در بازه [0.0، 1.0] باشد. |
نام
نامهای افکت رنگآمیزی مجدد.
| انومها | |
|---|---|
NONE | بدون افکت تغییر رنگ. مقدار پیشفرض. |
LIGHT1 | یک افکت تغییر رنگ که تصویر را با استفاده از اولین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT2 | یک افکت تغییر رنگ که تصویر را با استفاده از دومین رنگ موجود در طرح رنگی صفحه، روشنتر میکند. |
LIGHT3 | یک افکت تغییر رنگ که با استفاده از سومین رنگ موجود در طرح رنگ صفحه، تصویر را روشنتر میکند. |
LIGHT4 | یک افکت تغییر رنگ که تصویر را با استفاده از چهارمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT5 | یک افکت تغییر رنگ که تصویر را با استفاده از پنجمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT6 | یک افکت تغییر رنگ که تصویر را با استفاده از ششمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT7 | یک افکت تغییر رنگ که تصویر را با استفاده از هفتمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT8 | یک افکت تغییر رنگ که تصویر را با استفاده از هشتمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT9 | یک افکت تغییر رنگ که تصویر را با استفاده از نهمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
LIGHT10 | یک افکت تغییر رنگ که تصویر را با استفاده از دهمین رنگ موجود در طرح رنگ صفحه، روشنتر میکند. |
DARK1 | یک افکت تغییر رنگ که تصویر را با استفاده از اولین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK2 | یک افکت تغییر رنگ که با استفاده از دومین رنگ موجود در طرح رنگ صفحه، تصویر را تیرهتر میکند. |
DARK3 | یک افکت تغییر رنگ که تصویر را با استفاده از سومین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK4 | یک افکت تغییر رنگ که تصویر را با استفاده از چهارمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK5 | یک افکت تغییر رنگ که تصویر را با استفاده از پنجمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK6 | یک افکت تغییر رنگ که با استفاده از ششمین رنگ موجود در طرح رنگ صفحه، تصویر را تیرهتر میکند. |
DARK7 | یک افکت تغییر رنگ که تصویر را با استفاده از هفتمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK8 | یک افکت تغییر رنگ که تصویر را با استفاده از هشتمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK9 | یک افکت تغییر رنگ که تصویر را با استفاده از نهمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
DARK10 | یک افکت تغییر رنگ که تصویر را با استفاده از دهمین رنگ موجود در طرح رنگ صفحه، تیرهتر میکند. |
GRAYSCALE | یک افکت تغییر رنگ که تصویر را به حالت خاکستری تغییر رنگ میدهد. |
NEGATIVE | یک افکت تغییر رنگ که تصویر را به حالت خاکستری نگاتیو تغییر رنگ میدهد. |
SEPIA | یک افکت تغییر رنگ که تصویر را با استفاده از رنگ قهوهای (سپیا) تغییر رنگ میدهد. |
CUSTOM | افکت تغییر رنگ سفارشی. برای گرادیان بتن به recolorStops مراجعه کنید. |