ماژول ImageDraw#

ماژول ImageDraw گرافیک 2D ساده را برای اشیاء تصویر فراهم می کند. شما می توانید از این ماژول برای ایجاد تصاویر جدید ، حاشیه نویسی یا retouch تصاویر موجود و تولید گرافیک در پرواز برای استفاده در وب استفاده کنید. برای یک کتابخانه طراحی پیشرفته تر برای PIL ، به ماژول Aggdraw مراجعه کنید.

مثال: یک صلیب خاکستری را روی یک تصویر# بکشید

وارد كردن سید از جانب پیل وارد كردن تصویر, تصویر با تصویر.باز کن("hopper. jpg") as im: قرعه کشی = تصویر.قرعه کشی(im) قرعه کشی.خط((0, 0) + im.اندازه, پر کردن=128) قرعه کشی.خط((0, im.اندازه[1], im.اندازه[0], 0), پر کردن=128) # برای stdout بنویسید im.صرفه جویی(سید.با توجه به, "PNG") 

مفاهیم#

Coordinates#

رابط گرافیکی از همان سیستم مختصات خود PIL ، با (0 ، 0) در گوشه بالا سمت چپ استفاده می کند. هر پیکسل کشیده شده در خارج از مرزهای تصویر دور ریخته می شود.

رنگ#

برای مشخص کردن رنگ ها ، می توانید از اعداد یا tuples درست همانطور که می خواهید با pil. image. new () یا pil. image. image. putpixel () استفاده کنید. برای تصاویر "1" ، "L" و "I" از عدد صحیح استفاده می کنید. برای تصاویر "RGB" ، از یک مقادیر عدد صحیح 3 تاپل استفاده کنید. برای تصاویر "F" ، از مقادیر نقطه عدد صحیح یا شناور استفاده کنید. برای تصاویر پالت (حالت "P") ، از عدد صحیح به عنوان شاخص های رنگ استفاده کنید. در 1. 1. 4 و بعد از آن ، می توانید از RGB 3-Tuples یا نام های رنگی نیز استفاده کنید (به تصویر زیر مراجعه کنید). لایه نقاشی به طور خودکار شاخص های رنگ را اختصاص می دهد ، تا زمانی که با بیش از 256 رنگ ترسیم نکنید.

نام های رنگی#

نام های رنگی را برای نام های رنگی پشتیبانی شده توسط بالش مشاهده کنید.

قلم#

PIL می تواند از فونت های bitmap یا فونت های OpenType/trueType استفاده کند. فونت های Bitmap در قالب PIL ذخیره می شوند ، جایی که هر قلم به طور معمول از دو پرونده تشکیل شده است ، یکی به نام . pil و دیگری که معمولاً نامگذاری شده است . PBM. اولی حاوی معیارهای قلم ، داده های شطرنجی دوم است. برای بارگذاری یک قلم bitmap ، از توابع Load در ماژول ImageFont استفاده کنید. برای بارگیری یک قلم OpenType/TrueType ، از عملکرد TrueType در ماژول ImageFont استفاده کنید. توجه داشته باشید که این عملکرد به کتابخانه های شخص ثالث بستگی دارد و ممکن است در کلیه ساختهای PIL در دسترس نباشد.

مثال: متن کدورت جزئی#

از جانب پیل وارد كردن تصویر, تصویر, تصویر # یک تصویر دریافت کنید با تصویر.باز کن("بالش/تست/تصاویر/هاپپر. png").تبدیل("RGBA") as پایه: # برای متن یک تصویر خالی درست کنید ، به رنگ متن شفاف txt = تصویر.جدید("RGBA", پایه.اندازه, (255, 255, 255, 0)) # یک قلم بگیرید FNT = تصویر.نوع سه گانه("بالش/تست/قلم/freemono. ttf", 40) # زمینه ترسیم را دریافت کنید d = تصویر.قرعه کشی(txt) # ترسیم متن ، نیمی از کدورت d.متن((10, 10), "سلام", قلم=FNT, پر کردن=(255, 255, 255, 128)) # ترسیم متن ، کدورت کامل d.متن((10, 60), "جهان", قلم=FNT, پر کردن=(255, 255, 255, 255)) خارج = تصویر.alpha_composite(پایه, txt) خارج.نشان دادن() 

مثال: ترسیم متن چند لایه#

از جانب پیل وارد كردن تصویر, تصویر, تصویر # ایجاد یک تصویر خارج = تصویر.جدید("RGB", (150, 100), (255, 255, 255)) # یک قلم بگیرید FNT = تصویر.نوع سه گانه("بالش/تست/قلم/freemono. ttf", 40) # زمینه ترسیم را دریافت کنید d = تصویر.قرعه کشی(خارج) # متن چند خطی را بکشید d.multiline_text((10, 10), "سلام
جهان ", قلم=FNT, پر کردن=(0, 0, 0)) خارج.نشان دادن() 

کارکرد#

• IM - تصویر برای ترسیم.
• حالت - حالت اختیاری برای استفاده برای مقادیر رنگی. برای تصاویر RGB ، این استدلال می تواند RGB یا RGBA باشد (برای مخلوط کردن نقاشی در تصویر). برای همه حالت های دیگر ، این آرگومان باید همان حالت تصویر باشد. در صورت حذف ، حالت به حالت تصویر پیش فرض می شود.

ویژگی های#

Imagedrawپر: bool = false #

انتخاب می کند که آیا ImageDraw. ink باید به عنوان رنگ پر یا طرح ریزی استفاده شود.

قلم پیش فرض فعلی.

در هر نمونه قابل تنظیم است:

از جانب پیل وارد كردن تصویر, تصویر قرعه کشی = تصویر.قرعه کشی(تصویر) قرعه کشی.قلم = تصویر.نوع سه گانه("تست ها/فونت ها/freemono. ttf") 

یا در سطح جهانی برای همه نمونه های آینده تصویربرداری:

از جانب پیل وارد كردن تصویر, تصویر تصویر.تصویر.قلم = تصویر.نوع سه گانه("تست ها/فونت ها/freemono. ttf") 

ImagedrawFontMode #

حالت نقاشی فونت فعلی.

برای غیرفعال کردن آنتی بادی یا "L" روی "1" تنظیم کنید تا آن را فعال کنید.

بازنمایی داخلی رنگ پیش فرض فعلی.

مواد و روش ها#

ImagedrawgetFont () [منبع] #

فونت پیش فرض فعلی ، ImageDraw. font را دریافت کنید.

اگر فونت پیش فرض فعلی هیچ کدام نباشد ، با ImageFont. load_default () آغاز می شود.

قوس (بخشی از یک طرح دایره) را بین زاویه های شروع و پایان ، داخل جعبه محدودیت داده شده ترسیم می کند.

