الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

صورة بسيطة

فئة PHP تجعل العمل مع الصور بسيطًا قدر الإمكان.

تم تطويره وصيانته بواسطة Cory LaViska.

إذا جعلك هذا المشروع تحب معالجة صور PHP مرة أخرى، فيرجى التفكير في رعايتي لدعم تطويره.

ملخص 

 <?php
try {
  // Create a new SimpleImage object
  $ image = new  claviska  SimpleImage ();

  // Magic ! 
  $ image
    -> fromFile ( ' image.jpg ' )                     // load image . jpg
    -> autoOrient ()                              // adjust orientation based on exif data
    -> resize ( 320 , 200 )                          // resize to 320 x200 pixels
    -> flip ( ' x ' )                                 // flip horizontally
    -> colorize ( ' DarkBlue ' )                      // tint dark blue
    -> border ( ' black ' , 10 )                       // add a 10 pixel black border
    -> overlay ( ' watermark.png ' , ' bottom right ' )  // add a watermark image
    -> toFile ( ' new-image.png ' , ' image/png ' )      // convert to PNG and save a copy to new-image . png
    -> toScreen ();                               // output to the screen

  // And much more ! 
} catch ( Exception $ err ) {
  // Handle errors
  echo $ err -> getMessage ();
}

متطلبات

  • بي إتش بي 8.0+
  • تمديد جي دي

سمات

  • يدعم القراءة والكتابة وتحويل صيغ GIF، JPEG، PNG، WEBP، BMP، AVIF.
  • يقرأ ويكتب الملفات وعناوين URI للبيانات وسلاسل الصور.
  • المعالجة: الاقتصاص، تغيير الحجم، التراكب/العلامة المائية، إضافة نص TTF
  • الرسم: قوس، حدود، نقطة، قطع ناقص، خط، مضلع، مستطيل، مستطيل مستدير الزوايا
  • المرشحات: طمس، تفتيح، تلوين، تباين، تغميق، عدم التشبع، كشف الحواف، زخرف، عكس، عتامة، بكسل، بني داكن، شحذ، رسم
  • الأدوات المساعدة: تعديل الألوان، تغميق/تفتيح اللون، استخراج الألوان
  • الخصائص: بيانات exif، الارتفاع/العرض، نوع mime، الاتجاه
  • يمكن تمرير وسيطات اللون كأي لون CSS (مثل LightBlue )، أو لون سداسي عشري، أو مصفوفة RGB(A).
  • دعم شفافية ألفا (GIF، PNG، WEBP، AVIF)
  • طرق قابلة للتسلسل
  • يستخدم الاستثناءات
  • التحميل باستخدام Composer أو يدويًا (ملف واحد فقط)
  • الإصدار الدلالي

تثبيت

التثبيت مع الملحن: 

 composer require claviska/simpleimage

أو قم بتضمين المكتبة يدويًا: 

 <?php
require ' src/claviska/SimpleImage.php ' ;

عن

تم تطوير SimpleImage وصيانته بواسطة Cory LaViska. حقوق الطبع والنشر موقع جميل، LLC.

إذا كنت تستمتع باستخدام SimpleImage، خاصة في التطبيقات التجارية، فيرجى التفكير في رعايتي لدعم تطويره.

شكرًا!

رخصة

مرخص بموجب ترخيص MIT.

واجهة برمجة التطبيقات

ترتيب الروعة:

  1. قم بتحميل صورة
  2. التلاعب بالصورة
  3. حفظ/إخراج الصورة

نصائح واجهة برمجة التطبيقات:

  • تشير العلامة النجمية إلى الوسيطة المطلوبة.
  • الأساليب التي تُرجع كائن SimpleImage قابلة للتسلسل.
  • يمكنك تمرير ملف أو URI بيانات إلى المُنشئ لتجنب استدعاء fromFile أو fromDataUri .
  • يمكن استدعاء الأساليب الثابتة باستخدام $image::methodName() أو claviskaSimpleImage::methodName() .
  • يمكن أن تكون الألوان أحد ألوان CSS (على سبيل المثال white )، أو سلسلة سداسية عشرية (على سبيل المثال '#ffffff')، أو مصفوفة RGBA.
  • يمكنك توجيه الشفافية إلى normalizeColor عند تمرير لون CSS أو سلسلة سداسية عشرية: white|0.25

