wThumbnail::createThumbnail

Erstellt ein Vorschaubild auf Basis eines vorhandenen Bildes

Funktionsaufruf

String createThumbnail(String path, Integer width, Integer height, String mode)

Parameter

path

Pfad des Orginalbildes, aus dem das Vorschaubild generiert werden soll

width

Breite des zu erstellenden Vorschaubildes

height

Höhe des zu erstellenden Vorschaubildes

mode

Darstellungsmodus [default|crop|cropTop|cropRight|cropBottom|cropLeft|embed|embedTop|embedRight|embedBottom|embedLeft|embedTopLeft|embedTopRight|embedBottomRight|embedBottomLeft|force]

default
Das Bild wird so weit verkleinert, dass beide Seiten in die Vorgabe passen und der ggf. entstehende Leerraum abgeschnitten wird. So kann es sein, dass eine Seite kleiner als angegeben dargestellt wird.
crop
Das Bild wird so weit verkleinert, dass eine Seite in die Vorgabe passt und die ggf. überstehenden Seiten abgeschnitten werden.
cropTop
Wie crop mit Ausrichtung oben
cropRight
Wie crop mit Ausrichtung right
cropBottom
Wie crop mit Ausrichtung unten
cropLeft
Wie crop mit Ausrichtung links
embed
Das Bild wird so weit verkleinert, dass beide Seiten in die Vorgabe passen und der ggf. entstehende Leerraum aufgefüllt wird.
embedTop
Wie embed mit Ausrichtung oben
embedRight
Wie embed mit Ausrichtung rechts
embedBottom
Wie embed mit Ausrichtung unten
embedLeft
Wie embed mit Ausrichtung links
embedTopLeft
Wie embed mit Ausrichtung oben links
embedTopRight
Wie embed mit Ausrichtung oben rechts
embedBottomRight
Wie embed mit Ausrichtung unten rechts
embedBottomLeft
Wie embed mit Ausrichtung unten links
force
Die Größe wird angepasst und das Bild ggf. verzerrt
copyrightText
Copyright Text

options

Zusatzoptionen

cutLeft
Linke Position beim Ausschneiden
cutTop
Obere Position beim Ausschneiden
cutWidth
Breite beim Ausschneiden
cutHeight
Höhe beim Ausschneiden
cryptPath
Gibt an, ob der Bildpfad verkryptet werden soll
useTransparency
Falls keine Transparenz benutzt werden darf, muss der Wert auf no stehen
backgroundColor
Falls die Hintergrundfarbe definiert werden soll (z.B. #fcfcfc)
hd
Falls ein HD-Bild generiert werden soll
quality
Falls die Qualität bei JPG-Bildern reduziert werden soll (0-100)
qualityHD
Falls die Qualität bei der HD-Darstellung von JPG-Bildern abweichend von der Standardqualität reduziert werden soll (0-100)
colorspace
Falls das Bild in Graustufen ausgegeben werden soll [|gray]
srcAlt
Alternatives Bild, falls das angegebene Bild nicht existiert
filenameOnly
Dateiname (ohne Endung) des generierten Bildes
additionalMinWidth
Maximale Bildbreite bei minimaler Bildschirmbreite
useOrig [|true]
Falls das Originalbild ausgegeben werden soll

Diese Funktion erstellt auf Basis eines vorhandenen Bildes eine kleinere Vorschauversion.

Animierte Bilder (z.B. GIFs) verlieren die Funktionalität beim Generieren eines Vorschaubildes!
Im Bild-Element kann dies umgangen werden, indem dort die Auswahl auf "Originalgröße" gesetzt wird.

Beispiel

Erstellt ein Vorschaubild, das in die definierte Bildgröße eingepasst wird

Quelltext

<?php

$pathThumbnail 
wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120120'embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120'''embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'''120'embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

print 
'<br />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120120'embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120'''embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'''120'embed');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';



?>

Ergebnis


Beispiel

Erstellt ein Vorschaubild, das auf die definierte Größe zugeschnitten wird, nachdem die kürzeste Seite eingepasst wurde

Quelltext

<?php

$pathThumbnail 
wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120120'crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120'''crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'''120'crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

print 
'<br />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120120'crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120'''crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'''120'crop');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';



?>

Ergebnis


Beispiel

Erstellt ein Vorschaubild, das auf die definierte Größe zugeschnitten wird, nachdem die längste Seite eingepasst wurde

Quelltext

<?php

$pathThumbnail 
wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120120'default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'120'''default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-rot.png'''120'default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

print 
'<br />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120120'default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'120'''default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/bild-blau-s.png'''120'default');

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';



?>

Ergebnis


Beispiel

Erstellt ein Vorschaubild, für das die Qualität des generierten Bildes mitgegeben wird

Quelltext

<?php

$pathThumbnail 
wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 10));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 40));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 60));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

print 
'<br />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 80));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 90));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';

$pathThumbnail wThumbnail::createThumbnail('/devAssets/img/CIMG1299.jpg'120120'default', array('quality' => 100));

print 
'<img style="margin:8px;background-color:#f0f0f0" src="'.$pathThumbnail.'" />';



?>

Ergebnis


 

Entwicklerbereich Weblication® CMS - © Scholl Communications AG