صانع صور GIF لسلاك

# صانع صور GIF لسلاك (Slack GIF Creator)

مجموعة أدوات توفر أدوات مساعدة ومعرفة لإنشاء صور GIF متحركة محسنة لسلاك.

## متطلبات Slack

**الأبعاد:** - صور GIF للرموز التعبيرية (Emoji GIFs): 128x128 (موصى به) - صور GIF للرسائل (Message GIFs): 480x480

**المعاملات:** - FPS (إطار في الثانية): 10-30 (الأقل يعني حجم ملف أصغر) - الألوان: 48-128 (الأقل يعني حجم ملف أصغر) - المدة: حافظ عليها أقل من 3 ثوان لصور GIF للرموز التعبيرية

## سير العمل الأساسي

```python from core.gif_builder import GIFBuilder from PIL import Image, ImageDraw

# 1. Create builder builder = GIFBuilder(width=128, height=128, fps=10)

# 2. Generate frames for i in range(12): frame = Image.new('RGB', (128, 128), (240, 248, 255)) draw = ImageDraw.Draw(frame)

# Draw your animation using PIL primitives # (circles, polygons, lines, etc.)

builder.add_frame(frame)

# 3. Save with optimization builder.save('output.gif', num_colors=48, optimize_for_emoji=True) ```

## رسم الرسومات

### العمل مع الصور التي يرفعها المستخدم إذا قام المستخدم بتحميل صورة، فكر فيما إذا كان يريد: - **استخدامها مباشرة** (على سبيل المثال، "تحريك هذا"، "تقسيم هذا إلى إطارات") - **استخدامها كمصدر إلهام** (على سبيل المثال، "اصنع شيئا كهذا")

قم بتحميل الصور والعمل بها باستخدام PIL: ```python from PIL import Image

uploaded = Image.open('file.png') # Use directly, or just as reference for colors/style ```

### الرسم من الصفر عند رسم الرسومات من الصفر، استخدم بدائيات ImageDraw من PIL:

```python from PIL import ImageDraw

draw = ImageDraw.Draw(frame)

# Circles/ovals draw.ellipse([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

# Stars, triangles, any polygon points = [(x1, y1), (x2, y2), (x3, y3), ...] draw.polygon(points, fill=(r, g, b), outline=(r, g, b), width=3)

# Lines draw.line([(x1, y1), (x2, y2)], fill=(r, g, b), width=5)

# Rectangles draw.rectangle([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3) ```

**لا تستخدم:** خطوط الرموز التعبيرية (غير موثوقة عبر الأنظمة الأساسية) أو تفترض وجود رسومات مسبقة التعبئة في هذه المهارة.

### جعل الرسومات تبدو جيدة

يجب أن تبدو الرسومات مصقولة ومبتكرة، وليست أساسية. إليك الطريقة:

**استخدم خطوطا أكثر سمكا** - اضبط دائما `width=2` أو أعلى للمخططات والخطوط. تبدو الخطوط الرفيعة (width=1) متقطعة وغير احترافية.

**أضف عمقا بصريا**: - استخدم التدرجات للخلفيات (`create_gradient_background`) - قم بوضع طبقات متعددة من الأشكال للتعقيد (على سبيل المثال، نجمة بداخلها نجمة أصغر)

**اجعل الأشكال أكثر إثارة للاهتمام**: - لا ترسم دائرة عادية فقط - أضف إبرازات أو حلقات أو أنماطا - يمكن أن يكون للنجوم توهجات (ارسم نسخا أكبر وشبه شفافة خلفها) - اجمع بين أشكال متعددة (نجوم + لمعان، دوائر + حلقات)

**انتبه للألوان**: - استخدم ألوانا نابضة بالحياة ومتكاملة - أضف تباينا (مخططات داكنة على أشكال فاتحة، مخططات فاتحة على أشكال داكنة) - ضع في اعتبارك التكوين العام

**للأشكال المعقدة** (قلوب، رقاقات ثلج، إلخ): - استخدم مجموعات من المضلعات والقطع الناقصة - احسب النقاط بعناية للتناظر - أضف تفاصيل (يمكن أن يحتوي القلب على منحنى إبراز، ورقاقات الثلج لها فروع معقدة)

كن مبدعا ومفصلا! يجب أن تبدو صورة GIF جيدة لسلاك مصقولة، وليست رسومات بديلة.

## الأدوات المساعدة المتاحة

### GIFBuilder (`core.gif_builder`) تجمع الإطارات وتحسنها لسلاك: ```python builder = GIFBuilder(width=128, height=128, fps=10) builder.add_frame(frame) # Add PIL Image builder.add_frames(frames) # Add list of frames builder.save('out.gif', num_colors=48, optimize_for_emoji=True, remove_duplicates=True) ```

### Validators (`core.validators`) تتحقق مما إذا كانت صورة GIF تفي بمتطلبات Slack: ```python from core.validators import validate_gif, is_slack_ready

# Detailed validation passes, info = validate_gif('my.gif', is_emoji=True, verbose=True)

# Quick check if is_slack_ready('my.gif'): print("Ready!") ```

### Easing Functions (`core.easing`) حركة سلسة بدلا من الخطية: ```python from core.easing import interpolate

# Progress from 0.0 to 1.0 t = i / (num_frames - 1)

# Apply easing y = interpolate(start=0, end=400, t=t, easing='ease_out')

# Available: linear, ease_in, ease_out, ease_in_out, # bounce_out, elastic_out, back_out ```

### Frame Helpers (`core.frame_composer`) وظائف مساعدة للاحتياجات الشائعة: ```python from core.frame_composer import ( create_blank_frame, # Solid color background create_gradient_background, # Vertical gradient draw_circle, # Helper for circles draw_text, # Simple text rendering draw_star # 5-pointed star ) ```

## مفاهيم التحريك

### اهتزاز/ارتعاش (Shake/Vibrate) إزاحة موضع الكائن مع التذبذب: - استخدم `math.sin()` أو `math.cos()` مع فهرس الإطار - أضف اختلافات عشوائية صغيرة لإحساس طبيعي - طبق على الموضع x و/أو y

### نبض/ضربات قلب (Pulse/Heartbeat) تغيير حجم الكائن بشكل إيقاعي: - استخدم `math.sin(t * frequency * 2 * math.pi)` لنبض سلس - لضربات القلب: نبضتان سريعتان ثم توقف مؤقت (اضبط موجة الجيب) - تغيير الحجم بين 0.8 و 1.2 من الحجم الأساسي

### ارتداد (Bounce) سقوط الكائن وارتداده: - استخدم `interpolate()` مع