Download the PHP package pupiq/image-scaler without Composer

On this page you can find all versions of the php package pupiq/image-scaler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package image-scaler

ImageScaler

Build Status

Handy tool for image resizing. Produces well optimized images for web.

Basic Usage

$scaler = new Pupiq\ImageScaler("/path/to/image.jpg");

// getting info about image
$scaler->getImageWidth(); // e.g. 1920
$scaler->getImageHeight(); // e.g. 1080
$scaler->getOrientation(); // 0, 1, 2 or 3 (i.e. 0, 90, 180, 270 degrees clockwise)
$scaler->getMimeType(); // "image/jpeg"

// performing a transformation
$scaler->scaleTo(300,200,["keep_aspect" => true]);

// saving to output file
$scaler->saveTo("/path/to/output_file.jpg");
// or saving to string
// $image = $scaler->saveToString();

// checking the result
$scaler_out = new Pupiq\ImageScaler("/path/to/output_file.jpg");
$scaler_out->getImageWidth(); // 300
$scaler_out->getImageHeight(); // 169

Scaling options

There are plenty of options in method scaleTo(). Some of them are against each other. So they should not be used together.

$scaler->scaleTo($width,$height,[
  "orientation" => 0, // automatically detected 

  // this is the source area on the original image
  "x" => 0,
  "y" => 0,
  "width" => $image_width,
  "height" => $image_height,

  "keep_aspect" => false,

  "crop" => null, // null, "auto", "top", "bottom"

  "strip_meta_data" => true,
  "sharpen_image" => null, // true, false, null (auto)
  "compression_quality" => 85,
  "auto_convert_cmyk_to_rgb" => true,

  "output_format" => "jpeg", // "jpeg", "png"

  "background_color" => "#ffffff", // by default it is "transparent" for png images
]);

Typical usages

// Scale image to 200px width.
$scaler->scaleTo(200);

// Scale image to 200px height.
$scaler->scaleTo(null,200);

// Scale image to size 200x200.
// Original image will be inscribed into 200x200 box.
// There will be no aspect ratio distortion,
// but rather some parts of the output image may be padded with the background_color.
$scaler->scaleTo(200,200,["background_color" => "#ffffff"]);

// Transform original image into max 200px width and max 200px height
// so either the final width or the final height may be lower than 200px.
$scaler->scaleTo(200,200,["keep_aspect" => true]);

// Transform and crop the original image into 200x200 box.
$scaler->scaleTo(200,200,["crop" => true]);

// Transform and crop the original image into 200x200 box
// and preserve the top part of the image.
// This is a great option e.g. for magazine or book covers.
$scaler->scaleTo(200,200,["crop" => "top"]);

Filters

Image processing can be affected by the use of filters. There are two types of filters.

In both types of filter, details about the desired transformation are also passed to them.

This package comes with several filters that can be used instantly.

Grayscale filter

Grayscale filter converts the currently processed image to grayscale. It is an after scale filter.

$scaler = new Pupiq\ImageScaler("/path/to/image.jpg");
$scaler->appendAfterScaleFilter(new Pupiq\ImageScaler\GrayscaleFilter());

$scaler->scaleTo(300,300);
$scaler->saveTo("/path/to/output_image.jpg"); // grayscale

Pngquant Optimizer filter

For png images there is Pngquant Optimizer filter. It can significantly reduce size of the final PNG image. It is required that the binary pngquant is installed in the system.

Pngquant Optimizer filter is an after save filter.

$scaler = new Pupiq\ImageScaler("/path/to/image.png");
$scaler->appendAfterSaveFilter(new Pupiq\ImageScaler\PngquantOptimizer([
  "pngquant_binary" => "/usr/bin/pngquant",
  "quality_range" => "70-90"
]));

$scaler->scaleTo(300,300);
$scaler->saveTo("/path/to/output_image.png");

For jpeg images, this filter simply does nothing.

Watermark filter

This filter places the given watermark into the currently processed image.

$scaler = new Pupiq\ImageScaler("/path/to/image.jpg");
$scaler->appendAfterScaleFilter(new Pupiq\ImageScaler\WatermarkFilter("/path/to/watermak_image.png",[
  "opacity" => 50, // 50%
  "position" => "center", // "center", "left-top" "left-bottom", "right-top", "right-bottom"
]);

$scaler->scaleTo(300,300);
$scaler->saveTo("/path/to/output_image.jpeg"); // watermaked image

Of course, the filters can be combined. They are processed in the given order.

$scaler = new Pupiq\ImageScaler("/path/to/image.jpg");

$scaler->appendAfterScaleFilter(new Pupiq\ImageScaler\WatermarkFilter("/path/to/watermak_image.png"));
$scaler->appendAfterScaleFilter(new Pupiq\ImageScaler\GrayscaleFilter());

$scaler->scaleTo(300,300);
$scaler->saveTo("/path/to/output_image.jpeg"); // watermaked and grayscaled image

Installation

Just use the Composer:

composer require pupiq/image-scaler

Testing

Install required dependencies for development:

composer update --dev

Run tests:

cd test
../vendor/bin/run_unit_tests

License

ImageScaler is free software distributed under the terms of the MIT license


All versions of image-scaler with dependencies

PHP Build Version
Package Version
Requires php Version >=5.3.0
ext-imagick Version >=3.4
atk14/files Version 1.* >=1.3.1
sybio/gif-frame-extractor Version ^1.0
yarri/gif-creator Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package pupiq/image-scaler contains the following files

Loading the files please wait ....