لوادر

fromDataUri($uri)

يقوم بتحميل صورة من URI للبيانات.

  • $uri * (سلسلة) - عنوان URI للبيانات.

إرجاع كائن SimpleImage.

fromFile($file)

يقوم بتحميل صورة من ملف.

  • $file * (string) - ملف الصورة المراد تحميله.

إرجاع كائن SimpleImage.

fromNew($width, $height, $color)

يخلق صورة جديدة.

  • $width * (int) - عرض الصورة.
  • $height * (int) - ارتفاع الصورة.
  • $color (string|array) - لون تعبئة اختياري للصورة الجديدة (الافتراضي "شفاف").

إرجاع كائن SimpleImage.

fromString($string)

ينشئ صورة جديدة من سلسلة.

  • $string * (string) - بيانات الصورة الأولية كسلسلة. مثال: 
     $string = file_get_contents('image.jpg');

إرجاع كائن SimpleImage.

المدخرين

toDataUri($mimeType, $options)

يولد URI للبيانات.

  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

تقوم بإرجاع سلسلة تحتوي على URI للبيانات.

toDownload($filename, $mimeType, $options)

يفرض تنزيل الصورة على جهاز العميل. يجب أن يتم استدعاؤه قبل إرسال أي مخرجات إلى الشاشة.

  • $filename * (string) - اسم الملف (بدون مسار) الذي سيتم إرساله إلى العميل (على سبيل المثال 'image.jpeg').
  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

إرجاع كائن SimpleImage.

toFile($file, $mimeType, $options)

يكتب الصورة إلى ملف.

  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

إرجاع كائن SimpleImage.

toScreen($mimeType, $options)

يقوم بإخراج الصورة إلى الشاشة. يجب أن يتم استدعاؤه قبل إرسال أي مخرجات إلى الشاشة.

  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

إرجاع كائن SimpleImage.

toString($mimeType, $options)

يولد سلسلة صورة.

  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

إرجاع كائن SimpleImage.

generate($mimeType, $options)

يولد صورة.

  • $mimeType (سلسلة) - تنسيق الصورة المطلوب إخراجها كنوع mime (الإعداد الافتراضي هو نوع mime الأصلي).
  • $options (array|int) - مجموعة من الخيارات أو جودة الصورة كنسبة مئوية (الافتراضي 100).

إرجاع مصفوفة: [mimeType، data]

مصفوفة الخيارات

