JPEGator v. 1.5.1195 pg-trial
Copyright (C) 2005-2009, Aleh Dzenisiuk
JPEGator is a class library which allows to compress and decompress JPEG
images under .NET Compact Framework 1.0 or 2.0 using C# or Visual Basic.
This software is based in part on the work of the Independent JPEG Group
[http://www.ijg.org/].
For class library reference see \doc\JPEGator Reference.chm.
Registration link (see also legal notes below):
http://dzenisiuk.info/redirect.php?d=pocketgear
== Files
This package has the following directory layout:
\doc
JPEGator Reference.chm - Library reference documentation.
\examples
\vs-2003 - Examples prepared for Visual Studio 2003.
\vs-2005 - Examples prepared for Visual Studio 2005.
\lib
\netcf-1.0
JPEGator.dll - Managed part of JPEGator library for .NETCF 1.0.
\netcf-2.0
JPEGator.dll - Managed part of JPEGator library for .NETCF 2.0.
JPEGator.jpeg.dll - Unmanaged part of JPEGator library
(Independent JPEG Groups' Software)
As you can see you will need to ship 2 files along with your application:
JPEGator.jpeg.dll and JPEGator.dll. The last one should be referenced from
your .NETCF project (depending on framework version you are using).
== Examples
The \examples folder of this package contains three C# examples (triangles,
thumbnailviewer, resizer) and one VB.NET example (JPEGPad). Their projects
are included into solution files \examples\vs-2005\examples.sln and
\examples\vs-2003\examples.sln. Choose any of them depending on version of
Visual Studio you are going to complie these examples with.
Take note, that you should manually add reference to assembly
\lib\netcf-1.0\JPEGator.dll into all vs-2003 projects, because Visual
Studio 2003 does not support relative paths for assembly references in
Smart Devices projects.
Triangles is an example of a program that needs to generate some big image
and output it directly to a JPEG file on a disk. It demonstrates how to use
JPEGator.Compress class.
Resizer is more complicated example, which shows how to process some
existing JPEG image. It utilizes both JPEGator.Compress and
JPEGator.Decompress classes. Input image is scaled down using integer
linear interpolation.
Two other examples show how to use helper functions from BitmapUtils class.
ThumbnailViewer example demonstrates BitmapUtils.LoadThumbnail, while
JPEGPad --- BitmapUtils.LoadBitmap and BitmapUtils.SaveBitmap.
Please note, that if you have the trial version of the JPEGator.dll
assembly, then you will get exceptions for images larger than 1023 pixels
in size (either width or height).
== Legal issues
As mentioned in the above, this software is based in part on the work of
the Independent JPEG Group, so when using JPEGator library you will be
using the Independent JPEG Group's software too, and, according to its
license, you must state somewhere in your documentation that "this software
is based in part on the work of the Independent JPEG Group".
I MAKE NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH
RESPECT TO THE JPEGATOR LIBRARY, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR
FITNESS FOR A PARTICULAR PURPOSE. IT IS PROVIDED "AS IS", AND YOU
ASSUME THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY.
DO NOT USE JPEGATOR LIBRARY, IF YOU DO NOT FULLY ACCEPT RESPONSIBILITY FOR
ANY UNDESIRABLE CONSEQUENCES.
If you find JPEGator useful and plan to use it in your application, then
please register it on this page:
http://dzenisiuk.info/redirect.php?d=pocketgear
After registration you will get a full version (without image size
limitations), first-order support (using e-mail and ICQ), free upgrades,
and ability to request new features.
Company or individual who registered the full version can use JPEGator in
any number of projects without any limitations.
If you need JPEGator for some non-commercial project, then please drop me a
note with a brief description of your project, and I propably will send the
full version for free.
The trial version of the JPEGator library has artificial limitations on
size of image it allows to work with: both width and height of processed
images must be less than 1024 pixels, else it throws an exception with a
corresponding message.
== Feedback
I would really like to hear from you any questions, comments, bug reports
and everything you would like to tell. Please, use the following link:
http://dzenisiuk.info/contact.php
Here is the log of changes made in JPEGator library.
Version 1.5.688:
- Fixed setup of output color space in decompressor. Now works
correctly with grayscale images.
- Since the version is quite stable, added 1.0 to the version number.
Version 0.5.573:
- Behaves correctly on devices where only .NETCF 2.0 is installed in ROM.
- Added BitmapFromBGR24() function which converts array of bytes into Bitmap.
Version 0.4.358:
- Starting with this version the Independent JPEG Group's software is
shipped along with JPEGator in file lib\JPEGator.jpeg.dll.
- Error handling improved: no unhandled exceptions anymore, JpegException with
an error message and an attached error code is thrown now instead of former
ApplicationException.
- Added SkipScanlines() method for the Decompress class.
Version 0.3.227:
- Fixed file locking in BitmapUtils.LoadThumbnail().
Version 0.3.187:
- Fixed BitmapUtils.LoadThumbnail() behavior for source images smaller
than destination image size.
- Fixed problem with closing of output file in BitmapUtils.SaveBitmap()
function. Thanks to The Fi Organization for pointing on this.
- Improved documentation.
