DR_AWI LIBRARY

PHP Image Editing Library
Explore the docs »

Report Bug · Request Feature

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Include Files
• Basic Usage
  • Resize Image
  • Crop Image
  • Image Rotating
  • Set Borders
  • Add Text
  • Add New Image On Top
  • Save Image

About The Project

PHP Image Editing Library For Image Cropping , Coping , Moving , Resizing , Scaling , Text Adding , Effect Adding , Rotating & Many More Functionality

Built With

• PHP

Getting Started

Include Files

<?php
namespace DR_AWI;
require dirname(__FILE__) . '/inc/combine.php';
use DR_AWI\AWI as AWI;

Usage

$img = new AWI($IMAGE);
 
 
 $IMAGE >> CAN BE AN URL OR A PATH OR A BASE64 ENCODED IMAGE STRING.
 Currently Supported Image Types : JPG/JPEG , PNG , WBMP , XBM , GIF

EDITING

Resize Image

$img->resizeIt($width ,$height );
 
 $width >> Preferred IMAGE WIDTH In PIXELS 
 $height >> Preferred IMAGE HEIGHT In PIXELS 
 
* EASY RESIZING ---------------------------------
 
 IF >> $width > 0 AND $width < 5
   $width :
         $width = $actualImageWidth / (2 ** $width) 
 
 IF >> $height > 0 AND $height < 5
   $height :
         $height= $actualImageHeight / (2 ** $height) 
 

Crop Image

$img->set_size($width ,$height );
$img->crop_starting_pos($position);
 
 $width >> Preferred IMAGE WIDTH To Crop (In PIXELS) 
 $height >> Preferred IMAGE HEIGHT To Crop (In PIXELS)
 
* EASY CROPPING ---------------------------------
 
 IF >> $width > 0 AND $width < 5
   $width :
         $width = $actualImageWidth / (2 ** $width) 
 
 IF >> $height > 0 AND $height < 5
   $height :
         $height= $actualImageHeight / (2 ** $height) 
 
 
* SET CROP POSITION ---------------------------------
 
$position >> 
 
    'TL' >> TOP LEFT
    'TM' >> TOP MIDDLE
    'TR' >> TOP RIGHT
    'ML' >> TOP LEFT
    'M'  >> MIDDLE
    'MR' >> MIDDLE RIGHT
    'BL' >> BOTTOM LEFT
    'BM' >> BOTTOM MIDDLE
    'BR' >> BOTTOM RIGHT
    '$X,$Y' >> CUSTOM POSITION
        $X = Postion X In Pixels 
        $Y = Postion Y In Pixels 
         Ex: '0,0'

Image Rotating

$img->rotateIt( $degree, $uncoveredAColor);
 
$degree >> DEGREE TO ROTATE IMAGE
 
$uncoveredAColor >> Uncovered Area Color (Optional - Default '0,0,0')
   '$red,$green,$blue'
     $red = 0 - 255
     $green= 0 - 255
     $blue= 0 - 255
 

Set Borders

$img->setBorder($borderSize, $borderColor, $borderType);
 

 
$borderSize >> Border Size In Pixels
$borderColor >> Border Color 
    Ex: '0,0,0'
$borderType >> (Optional - Default 'A')
    'L' >> Only Border Left
    'T' >> Only Border Top
    'R' >> Only Border Right
    'B' >> Only Border Bottom

Add Text

$img->setFont($fontNo, $fontSize, $fontColour);
$img->setTextShadow($Ygap, $shadowColor);
$img->setCaption($theText, $textPos);

 
setFont() ---------------------------------------------
 
$fontNo = 0-5 (Still 5 Fonts Available)
$fontSize = Font Size
$fontColour = Font Color
     Ex: '0,0,0'
 

setTextShadow() -----------------------------------------
 
$Ygap= The (Y) Gap Between TEXT And SHADOW
$shadowColor= Shadow Color
     Ex: '0,0,0'
 
setCaption() --------------------------------------------
 
$theText >> The Text That You Want To Display 
$textPos >> Position Of Text
 
    'TL' >> TOP LEFT
    'TM' >> TOP MIDDLE
    'ML' >> TOP LEFT
    'M'  >> MIDDLE
    'BL' >> BOTTOM LEFT
    'BM' >> BOTTOM MIDDLE
    '$X,$Y' >> CUSTOM POSITION
        $X = Postion X In Pixels 
        $Y = Postion Y In Pixels 
         Ex: '0,0'
 

Add New Image On Top

$img->addNewImage($imgSrc, $imgSize, $imgPos, $layerEffect);

$imgSrc - Path To Image File (Supported : JPG/JPEG , PNG , GIF , WBMP , XBM)
$imgSize - New Image Size In Pixels 
            '250,250'
$imgPos- New Image Position
 
          'TL' >> TOP LEFT
          'TM' >> TOP MIDDLE
          'ML' >> TOP LEFT
          'M'  >> MIDDLE
          'BL' >> BOTTOM LEFT
          'BM' >> BOTTOM MIDDLE
          '$X,$Y' >> CUSTOM POSITION
            $X = Postion X In Pixels 
            $Y = Postion Y In Pixels 
              Ex: '0,0'
 
$layerEffect - Add Image With Layer Effect
           'EFF_REPLACE' ,  'EFF_ALPHABLEND' ,  
           'EFF_NORMAL' ,  'EFF_OVERLAY'  , 'EFF_MULTIPLY'
 

Save Image

$img->saveIt($target_path, $createDir, $deleteSource)

 

$target_path - Path To Save Image
             Ex: 'FromHere/To'
$createDir - If Path Not Exists Then Create Directory (Default 0)
             0 - Don't Create Directory
             1 - Create Directory
$deleteSource - If Original Image Is On Your Server , (Default 0)
             0 - Do Not Delete Original File After Editing It
             1 - Delete Original File After Editing It

Get Edited Image Without Saving It

$img_name = $img->getImage64BaseString();
?>
<img src="data:image/png;base64,<?= $img_name ?>">

Sample Images

See All Images (Step wise)