بدلاً من توفير الجودة كعدد صحيح كمعلمة دالة أخيرة، يمكنك أيضًا تعيين خيارات متنوعة اعتمادًا على نوع Mime المستهدف باستخدام مصفوفة ترابطية. 

 $ image -> toFile ( $ file , ' image/avif ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,

    // AVIF ( default - 1 which is 6 )
    // range of slow and small file 0 to 10 fast but big file
    ' speed ' => - 1 ,
]);
 $ image -> toFile ( $ file , ' image/bmp ' , [
    // BMP : boolean ( default true )
    ' compression ' => true ,

    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,
]);
 $ image -> toFile ( $ file , ' image/gif ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,
]);
 $ image -> toFile ( $ file , ' image/jpeg ' , [
    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,

    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);
 $ image -> toFile ( $ file , ' image/png ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,

    // PNG : 0 - 10 , defaults to zlib ( default 6 )
    ' compression ' => - 1 ,

    // PNG ( default - 1 )
    ' filters ' => - 1 ,

    // has no effect on PNG images , since the format is lossless
    // ' quality' = > 100 ,
]);
 $ image -> toFile ( $ file , ' image/webp ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

المرافق

getAspectRatio()

يحصل على نسبة العرض إلى الارتفاع الحالية للصورة.

إرجاع نسبة العرض إلى الارتفاع كتعويم.

getExif()

يحصل على بيانات exif الخاصة بالصورة.

يُرجع مصفوفة من بيانات exif أو يُرجع قيمة فارغة في حالة عدم توفر بيانات.

getHeight()

يحصل على الارتفاع الحالي للصورة.

إرجاع الارتفاع كعدد صحيح.

getMimeType()

يحصل على نوع التمثيل الصامت للصورة المحملة.

إرجاع سلسلة نوع mime.

getOrientation()

يحصل على الاتجاه الحالي للصورة.

إرجاع سلسلة: "أفقي" أو "عمودي" أو "مربع"

getResolution()

يحصل على الدقة الحالية للصورة بـ DPI.

إرجاع مصفوفة من الأعداد الصحيحة: [0 => 96, 1 ​​=> 96]

getWidth()

يحصل على العرض الحالي للصورة.

إرجاع العرض كعدد صحيح.

hasImage()

يتحقق مما إذا كان كائن SimpleImage قد قام بتحميل صورة.

إرجاع قيمة منطقية.

reset()

يدمر مورد الصورة.

إرجاع كائن SimpleImage.

تلاعب

autoOrient()

يقوم بتدوير الصورة بحيث يكون الاتجاه صحيحًا بناءً على بيانات exif الخاصة بها. من الآمن استدعاء هذه الطريقة على الصور التي لا تحتوي على بيانات exif (لن يتم إجراء أي تغييرات). إرجاع كائن SimpleImage.

bestFit($maxWidth, $maxHeight)

قم بتغيير حجم الصورة بشكل متناسب لتلائم العرض والارتفاع المحددين.

  • $maxWidth * (int) - الحد الأقصى لعرض الصورة.
  • $maxHeight * (int) - الحد الأقصى لارتفاع الصورة.

إرجاع كائن SimpleImage.

crop($x1, $y1, $x2, $y2)

قص الصورة.

  • $x1 - إحداثي x العلوي الأيسر.
  • $y1 - إحداثي y العلوي الأيسر.
  • $x2 - تنسيق x السفلي الأيمن.
  • $y2 - تنسيق x السفلي الأيمن.

إرجاع كائن SimpleImage.

fitToHeight($height) (مهمل)

تغيير حجم الصورة بشكل متناسب إلى ارتفاع معين.

تم إهمال هذه الطريقة في الإصدار 3.2.2 وستتم إزالتها في الإصدار 4.0. الرجاء استخدام resize(null, $height) بدلاً من ذلك.

  • $height * (int) - الارتفاع المطلوب تغيير حجم الصورة إليه.

إرجاع كائن SimpleImage.

fitToWidth($width) (مهمل)

تغيير حجم الصورة بشكل متناسب إلى عرض معين.

تم إهمال هذه الطريقة في الإصدار 3.2.2 وستتم إزالتها في الإصدار 4.0. الرجاء استخدام resize($width, null) بدلاً من ذلك.

  • $width * (int) - العرض المطلوب تغيير حجم الصورة إليه.

إرجاع كائن SimpleImage.

flip($direction)

اقلب الصورة أفقيًا أو رأسيًا.

  • $direction * (سلسلة) - الاتجاه المطلوب قلبه: x|y|كلاهما

إرجاع كائن SimpleImage.

maxColors($max, $dither)

يقلل الصورة إلى الحد الأقصى لعدد الألوان.

  • $max * (int) - الحد الأقصى لعدد الألوان المستخدمة.
  • $dither (bool) - ما إذا كان سيتم استخدام تأثير ثبات الألوان أم لا (صحيح افتراضي).

إرجاع كائن SimpleImage.

overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)

ضع صورة فوق الصورة الحالية.

  • $overlay * (string|SimpleImage) - الصورة المراد تراكبها. يمكن أن يكون هذا اسم ملف، أو معرف URI للبيانات، أو كائن SimpleImage.
  • $anchor (سلسلة) - نقطة الربط: "المركز"، "أعلى"، "أسفل"، "يسار"، "يمين"، "أعلى اليسار"، "أعلى اليمين"، "أسفل اليسار"، "أسفل اليمين" ( الافتراضي "المركز")
  • $opacity (float) - مستوى عتامة التراكب 0-1 (الافتراضي 1).
  • $xOffset (int) - الإزاحة الأفقية بالبكسل (الافتراضي 0).
  • $yOffset (int) - الإزاحة الرأسية بالبكسل (الافتراضي 0).
  • $calculateOffsetFromEdge (bool) - حساب الإزاحة بالإشارة إلى حواف الصورة. ليس لـ $xOffset و$yOffset أي تأثير في المرساة المركزية. (خطأ افتراضي).

