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.
created() - Aufnahmezeitpunkt
Synopsis
$created=$img->created;
Description
Liefere den Aufnahmezeitpunkt des Bildes, z.B. '2024-11-11 22:22:06'.
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.333333333333333
aspectRatio() - 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.225
AUTHOR
Frank Seitz, http://fseitz.de/
COPYRIGHT
Copyright (C) 2025 Frank Seitz
LICENSE
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.