Media

Композитная Матрица Изображения

Применить композитное преобразование, комбинируя несколько базовых преобразований (масштабирование, вращение, сдвиг). Увидьте, как матрицы преобразования умножаются и создают сложные эффекты.

file· Файловый результатОткрыть инструмент

Быстрый старт

Вызовите этот инструмент из своего кода на трёх языках.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-composite-matrix' \
  -F 'file=@/path/to/imageFile.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/ru/api/tools/image-composite-matrix' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'scaleX=1.0' \
  -F 'scaleY=1.0' \
  -F 'angle=0' \
  -F 'shearX=0' \
  -F 'shearY=0' \
  -F 'transformOrder=scale-rotate-shear' \
  -F 'background=transparent' \
  -F 'format=original' \
  -F 'quality=95'

Справочник API

Отправьте POST-запрос с входными данными в JSON. Параметры типа «файл» требуют предварительной загрузки.

Endpoint

HTTP

POST https://api.elysiatools.com/ru/api/tools/image-composite-matrix

Параметры

Имя	Тип	Обязательный	Описание
imageFile	fileнужна загрузка	Да	Загрузить любой файл изображения (JPEG, PNG, WebP, GIF, BMP, TIFF) для композитного матричного преобразования
scaleX	range	Да	Горизонтальный фактор масштабирования (0.1 до 3.0, 1.0 = оригинальный размер)
scaleY	range	Да	Вертикальный фактор масштабирования (0.1 до 3.0, 1.0 = оригинальный размер)
angle	range	Да	Угол вращения в градусах (-180 до 180, 0 = без вращения)
shearX	range	Да	Горизонтальный фактор сдвига (-1.5 до 1.5, 0 = без сдвига)
shearY	range	Да	Вертикальный фактор сдвига (-1.5 до 1.5, 0 = без сдвига)
transformOrder	select	Да	Порядок применения преобразований (умножение справа налево)
background	text	Нет	Цвет фона для прозрачных областей (hex #RRGGBB или #RRGGBBAA, или название цвета)
format	select	Нет	Выбрать формат вывода или сохранить оригинал. PNG рекомендуется для прозрачности
quality	number	Нет	Качество вывода для форматов с потерями (JPEG, WebP). Выше = лучшее качество но больший размер файла

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-composite-matrix, затем возвращённый filePath передаётся в соответствующее поле.

Формат ответа

Файловый результат

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Интеграция MCP

Добавьте этот инструмент на свой сервер Model Context Protocol, чтобы ИИ-агенты могли перечислять и вызывать его.

Конфигурация сервера

Добавьте этот блок в конфигурацию вашего MCP-клиента:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-composite-matrix": {
      "name": "image-composite-matrix",
      "description": "Применить композитное преобразование, комбинируя несколько базовых преобразований (масштабирование, вращение, сдвиг). Увидьте, как матрицы преобразования умножаются и создают сложные эффекты.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite-matrix",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Получить список инструментов

После подключения к SSE-endpoint выведите список доступных инструментов:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Вызвать этот инструмент

Вызовите инструмент по его id; аргументы формируются из его параметров:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "image-composite-matrix",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "scaleX": "1.0",
  "scaleY": "1.0",
  "angle": "0",
  "shearX": "0",
  "shearY": "0",
  "transformOrder": "scale-rotate-shear",
  "background": "transparent",
  "format": "original",
  "quality": 95
}
  }
}

Объединяйте несколько инструментов в одной сессии списком toolId через запятую, напр. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (макс. 20).

Файловые параметры принимают только публичный URL файла (https://…). Локальные пути, data: URI и строки Base64 не поддерживаются.

Вопросы или проблемы? Свяжитесь с [email protected]