إرجاع كائن SimpleImage.

resize($width, $height)

تغيير حجم الصورة إلى الأبعاد المحددة. إذا تم تحديد بُعد واحد فقط، فسيتم تغيير حجم الصورة بشكل متناسب.

  • $width * (int) - عرض الصورة الجديد.
  • $height * (int) - ارتفاع الصورة الجديد.

إرجاع كائن SimpleImage.

resolution($res_x, $res_y)

يغير دقة (DPI) للصورة.

  • $res_x * (int) - الدقة الأفقية، بـ DPI.
  • $res_y (int) - الدقة الرأسية، بـ DPI.

إرجاع كائن SimpleImage.

rotate($angle, $backgroundColor)

يقوم بتدوير الصورة.

  • $angle * (int) - زاوية الدوران (-360 - 360).
  • $backgroundColor (string|array) - لون الخلفية الذي سيتم استخدامه لمنطقة المنطقة غير المكشوفة بعد التدوير (الافتراضي "شفاف").

إرجاع كائن SimpleImage.

text($text, $options, &$boundary)

يضيف النص إلى الصورة.

  • $text* (سلسلة) - النص المطلوب.
  • $options (صفيف) - مجموعة من الخيارات.
    • fontFile * (سلسلة) - ملف خط TrueType (أو المتوافق) المطلوب استخدامه.
    • size (int) - حجم الخط بالبكسل (الافتراضي 12).
    • color (سلسلة | صفيف) - لون النص (أسود افتراضي).
    • anchor (سلسلة) - نقطة الربط: "المركز"، "أعلى"، "أسفل"، "يسار"، "يمين"، "أعلى اليسار"، "أعلى اليمين"، "أسفل اليسار"، "أسفل اليمين" (افتراضي) 'مركز').
    • xOffset (int) - الإزاحة الأفقية بالبكسل (الافتراضي 0).
    • yOffset (int) - الإزاحة الرأسية بالبكسل (الافتراضي 0).
    • shadow (صفيف) - معلمات ظل النص.
      • x * (int) - الإزاحة الأفقية بالبكسل.
      • y * (int) - الإزاحة الرأسية بالبكسل.
      • color * (سلسلة | صفيف) - لون ظل النص.
    • calculateOffsetFromEdge (bool) - حساب الإزاحة بالإشارة إلى حواف الصورة (خطأ افتراضي).
    • baselineAlign (bool) - محاذاة خط النص مع الخط الأساسي. (صحيح افتراضي).
  • $boundary (array) - إذا تم تمريره، سيحتوي هذا المتغير على مصفوفة بإحداثيات تحيط بالنص: [x1, y1, x2, y2, width, height]. يمكن استخدام هذا لحساب موضع النص بعد إضافته إلى الصورة.

إرجاع كائن SimpleImage.

thumbnail($width, $height, $anchor)

ينشئ صورة مصغرة. تحاول هذه الوظيفة تقريب الصورة من الأبعاد المتوفرة قدر الإمكان، ثم تقوم باقتصاص الفائض المتبقي لفرض الحجم المطلوب. مفيد لتوليد الصور المصغرة.

  • $width * (int) - عرض الصورة المصغرة.
  • $height * (int) - ارتفاع الصورة المصغرة.
  • $anchor (سلسلة) - نقطة الربط: "المركز"، "أعلى"، "أسفل"، "يسار"، "يمين"، "أعلى اليسار"، "أعلى اليمين"، "أسفل اليسار"، "أسفل اليمين" ( الافتراضي "المركز").

إرجاع كائن SimpleImage.

رسم

arc($x, $y, $width, $height, $start, $end, $color, $thickness)

يرسم قوسا.

  • $x * (int) - الإحداثي x لمركز القوس.
  • $y * (int) - الإحداثي y لمركز القوس.
  • $width * (int) - عرض القوس.
  • $height * (int) - ارتفاع القوس.
  • $start * (int) - بداية القوس بالدرجات.
  • $end * (int) - نهاية القوس بالدرجات.
  • $color * (string|array) - لون القوس.
  • $thickness (int|string) - سمك الخط بالبكسل أو "مملوء" (الافتراضي 1).

إرجاع كائن SimpleImage.

border($color, $thickness)

