Jimage-L2

🚀 معرفی

✨ قابلیت‌های اصلی

📝 پردازش متن

• پشتیبانی کامل از حروف فارسی و انگلیسی
• اعتبارسنجی کاراکترها با سیستم Token-Based
• تشخیص خودکار زبان متن (فارسی/انگلیسی)
• نمایش دقیق متن بدون جابجایی یا جدا شدن حروف

🎨 مدیریت فونت

• انتخاب خودکار فونت بر اساس زبان متن
• پشتیبانی از 182 فونت انگلیسی در پوشه EnglishFonts
• پشتیبانی از 138 فونت فارسی در پوشه PersianFonts
• انتخاب رندوم فونت مناسب برای هر درخواست

🖼️ نسبت‌های تصویر

• 1:1 (مربعی)
• 4:3 (افقی)
• 3:4 (عمودی)

🌈 سیستم رنگ‌آمیزی

• رنگ ساده رندوم
• گرادیانت ۲ یا ۴ رنگ با هارمونی رنگی
• گرادیانت عمودی، افقی و مورب
• رنگ‌های نزدیک به هم در گرادیانت

• ۵۰٪ احتمال رنگ سفید برای متن
• ۵۰٪ احتمال رنگ‌های رندوم
• تضمین تضاد رنگی با پس‌زمینه
• قابلیت گرادیانت روی متن

✨ افکت‌های ویژه

• سایه متن: رندوم (بدون سایه، ساده، عمیق)
• حاشیه متن: رندوم با رنگ‌های ساده یا گرادیانت
• گرادیانت متن: قابلیت فعال شدن رندوم

📁 ساختار فایل‌ها

project/
├── tokens.json       # دیکشنری کاراکترهای مجاز
├── fonts.json           # لیست فونت‌های موجود
├── EnglishFonts/        # پوشه فونت‌های انگلیسی
├── PersianFonts/        # پوشه فونت‌های فارسی
└── index.php          # فایل اصلی

🛠️ نصب و راه‌اندازی

نیازمندی‌ها

• PHP 7.4 یا بالاتر
• اکستنشن GD
• هاست لینوکس با سی پنل

مراحل نصب

1. آپلود تمام فایل‌ها در هاست
2. اطمینان از وجود پوشه‌های EnglishFonts و PersianFonts
3. قرار دادن فونت‌ها در پوشه‌های مربوطه
4. تنظیم permission مناسب (755)

📡 روش استفاده

درخواست پایه

مثال‌های کاربردی

https://example.com/jimage.php?text=سلام دنیا
https://example.com/jimage.php?text=Hello World
https://example.com/jimage.php?text=پویا

⚡ ویژگی‌های فنی

بهینه‌سازی

• زمان اجرا: حداکثر ۱۰ ثانیه
• مدیریت حافظه بهینه
• سازگار با هاست‌های اشتراکی
• بدون نیاز به دسترسی ترمینال

امنیت

• اعتبارسنجی کامل ورودی
• بررسی کاراکترهای مجاز
• مدیریت خطاهای مختلف
• جلوگیری از حملات احتمالی

کیفیت

• سایز تصاویر متعادل (۴۰۰px پایه)
• محاسبه خودکار سایز فونت
• قرارگیری متن در مرکز تصویر
• کیفیت بالا در خروجی PNG

🎯 پارامترهای خروجی

• فرمت: PNG,JPG
• کیفیت: بالا
• Header-Type: image/png
• سایز: پویا بر اساس نسبت انتخابی

⚠️ مدیریت خطا

• متن ورودی خالی است
• کاراکترهای غیرمجاز در متن
• خطا در بارگذاری tokens
• خطا در بارگذاری فونت‌ها
• فونت مناسب یافت نشد

🔧 توسعه و سفارشی‌سازی

• افزودن فونت‌های جدید
• اضافه کردن زبان‌های بیشتر
• ایجاد افکت‌های جدید
• تغییر الگوریتم‌های رندوم

📞 پشتیبانی