DokumentationDynamic Media Image Serving and Rendering API

rect rect

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

Rechteck der endgültigen Ansicht. Dadurch kann das endgültige Ansichtsbild in mehrere Streifen oder Kacheln zerlegt werden, die vom Kunden getrennt und nahtlos neu zusammengestellt werden können, ohne dass Artefakte an den Kanten vorhanden sind.

rect= *coord*, *size*[, *scale*]

coord
Pixelversatz von der oberen linken Ecke des Ansichtsbilds oben links im Ansichtsrechteck (int, int), in Pixel ausgedrückt, nachdem Skalierung angewendet wurde.
size
Größe des ROI in Pixel (int, int). Gibt die Größe des Antwortbilds an. Das Bild wird mit bgc= in Bereichen gefüllt, die nicht vom Ansichtsbild abgedeckt werden (oder transparent gelassen, wenn in der Anforderung fmt=*-alpha vorhanden ist).
scale
Skalierungsfaktor (real). Werte, die kleiner als 1,0 sind, reduzieren die Auflösung, Werte größer als 1,0 erhöhen die Auflösung.

Mit diesem Befehl kann Image Serving große Bilder über HTTP bereitstellen, die ansonsten die mit attribute::MaxPix konfigurierte Größenbeschränkung überschreiten würden.

NOTE
Wenn die JPEG-Komprimierung verwendet wird, sollte die Streifen- oder Kachelgröße ein Vielfaches der JPEG-Kodierungs-Kachelgröße sein (16 x 16 Pixel).

Beispiel section-932fcfcb41d74a29bc929e4430c49601

Trennen Sie ein druckbares CMYK-Bild in mehrere Streifen mit voller Auflösung, um die Download-Dateigröße zu reduzieren. Wenn Sie ein zusammenhängendes Bild angefordert haben:

http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&fmt=tif&icc=WebCoated

Zunächst werden relevante Informationen zum Bild abgerufen:

http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&req=props

Die Textantwort enthält folgende Eigenschaften:

image.width=2000 image.height=2400 image.version=37JK6NTvpvC42F5gOuLEVY

Anhand dieser Informationen sind vier 600x2000 Pixelstreifen gewünscht. Der Befehl rect= dient zur Beschreibung der Bandgrößen und -positionen.

Da dieses Bild häufig geändert wird, ist der Befehl id= enthalten. Dadurch wird die Wahrscheinlichkeit minimiert, mit einem oder mehreren Streifen aus einer älteren Version des Bildes zu enden, die möglicherweise in einem CDN- oder Proxy-Server zwischengespeichert wurden. Zu diesem Zweck wird der Wert der Eigenschaft image.version verwendet.

http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&id=37JK6NTvpvC42F5gOuLEVY&rect=0,0,2000,600 http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&id=37JK6NTvpvC42F5gOuLEVY&rect=0,600,2000,600 http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&id=37JK6NTvpvC42F5gOuLEVY&rect=0,1200,2000,600 http://server/is/image/cat/imageId?scl=1&op_usm=.9,2&bgc=ffffff&id=37JK6NTvpvC42F5gOuLEVY&rect=0,1800,2000,600

Eigenschaften section-aae223cee13e46d38b74680c048d945b

Attribut anzeigen. Sie gilt unabhängig von der aktuellen Ebeneneinstellung.

Alle Bereiche des ROI, die sich außerhalb des Ansichtsbilds befinden, werden mit bgc= aufgefüllt.

Wichtig: rect= wird nach letzter Skalierung und Übereinstimmung mit scl=, wid=, hei=, fit=, rgn= und align= angewendet.

Standard section-b296d3bbfb19441f87137a452b70f19a

Gesamtes, unverändertes Ansichtsbild ( rect=0,0,width,height,1.0).

Siehe auch section-74015202c0c545ec82aec614d74b4bbd

crop= , extend=, wid=, hei=, scl=, align=, fit=, rgn=, attribute::MaxPix, id=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49