• xy Two points to define the bounding box. Sequence of [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0.
• شروع - زاویه شروع ، در درجه. زاویه ها از ساعت 3 اندازه گیری می شوند و در جهت عقربه های ساعت افزایش می یابد.
• پایان - زاویه پایان ، در درجه.
• پر کردن - رنگ برای استفاده برای قوس.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 5. 3. 0.

با استفاده از رنگ پر شده فعلی برای بخش های غیر صفر ، یک bitmap (ماسک) را در موقعیت داده شده ترسیم می کند. bitmap باید یک ماسک شفافیت معتبر (حالت "1") یا مات (حالت "L" یا "RGBA") باشد.

این معادل انجام Image. paste (XY ، رنگ ، bitmap) است.

برای چسباندن داده های پیکسل در یک تصویر ، از روش خمیر () روی خود تصویر استفاده کنید.

Imagedrawوتر (xy ، start ، end ، fill = none ، upline = none ، width = 1) [منبع] #

همان قوس () ، اما نقاط انتهایی را با یک خط مستقیم متصل می کند.

• xy Two points to define the bounding box. Sequence of [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• پر کردن - رنگ برای استفاده برای پر کردن.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 5. 3. 0.

یک بیضی را درون جعبه محدود شده داده می کند.

• xy Two points to define the bounding box. Sequence of either [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• پر کردن - رنگ برای استفاده برای پر کردن.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 5. 3. 0.

خط بین مختصات را در لیست XY ترسیم می کند.

• XY-دنباله ای از هر دو نمونه مانند [(x ، y) ، (x ، y) ،. مقادیر عددی مانند [x ، y ، x ، y ،.].
• پر کردن - رنگ برای استفاده برای خط.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 1. 1. 5. توجه داشته باشید این گزینه تا نسخه 1. 1. 6 شکسته شد. جدید در نسخه 5. 3. 0.

همان قوس ، اما همچنین بین نقاط انتهایی و مرکز جعبه محدود ، خطوط مستقیم را ترسیم می کند.

• xy Two points to define the bounding box. Sequence of [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0.
• شروع - زاویه شروع ، در درجه. زاویه ها از ساعت 3 اندازه گیری می شوند و در جهت عقربه های ساعت افزایش می یابد.
• پایان - زاویه پایان ، در درجه.
• پر کردن - رنگ برای استفاده برای پر کردن.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 5. 3. 0.

امتیاز (پیکسل های جداگانه) را در مختصات داده شده ترسیم می کند.

• XY-دنباله ای از هر دو نمونه مانند [(x ، y) ، (x ، y) ،. مقادیر عددی مانند [x ، y ، x ، y ،.].
• پر کردن - رنگ برای استفاده برای نقطه.

چند ضلعی را ترسیم می کند.

طرح چند ضلعی از خطوط مستقیم بین مختصات داده شده ، به علاوه یک خط مستقیم بین آخرین و اولین مختصات تشکیل شده است.

• XY-دنباله ای از هر دو نمونه مانند [(x ، y) ، (x ، y) ،. مقادیر عددی مانند [x ، y ، x ، y ،.].
• پر کردن - رنگ برای استفاده برای پر کردن.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• عرض - عرض خط ، در پیکسل.

یک چند ضلعی معمولی که در محدوده_ circle ، با n_sides و چرخش درجه های چرخش نوشته شده است ، ترسیم می کند.

• bounding_circle - دایره محدود کننده یک قلاب است که توسط یک نقطه و شعاع تعریف شده است.(به عنوان مثال bounding_circle = (x ، y ، r) یا ((x ، y) ، r)). چند ضلعی در این دایره نوشته شده است.
• n_sides - تعداد طرفین (به عنوان مثال n_sides = 3 برای مثلث ، 6 برای شش ضلعی).
• چرخش - یک چرخش دلخواه را به چند ضلعی اعمال کنید (به عنوان مثال چرخش = 90 ، چرخش 90 درجه را اعمال می کند).
• پر کردن - رنگ برای استفاده برای پر کردن.
• طرح کلی - رنگ برای استفاده برای طرح کلی.

مستطیل را ترسیم می کند.

• xy Two points to define the bounding box. Sequence of either [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0. جعبه محدودیت شامل هر دو نقطه پایانی است.
• پر کردن - رنگ برای استفاده برای پر کردن.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• عرض - عرض خط ، در پیکسل.

   

جدید در نسخه 5. 3. 0.

یک مستطیل گرد را ترسیم می کند.

• xy Two points to define the bounding box. Sequence of either [(x0, y0), (x1, y1)] or [x0, y0, x1, y1] , where x1>= x0 and y1>= y0. جعبه محدودیت شامل هر دو نقطه پایانی است.
• شعاع - شعاع گوشه ها.
• پر کردن - رنگ برای استفاده برای پر کردن.
• طرح کلی - رنگ برای استفاده برای طرح کلی.
• عرض - عرض خط ، در پیکسل.
• CORNERS - Tuple از دور زدن هر گوشه ، (top_left ، top_right ، bottom_right ، bottom_left).

جدید در نسخه 8. 2. 0.

Imagedrawشکل (شکل ، پر = هیچ ، طرح کلی = هیچ) [منبع] #

این روش تجربی است.

Imagedrawمتن (xy ، متن ، پر = هیچ ، font = none ، anchor = none ، فاصله = 4 ، align = 'Left' ، Direction = None ، None ، None ، None ، None ، Stroke_Width = 0 ، Stroke_fill = None ، EmbedDed_Color =نادرست) [منبع] #

رشته را در موقعیت داده شده ترسیم می کند.

• XY - مختصات لنگر متن.
• متن - رشته ای که باید ترسیم شود. اگر حاوی شخصیت های جدید باشد ، متن به multiline_text () منتقل می شود.
• پر کردن - رنگ برای استفاده برای متن.
• فونت - نمونه ImageFont.
• لنگر - تراز لنگر متن. مکان نسبی لنگر را به متن تعیین می کند. تراز پیش فرض از بالا سمت چپ است. برای مقادیر معتبر به مجریان متن مراجعه کنید. این پارامتر برای فونت های غیر توری نادیده گرفته می شود.

   

توجه داشته باشید که این پارامتر در نسخه های قبلی بالش وجود داشت ، اما فقط در نسخه 8. 0. 0 اجرا شد.

جدید در نسخه 4. 2. 0. جدید در نسخه 4. 2. 0. جدید در نسخه 6. 0. 0. جدید در نسخه 6. 2. 0. جدید در نسخه 6. 2. 0. جدید در نسخه 8. 0. 0.

رشته را در موقعیت داده شده ترسیم می کند.

• XY - مختصات لنگر متن.
• متن - رشته ای که باید ترسیم شود.
• پر کردن - رنگ برای استفاده برای متن.
• فونت - نمونه ImageFont.
• لنگر - تراز لنگر متن. مکان نسبی لنگر را به متن تعیین می کند. تراز پیش فرض از بالا سمت چپ است. برای مقادیر معتبر به مجریان متن مراجعه کنید. این پارامتر برای فونت های غیر توری نادیده گرفته می شود.

   

توجه داشته باشید که این پارامتر در نسخه های قبلی بالش وجود داشت ، اما فقط در نسخه 8. 0. 0 اجرا شد.

جدید در نسخه 4. 2. 0. جدید در نسخه 4. 2. 0. جدید در نسخه 6. 0. 0. جدید در نسخه 6. 2. 0. جدید در نسخه 6. 2. 0. جدید در نسخه 8. 0. 0.

از نسخه 9. 2. 0 کاهش یافته است.

برای اطلاعات بیشتر به استهلاک مراجعه کنید.

برای اندازه گیری جبران متن زیر با دقت 1/64 پیکسل از طول متن () استفاده کنید. برای به دست آوردن جعبه محدودیت دقیق بر اساس لنگر ، از TextBbox () استفاده کنید.

اندازه رشته داده شده را در پیکسل ها برگردانید.

به دلایل تاریخی ، این عملکرد ارتفاع متن را از خط صعود به جای بالا اندازه گیری می کند ، به لنگرهای متن مراجعه کنید. اگر می خواهید ارتفاع متن را از بالا اندازه گیری کنید ، توصیه می شود به جای آن از textbbox () با anchor = 'lt' استفاده کنید.

• متن - متن برای اندازه گیری. اگر حاوی شخصیت های جدید باشد ، متن به multiline_textsize () منتقل می شود.
• فونت - نمونه ImageFont.
• فاصله - اگر متن به multiline_textsize () منتقل شود ، تعداد پیکسل ها بین خطوط.
• جهت - جهت متن. این می تواند "RTL" (راست به چپ) ، "LTR" (چپ به راست) یا "TTB" (از بالا به پایین) باشد. به LIBRAQM نیاز دارد.

جدید در نسخه 4. 2. 0. جدید در نسخه 4. 2. 0. جدید در نسخه 6. 0. 0. جدید در نسخه 6. 2. 0.

Imagedrawmultiline_textsize (متن ، فونت = هیچ ، فاصله = 4 ، جهت = هیچ ، ویژگی ها = هیچ ، زبان = هیچ ، سکته مغزی_ wwidth = 0) [منبع] #

از نسخه 9. 2. 0 کاهش یافته است.

برای اطلاعات بیشتر به استهلاک مراجعه کنید.

اندازه رشته داده شده را در پیکسل ها برگردانید.

برای اندازه گیری جبران متن زیر با دقت 1/64 پیکسل از طول متن () استفاده کنید. برای به دست آوردن جعبه محدودیت دقیق بر اساس لنگر ، از TextBbox () استفاده کنید.

به دلایل تاریخی این عملکرد ارتفاع متن را به عنوان فاصله بین خط صعود بالا و خط نزولی پایین ، نه بالا و پایین متن ، اندازه گیری می کند ، به لنگرهای متن مراجعه کنید. اگر می خواهید ارتفاع متن را از بالا تا پایین متن اندازه گیری کنید ، توصیه می شود به جای آن از multiline_textbbox () استفاده کنید.

• متن - متن برای اندازه گیری.
• فونت - نمونه ImageFont.
• فاصله - تعداد پیکسل ها بین خطوط.
• جهت - جهت متن. این می تواند "RTL" (راست به چپ) ، "LTR" (چپ به راست) یا "TTB" (از بالا به پایین) باشد. به LIBRAQM نیاز دارد.

جدید در نسخه 4. 2. 0. جدید در نسخه 4. 2. 0. جدید در نسخه 6. 0. 0. جدید در نسخه 6. 2. 0.

Imagedrawطول متن (متن ، فونت = هیچ ، جهت = هیچ ، ویژگی ها = هیچ ، زبان = هیچ ، تعبیه شده_ color = false) [منبع] #

طول بازگشت (در پیکسل هایی با دقت 1/64) متن داده شده هنگام ارائه در قلم با جهت ، ویژگی ها و زبان ارائه شده است.

این مبلغی است که متن زیر باید جبران شود. جعبه محدود کردن متن ممکن است طول برخی از قلم ها را گسترش دهد ، به عنوان مثالهنگام استفاده از ایتالیایی یا لهجه.

نتیجه به عنوان شناور بازگردانده می شود. در صورت استفاده از طرح اساسی ، این یک عدد کامل است.

توجه داشته باشید که مجموع دو طول ممکن است با طول یک رشته جمع شده به دلیل کرنر برابر نباشد. اگر نیاز به تنظیم برای کرنر دارید ، شخصیت زیر را درج کنید و طول آن را کم کنید.

به عنوان مثال ، به جای

سلام = قرعه کشی.طول متن("سلام", قلم) جهان = قرعه کشی.طول متن("جهان", قلم) سلام دنیا = سلام + جهان # برای کرنینگ تنظیم نشده است ادعا کردن سلام دنیا == قرعه کشی.طول متن("سلام دنیا", قلم) # ممکن است شکست بخورد 

سلام = قرعه کشی.طول متن("جهنم", قلم) - قرعه کشی.طول متن( "W", قلم ) # تنظیم شده برای Keing جهان = قرعه کشی.طول متن("جهان", قلم) سلام دنیا = سلام + جهان # تنظیم شده برای Keing ادعا کردن سلام دنیا == قرعه کشی.طول متن("سلام دنیا", قلم) # درست است، واقعی 

یا غیرفعال کردن Keing با (نیاز به LibraQM)

سلام = قرعه کشی.طول متن("سلام", قلم, امکانات=["-کرن"]) جهان = قرعه کشی.طول متن("جهان", قلم, امکانات=["-کرن"]) سلام دنیا = سلام + جهان # کرنینگ غیرفعال است ، نیازی به تنظیم نیست ادعا کردن سلام دنیا == قرعه کشی.طول متن("سلام دنیا", قلم, امکانات=["-کرن"]) # درست است، واقعی 

جدید در نسخه 8. 0. 0.

• متن - متن برای اندازه گیری. ممکن است هیچ شخصیت خطی نداشته باشد.
• فونت - نمونه ImageFont.
• جهت - جهت متن. این می تواند "RTL" (راست به چپ) ، "LTR" (چپ به راست) یا "TTB" (از بالا به پایین) باشد. به LIBRAQM نیاز دارد.
• ویژگی ها - لیستی از ویژگی های فونت OpenType که در هنگام طرح متن مورد استفاده قرار می گیرد. این معمولاً برای روشن کردن ویژگی های فونت اختیاری که به طور پیش فرض فعال نیستند ، به عنوان مثال "Dlig" یا "SS01" استفاده می شود ، اما می تواند برای خاموش کردن ویژگی های فونت پیش فرض نیز استفاده شود ، به عنوان مثال "-liga" برای غیرفعال کردن لیگاتور یا "-کرن "برای غیرفعال کردن Keing. برای به دست آوردن تمام ویژگی های پشتیبانی شده ، به اسناد OpenType مراجعه کنید. به LIBRAQM نیاز دارد.
• زبان - زبان متن. زبانهای مختلف ممکن است از اشکال مختلف گلیف یا لیگاتور استفاده کنند. این پارامتر به قلم می گوید که متن در کدام زبان قرار دارد و در صورت وجود ، جایگزین های صحیح را در صورت لزوم اعمال می کند. این باید یک کد زبان BCP 47 باشد. به LIBRAQM نیاز دارد.
• Embedded_color - اینکه آیا از گلیف های رنگی فونت تعبیه شده استفاده کنید (COLR ، CBDT ، SBIX).

عرض برای افقی ، ارتفاع برای متن عمودی.

ImagedrawTextBbox (xy ، متن ، font = none ، anchor = none ، فاصله = 4 ، align = 'Left' ، Direction = None ، None = None ، None ، None ، None ، STROKE_WIDTH = 0 ، SUBSEDDED_COLOR = FALSE) [منبع] #

جعبه محدود کننده (در پیکسل ها) متن داده شده نسبت به لنگر داده شده را هنگام ارائه در قلم با جهت ، ویژگی ها و زبان ارائه می دهد. فقط برای فونت های TrueType پشتیبانی می شود.

برای دریافت جبران متن زیر با دقت 1/64 پیکسل از TextL طول () استفاده کنید. جعبه محدودیت شامل حاشیه های اضافی برای برخی از قلم ها است ، به عنوان مثالایتالیایی یا لهجه ها.

جدید در نسخه 8. 0. 0.

• XY - مختصات لنگر متن.
• متن - متن برای اندازه گیری. اگر حاوی شخصیت های جدید باشد ، متن به multiline_textbbox () منتقل می شود.
• قلم - نمونه Freetypefont.
• لنگر - تراز لنگر متن. مکان نسبی لنگر را به متن تعیین می کند. تراز پیش فرض از بالا سمت چپ است. برای مقادیر معتبر به مجریان متن مراجعه کنید. این پارامتر برای فونت های غیر توری نادیده گرفته می شود.
• فاصله - اگر متن به multiline_textbbox () منتقل شود ، تعداد پیکسل ها بین خطوط.
• Align - اگر متن به multiline_textbbox () ، "سمت چپ" ، "مرکز" یا "راست" منتقل شود. تراز نسبی خطوط را تعیین می کند. برای مشخص کردن تراز با XY از پارامتر لنگر استفاده کنید.
• جهت - جهت متن. این می تواند "RTL" (راست به چپ) ، "LTR" (چپ به راست) یا "TTB" (از بالا به پایین) باشد. به LIBRAQM نیاز دارد.
• ویژگی ها - لیستی از ویژگی های فونت OpenType که در هنگام طرح متن مورد استفاده قرار می گیرد. این معمولاً برای روشن کردن ویژگی های فونت اختیاری که به طور پیش فرض فعال نیستند ، به عنوان مثال "Dlig" یا "SS01" استفاده می شود ، اما می تواند برای خاموش کردن ویژگی های فونت پیش فرض نیز استفاده شود ، به عنوان مثال "-liga" برای غیرفعال کردن لیگاتور یا "-کرن "برای غیرفعال کردن Keing. برای به دست آوردن تمام ویژگی های پشتیبانی شده ، به اسناد OpenType مراجعه کنید. به LIBRAQM نیاز دارد.
• زبان - زبان متن. زبانهای مختلف ممکن است از اشکال مختلف گلیف یا لیگاتور استفاده کنند. این پارامتر به قلم می گوید که متن در کدام زبان قرار دارد و در صورت وجود ، جایگزین های صحیح را در صورت لزوم اعمال می کند. این باید یک کد زبان BCP 47 باشد. به LIBRAQM نیاز دارد.
• STROKE_WIDTH - عرض سکته مغزی.
• Embedded_color - اینکه آیا از گلیف های رنگی فونت تعبیه شده استفاده کنید (COLR ، CBDT ، SBIX).

(چپ ، بالا ، راست ، پایین) جعبه محدود

Imagedrawmultiline_textbbox (xy ، متن ، font = none ، anchor = none ، فاصله = 4 ، align = 'Left' ، Direction = None ، None ، None = None ، None ، Stroke_Width = 0 ، EmbedDed_Color = false) [منبع] #

جعبه محدود کننده (در پیکسل ها) متن داده شده نسبت به لنگر داده شده را هنگام ارائه در قلم با جهت ، ویژگی ها و زبان ارائه می دهد. فقط برای فونت های TrueType پشتیبانی می شود.

برای دریافت جبران متن زیر با دقت 1/64 پیکسل از TextL طول () استفاده کنید. جعبه محدودیت شامل حاشیه های اضافی برای برخی از قلم ها است ، به عنوان مثالایتالیایی یا لهجه ها.

جدید در نسخه 8. 0. 0.

• XY - مختصات لنگر متن.
• متن - متن برای اندازه گیری.
• قلم - نمونه Freetypefont.
• لنگر - تراز لنگر متن. مکان نسبی لنگر را به متن تعیین می کند. تراز پیش فرض از بالا سمت چپ است. برای مقادیر معتبر به مجریان متن مراجعه کنید. این پارامتر برای فونت های غیر توری نادیده گرفته می شود.
• فاصله - تعداد پیکسل ها بین خطوط.
• تراز - "چپ" ، "مرکز" یا "راست". تراز نسبی خطوط را تعیین می کند. برای مشخص کردن تراز با XY از پارامتر لنگر استفاده کنید.
• جهت - جهت متن. این می تواند "RTL" (راست به چپ) ، "LTR" (چپ به راست) یا "TTB" (از بالا به پایین) باشد. به LIBRAQM نیاز دارد.
• ویژگی ها - لیستی از ویژگی های فونت OpenType که در هنگام طرح متن مورد استفاده قرار می گیرد. این معمولاً برای روشن کردن ویژگی های فونت اختیاری که به طور پیش فرض فعال نیستند ، به عنوان مثال "Dlig" یا "SS01" استفاده می شود ، اما می تواند برای خاموش کردن ویژگی های فونت پیش فرض نیز استفاده شود ، به عنوان مثال "-liga" برای غیرفعال کردن لیگاتور یا "-کرن "برای غیرفعال کردن Keing. برای به دست آوردن تمام ویژگی های پشتیبانی شده ، به اسناد OpenType مراجعه کنید. به LIBRAQM نیاز دارد.
• زبان - زبان متن. زبانهای مختلف ممکن است از اشکال مختلف گلیف یا لیگاتور استفاده کنند. این پارامتر به قلم می گوید که متن در کدام زبان قرار دارد و در صورت وجود ، جایگزین های صحیح را در صورت لزوم اعمال می کند. این باید یک کد زبان BCP 47 باشد. به LIBRAQM نیاز دارد.
• STROKE_WIDTH - عرض سکته مغزی.
• Embedded_color - اینکه آیا از گلیف های رنگی فونت تعبیه شده استفاده کنید (COLR ، CBDT ، SBIX).

(چپ ، بالا ، راست ، پایین) جعبه محدود

pil. imagedRaw. getDraw (im = هیچ ، نکات = هیچ) [منبع] #

این روش تجربی است.

یک رابط 2D پیشرفته تر برای تصاویر PIL ، بر اساس رابط WCK.

• IM - تصویر برای ترسیم.
• نکات - لیست اختیاری از نکات.

A (زمینه طراحی ، طراحی کارخانه منابع) Tuple.

pil. imagedRaw. Floodfill (تصویر ، xy ، مقدار ، مرز = هیچ ، آرت = 0) [منبع] #

این روش تجربی است.

یک منطقه محدود را با یک رنگ معین پر می کند.

• تصویر - تصویر هدف.
• XY-موقعیت بذر (یک توله مختصات 2 ماده ای).
• مقدار - رنگ را پر کنید.
• مرز - مقدار مرزی اختیاری. در صورت داده شده ، منطقه از پیکسل هایی با رنگ متفاوت از رنگ مرزی تشکیل شده است. اگر داده نشود ، منطقه از پیکسل هایی تشکیل شده است که همان رنگ پیکسل بذر را دارند.
• تست - مقدار آستانه اختیاری که حداکثر تفاوت قابل تحمل یک مقدار پیکسل را از "پس زمینه" مشخص می کند تا جایگزین شود. برای پر کردن مناطق رنگهای غیر همگن اما مشابه مفید است.