Škálování obrázků v CMS

Cíl tutoriálu

Naučíš se, jak CMS bluetronix škáluje místní obrázky pomocí IMG.pl během procesu renderování CMS stránky, jaké šest parametrů volání používá a proč prohlížeč poté obdrží pouze hotově vytvořený soubor obrázku.

CMS bluetronix má:

IMG.pl

centrální funkci pro automatickou škálování a úpravu obrázků.

IMG.pl se používá uvnitř CMS k automatickému oříznutí nebo škálování obrázků na požadovanou velikost během procesu renderování CMS stránky.

Důležité: IMG.pl je interní funkce CMS bluetronix. Volání IMG.pl není návštěvníkovi doručeno jako konečná URL obrázku.

Základní princip

Uvnitř HTML kódu může být nejprve použito interní volání IMG.pl.

Příklad:

<img src="/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1">

Během procesu vykreslování CMS stránek je tento požadavek zpracován.

CMS z toho jednorázově vytvoří odpovídající škálovaný obrázek.

Poté je původní IMG.pl požadavek nahrazen názvem dokončeného obrázku.

Kód před renderováním

<img src="/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1">

Kód po renderování

Po zpracování může mít HTML kód například takovou podobu:

<img src="/tmp/img_image_700_500_1_100_1_1070.jpg">

Prohlížeč tak nezíská původní IMG.pl požadavek, ale přímo již vytvořený obrázek.

Průběh procesu renderování CMS stránky

HTML enthält IMG.pl-Aufruf
      ↓
CMS-Site-Rendering-Prozess
      ↓
IMG.pl wird intern verarbeitet
      ↓
Bild wird skaliert / zugeschnitten
      ↓
neue Bilddatei wird erzeugt
      ↓
IMG.pl-Aufruf wird ersetzt
      ↓
fertiger Bild-Dateiname wird in das HTML eingesetzt
      ↓
fertige HTML-Seite wird ausgeliefert

Tím pádem se škálování obrázků nemusí provádět při každém volání prohlížeče znovu.

IMG.pl se používá jen interně

Důležité: IMG.pl je určeno výhradně pro vnitřní použití v rámci bluetronix CMS.

IMG.pl by neměl být používán jako externí rozhraní pro obrázky nebo volán přímo z externích webových stránek.

Zpracování probíhá interně během procesu vykreslování.

Na venek je dodáván pouze dokončený obrázek.

Obrázky musí být přítomny na webovém prostoru

Důležité: Všechny obrázky zpracovávané přes IMG.pl musí být přímo na webovém prostoru příslušné instalace bluetronix.

Externí URL obrázků nemohou být použity jako zdrojový soubor.

Přípustné je například:

/img/image.jpg

Nepřipouští se například:

https://external-domain.com/image.jpg

Zdrojový soubor musí být dostupný lokálně v rámci webového prostoru.

Struktura volání IMG.pl

Typický požadavek vypadá takto:

<img src="/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1">

Parametry se uvádějí přímo za sebou s:

=

odděleni.

Názvy parametrů nejsou používány.

Rozhodující je výhradně pořadí parametrů.

Přehled parametrů

Parametr 1 – Název souboru

První parametr obsahuje cestu k zdrojovému souboru.

Příklad:

/img/image.jpg

Interně tento parametr odpovídá:

my $f = $help[0];

Pokud zadaný zdrojový soubor neexistuje, zpracování bude ukončeno.

Poznámka: Bez platného místního zdrojového souboru nemůže IMG.pl vygenerovat žádný obrázek.

Parametr 2 – Šířka

Druhý parametr určuje požadovanou šířku obrázku v pixelech.

Příklad:

700

Interně:

my $w = $help[1];

Parametr 3 – Výška

Třetí parametr určuje požadovanou výšku obrázku v pixelech.

Příklad:

500

Interně:

my $h = $help[2];

Parametr 4 – Proporcionalita

Čtvrtý parametr řídí proporční škálování, resp. oříznutí obrázku.

Příklad:

1

Interně:

my $p = $help[3];

Tímto lze řídit, jak bude zachováno původní proporční rozměry obrázku při škálování nebo oříznutí.

Parametr 5 – Kvalita

Pátý parametr určuje kvalitu vytvářené obrazové souboru u normálních rastrových obrázků.

