Klasifikácia obrázkov v CMS

Cieľ tutoriálu

Naučíš sa, ako bluetronix CMS škáluje lokálne obrázky pomocou IMG.pl počas procesu renderovania stránky CMS, aké šesť parametrov volanie používa a prečo prehliadač následne dostane iba hotový obrázkový súbor.

bluetronix CMS má:

IMG.pl

centrálnu funkciu automatického škálovania a úpravy obrázkov.

IMG.pl sa používa v rámci CMS na automatické orezanie alebo škálovanie obrázkov na požadovanú veľkosť počas procesu renderovania stránky CMS.

Dôležité: IMG.pl je interná funkcia bluetronix CMS. Volanie IMG.pl nie je dodávané ako konečná URL adresa obrázka návštevníkovi.

Základný princíp

V rámci HTML kódu môže byť najprv použité interné volanie IMG.pl.

Príklad:

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

Počas procesu renderovania stránky v CMS sa tento volanie spracováva.

CMS z toho vytvára raz vhodne škálovaný súbor obrázku.

Následne je pôvodné volanie IMG.pl nahradené názvom súboru hotového obrázku.

Kód pred renderovaním

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

Kód po renderovaní

Po spracovaní môže HTML kód vyzerať napríklad takto:

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

Prehliadač teda nedostane pôvodné volanie IMG.pl, ale priamo už vytvorený obrázok.

Prebeh renderovania v CMS-site

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ádom sa škálovanie obrázku nemusí vykonávať pri každom volaní prehliadača znova.

IMG.pl sa používa iba interne

Dôležité: IMG.pl je určené výhradne na interné použitie v rámci bluetronix CMS.

IMG.pl sa nemá používať ako externé rozhranie pre obrázky ani priamo vyvolávať z externých webových stránok.

Spracovanie prebieha interne počas procesu renderovania.

Navonok sa dodáva len hotový súbor obrázku.

Obrázky musia byť dostupné na webovom priestore

Dôležité: Všetky obrázky, ktoré sú spracované cez IMG.pl, musia byť priamo na webovom priestore príslušnej inštalácie bluetronix.

Externé URL obrázkov nemôžu byť použité ako zdrojový súbor.

Povolené je napríklad:

/img/image.jpg

Nepovolí sa napríklad:

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

Zdrojový súbor musí byť lokálne dostupný v rámci webového priestoru.

Štruktúra volania IMG.pl

Typické volanie znie:

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

Parametre sa zapisujú priamo za sebou s:

=

oddelené.

Názvy parametrov sa nepoužívajú.

Rozhodujúca je výlučne poradie parametrov.

Prehľad parametrov

Parameter 1 – Názov súboru

Prvý parameter obsahuje cestu k zdrojovému súboru.

Príklad:

/img/image.jpg

Interný ekvivalent tohto parametra:

my $f = $help[0];

Ak neexistuje zadaný zdrojový súbor, spracovanie sa skončí.

Poznámka: Bez platného miestneho zdrojového súboru nemôže IMG.pl vytvoriť žiadny obrázok.

Parameter 2 – Šírka

Druhý parameter určuje požadovanú šírku obrázka v pixeloch.

Príklad:

700

Interný:

my $w = $help[1];

Parameter 3 – Výška

Tretí parameter určuje požadovanú výšku obrázka v pixeloch.

Príklad:

500

Interný:

my $h = $help[2];

Parameter 4 – Proporcionalita

Štvrtý parameter riadi proporčné škálovanie alebo orezanie obrázka.

Príklad:

1

Interný:

my $p = $help[3];

Týmto sa dá riadiť, ako sa pri škálovaní alebo orezaní zaobchádza s pôvodným stránkovým pomerom obrázka.

Parameter 5 – Kvalita

Piaty parameter určuje kvalitu vytvorenej obrazovej súboru pri normálnych rastrách.

Príklad:

100

Interný:

my $q = $help[4];

Všeobecne je táto hodnota nastavená na:

100

.

Parameter 6 – Priblíženie

Šiesty parameter určuje, či sa obrázok môže zväčšiť, ak je požadovaná veľkosť výstupu väčšia ako pôvodný obrázok.

Interný:

my $z = $help[5];

S:

1

sa obrázok v prípade potreby zväčší.

Príklad:

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

Bez aktivovaného zoomu sa príliš malý obrázok nemôže zodpovedajúco zväčšiť. Zostávajúca oblast sa namiesto toho vyplní bielym okrajom alebo pozadím.

Príklad so všetkými šiestimi parametrami

/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

Prijateľné typy súborov

IMG.pl podporuje nasledujúce formáty obrázkov:

gif
jpg
jpe
jpeg
png
svg

Osobitosť pri SVG súboroch

Pri SVG súboroch má piaty parameter osobitný význam.

Pri normálnych formátoch obrázkov, ako sú JPG alebo PNG, je:

my $q = $help[4];

kvalita obrázka.

Pri SVG súboroch sa tento parameter naopak používa ako farba.

Poznámka: $help[4] je technicky piaty odovzdaný parameter, pretože interné pole začína na indexe 0.

Týmto platí:

JPG / PNG / GIF
Parameter 5
→ Qualität


SVG
Parameter 5
→ Farbe

Pri spracovaní SVG súboru môže byť nastavená alebo nahradená požadovaná farba.

Interné priradenie parametrov

Intern sa šesť predaných hodnôt spracováva nasledovne:

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

Prečo je IMG.pl nahradené pri renderovaní?

Interný volanie IMG.pl nie je určené ako trvalá verejná URL adresa obrázku.

Namiesto toho slúži CMS ako pokyn:

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

Výsledok sa následne uloží ako bežný obrázkový súbor.

Z:

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

sa napríklad stane:

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

Prehliadač tak dostane iba hotový súbor.

Výhody škálovania obrázkov v CMS

Centrálny skaler obrázkov ponúka niekoľko 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

Zhrnutie

IMG.pl je centrálna interna funkcia na skalovanie obrázkov v bluetronix CMS.

Typické volanie znie:

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

Šesť parametrov sú:

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:

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