يرسم حدودًا حول الصورة.

  • $color * (string|array) - لون الحدود.
  • $thickness (int) - سمك الحدود (الافتراضي 1).

إرجاع كائن SimpleImage.

dot($x, $y, $color)

يرسم نقطة بكسل واحدة.

  • $x * (int) - الإحداثي x للنقطة.
  • $y * (int) - الإحداثي y للنقطة.
  • $color * (string|array) - لون النقطة.

إرجاع كائن SimpleImage.

ellipse($x, $y, $width, $height, $color, $thickness)

يرسم القطع الناقص.

  • $x * (int) - الإحداثي x للمركز.
  • $y * (int) - الإحداثي y للمركز.
  • $width * (int) - عرض القطع الناقص.
  • $height * (int) - ارتفاع القطع الناقص.
  • $color * (string|array) - لون القطع الناقص.
  • $thickness (int|string) - سمك الخط بالبكسل أو "مملوء" (الافتراضي 1).

إرجاع كائن SimpleImage.

fill($color)

يملأ الصورة بلون ثابت.

  • $color (string|array) - لون التعبئة.

إرجاع كائن SimpleImage.

line($x1, $y1, $x2, $y2, $color, $thickness)

يرسم خطا.

  • $x1 * (int) - الإحداثي x للنقطة الأولى.
  • $y1 * (int) - الإحداثي y للنقطة الأولى.
  • $x2 * (int) - الإحداثي x للنقطة الثانية.
  • $y2 * (int) - الإحداثي y للنقطة الثانية.
  • $color (string|array) - لون الخط.
  • $thickness (int) - سمك الخط (الافتراضي 1).

إرجاع كائن SimpleImage.

polygon($vertices, $color, $thickness)

يرسم مضلعًا.

  • $vertices * (array) - رؤوس المضلع في مصفوفة من صفائف x/y. مثال: 
     [
  ['x' => x1, 'y' => y1],
  ['x' => x2, 'y' => y2],
  ['x' => xN, 'y' => yN]
]
  • $color * (string|array) - لون المضلع.
  • $thickness (int|string) - سمك الخط بالبكسل أو "مملوء" (الافتراضي 1).

إرجاع كائن SimpleImage.

rectangle($x1, $y1, $x2, $y2, $color, $thickness)

يرسم مستطيلاً.

  • $x1 * (int) - إحداثي x العلوي الأيسر.
  • $y1 * (int) - إحداثي y العلوي الأيسر.
  • $x2 * (int) - الإحداثي x الأيمن السفلي.
  • $y2 * (int) - إحداثي y السفلي الأيمن.
  • $color * (string|array) - لون المستطيل.
  • $thickness (int|string) - سمك الخط بالبكسل أو "مملوء" (الافتراضي 1).

إرجاع كائن SimpleImage.

roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)

يرسم مستطيلاً مستدير الزوايا.

  • $x1 * (int) - إحداثي x العلوي الأيسر.
  • $y1 * (int) - إحداثي y العلوي الأيسر.
  • $x2 * (int) - الإحداثي x الأيمن السفلي.
  • $y2 * (int) - إحداثي y السفلي الأيمن.
  • $radius * (int) - نصف قطر الحدود بالبكسل.
  • $color * (string|array) - لون المستطيل.
  • $thickness (int|string) - سمك الخط بالبكسل أو "مملوء" (الافتراضي 1).

إرجاع كائن SimpleImage.

المرشحات

blur($type, $passes)

يطبق مرشح التمويه.

  • $type (سلسلة) - خوارزمية التمويه المستخدمة: "انتقائية"، "gaussian" (افتراضي "gaussian").
  • $passes (int) - عدد مرات تطبيق المرشح، مما يعزز التأثير (الافتراضي 1).

إرجاع كائن SimpleImage.

brighten($percentage)

يطبق مرشح السطوع لتفتيح الصورة.

  • $percentage * (int) - النسبة المئوية لتفتيح الصورة (0 - 100).

إرجاع كائن SimpleImage.

colorize($color)

يطبق مرشح التلوين.

  • $color * (string|array) - لون الفلتر.

إرجاع كائن SimpleImage.

contrast($percentage)

يطبق مرشح التباين.

  • $percentage * (int) - النسبة المئوية للضبط (-100 - 100).

إرجاع كائن SimpleImage.

darken($percentage)

يستخدم مرشح السطوع لتغميق الصورة.

  • $percentage * (int) - النسبة المئوية لتغميق الصورة (0 - 100).

إرجاع كائن SimpleImage.

desaturate()

يطبق مرشح عدم التشبع (تدرج الرمادي).

إرجاع كائن SimpleImage.

duotone($lightColor, $darkColor)

يطبق مرشح الفرز الثنائي على الصورة.

  • $lightColor * (string|array) - اللون الأفتح في اللون الثنائي.
  • $darkColor * (string|array) - اللون الأغمق في الفرز الثنائي.

إرجاع كائن SimpleImage.

edgeDetect()

يطبق مرشح كشف الحافة.

إرجاع كائن SimpleImage.

emboss()

يطبق مرشح الزخرفة.

إرجاع كائن SimpleImage.

invert()

يعكس ألوان الصورة.

إرجاع كائن SimpleImage.

opacity()

يغير مستوى عتامة الصورة.

  • $opacity * (float) - مستوى العتامة المطلوب (0 - 1).

إرجاع كائن SimpleImage.

pixelate($size)

يطبق مرشح البيكسلات.

  • $size (int) - حجم الكتل بالبكسل (الافتراضي 10).

إرجاع كائن SimpleImage.

sepia()

يحاكي تأثير البني الداكن عن طريق إزالة تشبع الصورة وتطبيق درجة اللون البني الداكن.

إرجاع كائن SimpleImage.

sharpen($amount)

يشحذ الصورة.

  • $amount (int) - مقدار التوضيح (1 - 100، الافتراضي 50)

إرجاع كائن SimpleImage.

sketch()

يطبق مرشح الإزالة المتوسط ​​لإنتاج تأثير رسم.

إرجاع كائن SimpleImage.

المرافق اللون

(static) adjustColor($color, $red, $green, $blue, $alpha)

يضبط اللون عن طريق زيادة/تقليل قيم الأحمر/الأخضر/الأزرق/ألفا بشكل مستقل.

  • $color * (string|array) - اللون المطلوب ضبطه.
  • $red * (int) - تعديل باللون الأحمر (-255 - 255).
  • $green * (int) - تعديل اللون الأخضر (-255 - 255).
  • $blue * (int) - تعديل اللون الأزرق (-255 - 255).
  • $alpha * (float) - تعديل ألفا (-1 - 1).

إرجاع مصفوفة ألوان RGBA.

(static) darkenColor($color, $amount)

يغمق اللون.

  • $color * (string|array) - اللون المراد تغميقه.
  • $amount * (int) - المبلغ المراد تغميقه (0 - 255).

إرجاع مصفوفة ألوان RGBA.

extractColors($count = 10, $backgroundColor = null)

يستخرج الألوان من صورة مثلما يفعل الإنسان.™ تتطلب هذه الطريقة مكتبة تابعة لجهة خارجية LeagueColorExtractor. إذا كنت تستخدم Composer، فسيتم تثبيته لك تلقائيًا.

  • $count (int) - الحد الأقصى لعدد الألوان المراد استخراجها (الافتراضي 5).
  • $backgroundColor (string|array) - افتراضيًا، سيتم تجاهل أي بكسل بقيمة ألفا أكبر من الصفر. وذلك لأن الألوان الشفافة لا يتم إدراكها كما هي. على سبيل المثال، يمكن رؤية اللون الأسود الشفاف بالكامل باللون الأبيض على خلفية بيضاء. لذا، إذا كنت تريد أن تأخذ الشفافية في الاعتبار، فيجب عليك تحديد لون الخلفية الافتراضي.

إرجاع مصفوفة من مصفوفات ألوان RGBA.

getColorAt($x, $y)

يحصل على قيمة RGBA للبيكسل الواحد.

  • $x * (int) - الموضع الأفقي للبيكسل.
  • $y * (int) - الموضع الرأسي للبيكسل.

يُرجع مصفوفة ألوان RGBA أو يُرجع خطأ إذا كان موضع x/y خارج اللوحة القماشية.

(static) lightenColor($color, $amount)

يخفف اللون.

  • $color * (string|array) - اللون المراد تفتيحه.
  • $amount * (int) - المبلغ المراد تغميقه (0 - 255).