Příklad:

100

Interně:

my $q = $help[4];

Obvykle je tato hodnota nastavena na:

100

nastaveno.

Parametr 6 – Přiblížení

Šestý parametr řídí, zda může být obrázek zvětšen, pokud je požadovaná výstupní velikost větší než originální obrázek.

Interně:

my $z = $help[5];

S:

1

se obrázek při potřebě zvětší.

Příklad:

...=700=500=1=100=1

Bez aktivního zoomu nebude příliš malý obrázek odpovídajícím způsobem zvětšen. Zbývající prostor bude místo toho vyplněn bílým okrajem nebo pozadím.

Příklad se všemi šesti parametry

/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1

Hodnoty znamenají:

1. /img/image.jpg
   → Quelldatei

2. 700
   → Breite: 700 Pixel

3. 500
   → Höhe: 500 Pixel

4. 1
   → proportionale Verarbeitung / Zuschnitt

5. 100
   → Bildqualität

6. 1
   → Zoom aktiviert

Povolené typy souborů

IMG.pl podporuje následující formáty obrázků:

gif
jpg
jpe
jpeg
png
svg

Zvláštnost u SVG souborů

U SVG souborů má pátý parametr zvláštní význam.

U běžných obrazových formátů jako JPG nebo PNG je:

my $q = $help[4];

kvalita obrázku.

U SVG souborů se tento parametr naopak používá jako barva.

Poznámka: $help[4] je technicky pátý předaný parametr, protože interní pole začíná na indexu 0.

Tímto platí:

JPG / PNG / GIF
Parameter 5
→ Qualität


SVG
Parameter 5
→ Farbe

Při zpracování SVG souboru lze nastavit nebo nahradit požadovanou barvu.

Interní přiřazení parametrů

Interně se předané hodnoty zpracovávají následovně:

my $f = $help[0];  # Dateiname
my $w = $help[1];  # Breite
my $h = $help[2];  # Höhe
my $p = $help[3];  # Proportionalität
my $q = $help[4];  # Qualität / bei SVG: Farbe
my $z = $help[5];  # Zoom

Proč je IMG.pl při renderování nahrazen?

Interní volání IMG.pl není určeno jako trvalá veřejná URL pro obrázky.

Místo toho slouží CMS jako pokyn:

Nimm dieses Bild
+
erzeuge diese Größe
+
verwende diese Skalierung
+
verwende diese Qualität
+
berücksichtige die Zoom-Einstellung

Výsledek bude následně uložen jako běžný obrázek.

Z:

<img src="/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1">

se například stane:

<img src="/tmp/img_image_700_500_1_100_1_1070.jpg">

Prohlížeč tak obdrží pouze hotový soubor.

Výhody škálování obrázků v CMS

Centrální škálování obrázků nabízí několik výhod:

• einheitliche Bildgrößen
• automatischer Bildzuschnitt
• keine manuelle Erstellung jeder einzelnen Bildgröße erforderlich
• fertige Bilddateien können direkt ausgeliefert werden
• IMG.pl muss nicht als öffentliche Bildschnittstelle verwendet werden
• die Bildverarbeitung wird zentral vom CMS gesteuert

Shrnutí

IMG.pl je centrální interní funkce pro škálování obrázků v bluetronix CMS.

Typický požadavek vypadá takto:

<img src="/CMS/cgi-bin/IMG.pl?/img/image.jpg=700=500=1=100=1">

Šest parametrů je:

1. Dateiname
2. Breite
3. Höhe
4. Proportionalität
5. Qualität / bei SVG Farbe
6. Zoom

Důležité je:

Quelldateien müssen lokal auf dem Webspace liegen.

IMG.pl ist nur für die interne CMS-Verarbeitung vorgesehen.

IMG.pl-Aufrufe werden während des Rendering-Prozesses verarbeitet.

Nach außen wird die fertig erzeugte Bilddatei ausgeliefert.

Základní postup je následující:

lokales Originalbild
      ↓
IMG.pl
      ↓
Skalierung / Zuschnitt
      ↓
fertige Bilddatei erzeugen
      ↓
IMG.pl-Aufruf im HTML ersetzen
      ↓
fertige Bild-URL an den Browser ausliefern