Media

Matriz Composta de Imagem

Aplicar transformação composta combinando múltiplas transformações básicas (escalamento, rotação, cisalhamento). Veja como as matrizes de transformação se multiplicam e criam efeitos complexos.

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

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/pt/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'

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

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

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFile	fileupload necessário	Sim	Carregar qualquer arquivo de imagem (JPEG, PNG, WebP, GIF, BMP, TIFF) para transformação de matriz composta
scaleX	range	Sim	Fator de escalonamento horizontal (0.1 a 3.0, 1.0 = tamanho original)
scaleY	range	Sim	Fator de escalonamento vertical (0.1 a 3.0, 1.0 = tamanho original)
angle	range	Sim	Ângulo de rotação em graus (-180 a 180, 0 = sem rotação)
shearX	range	Sim	Fator de cisalhamento horizontal (-1.5 a 1.5, 0 = sem cisalhamento)
shearY	range	Sim	Fator de cisalhamento vertical (-1.5 a 1.5, 0 = sem cisalhamento)
transformOrder	select	Sim	Ordem em que as transformações são aplicadas (multiplicação direita para esquerda)
background	text	Não	Cor de fundo para áreas transparentes (hex #RRGGBB ou #RRGGBBAA, ou nome da cor)
format	select	Não	Escolher formato de saída ou manter original. PNG recomendado para transparência
quality	number	Não	Qualidade de saída para formatos com perda (JPEG, WebP). Maior = melhor qualidade mas arquivo maior

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-composite-matrix; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

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)"
}

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-composite-matrix": {
      "name": "image-composite-matrix",
      "description": "Aplicar transformação composta combinando múltiplas transformações básicas (escalamento, rotação, cisalhamento). Veja como as matrizes de transformação se multiplicam e criam efeitos complexos.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite-matrix",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

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

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

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
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]