Bildskalning i CMS

Målet med guiden

Du lär dig hur bluetronix CMS skalar lokala bilder via IMG.pl under CMS-sidan rendering-processen, vilka sex parametrar anropet använder och varför webbläsaren sedan bara får den färdiga bildfilen.

Det bluetronix CMS har:

IMG.pl

en central funktion för automatisk skalning och bearbetning av bilder.

IMG.pl används inom CMS för att automatiskt beskära eller skala bilder till önskad storlek under CMS-sidan rendering-processen.

Viktigt: IMG.pl är en intern funktion i bluetronix CMS. IMG.pl-anropet levereras inte som en slutgiltig bild-URL till besökaren.

Grundprincip

Inom HTML-koden kan först ett internt IMG.pl-anrop användas.

Exempel:

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

Under CMS-sidan rendering-processen bearbetas detta anrop.

CMS:et skapar därmed en motsvarande skalad bildfil en gång.

Därefter ersätts den ursprungliga IMG.pl-anropet med filnamnet på den färdigt skapade bildfilen.

Kod före rendering

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

Kod efter rendering

Efter bearbetning kan HTML-koden se ut så här:

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

Webbläsaren får därmed inte det ursprungliga IMG.pl-anropet, utan direkt den redan skapade bildfilen.

Process i CMS-sidan rendering

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

Därmed behöver bildskaleringen inte göras om vid varje webbläsaranrop.

IMG.pl används endast internt

Viktigt: IMG.pl är endast avsedd för intern användning inom bluetronix CMS.

IMG.pl ska inte användas som extern bildgränssnitt eller direkt anropas av externa webbplatser.

Bearbetningen sker internt under renderingprocessen.

Utåt levereras endast den färdigt skapade bildfilen.

Bilder måste finnas på webbservern

Viktigt: Alla bilder som bearbetas via IMG.pl måste befinna sig direkt på webbutrymmet av den aktuella bluetronix-installationen.

Externa bild-URL:er kan inte användas som källfil.

Tillåtet är till exempel:

/img/image.jpg

Inte avsett är till exempel:

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

Källfilen måste vara tillgänglig lokalt inom webbutrymmet.

Uppbyggnad av ett IMG.pl-anrop

Ett typiskt anrop ser ut så här:

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

Parametrarna anges direkt efter varandra med:

=

åtskilt.

Inga parameternamn används.

Endast ordningen på parametrarna är avgörande.

Översikt av parametrar

Parameter 1 – Filnamn

Den första parametern innehåller sökvägen till källfilen.

Exempel:

/img/image.jpg

Internt motsvarar denna parameter:

my $f = $help[0];

Om den angivna källfilen inte finns, avbryts bearbetningen.

Observera: Utan en giltig lokal källfil kan IMG.pl inte skapa en bild.

Parameter 2 – Bredd

Den andra parametern bestämmer den önskade bildbredden i pixlar.

Exempel:

700

Internt:

my $w = $help[1];

Parameter 3 – Höjd

Den tredje parametern bestämmer den önskade bildhöjden i pixlar.

Exempel:

500

Internt:

my $h = $help[2];

Parameter 4 – Proportionalitet

Den fjärde parametern styr den proportionella skaleringen eller beskärningen av bilden.

Exempel:

1

Internt:

my $p = $help[3];

Detta kan kontrollera hur det ursprungliga bildförhållandet hanteras vid skalning eller beskärning.

Parameter 5 – Kvalitet

Den femte parametern bestämmer kvaliteten på den skapade bildfilen vid vanliga rasterbilder.

Exempel:

100

Internt:

my $q = $help[4];

I regel sätts detta värde till:

100

anges.

Parameter 6 – Zoom

Den sjätte parametern styr om en bild får förstoras om den önskade utmatningsstorleken är större än originalbilden.

Internt:

my $z = $help[5];

Med:

1

förstoras bilden vid behov.

Exempel:

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

Utan aktiverad zoom kommer en för liten bild inte att skalas upp. Den återstående ytan fylls istället med en vit kant eller bakgrund.

Exempel med alla sex parametrar

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

Värdena betyder:

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

Godkända filtyper

IMG.pl stöder följande bildformat:

gif
jpg
jpe
jpeg
png
svg

Särskildhet vid SVG-filer

För SVG-filer har den femte parametern en särskild betydelse.

För vanliga bildformat som JPG eller PNG är:

my $q = $help[4];

bildkvaliteten.

För SVG-filer används istället denna parameter som färg.

Notera: $help[4] är tekniskt den femte överförda parametern, eftersom den interna arrayen börjar med index 0.

Således gäller:

JPG / PNG / GIF
Parameter 5
→ Qualität


SVG
Parameter 5
→ Farbe

Genom att bearbeta en SVG-fil kan en önskad färg sättas eller ersättas.

Intern parameterkartläggning

Internt behandlas de sex överförda värdena på följande sätt:

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

Varför ersätts IMG.pl vid rendering?

Det interna IMG.pl-anropet är inte avsett som en permanent offentlig bild-URL.

Istället fungerar det som en instruktion för CMS:

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

Resultatet sparas sedan som en vanlig bildfil.

Från:

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

blir till exempel:

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

Webbläsaren får därför endast den färdiga filen.

Fördelar med CMS-bildskalning

Den centrala bildskalningen erbjuder flera fördelar:

• 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

Sammanfattning

IMG.pl är den centrala interna bildskaleringsfunktionen för bluetronix CMS.

Ett typiskt anrop ser ut så här:

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

De sex parametrarna är:

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

Viktigt är:

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.

Det grundläggande flödet är:

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