NAME
Quiq::File::Image - Informationen über Bild-Datei
BASE CLASS
METHODS
Konstruktor
new() - Instantiiere Bild-Datei-Objekt
Synopsis
$img = $class->new($path);Description
Instantiiere ein Bild-Datei-Objekt und liefere eine Referenz auf dieses Objekt zurück.
Eigenschaften
path() - Datei-Pfad
Synopsis
$path = $img->path;Description
Liefere den Dateinamen einschl. Pfad der Bild-Datei.
filename() - Datei-Name ohne Verzeichnisanteil
Synopsis
$filename = $img->filename;Description
Liefere den Dateinamen ohne Verzeichnisanteil, aber mit Extension, z.B. '000456.jpg'.
basename() - Datei-Name ohne Verzeichnis und Extension
Synopsis
$basename = $img->basename;Description
Liefere den Dateinamen ohne Verzeichnis und Extension, z.B. '000456'.
extension() - Datei-Extension
Synopsis
$ext = $img->extension;Description
Liefere die Extentsion der Datei, z.B. 'png'.
mtime() - Letzte Änderung
Synopsis
$mtime = $img->mtime;Description
Liefere den Zeitpunkt (Unix Epoch), an dem die Bilddatei das letzte Mal geändert wurde.
type() - Bild-Typ
Synopsis
$type = $img->type;Description
Liefere den Datei-Typ des Bildes, z.B. 'jpg'.
width() - Breite
Synopsis
$width = $img->width;Description
Liefere die Breite des Bildes in Pixeln, z.B. 1920.
height() - Höhe
Synopsis
$height = $img->height;Description
Liefere die Höhe des Bildes in Pixeln, z.B. 1080.
size() - Breite und Höhe
Synopsis
$size = $img->size;
($width,$height) = $img->size;Description
Liefere die Breite und Höhe des Bildes in Pixeln. Im Skalarkontext werden die Breite und Höhe in einem String zusammengefasst geliefert:
'WIDTHxHEIGHT'Examples
List-Kontext:
$img->size;
=>
(1920,1080)Skalar-Kontext:
$img->size;
=>
'1920x1080'scaleFactor() - Skalierungsfaktor für andere Breite, Höhe
Synopsis
$scale = $img->scaleFactor($width,$height);Description
Liefere den Skalierungsfaktor, wenn das Bild auf die Breite $width und die Höhe $height skaliert werden soll. Werden nicht-proportionale Werte für $width und $height angegeben, dass also für die Breite und die Höhe unterschiedliche Skalierungsfakoren berechnet werden, liefere von beiden den kleineren Wert.
Example
Das Bild hat die Größe 249 x 249 und soll skaliert werden auf die Größe 83 x 83:
$scale = $img->scaleFactor(83,83);
# 0.333333333333333aspectRatio() - Seitenverhältnis
Synopsis
$aspectRatio = $img->aspectRatio;Description
Liefere das Seitenverhältnis des Bildes, z.B. '16:9'.
Properties
property() - Liefere Property-Hash
Synopsis
$h = $img->property;
$h = $img->property(\%hash);Description
Liefere eine Referenz auf den Property-Hash des Bildes. Der Property-Hash speichert zusätzliche Eigenschaften des Bild-Datei-Objektes, die z.B. im Zuge einer Bild-Bearbeitung verwendet werden.
Der Property-Hash ist ein Quiq::Hash-Objekt, dessen Schlüssel nicht gelockt sind. Nach der Objekt-Instantiierung ist der Property-Hash leer.
Examples
Setze Eigenschaft:
$img->property->set(sizeFill=>[1440,1080]);Eigenschaft abfragen:
($width,$height) = $img->property->getArray('sizeFill');Interne Methoden
analyzeFile() - Analysiere Bild-Datei
Synopsis
$img->analyzeFile;Description
Analysiere die Bild-Datei und weise die ermittelten Eigenschaften an die Attribute des Objektes zu.
VERSION
1.222
AUTHOR
Frank Seitz, http://fseitz.de/
COPYRIGHT
Copyright (C) 2024 Frank Seitz
LICENSE
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.