Frank Seitz
and 1 contributors

NAME

Prty::ImageMagick - ImageMagick-Kommandozeile

BASE CLASS

Prty::Hash

DESCRIPTION

ImageMagick Online-Dokumentation: http://www.imagemagick.org/Usage/

Ein Objekt der Klasse repräsentiert eine ImageMagick-Kommandozeile. Die Klasse verfügt einerseits über elementare Objektmethoden, um eine solche Kommandozeile sukzessive aus ihren elementaren Bestandteilen konstruieren zu können und höhere Objektmethoden, die eine bestimmte Funktion durch das Hinzufügen einer Reihe von Optionen realisieren.

METHODS

Konstruktor

new() - Konstruktor

Synopsis

    $cmd = $class->new;

Description

Instanziiere ein ImageMagick-Kommandozeilen-Objekt und liefere eine Referenz auf dieses Objekt zurück.

Kommando konstruieren

addElement() - Füge ein Kommandozeilen-Element hinzu

Synopsis

    $cmd->addElement($str);

Description

Ergänze die Kommandozeile um Kommandozeilen-Element $str. Ein Kommandozeilen-Element ist ein durch Whiltespace getrennter elementarer Teil der Kommandozeile, wie z.B. das Kommando, eine Option, ein Optionsargument, ein Dateiname usw.

Enthält $str Whitespace oder andere, spezielle Zeichen, wird $str in einfache Anführungsstriche eingefasst.

Examples

Ohne Whitespace:

    $cmd->addElement('input.jpg');
    =>
    input.gif

Mit Whitespace:

    $cmd->addElement('Sonne am Abend.jpg');
    =>
    'Sonne am Abend.jpg'

addCommand() - Füge Kommando hinzu

Synopsis

    $cmd->addCommand($command);

Description

Ergänze die Kommandozeile am Anfang um das Kommando $command. Die Methode liefert keinen Wert zurück.

Examples

Kommando convert:

    $cmd->addCommand('convert');
    =>
    convert

addOption() - Füge Option hinzu

Synopsis

    $cmd->addOption($opt);
    $cmd->addOption($opt=>$val);

Description

Ergänze die Kommandozeile um die Option $opt und (optional) den Wert $val. Die Methode liefert keinen Wert zurück.

Examples

Option ohne Wert:

    $cmd->addOption('-negate');
    =>
    -negate

Option mit Wert:

    $cmd->addOption(-rotate=>90);
    =>
    -rotate 90

Kommando

command() - Kommandozeile als Zeichenkette

Synopsis

    $str = $cmd->command;

Description

Liefere das Kommando als Zeichenkette.

Kommando-Ausführung

execute() - Führe ImageMagick-Kommandozeile aus

Synopsis

    $cmd->execute;

Description

Führe ImageMagick-Kommando $cmd aus. Im Fehlerfall wird eine Exception geworfen.

Klassenmethoden (vollständige Kommandozeilen)

resizeFill() - Generiere Kommando für Operation resizeFill

Synopsis

    $cmd = $class->resizeFill($input,$output,$size,$background);

Arguments

$input

Image-Objekt oder Bilddatei-Pfad des Input-Bildes.

$output

Bilddatei-Pfad des Output-Bildes. Das Verzeichnis wird erzeugt

$size

Größe des generierten Output-Bildes.

$background

Farbe des Hintergrunds, wenn das Bild den Bereich $size nicht vollständig ausfüllt.

Description

Generiere ein convert-Kommando, dass das Input-Bild auf Größe $size bringt.

  • Ist das Bild in mindestens einer Dimension größer als $size, wird es verkleinert.

  • Andernfalls wird das Bild in seiner Größe nicht verändert.

  • Vom Bild nicht abgedeckte Bereiche werden in Hintergrundfarbe $background dargestellt.

resizeStretch() - Generiere Kommando für Operation resizeStretch

Synopsis

    $cmd = $class->resizeStretch($input,$output,$size);

Arguments

$input

Image-Objekt oder Bilddatei-Pfad des Input-Bildes.

$output

Bilddatei-Pfad des Output-Bildes. Das Verzeichnis wird erzeugt

$size

Größe des generierten Output-Bildes.

Description

Generiere ein convert-Kommando, dass das Input-Bild auf Größe $size bringt.

  • Weicht das Seitenverhltmis ab, wird das Bild verzerrt.

negate() - Generiere Kommando für Operation negate

Synopsis

    $cmd = $class->negate($input,$output);

Arguments

$input

Image-Objekt oder Bilddatei-Pfad des Input-Bildes.

$output

Bilddatei-Pfad des Output-Bildes. Das Verzeichnis wird erzeugt

Description

Generiere ein convert-Kommando, dass das Input-Bild negiert.

morph() - Generiere Kommando für Operation morph

Synopsis

    $cmd = $class->morph($input1,$input2,$outPattern,$morph);

Arguments

$input1

Image-Objekt oder Bilddatei-Pfad des ersten Input-Bildes.

$input2

Image-Objekt oder Bilddatei-Pfad des zweiten Input-Bildes.

$outPattern

Pfad-Muster für die generierte Bildfolge.

Description

Generiere ein convert-Kommando, das Zwischenbilder für die Bilder $input1 und $input2 erzeugt und unter dem Pfad-Muster speichert.

AUTHOR

Frank Seitz, http://fseitz.de/