Difference between revisions of "PascalMagick"

From Free Pascal wiki
Jump to navigationJump to search
(Category and code highlight)
Line 81: Line 81:
 
=== Demonstration program 1 ===
 
=== Demonstration program 1 ===
  
<pre>
+
<delphi>
 
{
 
{
 
   Demonstration program for the ImageMagick Library
 
   Demonstration program for the ImageMagick Library
Line 97: Line 97:
 
{$mode objfpc}{$H+}
 
{$mode objfpc}{$H+}
  
uses SysUtils, magick_wand, ImageMagick;
+
uses  
 +
  SysUtils, magick_wand, ImageMagick;
  
 
procedure ThrowWandException(wand: PMagickWand);
 
procedure ThrowWandException(wand: PMagickWand);
Line 141: Line 142:
 
     MagickWandTerminus;
 
     MagickWandTerminus;
 
   end;
 
   end;
end.
+
end.</delphi>
</pre>
 
  
  
Line 180: Line 180:
  
 
Please send help requests to the Lazarus Forum or the Lazarus mailling list.
 
Please send help requests to the Lazarus Forum or the Lazarus mailling list.
 +
 +
[[Category:Components]]

Revision as of 17:04, 18 January 2011

English (en) español (es) français (fr) Bahasa Indonesia (id) 日本語 (ja) português (pt) русский (ru) 中文(中国大陆)‎ (zh_CN)

About

About ImageMagick

ImageMagick is a free software suite developed to create, edit, and compose bitmap images. It supports a huge variety of formats (over 90) including formats like GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Images can be cropped, colors can be changed, various effects can be applied, images can be rotated and combined, and text, lines, polygons, ellipses and Bézier curves can be added to images and stretched and rotated.

The suite runs on all major operating systems and it can also be used from the command line and it´s command line tools package is one of Linux standard packages, being distributed with many distributions.

Features and Capabilities:

  • Convert an image from one format to another (e.g. PNG to JPEG)
  • Resize, rotate, sharpen, color reduce, or add special effects to an image
  • Create a montage of image thumbnails
  • Create a transparent image suitable for use on the Web
  • Turn a group of images into a GIF animation sequence
  • Create a composite image by combining several separate image
  • Draw shapes or text on an image
  • Decorate an image with a border or frame
  • Describe the format and characteristics of an image

ImageMagick Book

ImageMagick Tricks This fast paced and practical tutorial is packed with examples of photo manipulations, logo creation, animations, and complete web projects. With this book up your sleeve, you'll be creating spellbinding images from code in no time.

About MagickWand

The MagickWand API is the recommended interface by the ImageMagick team. It is an easy to use programming interface for using the suite.

About MagickCore

The MagickCore API is a low-level interface for ImageMagick.

About PascalMagick

This port is a translation of the c header files for both MagickWand and Magick Core.


Screenshot

Authors

Felipe Monteiro de Carvalho

Ángel Eduardo García

License

BSD-style and compatible with the GPL.

You can read the Licence here.

Download

PascalMagick 0.4 is available here: http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=174103&release_id=431432

Status: Magick Wand headers are complete and working on both Windows and Linux.

Installation

The current version of PascalMagick works on Windows and Linux. Beta testers are necessary for the Mac OS X version.

To start with, install ImageMagick binaries from the official website: http://www.imagemagick.org/script/binary-releases.php

Now download and unzip PascalMagick package (Instructions on the Download section above).

To check that everything is working, open the PascalMagick/wand/wanddemo.lpi project. Now go to the Project --> "Compiler Options dialog" and change the "Other Units" field to point to "../magick", so it can find the PascalMagick/magick/ImageMagick.pas file. After this you can compile and run the test program.

If the program is working, it will load the image.png image located on the same directory as he is, resize it and then save it as a jpg called image.jpg.

One Extra step is necessary on Linux: Rename the image.PNG to image.png due to case issues.

Under linux you must edit the file PascalMagick/magick/ImageMagick.pas and change
WandExport = 'libWand'; by WandExport = 'libMagickWand';
but remember PascalMagick is already installed with a recent version of fpc

Demonstration program 1

<delphi> {

 Demonstration program for the ImageMagick Library
 This program was converted from c by: Felipe Monteiro de Carvalho
 Usage: Just execute the program. It will resize the image.png image
 on it´s directory to fit (106, 80) and convert it to a jpg.
 
 Dez/2005

} {Version 0.1} program wanddemo;

{$mode objfpc}{$H+}

uses

 SysUtils, magick_wand, ImageMagick;

procedure ThrowWandException(wand: PMagickWand); var

 description: PChar;
 severity: ExceptionType;

begin

 description := MagickGetException(wand, @severity);
 WriteLn(Format('An error ocurred. Description: %s', [description]));
 description := MagickRelinquishMemory(description);
 Abort;

end;

var

 status: MagickBooleanType;
 wand: PMagickWand;

begin

 { Read an image. }
 
 MagickWandGenesis;
 wand := NewMagickWand;
 
 try
   status := MagickReadImage(wand, 'image.png');
   if (status = MagickFalse) then ThrowWandException(wand);
   { Turn the images into a thumbnail sequence. }
   MagickResetIterator(wand);
   while (MagickNextImage(wand) <> MagickFalse) do
    MagickResizeImage(wand, 106, 80, LanczosFilter, 1.0);
   { Write the image as MIFF and destroy it. }
 
   status := MagickWriteImages(wand, 'image.jpg', MagickTrue);
   if (status = MagickFalse) then ThrowWandException(wand);
 finally
   wand := DestroyMagickWand(wand);
   MagickWandTerminus;
 end;

end.</delphi>


Subversion

You can download the subversion version of this project using this command:

svn checkout http://svn.freepascal.org/svn/fpc/trunk/packages/base/imagemagick imagemagick

You can also download the full fpc 2.1.1 repository and it will be included.

Bug Reporting/Feature Request

Tests are necessary to verify if the bindings work with all versions of ImageMagick.

Please post Bug Reports / Feature Requests in the discussion page.

Change Log

  • 07.11.07
  1. Added 4 missing functions on magick_image.inc on fpc subversion, but no new release
  • 12.07.06 PascalMagick version 0.4 released
  1. Last bugs fixed
  • 24.05.06 PascalMagick version 0.3 released
  1. Minor fixes on the bindings
  • 10.04.06 PascalMagick version 0.2 released
  1. Based on ImageMagic 6.2
  2. MagickWand API fully translated
  3. Added a second demonstration program
  • 27.12.05 PascalMagick version 0.1 released
  1. About 80% of the MagickWand API is translated
  2. The basic demonstration program is working well
  3. Only the very minimum necessary MagickCode headers were translated
  • 14.12.05 Began working on a pascal port for the c headers

Help

Please send help requests to the Lazarus Forum or the Lazarus mailling list.