Kuvan skaalaus CMS:ssä

Oppaan tavoite

Opit, kuinka bluetronix CMS skaalaa paikallisia kuvia IMG.pl:n avulla CMS-sivun renderöintiprosessin aikana, mitkä kuusi parametriä kutsu käyttää ja miksi selain saa vain valmiiksi tuotetun kuvafile.

bluetronix CMS:llä on:

IMG.pl

keskitetty toiminto kuvien automaattiseen skaalaamiseen ja valmisteluun.

IMG.pl:tä käytetään CMS:n sisällä, jotta kuvat voidaan automaattisesti rajata tai skaalata haluttuun kokoon CMS-sivun renderöintiprosessin aikana.

Tärkeää: IMG.pl on bluetronix CMS:n sisäinen toiminto. IMG.pl-kutsua ei toimiteta vierailijalle lopullisena kuv URL:na.

Perusperiaate

HTML-koodissa voidaan aluksi käyttää sisäistä IMG.pl-kutsua.

Esimerkki:

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

CMS-sivuston renderöintiprosessin aikana tämä kutsu käsitellään.

CMS luo siitä kerran sopivan kokoisen kuvatiedoston.

Tämän jälkeen alkuperäinen IMG.pl-kutsu korvataan valmiin kuvatiedoston nimellä.

Koodi ennen renderöintiä

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

Koodi renderöinnin jälkeen

Käsittelyn jälkeen HTML-koodi voi esimerkiksi näyttää tältä:

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

Selaimelle ei siis palauteta alkuperäistä IMG.pl-kutsua, vaan suoraan jo luotu kuvatiedosto.

Prosessi CMS-sivun renderöintivaiheessa

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ä tarkoittaa, että kuvan skaalausta ei tarvitse suorittaa uudelleen joka kerta selainkutsussa.

IMG.pl käytetään vain sisäisesti

Tärkeää: IMG.pl on tarkoitettu vain bluetronix CMS:n sisäiseen käyttöön.

IMG.pl:ää ei saa käyttää ulkoisena kuvakäyttöliittymänä tai kutsua suoraan ulkoisilta verkkosivuilta.

Käsittely tapahtuu sisäisesti renderöintiprosessin aikana.

Ulospäin toimitetaan vain valmiiksi luotu kuvatiedosto.

Kuvien on oltava verkkotilassa saatavilla

Tärkeää: Kaikkien IMG.pl:n käsittelemien kuvien on oltava suoraan bluetronix-asennuksen verkkotilassa.

Ulkoisia kuvan URL-osoitteita ei voi käyttää lähdetiedostona.

Sallittuja esimerkkejä ovat:

/img/image.jpg

Ei sallittuja esimerkkejä ovat:

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

Lähdetiedoston on oltava saatavilla paikallisesti verkkotilassa.

IMG.pl-kutsun rakenne

Tyypillinen kutsu kuuluu näin:

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

Parametrit annetaan peräkkäin:

=

erotettuna.

Parametrinimiä ei käytetä.

Kritiikittömästi tärkeintä on vain parametrien järjestys.

Parametrin yleiskatsaus

Parametri 1 – Tiedostonimi

Ensimmäinen parametri sisältää polun lähdetiedostoon.

Esimerkki:

/img/image.jpg

Sisäisesti tämä parametri vastaa:

my $f = $help[0];

Jos annettua lähdetiedostoa ei ole, käsittely keskeytetään.

Huom: Ilman voimassa olevaa paikallista lähdetiedostoa IMG.pl ei voi luoda kuvaa.

Parametri 2 – Leveys

Toinen parametri määrittää toivotun kuvaleveyden pikseleissä.

Esimerkki:

700

Sisäisesti:

my $w = $help[1];

Parametri 3 – Korkeus

Kolmas parametri määrittää toivotun kuvakorkeuden pikseleissä.

Esimerkki:

500

Sisäisesti:

my $h = $help[2];

Parametri 4 – Suhteellisuus

Neljäs parametri ohjaa kuvan suhteellista skaalausta tai rajauksen.

Esimerkki:

1

Sisäisesti:

my $p = $help[3];

Tämän avulla voidaan määritellä, miten alkuperäinen kuvasuhde käsitellään skaalaamisen tai rajauksen yhteydessä.

Parametri 5 – Laatu

Viides parametri määrittää normaalien rasterikuvien luodun kuvafailin laadun.

Esimerkki:

100

Sisäisesti:

my $q = $help[4];

Yleensä tämä arvo on:

100

arvo.

Parametri 6 – Zoomaaminen

Kuudes parametri ohjaa, voidaanko kuvaa suurentaa, jos haluttu tulostuskoko on suurempi kuin alkuperäinen kuva.

Sisäisesti:

my $z = $help[5];

Kun:

1

kuva suurennetaan tarvittaessa.

Esimerkki:

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

Ilman aktivoitua zoomia liian pientä kuvaa ei suurenneta vastaavasti. Väljälle alueelle täytetään sen sijaan valkoinen reuna tai tausta.

Esimerkki kaikista kuudesta parametrista

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

Arvot tarkoittavat:

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

Sallitut tiedostotyypit

IMG.pl tukee seuraavia kuvamuotoja:

gif
jpg
jpe
jpeg
png
svg

Erityispiirteet SVG-tiedostoissa

SVG-tiedostoilla viidennellä parametrilla on erityinen merkitys.

Normaalimuodoissa, kuten JPG tai PNG, on:

my $q = $help[4];

kuvanlaatu.

SVG-tiedostoissa tätä parametria käytetään sen sijaan värinä.

Huom: $help[4] on teknisesti viides siirretty parametri, koska sisäinen taulukko alkaa indeksistä 0.

Näin ollen pätee:

JPG / PNG / GIF
Parameter 5
→ Qualität


SVG
Parameter 5
→ Farbe

Tämän avulla voidaan määrittää tai korvata haluttu väri SVG-tiedoston käsittelyn aikana.

Sisäinen parametrien kohdistus

Sisäisesti kuusi siirrettyä arvoa käsitellään seuraavasti:

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

Miksi IMG.pl korvataan renderöinnin aikana?

Sisäinen IMG.pl-kutsu ei ole tarkoitettu pysyväksi julkiseksi kuva-URL:ksi.

Sen sijaan se toimii CMS:lle ohjeena:

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

Tuloksena oleva tiedosto tallennetaan sitten normaalina kuva tiedostona.

Lähteestä:

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

tulee esimerkiksi:

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

Selain saa vain valmiin tiedoston.

CMS:n kuvaskaalauksen edut

Keskuskuvan skaalaus tarjoaa useita etuja:

• 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

Yhteenveto

IMG.pl on bluetronix CMS:n keskeinen sisäinen kuvien skaalaustoiminto.

Tyypillinen kutsu kuuluu näin:

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

Kuusi parametria ovat:

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

On tärkeää:

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.

Perusprosessi on seuraava:

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