Bild auf Ausschnitt zuschneiden

Dieser Prüfer übernimmt Breite und Höhe des Quellbildes sowie einen durch x, y, Breite und Höhe beschriebenen Ausschnitt. Er kontrolliert jeden Wert, stellt sicher, dass das gesamte Rechteck im Bild liegt, und gibt bei einem gültigen Bereich die zugeschnittenen Abmessungen zurück. Ein Hochladen oder Dekodieren des Bildes ist nicht nötig. Daher können Sie die Prüfung vor einer Bildverarbeitung, für eine Vorschau oder beim Übernehmen von Koordinaten aus einem anderen Dienst einsetzen.

Quellbild und Ausschnitt beschreiben

Beginnen Sie mit den Pixelmaßen des Originalbildes. Tragen Sie bei image_width die gesamte horizontale Pixelzahl und bei image_height die gesamte vertikale Pixelzahl ein. Beschreiben Sie anschließend das Rechteck mit x, y, width und height. Die Werte x und y positionieren seine obere linke Ecke relativ zur oberen linken Bildecke mit der Koordinate 0,0. Width erstreckt sich nach rechts, height nach unten. Alle sechs Werte müssen ganze Zahlen sein, da diese Funktion pixelgenaue Rasterausschnitte und keine Bruchgeometrie modelliert. Bild- und Ausschnittmaße müssen positiv sein; x und y dürfen null betragen. Beispielsweise überspringt x mit dem Wert 240 die ersten 240 Pixelspalten. Ein Ausschnitt darf jede Bildkante exakt berühren. Deshalb darf x plus width gleich image_width und y plus height gleich image_height sein. Verwenden Sie Maße desselben Bildes, das später zugeschnitten wird. Koordinaten aus einer skalierten Vorschau müssen Sie zuvor auf die Originalgröße umrechnen.

Funktionsweise der Grenzprüfung verstehen

Die Prüfung weist zunächst fehlende Werte, Nicht-Ganzzahlen, negative Koordinaten, Ausschnitte ohne Fläche und Werte außerhalb des dokumentierten Bereichs zurück. Danach werden die beiden Grenzen für das vollständige Einschließen kontrolliert. Horizontal muss x plus width kleiner oder gleich image_width sein. Vertikal muss y plus height kleiner oder gleich image_height sein. Ist eine Summe größer, liegt ein Teil des Ausschnitts außerhalb der Quelle und die Anfrage liefert einen Fehler für ungültige Eingaben. Diese eindeutige Regel verhindert ein verbreitetes Missverständnis um eine Einheit: Ein 100 Pixel breiter Ausschnitt ab x 0 belegt eine vollständige Spanne von 100 Pixeln und passt exakt in ein 100 Pixel breites Bild. Die Funktion begrenzt, verschiebt oder verkleinert einen ungültigen Bereich nicht, denn eine unbemerkte Änderung kann ein anderes Motiv oder einen anderen Bildaufbau erzeugen. Bilddaten selbst werden ebenfalls nicht untersucht. Die Entscheidung beruht ausschließlich auf den angegebenen Maßen und Koordinaten und ist deshalb schnell, reproduzierbar sowie für Formulare und automatisierte Abläufe geeignet.

Ergebnis vor dem echten Zuschnitt verwenden

Eine erfolgreiche Antwort enthält Breite und Höhe des entstehenden Ausschnitts. Diese Werte entsprechen dem angeforderten Rechteck, weil die Funktion Geometrie validiert und weder neu skaliert noch verändert. Nutzen Sie die Antwort als Schutz, bevor Sie dieselben Koordinaten an eine Bildbibliothek, einen Mediendienst oder einen eingereihten Renderingauftrag übergeben. So trennen Sie eine günstige Eingabeprüfung von aufwendiger Dekodierung und halten vorhersehbare Grenzfehler von nachgelagerten Systemen fern. Prüfen Sie in einem Editor nach Bestätigung der Auswahl oder nachdem Vorschaukoordinaten in Pixel des Originals zurückgerechnet wurden. Kontrollieren Sie in einer Datenpipeline Ausschnittmetadaten direkt beim Eingang und leiten Sie fehlerhafte Datensätze zur Korrektur weiter. Beachten Sie die Ausrichtung: Dreht ein anderer Schritt das Bild tatsächlich, verwenden Sie die Maße nach der Drehung und Koordinaten derselben Orientierung. Eine API-Anfrage kostet $0.002; der Browser führt dieselbe deterministische Berechnung lokal aus. Bei keinem Weg wird ein Bild übertragen.