PHPackages                             offline-agency/image-puzzle - 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 & Media](/categories/media)
4. /
5. offline-agency/image-puzzle

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

offline-agency/image-puzzle
===========================

Split images into a grid of puzzle pieces with optional edge styles; export as PNG and JSON manifest.

1.0.0(3mo ago)00MITPHPPHP ^8.4CI passing

Since Feb 2Pushed 2mo agoCompare

[ Source](https://github.com/offline-agency/php-image-puzzle)[ Packagist](https://packagist.org/packages/offline-agency/image-puzzle)[ RSS](/packages/offline-agency-image-puzzle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (3)Used By (0)

PHP Image Puzzle
================

[](#php-image-puzzle)

[![CI](https://github.com/offline-agency/php-image-puzzle/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/offline-agency/php-image-puzzle/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/7b2226834e4e495b202e7232246320bc8d1e3b106fcba7b84af9e65944200416/68747470733a2f2f636f6465636f762e696f2f67682f6f66666c696e652d6167656e63792f7068702d696d6167652d70757a7a6c652f67726170682f62616467652e737667)](https://codecov.io/gh/offline-agency/php-image-puzzle)[![Downloads](https://camo.githubusercontent.com/ed3800e8fd02fa88b986fbf7a9f5f95499f39937100e0e3feb61a46211879f06/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f66666c696e652d6167656e63792f696d6167652d70757a7a6c65)](https://packagist.org/packages/offline-agency/image-puzzle)[![PHP](https://camo.githubusercontent.com/afc7359cab548e040a1f49dbdadae08adeb694488fe67c30db4eb6e8b4934752/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e34253230253743253230382e352d3737374242343f6c6f676f3d706870)](https://www.php.net/)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

Split images into a grid of puzzle pieces, optionally apply edge styles, and export each piece as PNG (or JPEG) plus a JSON manifest with metadata (rows/cols, piece dimensions, x/y offsets, filenames).

**Requirements:** PHP 8.4 or 8.5, [ext-gd](https://www.php.net/manual/en/book.image.php).

[![Php Image Puzzle](https://camo.githubusercontent.com/aeed1134d0bb0d4a01331b57241d3bf03bbde17ebe35f605304ea8443aa497e4/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f504850253230496d61676525323050757a7a6c652e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532467068702d696d6167652d70757a7a6c65267061747465726e3d617263686974656374267374796c653d7374796c655f31266465736372697074696f6e3d4372656174652b70757a7a6c652b66726f6d2b616e2b696d616765266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d68747470732533412532462532467777772e7068702e6e6574253246696d616765732532466c6f676f732532466e65772d7068702d6c6f676f2e737667)](https://camo.githubusercontent.com/aeed1134d0bb0d4a01331b57241d3bf03bbde17ebe35f605304ea8443aa497e4/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f504850253230496d61676525323050757a7a6c652e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532467068702d696d6167652d70757a7a6c65267061747465726e3d617263686974656374267374796c653d7374796c655f31266465736372697074696f6e3d4372656174652b70757a7a6c652b66726f6d2b616e2b696d616765266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d68747470732533412532462532467777772e7068702e6e6574253246696d616765732532466c6f676f732532466e65772d7068702d6c6f676f2e737667)

Installation
------------

[](#installation)

```
composer require offline-agency/image-puzzle
```

Quickstart
----------

[](#quickstart)

**Recommended (three steps):**

```