mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
93 lines
5.6 KiB
Markdown
93 lines
5.6 KiB
Markdown
---
|
|
description: "دمج عدة صور في صور مجمّعة شبكية باستخدام أكثر من 25 قالبًا، مع فجوات وزوايا قابلة للتعديل، وتحريك وتكبير لكل خلية."
|
|
i18n_source_hash: cd50a782239d
|
|
i18n_provenance: human
|
|
i18n_output_hash: f966a795442b
|
|
---
|
|
|
|
# صورة مجمّعة وشبكة {#collage-grid}
|
|
|
|
ادمج عدة صور في صور مجمّعة شبكية جميلة باستخدام أكثر من 25 قالبًا. يدعم تخطيطات من صورتين إلى 9 صور مع فجوة قابلة للتخصيص، ونصف قطر للزوايا، ولون خلفية، وعناصر تحكم بالتحريك والتكبير لكل خلية.
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/collage`
|
|
|
|
## Parameters {#parameters}
|
|
|
|
| Parameter | Type | Required | Default | Description |
|
|
|-----------|------|----------|---------|-------------|
|
|
| templateId | string | Yes | - | معرّف تخطيط القالب (مثل `2-h-equal`، `3-left-large`، `4-grid`، `9-grid`) |
|
|
| cells | array | No | - | مصفوفة إعدادات لكل خلية تحتوي على `imageIndex`، `panX`، `panY`، `zoom`، `objectFit` |
|
|
| cells[].imageIndex | integer | Yes | - | فهرس الصورة المراد وضعها في هذه الخلية (يبدأ من 0) |
|
|
| cells[].panX | number | No | 0 | إزاحة التحريك الأفقية (-100 إلى 100) |
|
|
| cells[].panY | number | No | 0 | إزاحة التحريك العمودية (-100 إلى 100) |
|
|
| cells[].zoom | number | No | 1 | مستوى التكبير (1 إلى 10) |
|
|
| cells[].objectFit | string | No | `"cover"` | كيفية ملء الصورة للخلية: `cover` أو `contain` |
|
|
| gap | number | No | 8 | الفجوة بين الخلايا بالبكسل (0 إلى 500) |
|
|
| cornerRadius | number | No | 0 | نصف قطر الزوايا لكل خلية بالبكسل (0 إلى 500) |
|
|
| backgroundColor | string | No | `"#FFFFFF"` | لون الخلفية كقيمة hex أو `"transparent"` |
|
|
| aspectRatio | string | No | `"free"` | نسبة أبعاد اللوحة: `free`، `1:1`، `4:3`، `3:2`، `16:9`، `9:16`، `4:5` |
|
|
| outputFormat | string | No | `"png"` | صيغة الإخراج: `png`، `jpeg`، `webp`، `avif`، `jxl` |
|
|
| quality | number | No | 90 | جودة الإخراج (1 إلى 100) |
|
|
|
|
## Available Templates {#available-templates}
|
|
|
|
| Template ID | Images | Layout |
|
|
|-------------|--------|--------|
|
|
| `2-h-equal` | 2 | عمودان متساويان |
|
|
| `2-v-equal` | 2 | صفّان متساويان |
|
|
| `2-h-left-large` | 2 | اليسار الثلثان، اليمين الثلث |
|
|
| `2-h-right-large` | 2 | اليسار الثلث، اليمين الثلثان |
|
|
| `3-left-large` | 3 | كبيرة على اليسار، اثنتان مكدّستان على اليمين |
|
|
| `3-right-large` | 3 | اثنتان مكدّستان على اليسار، كبيرة على اليمين |
|
|
| `3-top-large` | 3 | كبيرة في الأعلى، عمودان في الأسفل |
|
|
| `3-h-equal` | 3 | ثلاثة أعمدة متساوية |
|
|
| `3-v-equal` | 3 | ثلاثة صفوف متساوية |
|
|
| `4-grid` | 4 | شبكة 2x2 |
|
|
| `4-left-large` | 4 | كبيرة على اليسار، ثلاث مكدّسة على اليمين |
|
|
| `4-top-large` | 4 | كبيرة في الأعلى، ثلاثة أعمدة في الأسفل |
|
|
| `4-bottom-large` | 4 | ثلاثة أعمدة في الأعلى، كبيرة في الأسفل |
|
|
| `5-top2-bottom3` | 5 | اثنتان في الأعلى، ثلاث في الأسفل |
|
|
| `5-top3-bottom2` | 5 | ثلاث في الأعلى، اثنتان في الأسفل |
|
|
| `5-left-large` | 5 | كبيرة على اليسار، أربع مكدّسة على اليمين |
|
|
| `5-center-large` | 5 | كبيرة في المنتصف، أربع في الزوايا |
|
|
| `6-grid-2x3` | 6 | عمودان × ثلاثة صفوف |
|
|
| `6-grid-3x2` | 6 | ثلاثة أعمدة × صفّان |
|
|
| `6-top-large` | 6 | كبيرة في الأعلى، خمسة أعمدة في الأسفل |
|
|
| `7-mosaic` | 7 | تخطيط فسيفسائي |
|
|
| `8-mosaic` | 8 | تخطيط فسيفسائي |
|
|
| `9-grid` | 9 | شبكة 3x3 |
|
|
|
|
## Example Request {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/collage \
|
|
-F "file=@photo1.jpg" \
|
|
-F "file=@photo2.jpg" \
|
|
-F "file=@photo3.jpg" \
|
|
-F "file=@photo4.jpg" \
|
|
-F 'settings={"templateId":"4-grid","gap":12,"cornerRadius":8,"backgroundColor":"#F5F5F5","outputFormat":"png","quality":90}'
|
|
```
|
|
|
|
## Example Response {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
|
|
"originalSize": 2456789,
|
|
"processedSize": 1823456
|
|
}
|
|
```
|
|
|
|
## Notes {#notes}
|
|
|
|
- ارفع عدة ملفات صور في طلب multipart. تُسنَد الصور إلى خلايا القالب بترتيب الرفع.
|
|
- إذا رُفعت صور أكثر مما يدعمه القالب، تُتجاهَل الصور الزائدة.
|
|
- يدعم صيغ الإدخال HEIC وRAW وPSD وSVG (تُفَكّ شفرتها تلقائيًا).
|
|
- الحجم الأساسي للوحة هو 2400 بكسل على الجانب الأطول، مع تحجيمه وفق نسبة الأبعاد المختارة.
|
|
- عندما تكون `aspectRatio` هي `"free"`، تكون اللوحة افتراضيًا 4:3 (2400x1800).
|
|
- تُزيح قيم `panX`/`panY` لكل خلية نافذة الاقتصاص داخل الخلية. قيمة 100 تحرّكها بالكامل نحو حافة، و-100 نحو الحافة المقابلة.
|
|
- يُحفَظ لون الخلفية `"transparent"` فقط مع صيغ الإخراج `png` أو `webp` أو `avif`.
|