Filigrana immagine: posizione, scala e riquadro
Questo calcolatore determina con precisione dove verrà collocata una filigrana prima di modificare qualsiasi pixel.
Esegui gratis nel browser
Inserisca le dimensioni dell'immagine di base e della filigrana, un fattore di scala e una delle nove posizioni di ancoraggio. Il risultato riporta le coordinate sinistra, superiore, destra e inferiore, oltre a larghezza e altezza finali. La riduzione proporzionale facoltativa adatta una filigrana troppo grande senza alterarne le proporzioni.
Descriva entrambe le immagini nello stesso sistema di coordinate
Inizi dalla larghezza e dall'altezza dell'immagine di base, quindi inserisca le dimensioni naturali della filigrana. I pixel sono l'unità consueta, ma va bene qualsiasi unità positiva usata con coerenza. Il fattore di scala viene applicato uniformemente a entrambe le dimensioni e conserva le proporzioni. Un valore di 0.5 dimezza ogni dimensione, mentre 2 le raddoppia. Il calcolatore rifiuta valori mancanti, nulli, negativi, non numerici o infiniti, perché non definiscono un rettangolo valido. Non legge né modifica file, non stima il disegno visibile all'interno della trasparenza e non considera la rotazione. Usi le dimensioni complete della tela di ciascuna immagine. La larghezza e l'altezza restituite descrivono l'intera tela della filigrana collocata, compresi gli eventuali pixel trasparenti appartenenti al file sorgente.
Scelga un ancoraggio e interpreti il riquadro
La posizione seleziona uno dei nove ancoraggi: i quattro angoli, il punto centrale di ciascun bordo oppure il centro esatto. L'origine è nell'angolo superiore sinistro, come nelle normali coordinate raster: x cresce verso destra e y verso il basso. Una filigrana in alto a sinistra parte da zero su entrambi gli assi; in basso a destra termina alla larghezza e all'altezza della base. Le opzioni centrate dividono equamente lo spazio residuo e possono generare decimali. La risposta fornisce x e y per l'angolo superiore sinistro, width e height per la dimensione collocata, e right e bottom per i bordi opposti. Questi valori formano il riquadro richiesto da molte librerie grafiche. Non è incluso alcun margine. Se serve una distanza dal bordo, modifichi successivamente le coordinate o allarghi prima il rettangolo concettuale.
Gestisca consapevolmente le filigrane sovradimensionate
La scala viene valutata prima del posizionamento. Se la filigrana scalata supera la larghezza o l'altezza dell'immagine di base, il comportamento predefinito restituisce un errore di input per evitare ritagli inattesi. Attivi scale_down quando desidera l'adattamento automatico. Il calcolatore sceglie il rapporto minore fra quelli disponibili per larghezza e altezza, applica uniformemente tale riduzione aggiuntiva e garantisce che entrambe le dimensioni rientrino. L'opzione non ingrandisce mai la filigrana e interviene solo quando la misura richiesta è eccessiva. La risposta include la scala finale e l'indicatore scaled_down, così il processo può registrare l'eventuale modifica. Una singola regola può quindi servire immagini orizzontali, verticali e miniature senza deformazioni. Il calcolo è deterministico, non carica file, non usa la rete e costa $0.002 per richiesta API quando viene automatizzato.
Casi d'uso
Preparare un comando di sovrapposizione
Calcoli coordinate e dimensioni esatte prima di passare logo e immagine di base a una libreria grafica.
Convalidare regole adattive
Provi la stessa scala e lo stesso ancoraggio su formati desktop, mobili, verticali e miniature senza modificare file.
Evitare ritagli accidentali
Rifiuti una filigrana eccessiva o la adatti proporzionalmente prima della sovrapposizione in produzione.
Domande frequenti
Questa capacità modifica un'immagine?
No. Calcola soltanto la geometria e restituisce un riquadro utilizzabile da un altro renderer o da una libreria.
Dove si trova l'origine delle coordinate?
Nell'angolo superiore sinistro della base. x aumenta verso destra e y verso il basso.
La scala conserva le proporzioni?
Sì. Un unico fattore viene applicato a entrambe le dimensioni, anche nell'adattamento proporzionale facoltativo.
Cosa accade se la filigrana è troppo grande?
La richiesta fallisce per impostazione predefinita. Attivi scale_down per ridurla proporzionalmente finché rientra.
La posizione include margini?
No. Gli ancoraggi toccano il bordo pertinente o centrano esattamente il rettangolo. Applichi poi la distanza voluta.
Quanto costa una richiesta API?
Il prezzo è $0.002 per richiesta. Lo stesso calcolo deterministico è disponibile gratuitamente nel browser.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/image/watermark-image \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}'const res = await fetch("https://api.kit.forhosting.com/image/watermark-image", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_width": 1200,
"base_height": 800,
"watermark_width": 300,
"watermark_height": 120
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/watermark-image",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_width": 1200,
"base_height": 800,
"watermark_width": 300,
"watermark_height": 120
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/watermark-image", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/watermark-image", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"base_width": 1200,
"base_height": 800,
"watermark_width": 300,
"watermark_height": 120
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.watermark_image",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 15 |
max_megapixels | 12 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |