JUImage

Juimage v6

JUIMAGE - مكتبة لتقديم إبهام مع دعم الويب و AVIF.

إنشاء إبهام لتوبة! التمديد أو الاستخدام المستقل.

العرض التوضيحي (جميع الإبهام)

• SCI314.com
• лвввска сса рада
• високий ззок

استخدام في Joomla! امتداد

• Junewsultra
• Jumultithumb
• Jursspublisher

الاستخدام

قائم بذاته

تثبيت الملحن

composer require joomla-ua/juimage

يمكنك بعد ذلك التحديث لاحقًا باستخدام الملحن:

composer update

مثال رمز

بعد التثبيت ، تحتاج إلى طلب التحميل التلقائي للملحن:

 require_once ( ' vendor/autoload.php ' );

$ config [ ' root_path ' ] = __DIR__ ;
$ config [ ' img_blank ' ] = ' images/logos ' ;

$ juImg = new JUImage  Image ( $ config );
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 77 ' ,
	' cache ' => ' img '
]);

echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300" height="100"> ' ;

الخيارات العالمية	وصف
$root_path	مسار الجذر لموقعك. افتراضي تحديد JPATH_BASE
$img_blank	طريق إلى الصورة الافتراضية. على سبيل المثال ، إذا لم يتم العثور على صورة عرض الافتراضية noimage.png . استخدم أيضًا error_image إذا لم يتم العثور على الصورة أو كسرها (انتقل إلى الخيار)

جملة! اندماج

ثَبَّتَ

تثبيت مكتبة التمديد (lib_juimage_v3.xxzip) باستخدام Joomla! مدير الإرشاد.

مثال رمز

رمز للاستخدام في امتدادك.

JLoader:: register ( ' JUImage ' ,  JPATH_LIBRARIES . ' /juimage/JUImage.php ' );

$ juImg = new JUImage ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 77 ' ,
	' cache ' => ' img '
]);

echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ;

أو

 require_once ( JPATH_SITE . ' /libraries/juimage/vendor/autoload.php ' );

$ juImg = new JUImage  Image ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 77 ' ,
	' cache ' => ' img '
]);

echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ;

دعم الويب

 <?php

$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 95 ' ,
	' webp '  => true
]);
?>

<picture>
	<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
	<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>

استخدم GD2 LIB لإبهام الويب:

 <?php

$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '           => ' 300 ' ,
	' h '           => ' 100 ' ,
	' q '           => ' 95 ' ,
	' webp '        => true ,
	' imagemagick ' => false
]);
?>

أمر الويب	يكتب	تقصير	وصف
ويب	منطقية	خطأ شنيع	إذا كان true إضافة صورة دعم ويب. لهذا الخيار ، استخدم علامة <picture> ، انظر على سبيل المثال.

دعم AVIF

تنسيق صورة AVIF (يتطلب PHP 8.1.0)

 <?php

$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 95 ' ,
	' avif '  => true
]);
?>

<picture>
	<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
	<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>

أمر الويب	يكتب	تقصير	وصف
أفيف	منطقية	خطأ شنيع	إذا كان true إضافة صورة دعم ويب. لهذا الخيار ، استخدم علامة <picture> . تنسيق صورة AVIF (يتطلب PHP 8.1.0)

كيف تجمع بين WebP و AVIF؟

 <?php

$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w '     => ' 300 ' ,
	' h '     => ' 100 ' ,
	' q '     => ' 95 ' ,
	' avif '  => true ,
	' webp '  => true
]);
?>

<picture>
	<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
	<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
	<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>

دعم يوتيوب و Vimeo

يوتيوب:

 $ thumb = $ juImg -> render ( ' https://www.youtube.com/watch?v=xxxxxxxxxxx ' , [
	' w ' => ' 300 ' ,
	' h ' => ' 100 '
]);

Vimeo:

 $ thumb = $ juImg -> render ( ' https://vimeo.com/xxxxxxxxx ' , [
	' w ' => ' 300 ' ,
	' h ' => ' 100 '
]);

دعم حجم الصورة

 <?php

$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
	' w ' => ' 300 '
]);

// Image size for thumb
$ size = $ juImg -> size ( $ thumb );
	
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width=" ' . $ size -> width . ' " height=" ' . $ size -> height . ' "> ' ;	

خيارات

أضف خيارًا إلى هذه المصفوفة:

[
  	' w '     => ' 300 ' ,
  	' h '     => ' 100 ' ,
  	' q '     => ' 77 ' ,
  	' cache ' => ' img '
]

يأمر	وصف
مخبأ	مجلد للثنائي المصغرة
error_image	مسار إلى الصورة الافتراضية إذا لم يتم العثور على الصورة أو كسرها
ث	أقصى عرض من الصورة المصغرة في البكسلات
ح	الحد الأقصى لارتفاع الصورة المصغرة في البكسل
WP	أقصى عرض لصور الصورة
HP	أقصى ارتفاع لصور الصورة
WL	أقصى عرض لصور المناظر الطبيعية
HL	أقصى ارتفاع لصور المناظر الطبيعية
WS	أقصى عرض للصور المربعة
HS	أقصى ارتفاع للصور المربعة
و	تنسيق صورة الإخراج ("JPEG" أو "PNG" أو "GIF" أو "WebP" أو "Avif")
س	ضغط JPEG (1 = أسوأ ، 95 = أفضل ، 75 = افتراضي)
SX	الجانب الأيسر من المستطيل المصدر (افتراضي 0) (القيم 0 <sx <1 تمثل النسبة المئوية)
سي	الجانب العلوي من المستطيل المصدر (افتراضي 0) (القيم 0 <sy <1 تمثل النسبة المئوية)
جنوب غرب	عرض مستطيل المصدر (عرض كامل الافتراضي) (تمثل القيم 0 <SW <1 النسبة المئوية)
ش	ارتفاع مستطيل المصدر (الافتراضي fullheight) (القيم 0 <sh <1 تمثل النسبة المئوية)
ZC	التكبير. سوف تلقائيًا من البعد الأكبر بحيث تملأ الصورة البعد الأصغر (يتطلب كل من "W" و "H" ، وتجاوز "IAR" ، "Far"). تم تعيينه على "1" أو "C" إلى التكبير باتجاه المركز ، أو ضبطه على "T" ، "B" ، "L" ، "R" ، "TL" ، "TR" ، "BL" ، "BR" للانجذاب نحو الاتجاهات العلوية/اليسار/أسفل/اليمين (Requies ImageMagick for Design Elo "C" أو "1")
BG	خلفية لون السداسي (الافتراضي FFFFFF)
قبل الميلاد	لون الحدود السداسي (الافتراضي 000000)
xto	Thumbnail Exif فقط - تم تعيينه لاستخراج الصورة المصغرة الخارجة فقط وعدم القيام بأي معالجة إضافية
ر	تدوير بزاوية: زاوية الدوران بدرجات إيجابية عكس اتجاه عقارب الساعة ، سلبية ، في اتجاه عقارب الساعة
AR	تدوير تلقائي: ضبط على "X" لاستخدام اتجاه EXIF ​​المخزنة بواسطة الكاميرا. يمكن أيضًا ضبطها على "L" أو "L" للمناظر الطبيعية ، أو "P" أو "P" للصورة. " l" و "p" تدوير الصورة في اتجاه عقارب الساعة ، "l" و "p" تدوير الصورة بعكس اتجاه عقارب الساعة.
SFN	رقم الإطار المصدر-استخدم رقم الإطار/الصفحة لصور المصدر متعددة الإطار/متعدد الصفحات (GIF ، TIFF ، إلخ)
عوي	إخراج السماح بالتوسيع - 1 = ON ، 0 = OFF. "Far" و "IAR" كلاهما يتجاوزان هذا ويسمح للإخراج أكبر من المدخلات)
إيار	تجاهل نسبة العرض إلى الارتفاع - تعطيل الحجم التناسبي وتطبيق الصورة لتناسب "H" و "W" (والتي يجب تعيين كلاهما). (1 = ON ، 0 = OFF) (يتجاوز "بعيد")
بعيد	سيتم إنشاء نسبة العرض إلى ارتفاع القوة - الصورة بالحجم المحدد بواسطة "W" و "H" (والتي يجب تعيين كلاهما). المحاذاة: l = اليسار ، r = يمين ، t = أعلى ، b = أسفل ، c = الوسط. BL ، BR ، TL ، TR استخدم الاتجاه المناسب إذا كانت الصورة منظرًا طبيعيًا أو صورة.
DPI	نقاط لكل بوصة - إدخال إعداد DPI عند الاستيراد من تنسيق صورة المتجه مثل PDF ، WMF ، إلخ
سيا	احفظ الصورة AS - اسم الملف الافتراضي لحفظ الصورة التي تم إنشاؤها على أنها. حدد اسم الملف الأساسي ، سيتم إضافة التمديد (على سبيل المثال: ".png") تلقائيًا
ماكس	الحد الأقصى لحجم البايت - جودة الإخراج محدد تلقائيًا لتناسب الصورة المصغرة في بايت "MAXB" (يتم ضبط جودة الضغط لـ JPEG ، يتم ضبط عمق بت على PNG و GIF)

رخصة

GNU General Public License الإصدار 3 أو الأحدث ؛ انظر الترخيص

البرنامج المستخدم

يعتمد Juimage على فئة Phpthumb () (James Heinrich) ، ومكتبة حجم الصورة السريعة (مارك ألكساندر).

الرعاة

بفضل JetBrains لدعم المشروع من خلال رعاية بعض حزم جميع المنتجات في برنامج ترخيص المصدر المجاني المجاني.