Frank Seitz
and 1 contributors

NAME

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

BASE CLASS

Prty::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'

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 Prty::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.108

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2017 Frank Seitz

LICENSE

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