JibayAi commited on
Commit
71e2ea7
·
verified ·
1 Parent(s): 818a745

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +141 -0
README.md ADDED
@@ -0,0 +1,141 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # JibayAi
2
+ # Jimage-L1
3
+
4
+ **مولد متن به تصویر پیشرفته**
5
+ *طراحی و توسعه شده توسط تیم JibayAi - ساخته شده از پایه بدون کپی‌برداری*
6
+
7
+ ## 🚀 معرفی
8
+
9
+ مدل Jimage-L1 یک سیستم قدرتمند تولید تصویر از متن با پشتیبانی کامل از زبان فارسی و انگلیسی می‌باشد. این سیستم به صورت کاملاً بومی و بدون استفاده از کتابخانه‌های خارجی توسعه یافته است.
10
+
11
+ ## ✨ قابلیت‌های اصلی
12
+
13
+ ### 📝 پردازش متن
14
+ - پشتیبانی کامل از حروف فارسی و انگلیسی
15
+ - اعتبارسنجی کاراکترها با سیستم Token-Based
16
+ - تشخیص خودکار زبان متن (فارسی/انگلیسی)
17
+ - نمایش دقیق متن بدون جابجایی یا جدا شدن حروف
18
+
19
+ ### 🎨 مدیریت فونت
20
+ - انتخاب خودکار فونت بر اساس زبان متن
21
+ - پشتیبانی از ۴۷ فونت انگلیسی در پوشه `EnglishFonts`
22
+ - پشتیبانی از ۶۳ فونت فارسی در پوشه `PersianFonts`
23
+ - انتخاب رندوم فونت مناسب برای هر درخواست
24
+
25
+ ### 🖼️ نسبت‌های تصویر
26
+ - **1:1** (مربعی)
27
+ - **4:3** (افقی)
28
+ - **3:4** (عمودی)
29
+
30
+ ### 🌈 سیستم رنگ‌آمیزی
31
+ **پس‌زمینه:**
32
+ - رنگ ساده رندوم
33
+ - گرادیانت ۲ یا ۴ رنگ با هارمونی رنگی
34
+ - گرادیانت عمودی، افقی و مورب
35
+ - رنگ‌های نزدیک به هم در گرادیانت
36
+
37
+ **متن:**
38
+ - ۵۰٪ احتمال رنگ سفید برای متن
39
+ - ۵۰٪ احتمال رنگ‌های رندوم
40
+ - تضمین تضاد رنگی با پس‌زمینه
41
+ - قابلیت گرادیانت روی متن
42
+
43
+ ### ✨ افکت‌های ویژه
44
+ - **سایه متن:** رندوم (بدون سایه، ساده، عمیق)
45
+ - **حاشیه متن:** رندوم با رنگ‌های ساده یا گرادیانت
46
+ - **گرادیانت متن:** قابلیت فعال شدن رندوم
47
+
48
+ ## 📁 ساختار فایل‌ها
49
+
50
+ ```
51
+ project/
52
+ ├── tokens.jmdl # دیکشنری کاراکترهای مجاز
53
+ ├── fonts.jmdl # لیست فونت‌های موجود
54
+ ├── EnglishFonts/ # پوشه فونت‌های انگلیسی
55
+ ├── PersianFonts/ # پوشه فونت‌های فارسی
56
+ └── index.php # فایل اصلی
57
+ ```
58
+
59
+ ## 🛠️ نصب و راه‌اندازی
60
+
61
+ ### نیازمندی‌ها
62
+ - PHP 7.4 یا بالاتر
63
+ - اکستنشن GD
64
+ - هاست یا سرور اختصاصی (مناسب در Cpanel)
65
+
66
+ ### مراحل نصب
67
+ 1. آپلود تمام فایل‌ها در هاست
68
+ 2. اطمینان از وجود پوشه‌های `EnglishFonts` و `PersianFonts`
69
+ 3. قرار دادن فونت‌ها در پوشه‌های مربوطه
70
+ 4. تنظیم permission مناسب (755)
71
+
72
+ ## 📡 روش استفاده
73
+
74
+ ### درخواست پایه
75
+ ```
76
+ https://example.com/index.php?text=متن مورد نظر
77
+ ```
78
+
79
+ ### مثال‌های کاربردی
80
+ ```
81
+ https://example.com/index.php?text=دنیا
82
+ https://example.com/index.php?text=Hello World
83
+ https://example.com/index.php?text=Jibay
84
+ ```
85
+
86
+ ## ⚡ ویژگی‌های فنی
87
+
88
+ ### بهینه‌سازی
89
+ - زمان اجرا: حداکثر ۱۰ ثانیه
90
+ - مدیریت حافظه بهینه
91
+ - سازگار با هاست‌های اشتراکی
92
+ - بدون نیاز به دسترسی ترمینال یا نصب کتابخانه
93
+
94
+ ### امنیت
95
+ - اعتبارسنجی کامل ورودی
96
+ - بررسی کاراکترهای مجاز
97
+ - مدیریت خطاهای مختلف
98
+ - جلوگیری از حملات احتمالی
99
+
100
+ ### کیفیت
101
+ - سایز تصاویر متعادل (۴۰۰px پایه)
102
+ - محاسبه خودکار سایز فونت
103
+ - قرارگیری متن در مرکز تصویر
104
+ - کیفیت بالا در خروجی PNG
105
+
106
+ ## 🎯 پارامترهای خروجی
107
+
108
+ - **فرمت:** PNG
109
+ - **کیفیت:** بالا
110
+ - **Header-Type:** image/png
111
+ - **سایز:** پویا بر اساس نسبت انتخابی
112
+
113
+ ## ⚠️ مدیریت خطا
114
+
115
+ سیستم در صورت مواجهه با خطا، تصویر خطای مناسب تولید می‌کند:
116
+
117
+ - متن ورودی خالی است
118
+ - کاراکترهای غیرمجاز در متن
119
+ - خطا در بارگذاری tokens
120
+ - خطا در بارگذاری فونت‌ها
121
+ - فونت مناسب یافت نشد
122
+ - timeout پس از ۱۰ ثانیه
123
+
124
+ ## 🔧 توسعه و سفارشی‌سازی
125
+
126
+ این سیستم کاملاً ماژولار طراحی شده و قابلیت‌های زیر برای توسعه موجود است:
127
+
128
+ - افزودن فونت‌های جدید
129
+ - اضافه کردن زبان‌های بیشتر
130
+ - ایجاد افکت‌های جدید
131
+ - تغییر الگوریتم‌های رندوم
132
+
133
+ ## 📞 پشتیبانی
134
+
135
+ **توسعه‌دهنده:** تیم JibayAi
136
+ **نسخه:** Jimage-L1
137
+ **وضعیت:** فعال
138
+
139
+ ---
140
+
141
+ *این پروژه به طور کامل از پایه و بدون استفاده از کدهای موجود توسعه یافته است. تمام حقوق برای تیم JibayAi محفوظ می‌باشد.*