منشئ رسائل Slack المتحركة

# منشئ صور GIF لتطبيق Slack

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

## متطلبات Slack

**الأبعاد:** - صور GIF الرموز التعبيرية: 128x128 (موصى به) - صور GIF الرسائل: 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 ```

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

```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`) - ادمج أشكالا متعددة للحصول على تعقيد (مثل نجمة بداخلها نجمة أصغر)

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

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

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

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

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

### GIFBuilder (`core.gif_builder`) يجميع الإطارات ويحسن لـ Slack: ```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) ```

### المدققات (`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!") ```

### دوال التخفيف (`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 ```

### مساعدات الإطارات (`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 ) ```

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

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

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

### الارتداد جسم يسقط ويرتد: - استخدم `interpolate()` مع