PHPackages                             drezynsoft/split-image - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image &amp; Media](/categories/media)
4. /
5. drezynsoft/split-image

ActiveLibrary[Image &amp; Media](/categories/media)

drezynsoft/split-image
======================

Split PNG images into pieces.

1.0.2(9y ago)031CustomPHPPHP &gt;=5.3.0

Since Jul 26Pushed 9y ago1 watchersCompare

[ Source](https://github.com/DrezynSoft/split-image)[ Packagist](https://packagist.org/packages/drezynsoft/split-image)[ Docs](http://drezynsoft.fotokrajobrazy.warmia.pl)[ RSS](/packages/drezynsoft-split-image/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependenciesVersions (4)Used By (0)

Split Image
===========

[](#split-image)

Split Image is a tool written in PHP to split images in format of PNG to smaller pieces. What is more valuable it could be used to split images with repetition of the left/right top/bottom fragments to get atlas form of presentation.

Installation
============

[](#installation)

```
composer require drezynsoft/split-image

```

or simply download the package in zip format.

Configuration
=============

[](#configuration)

You can use the `config/config.php` file or just override default options with args in console.

`config/config.php` options
---------------------------

[](#configconfigphp-options)

Params obliged:
---------------

[](#params-obliged)

### After split command: `source-file`

[](#after-split-command-source-file)

Path to PNG file to split.

### After source-file: `destination-dir` (second after split command)

[](#after-source-file-destination-dir-second-after-split-command)

Path to directory where split files will be saved.

> Note: Minimal command is as follows (warning: last slash is required):

`$ split-image split path/to/png/file.png path/to/save-dir/`

> Note: Trailing slash in directory path is necessary.

List of other available params:
-------------------------------

[](#list-of-other-available-params)

### `--width` default: 2200 (int)

[](#--width-default-2200-int)

Destination width \[px\] of the every split image.

### `--height` default: 3300 (int)

[](#--height-default-3300-int)

Destination height \[px\] of the every split image.

### `--left-right-margin` default: 500 (int)

[](#--left-right-margin-default-500-int)

Margin of the previous (if any) split image. It is the simply floating coat of the previous split image (in width) \[px\].

### `--top-bottom-margin` default: 500 (int)

[](#--top-bottom-margin-default-500-int)

Margin of the previous (if any) split image. It is the simply floating coat of the previous split image (in height) \[px\].

### `--sep` default: '\_' (string)

[](#--sep-default-_-string)

Text between digits of rows count and cols count.

### `--prefix` default: '' (string)

[](#--prefix-default--string)

Text before digits of rows and cols.

### `--suffix` default: '' (string)

[](#--suffix-default--string)

Text after digits of rows and cols.

### `--RAM-factor` default: 3.0 (float)

[](#--ram-factor-default-30-float)

Multiplier for calculating predicted RAM usage.

### `--compression` default: 0 max: 9 (int)

[](#--compression-default-0-max-9-int)

Compression of PNG file 0-9.

> Note: All params starting with `--` are optional and could be given in any order. Also all of them can be used in `config/config.php` without the `--` prefix.

List of params outside of the console:
--------------------------------------

[](#list-of-params-outside-of-the-console)

### `default-file` default: 'data/to\_convert/DrezynSoft.png' (string)

[](#default-file-default-datato_convertdrezynsoftpng-string)

Source file.

### `default-dir` default: 'data/converted/' (string)

[](#default-dir-default-dataconverted-string)

Destination directory.

Usage
=====

[](#usage)

Simplest usage (with defaults)
------------------------------

[](#simplest-usage-with-defaults)

### By console

[](#by-console)

`$ vendor/bin/split-image split path/to/png/file.png path/to/save-dir/`

or without composer

`$ scripts/split-image split path/to/png/file.png path/to/save-dir/`

> Note: Trailing slash in directory path is necessary.

> Tip: When params in `config/config.php` are the same you would like to use, you don't have to pass them into console command. The params will be get from config file.

### By http

[](#by-http)

go to:

> Note: With assumption that tool is installed in split-image dir in public of the site.

> Recommendation: When you use huge files it can take long to split so end of script execution could interrupt the process.

> Note: There is no possible to change defaults options. You can only edit the `config/config.php` and then open the http page.

Issues
======

[](#issues)

The tool has been made for one reason at one moment so we really can not to predict new version of this program.

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

3626d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/14141877?v=4)[DrezynSoft](/maintainers/DrezynSoft)[@DrezynSoft](https://github.com/DrezynSoft)

---

Top Contributors

[![DrezynSoft](https://avatars.githubusercontent.com/u/14141877?v=4)](https://github.com/DrezynSoft "DrezynSoft (3 commits)")

---

Tags

imagesplitPNG file

### Embed Badge

![Health badge](/badges/drezynsoft-split-image/health.svg)

```
[![Health](https://phpackages.com/badges/drezynsoft-split-image/health.svg)](https://phpackages.com/packages/drezynsoft-split-image)
```

###  Alternatives

[intervention/image

PHP Image Processing

14.3k203.8M2.5k](/packages/intervention-image)[league/glide

Wonderfully easy on-demand image manipulation library with an HTTP based API.

2.6k52.6M140](/packages/league-glide)[liip/imagine-bundle

This bundle provides an image manipulation abstraction toolkit for Symfony-based projects.

1.7k40.0M240](/packages/liip-imagine-bundle)[spatie/image

Manipulate images with an expressive API

1.4k58.5M180](/packages/spatie-image)[intervention/image-laravel

Laravel Integration of Intervention Image

1588.9M161](/packages/intervention-image-laravel)[intervention/gif

PHP GIF Encoder/Decoder

6128.3M14](/packages/intervention-gif)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
