PHPackages realitaetsverlust/imagewrapper - 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. realitaetsverlust/imagewrapper ActiveLibrary[Image & Media](/categories/media) realitaetsverlust/imagewrapper ============================== An OOP-Wrapper for images in PHP 1.0.1(5y ago)015WTFPLPHPPHP >=8.0 Since Mar 21Pushed 5y ago1 watchersCompare [ Source](https://github.com/Realitaetsverlust/ImageWrapper)[ Packagist](https://packagist.org/packages/realitaetsverlust/imagewrapper)[ RSS](/packages/realitaetsverlust-imagewrapper/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (3)Used By (0) ImageWrapper ============ [](#imagewrapper) ### A simple wrapper for image in PHP [](#a-simple-wrapper-for-image-in-php) ImageWrapper is one of my simplistic OOP Wrappers for PHP. My goal with this project was to create a library which is lightweight, has little to no dependencies and requires little to no explanation on how it works. And I think that I definitely succeeded. Image wrapper has no dependencies, is not very complex and extremely simple to integrate in existing or new web applications. Keep in mind that this software is still in development. It's currently in a state that is absolutely useable in productive environments, but it may have occasional bugs here and there, especially with older GDLb versions. If you notice a bug, please leave an issue, stating exactly the PHP Version and GDLib version you're using. #### Installation: [](#installation) You can easiely install ImageWrapper via composer: `composer require realitaetsverlust/imagewrapper` #### What can ImageWrapper do for you: [](#what-can-imagewrapper-do-for-you) - Load, edit, convert and output images of any kind with ease - Provide a nice to use API for all filetypes - No fancy stuff: Every method maps to one, sometimes two PHP functions. Very straighforward For example: You want to load an image called `test.png`, convert it into a JPEG file and output it: ``` use Realitaetsverlust\Wrapper\ImageTypes\Jpeg; use Realitaetsverlust\Wrapper\ImageTypes\Png; $image = new Png('test.png'); $image->convert(new Jpeg()); $image->output('test.jpeg'); ``` Tadaa, that's all necessary to convert an image from PNG to JPEG. If you prefer it a little bit fancier, you can also make use of the method chaining ImageWrapper provides: ``` use Realitaetsverlust\Wrapper\ImageTypes\Jpeg; use Realitaetsverlust\Wrapper\ImageTypes\Png; $image = new Png('test.png'); $image->convert(new Jpeg())->output('test.jpeg'); ``` Almost every method returns itself in the end, with a few exceptions. So you can chain methods as often and as much as you like! Also, if you don't know which kind of image you have there or you simply don't want to bother, no worries, ImageWrapper got your back. There is `ImageFactory::create()` that automatically checks the filetype using `exif_imagetype()` and returns the corresponding object: ``` use Realitaetsverlust\Wrapper\ImageFactory; $image = ImageFactory::create('test.png'); // Will return a Png Object $image = ImageFactory::create('test.jpg'); // Will return a Jpeg Object $image = ImageFactory::create('image_with_no_extension'); // Will return the correct object, whatever it is ``` ImageWrapper has support for all image types PHP supports, which are: - .png - .jpeg - .gif - .webp - .bmp - .wbmp - .xbm - .xpm (only read, no write) ### The elements of the library: [](#the-elements-of-the-library) #### ImageBase: [](#imagebase) `ImageBase` is the base class of all images. It's an abstract class that contains definitions for all methods. Every method maps to one PHP function, sometimes two if the two methods are very similar. A full documentation of methods inside `ImageBase` is below #### Color: [](#color) The `Color()` class is a RGB representation which is used throughout the the library. The main advantage of it is that it can convert RGB values as well as a hex-based string (#ff00ff) and even CMYK. Every time a function expects a color represenation, you should pass a Color object. This may look like the following: ``` $image->colorize(new \Realitaetsverlust\Wrapper\Color(255, 0, 0)); ``` This will colorize the image red. However, you can, as mentioned above, also add other values that represent a color: ``` $image->colorize(new \Realitaetsverlust\Wrapper\Color("#FF0000")); // Hex $image->colorize(new \Realitaetsverlust\Wrapper\Color(0, 100, 100, 0)); // CMYK ``` Usually, you never have to care about the allocation of the color, the picture class handles those by itself. However, the method `allocateColor()` allows you to perform the allocation of colors yourself. ### Method-Documentation: [](#method-documentation) ``` public function output(string $destination = null, ?): bool ``` Outputs the image. If `$destination` is set, the image is saved at the given path. If it is not, it's directly send as output. This method is ont inside `ImageBase`, but inside the child classes. PHPs output functions are not very streamlined which makes it really hard to write a proper function for all of them. ``` public function convert(ImageBase $imageType): ImageBase ``` Converts an image from one image type to another. Please keep in mind that this function returns a new object you have to use. So something like the following will not work. ``` $image = new Png('test.png'); $image->convert(new Jpeg()); $image->output('test.jpeg'); ``` Chaining the methods, however, will obviously work. ``` public function sendHeaders() : void ``` This method sends the headers as a browser would expect them in the format `Content-Type: image/png`. They are determined by `image_type_to_mime_type()`. In general, you don't have to call this function yourself, it is called automatically if the method `output()` does not get any `$destination` parameter. However, there may be a situation where you want to fire the function yourself, for example if you want to set some parameters before you send the image to the receiver. ``` public function getFileType(): string ``` Returns the current file type of the image. This is not determined by the extension, but by `exif_imagetype()` ``` public function getImageSize(): array ``` Returns the file size of the image. ``` public function getMinQuality(): int ``` Returns the minimum quality PHP accepts in the output function. ``` public function getMaxQuality(): int ``` Returns the maximum quality PHP accepts in the output function. ``` public function alphaBlending(bool $blendmode): ImageBase ``` Set the blending mode for the image ``` public function enableAntialias(bool $enabled): ImageBase ``` Activate the fast drawing antialiased methods for lines and wired polygons. ``` public function drawArc(int $cx, int $cy, int $width, int $height, int $start, int $end, Color $color, int $style = null): ImageBase ``` Draws an arc. if $style is passed, the arc will be filled ``` public function drawChar(bool $drawVertical, int $font, int $x, int $y, string $c, int $color): ImageBase ``` Draws a char horizontally or vertically onto the image. ``` public function getColoarAt(int $x, int $y): int|false ``` Fetches the color value at a specific location ``` public function cutPartial(int $x, int $y, int $width, int $height): ImageBase ``` Cuts a part from the current image and copies it into a new image ``` public function crop(int $x, int $y, int $width, int $height): ImageBase ``` Crops image to given dimension ``` public function drawDashedLine(int $srcX, int $srcY, int $destX, int $destY, Color $color): ImageBase ``` Draws a line onto the image ``` public function drawEllipse(int $x, int $y, int $width, int $height, Color $color, bool $fill = false): ImageBase ``` Draws an ellipse. If $fill isp passed, the ellipse will be filled with the passed color. ``` public function fill(int $x, int $y, Color $color): ImageBase ``` Performs a flood fill onto the image ``` public function drawPolygon(array $points, int $numberOfPoints, Color $color, bool $fill = false): ImageBase ``` Draws a polygon. If $fill is passed, the polygon will be filled with the passed color. ``` public function drawRectangle(int $topLeft, int $topRight, int $bottomLeft, int $bottomRight, Color $color, bool $fill = false) ``` Draws a rectangle. If $fill is passed, the rectangle will be filled with the given color. ``` public function invertColors(): ImageBase ``` Inverts the color of an image (white to black, black to white etc) ``` public function grayscaleImage(): ImageBase ``` Convert image into a grayscale image. Alpha components are retained. ``` public function setBrightness(int $brightness): ImageBase ``` Set brightness of given image ``` public function setContrast(int $contrast): ImageBase ``` Sets contrast of the given image ``` public function colorize(Color $color): ImageBase ``` Colorizes an image ``` public function edgedetect(): ImageBase ``` Uses edge detection to highlight the edges in the image. ``` public function emboss(): ImageBase ``` Embosses the image ``` public function blur(bool $useGauss = false): ImageBase ``` Blurs an image. If $useGauss is passed, the gauss blur will be used instead of the selective blur ``` public function sketchImage(): ImageBase ``` Transforms the image to have a sketchy look ``` public function smooth(int $smoothness): ImageBase ``` Smoothes the iamge ``` public function pixelate(int $blockSize, bool $advancedPixelationMode = false): ImageBase ``` Pixelates the iamge ``` public function scatter(int $effectSubstractionLevel, int $effectAdditionLevel, array $onlyApplyTo = []): ImageBase ``` Applies a scatter effect to the image. ``` public function gammaCorrection(float $inputGamma, float $outputGamma): ImageBase ``` Gamma correction method ``` public function flip(int $mode): ImageBase ``` Flips the image using the given mode. Modes are IMG\_FLIP\_HORIZONTAL, IMG\_FLIP\_VERTICAL and IMG\_FLIP\_BOTH ``` public function setInterlace(bool $interlaceMode): ImageBase ``` Enables/Disables interlace ``` public function isTrueColor(): bool ``` Determines if an image is a true color image ``` public function allocateColor(Color $color): false|int ``` Allocates a color and adds it to the list of allocated colors. ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity58 Maturing project, gaining track record 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 ~26 days Total 2 Last Release 1851d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/eb1b9bbbd4a857736bd7a62ed37c5aa6a13b2ecb61771b4a6f741a12e131942f?d=identicon)[realitaetsverlust](/maintainers/realitaetsverlust) --- Top Contributors [![Realitaetsverlust](https://avatars.githubusercontent.com/u/5919091?v=4)](https://github.com/Realitaetsverlust "Realitaetsverlust (14 commits)") ### Embed Badge ![Health badge](/badges/realitaetsverlust-imagewrapper/health.svg) ``` [![Health](https://phpackages.com/badges/realitaetsverlust-imagewrapper/health.svg)](https://phpackages.com/packages/realitaetsverlust-imagewrapper) ``` ### Alternatives [milon/barcode Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code) 1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa Image thumbnail creation through specially formatted URLs for Laravel 510496.0k23](/packages/bkwld-croppa)[char0n/ffmpeg-php PHP wrapper for FFmpeg application 495225.1k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph Generates SVG graphs 132849.6k3](/packages/goat1000-svggraph)[cohensive/embed Media Embed (for Laravel or as a standalone). 120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image Image support in CKEditor for the TYPO3 ecosystem - by Netresearch 63991.3k4](/packages/netresearch-rte-ckeditor-image) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)