إرجاع مصفوفة ألوان RGBA.

(static) normalizeColor($color)

لتطبيع قيمة اللون السداسية أو المصفوفة إلى مصفوفة RGBA جيدة التنسيق.

  • $color * (string|array) - اسم لون CSS، أو سلسلة سداسية عشرية، أو مصفوفة [أحمر، أخضر، أزرق، ألفا].

يمكنك توجيه شفافية ألفا من خلال سلاسل سداسية وأسماء الألوان. على سبيل المثال:

#fff|0.50 <-- 50% أبيض أحمر|0.25 <-- 25% أحمر

إرجاع مصفوفة: [أحمر، أخضر، أزرق، ألفا]

الاستثناءات

يطرح SimpleImage استثناءات قياسية عندما تسوء الأمور. يجب عليك دائمًا استخدام كتلة محاولة/التقاط حول التعليمات البرمجية الخاصة بك للتعامل معها بشكل صحيح. 

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  echo $ err -> getMessage ();
}

للتحقق من وجود أخطاء محددة، قارن $err->getCode() بثوابت الخطأ المحددة. 

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  if ( $ err -> getCode () === $ image :: ERR_FILE_NOT_FOUND ) {
    echo ' File not found! ' ;
  } else {
    echo $ err -> getMessage ();
  }
}

كأفضل ممارسة، استخدم دائمًا الثوابت المحددة بدلاً من قيم الأعداد الصحيحة الخاصة بها. من المحتمل أن تتغير القيم في الإصدارات المستقبلية، ولن يتم اعتبارها تغييرًا جذريًا.

  • ERR_FILE_NOT_FOUND - تعذر العثور على الملف المحدد أو تحميله لسبب ما.
  • ERR_FONT_FILE - لا يمكن تحميل ملف الخط المحدد.
  • ERR_FREETYPE_NOT_ENABLED - لم يتم تمكين دعم Freetype في إصدار PHP الخاص بك.
  • ERR_GD_NOT_ENABLED - لم يتم تمكين ملحق GD في إصدار PHP الخاص بك.
  • ERR_LIB_NOT_LOADED - لم يتم تحميل المكتبة المطلوبة.
  • ERR_INVALID_COLOR - تم تمرير قيمة لون غير صالحة كوسيطة.
  • ERR_INVALID_DATA_URI - معرف URI للبيانات المحددة غير صالح.
  • ERR_INVALID_IMAGE - الصورة المحددة غير صالحة.
  • ERR_UNSUPPORTED_FORMAT - تنسيق الصورة المحدد غير صالح.
  • ERR_WEBP_NOT_ENABLED - لم يتم تمكين دعم WEBP في إصدار PHP الخاص بك.
  • ERR_WRITE - غير قادر على الكتابة إلى نظام الملفات.
  • ERR_INVALID_FLAG - مفتاح العلامة المحدد غير موجود.

