The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Quiq::File::Image - Informationen über Bild-Datei

BASE CLASS

Quiq::Hash

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.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.189

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2020 Frank Seitz

LICENSE

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.