Bilde-skala i CMS

Målet med veiledningen

Du lærer hvordan bluetronix CMS skalerer lokale bilder via IMG.pl under CMS-nettside-renderingsprosessen, hvilke seks parametere anropet bruker og hvorfor nettleseren deretter kun mottar den ferdig produserte bildefilen.

bluetronix CMS har:

IMG.pl

en sentral funksjon for automatisk skalering og bearbeiding av bilder.

IMG.pl brukes innen CMS for automatisk å beskjære eller skalere bilder under CMS-nettside-renderingsprosessen til ønsket størrelse.

Viktig: IMG.pl er en intern funksjon av bluetronix CMS. IMG.pl-anropet leveres ikke som en endelig bild-URL til besøkeren.

Grunnprinsipp

Innen HTML-koden kan en intern IMG.pl-anrop først brukes.

Eksempel:

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

Under prosessen for CMS-nettside-rendeing behandles dette kallet.

CMSet genererer en en gang et tilsvarende skalert bilde.

Deretter blir den originale IMG.pl-kallet erstattet med filnavnet på det ferdige genererte bildet.

Kode før rendering

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

Kode etter rendering

Etter behandlingen kan HTML-koden for eksempel se slik ut:

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

Nettleseren får dermed ikke den originale IMG.pl-kallet, men direkte det allerede genererte bildet.

Forløp i CMS-nettside-renderingsprosessen

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

Dermed trenger ikke bildeskaleringen å utføres på nytt ved hver nettleserforespørsel.

IMG.pl brukes kun internt

Viktig: IMG.pl er kun ment for intern bruk innen bluetronix CMS.

IMG.pl skal ikke brukes som en ekstern bildesnitt eller direkte kalles fra eksterne nettsteder.

Behandlingen skjer internt under rendeingprosessen.

Utad blir kun det ferdig genererte bildet levert.

Bilder må være tilgjengelige på webområdet

Viktig: Alle bildene som behandles via IMG.pl må være direkte på webområdet til den respektive bluetronix-installasjonen.

Eksterne bilde-URLer kan ikke brukes som kildefil.

Tillatt er for eksempel:

/img/image.jpg

Ikke tillatt er for eksempel:

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

Kildefilen må være tilgjengelig lokalt innen webområdet.

Oppbygning av et IMG.pl-anrop

Et typisk kall ser slik ut:

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

Parametrene blir lagt rett etter hverandre med:

=

separert.

Det brukes ingen parameternavn.

Avgjørende er kun rekkefølgen på parameterne.

Oversikt over parametere

Parameter 1 – Filnavn

Den første parameteren inneholder stien til kildefilen.

Eksempel:

/img/image.jpg

Internt stemmer denne parameteren med:

my $f = $help[0];

Hvis den angitte kildefilen ikke finnes, blir behandlingen avsluttet.

Merk: Uten gyldig lokal kildefil kan ikke IMG.pl generere et bilde.

Parameter 2 – Bredde

Den andre parameteren bestemmer den ønskede bildebredden i piksler.

Eksempel:

700

Internt:

my $w = $help[1];

Parameter 3 – Høyde

Den tredje parameteren bestemmer den ønskede bildehøyden i piksler.

Eksempel:

500

Internt:

my $h = $help[2];

Parameter 4 – Proporsjonalitet

Den fjerde parameteren styrer den proporsjonale skaleringen eller beskjæringen av bildet.

Eksempel:

1

Internt:

my $p = $help[3];

Dermed kan man kontrollere hvordan det opprinnelige bildetransformasjonsholdet håndteres under skalering eller beskjæring.

Parameter 5 – Kvalitet

Den femte parameteren bestemmer kvaliteten på den genererte bildefilen for vanlige rasterbilder.

Eksempel:

100

Internt:

my $q = $help[4];

Som regel settes denne verdien til:

100

verdi.

Parameter 6 – Zoom

Den sjette parameteren styrer om et bilde kan forstørres når den ønskede utgangsstørrelsen er større enn originalbildet.

Internt:

my $z = $help[5];

Med:

1

vil bildet bli forstørret ved behov.

Eksempel:

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

Uten aktivert zoom vil et for lite bilde ikke bli oppskalert tilsvarende. Den gjenværende delen vil i stedet bli fylt med en hvit kant eller bakgrunn.

Eksempel med alle seks parametere

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

Verdiene betyr:

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

Godkjente filtyper

IMG.pl støtter følgende bildeformater:

gif
jpg
jpe
jpeg
png
svg

Spesiell bemerkning ved SVG-filer

For SVG-filer har den femte parameteren en spesiell betydning.

For vanlige bildeformater som JPG eller PNG er:

my $q = $help[4];

bildekvaliteten.

For SVG-filer brukes derimot denne parameteren som farge.

Merk: $help[4] er teknisk sett den femte overleverte parameteren, da det interne arrayet begynner ved indeks 0.

Dermed gjelder:

JPG / PNG / GIF
Parameter 5
→ Qualität


SVG
Parameter 5
→ Farbe

Ved behandling av en SVG-fil kan en ønsket farge settes eller erstattes.

Intern parametertildeling

Internt vil de seks overførte verdiene bli behandlet som følger:

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

Hvorfor blir IMG.pl erstattet ved rendering?

Den interne IMG.pl-kallet er ikke ment som en permanent offentlig bilde-URL.

I stedet fungerer det som en instruksjon til CMS:

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

Resultatet lagres deretter som en vanlig bilde-fil.

Fra:

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

blir for eksempel:

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

Nettleseren får dermed bare den ferdige filen.

Fordeler med CMS-bildeskalering

Den sentrale bildeskaleringen tilbyr flere fordeler:

• 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

Sammendrag

IMG.pl er den sentrale interne bildeskaleringsfunksjonen i bluetronix CMS.

Et typisk kall ser slik ut:

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

De seks parameterne er:

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

Viktig er:

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.

Den grunnleggende prosessen er som følger:

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