أشياء مفيدة يجب معرفتها

  • يمكن أن تكون وسيطات اللون عبارة عن اسم لون CSS (على سبيل المثال LightBlue )، أو سلسلة ألوان سداسية عشرية (على سبيل المثال #0099dd )، أو مصفوفة RGB(A) (على سبيل المثال ['red' => 255, 'green' => 0, 'blue' => 0, 'alpha' => 1] ).

  • عندما $thickness > 1، يرسم GD خطوطًا بالسمك المطلوب من نقطة الأصل المركزية. على سبيل المثال، المستطيل المرسوم عند [10، 10، 20، 20] بسمك 3 سيتم رسمه فعليًا عند [9، 9، 21، 21]. ينطبق هذا على كافة الأشكال ولا يعد خطأً في مكتبة SimpleImage.

أعلام المثيل

قم بتعديل سلوك مثيل SimpleImage عن طريق تعيين قيم علامة المثيل باستخدام طريقة setFlag($key, $value) . 

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' )-> setFlag ( " foo " , " bar " );

يمكنك أيضًا تمرير مصفوفة اقترانية إلى مُنشئ SimpleImage لتعيين علامات المثيل. 

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' , [ ' foo ' => ' bar ' ]);
// . . or without an $ image
$ image = new  claviska  SimpleImage (flags: [ ' foo ' => ' bar ' ]);

ملاحظة: سيطرح setFlag() استثناء ERR_INVALID_FLAG إذا كان المفتاح غير موجود (لا توجد قيمة افتراضية).

sslVerify

سيؤدي تعيين sslVerify إلى false (الإعداد الافتراضي إلى true ) إلى جعل جميع الصور المحملة عبر HTTPS تتخلى عن التحقق من صحة نظير الشهادة. وهذا مفيد بشكل خاص للشهادات الموقعة ذاتيًا. 

 $ image = new  claviska  SimpleImage ( ' https://localhost/image.jpeg ' , [ ' sslVerify ' => false ]);
// Would normally throw an OpenSSL exception , but is ignored with the sslVerify flag set to false .

الاختلافات عن SimpleImage 2.x

  • وسيطات الألوان التي تمت تسويتها (يمكن أن تكون الألوان اسم لون CSS أو لونًا سداسيًا عشريًا أو صفيف RGB(A)).
  • وسيطات ألفا (عتامة) التي تمت تسويتها: 0 (شفافة) - 1 (معتمة)
  • تمت إضافة ظل النص إلى طريقة text .
  • تمت إضافة طريقة fromString() لتحميل الصور من السلاسل.
  • تمت إضافة طريقة toString() لإنشاء سلاسل الصور.
  • تمت إضافة طريقة arc لرسم الأقواس.
  • تمت إضافة طريقة border لرسم الحدود.
  • تمت إضافة طريقة dot لرسم وحدات البكسل الفردية.
  • تمت إضافة طريقة ellipse لرسم القطع الناقص والدوائر.
  • طريقة line المضافة لرسم الخطوط.
  • تمت إضافة طريقة polygon لرسم المضلعات.
  • تمت إضافة طريقة rectangle لرسم المستطيلات.
  • تمت إضافة طريقة roundedRectangle لرسم مستطيلات مستديرة.
  • تمت إضافة طريقة adjustColor لتعديل قنوات ألوان RGBA لإنشاء تنوعات ألوان نسبية.
  • تمت إضافة طريقة darkenColor لتغميق اللون.
  • تمت إضافة طريقة extractColors للحصول على الألوان الأكثر شيوعًا من الصورة.
  • تمت إضافة طريقة getColorAt للحصول على قيم RGBA لبكسل معين.
  • تمت إضافة طريقة lightenColor لتفتيح اللون.
  • تمت إضافة طريقة toDownload لفرض تنزيل الصورة على جهاز العميل.
  • تمت إضافة مرشح duotone لإنشاء صور الفرز الثنائي.
  • تمت إضافة طريقة sharpen لزيادة وضوح الصورة.
  • تم تغيير مساحة الاسم من abeautifulsite إلى claviska .
  • تم تغيير طريقة create إلى fromNew .
  • تم تغيير طريقة load إلى fromFile .
  • تم تغيير طريقة load_base64 إلى fromDataUri .
  • تم تغيير طريقة output إلى toScreen .x
  • تم تغيير طريقة output_base64 إلى toDataUri .
  • تم تغيير طريقة save إلى toFile .
  • تم تغيير طريقة text لقبول مجموعة من الخيارات بدلاً من عدد كبير من الوسائط.
  • تمت إزالة حد النص من طريقة text لأنها أنتجت نتائج قذرة ولا تدعم الشفافية.
  • تمت إزالة الطريقة smooth نظرًا لعدم توثيق وسيطاتها في دليل PHP بشكل جيد.
  • تمت إزالة الطريقة المهملة adaptive_resize (استخدم thumbnail بدلاً من ذلك).
  • تمت إزالة get_meta_data (استخدم getExif و getHeight و getMime و getOrientation و getWidth بدلاً من ذلك).
  • تمت إضافة ملف .editorconfig. يرجى التأكد من أن محررك يدعم هذه الإعدادات قبل إرسال المساهمات.
  • تم التبديل من أربع مسافات إلى مسافات بادئة (آسف PHP-FIG!).
  • تم التبديل من underscore_methods إلى CamelCaseMethods.
  • الأساليب المنظمة في مجموعات على أساس الوظيفة
  • تمت إزالة تعليقات PHPDoc. في هذا الوقت، لا أرغب في دمجها في المكتبة.
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل