feat: Add comprehensive documentation suite and reorganize project structure
- Created complete documentation in docs/ directory - Added PROJECT_OVERVIEW.md with feature highlights and getting started guide - Added ARCHITECTURE.md with system design and technical details - Added SECURITY.md with comprehensive security implementation guide - Added DEVELOPMENT.md with development workflows and best practices - Added DEPLOYMENT.md with production deployment instructions - Added API.md with complete REST API documentation - Added CONTRIBUTING.md with contribution guidelines - Added CHANGELOG.md with version history and migration notes - Reorganized all documentation files into docs/ directory for better organization - Updated README.md with proper documentation links and quick navigation - Enhanced project structure with professional documentation standards
This commit is contained in:
SamiAhmed7777
318
f_core/f_classes/class.image.php
Normal file
318
f_core/f_classes/class.image.php
Normal file
@@ -0,0 +1,318 @@
|
||||
<?php
|
||||
/*******************************************************************************************************************
|
||||
| Software Name : EasyStream
|
||||
| Software Description : High End YouTube Clone Script with Videos, Shorts, Streams, Images, Audio, Documents, Blogs
|
||||
| Software Author : (c) Sami Ahmed
|
||||
|*******************************************************************************************************************
|
||||
|
|
||||
|*******************************************************************************************************************
|
||||
| This source file is subject to the EasyStream Proprietary License Agreement.
|
||||
|
|
||||
| By using this software, you acknowledge having read this Agreement and agree to be bound thereby.
|
||||
|*******************************************************************************************************************
|
||||
| Copyright (c) 2025 Sami Ahmed. All rights reserved.
|
||||
|*******************************************************************************************************************/
|
||||
|
||||
defined('_ISVALID') or header('Location: /error');
|
||||
|
||||
class VImage
|
||||
{
|
||||
private $image;
|
||||
private $gimage;
|
||||
private $gsrc;
|
||||
private $image_type;
|
||||
private $image_ext;
|
||||
|
||||
public static function load($filename)
|
||||
{
|
||||
try
|
||||
{
|
||||
return new \VImage($filename);
|
||||
} catch (\Exception $e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
public function location($path)
|
||||
{
|
||||
if (!is_dir($path)) {
|
||||
mkdir($path);
|
||||
chmod($path, 0777);
|
||||
}
|
||||
}
|
||||
|
||||
public static function dim($dimension)
|
||||
{
|
||||
$arr = explode('x', $dimension);
|
||||
$width = (isset($arr['0'])) ? (int) $arr['0'] : 0;
|
||||
$height = (isset($arr['1'])) ? (int) $arr['1'] : 0;
|
||||
|
||||
return array('width' => $width, 'height' => $height);
|
||||
}
|
||||
|
||||
public static function mime_to_ext($mime)
|
||||
{
|
||||
$mimes = array(
|
||||
'image/jpeg' => 'jpg',
|
||||
'image/pjpeg' => 'jpg',
|
||||
'image/png' => 'png',
|
||||
'image/x-png' => 'png',
|
||||
'image/tiff' => 'tif',
|
||||
'image/gif' => 'gif',
|
||||
);
|
||||
|
||||
return (isset($mimes[$mime])) ? $mimes[$mime] : false;
|
||||
}
|
||||
|
||||
public function __construct($filename)
|
||||
{
|
||||
if (!file_exists($filename)) {
|
||||
throw new \Exception();
|
||||
}
|
||||
|
||||
$image_info = getimagesize($filename);
|
||||
$this->image_type = $image_info[2];
|
||||
|
||||
if ($this->image_type == IMAGETYPE_JPEG) {
|
||||
$this->image = imagecreatefromjpeg($filename);
|
||||
$this->image_ext = 'jpg';
|
||||
} elseif ($this->image_type == IMAGETYPE_GIF) {
|
||||
$this->image = imagecreatefromgif($filename);
|
||||
$this->image_ext = 'gif';
|
||||
} elseif ($this->image_type == IMAGETYPE_PNG) {
|
||||
$this->image = imagecreatefrompng($filename);
|
||||
$this->image_ext = 'png';
|
||||
} else {
|
||||
throw new \Exception();
|
||||
}
|
||||
|
||||
}
|
||||
public function __destruct()
|
||||
{
|
||||
imagedestroy($this->image);
|
||||
}
|
||||
public function save($filename, $image_type = null, $compression = 100, $permissions = null)
|
||||
{
|
||||
if (is_null($image_type)) {
|
||||
$image_type = $this->image_type;
|
||||
}
|
||||
|
||||
if ($image_type == IMAGETYPE_JPEG) {
|
||||
imagejpeg($this->image, $filename, $compression);
|
||||
} elseif ($image_type == IMAGETYPE_GIF) {
|
||||
imagegif($this->image, $filename);
|
||||
} elseif ($image_type == IMAGETYPE_PNG) {
|
||||
imagepng($this->image, $filename);
|
||||
}
|
||||
|
||||
if ($permissions != null) {
|
||||
chmod($filename, $permissions);
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
public function output($send_headers = true, $image_type = null)
|
||||
{
|
||||
if (is_null($image_type)) {
|
||||
$image_type = $this->image_type;
|
||||
}
|
||||
|
||||
if ($send_headers === true) {
|
||||
header('Content-Type: ' . $image_type);
|
||||
}
|
||||
|
||||
if ($image_type == IMAGETYPE_JPEG) {
|
||||
imagejpeg($this->image);
|
||||
} elseif ($image_type == IMAGETYPE_GIF) {
|
||||
imagegif($this->image);
|
||||
} elseif ($image_type == IMAGETYPE_PNG) {
|
||||
imagepng($this->image);
|
||||
}
|
||||
}
|
||||
public function getWidth()
|
||||
{
|
||||
return imagesx($this->image);
|
||||
}
|
||||
public function getHeight()
|
||||
{
|
||||
return imagesy($this->image);
|
||||
}
|
||||
public function getImageType()
|
||||
{
|
||||
return $this->image_type;
|
||||
}
|
||||
|
||||
public function getImageExt()
|
||||
{
|
||||
return $this->image_ext;
|
||||
}
|
||||
|
||||
public function resizeToWidth_base($width)
|
||||
{
|
||||
$ratio = $width / $this->getWidth();
|
||||
$height = $this->getHeight() * $ratio;
|
||||
|
||||
$this->__resize($width, $height);
|
||||
}
|
||||
public function resizeToHeight_base($height)
|
||||
{
|
||||
$ratio = $height / $this->getHeight();
|
||||
$width = $this->getWidth() * $ratio;
|
||||
|
||||
$this->__resize($width, $height);
|
||||
}
|
||||
public function scale($scale)
|
||||
{
|
||||
$width = $this->getWidth() * $scale / 100;
|
||||
$height = $this->getHeight() * $scale / 100;
|
||||
|
||||
$this->__resize($width, $height);
|
||||
}
|
||||
private function __resize($width, $height)
|
||||
{
|
||||
$new_image = imagecreatetruecolor($width, $height);
|
||||
|
||||
imagealphablending($new_image, true);
|
||||
imagesavealpha($new_image, true);
|
||||
imagefill($new_image, 0, 0, imagecolorallocatealpha($new_image, 244, 244, 244, 127));
|
||||
imagecopyresampled($new_image, $this->image, 0, 0, 0, 0, $width, $height, $this->getWidth(), $this->getHeight());
|
||||
|
||||
$this->image = $new_image;
|
||||
}
|
||||
public static function filename($file, $type, $color = false)
|
||||
{
|
||||
$a = explode("-", $file);
|
||||
$t = count($a);
|
||||
|
||||
$a[$t] = $a[$t - 1];
|
||||
$a[$t - 1] = $type;
|
||||
|
||||
$b = implode("-", $a);
|
||||
|
||||
if ($color) {
|
||||
$b = str_replace($color . '-', '', $b);
|
||||
$a = explode("-", $b);
|
||||
|
||||
$t = count($a);
|
||||
$a[$t] = $a[$t - 1];
|
||||
$a[$t - 1] = $a[$t - 2];
|
||||
$a[$t - 2] = $a[$t - 3];
|
||||
$a[$t - 3] = $color;
|
||||
|
||||
$b = implode("-", $a);
|
||||
}
|
||||
|
||||
return $b;
|
||||
}
|
||||
public function save_original($src, $dst)
|
||||
{
|
||||
copy($src, $dst);
|
||||
}
|
||||
public function resizeToHeight($src, $product_id, $filename, $base_height, $size)
|
||||
{
|
||||
$base = THUMB_DIR . '/' . $product_id;
|
||||
$dst_path = $base . '/' . $filename;
|
||||
|
||||
$image = new \Gmagick($src);
|
||||
$height_src = $image->getimageheight();
|
||||
|
||||
if ($base_height > $height_src) {
|
||||
$this->save_original($src, $dst_path);
|
||||
} else {
|
||||
//Make thumbnail from image loaded. 0 for either axes preserves aspect ratio
|
||||
$image->thumbnailImage(0, $base_height);
|
||||
//Write the current image at the current state to a file
|
||||
$image->write($dst_path);
|
||||
}
|
||||
}
|
||||
|
||||
public function resizeToWidth_dome()
|
||||
{
|
||||
}
|
||||
public function resize($width, $height, $cropped = true)
|
||||
{
|
||||
if ($cropped === true) {
|
||||
$new_image = imagecreatetruecolor($width, $height);
|
||||
|
||||
$ratio = $width / $this->getWidth();
|
||||
$new_height = $this->getHeight() * $ratio;
|
||||
|
||||
if ($new_height >= $height) {
|
||||
$this->resizeToWidth_base($width);
|
||||
$x = 0;
|
||||
$y = ($height / 2 - ($this->getHeight() - $height) / 2);
|
||||
} else {
|
||||
$this->resizeToHeight_base($height);
|
||||
$x = ($width / 2 - ($this->getWidth() - $width) / 2);
|
||||
$y = 0;
|
||||
}
|
||||
|
||||
imagecopy($new_image, $this->image, 0, 0, $x, $y, $this->getWidth(), $this->getHeight());
|
||||
|
||||
$this->image = $new_image;
|
||||
} else {
|
||||
$this->__resize($width, $height);
|
||||
}
|
||||
}
|
||||
public function convertToBlackAndWhite()
|
||||
{
|
||||
$width = $this->getWidth();
|
||||
$height = $this->getHeight();
|
||||
|
||||
$bwimage = imagecreate($width, $height);
|
||||
|
||||
for ($c = 0; $c < 256; $c++) {
|
||||
$palette[$c] = imagecolorallocate($bwimage, $c, $c, $c);
|
||||
}
|
||||
|
||||
for ($y = 0; $y < $height; $y++) {
|
||||
for ($x = 0; $x < $width; $x++) {
|
||||
$rgb = imagecolorat($this->image, $x, $y);
|
||||
$r = ($rgb >> 16) & 0xFF;
|
||||
$g = ($rgb >> 8) & 0xFF;
|
||||
$b = $rgb & 0xFF;
|
||||
|
||||
$gs = ($r * 0.299) + ($g * 0.587) + ($b * 0.114);
|
||||
imagesetpixel($bwimage, $x, $y, $palette[$gs]);
|
||||
}
|
||||
}
|
||||
|
||||
$this->image = $bwimage;
|
||||
}
|
||||
public function flip($mode = 'both')
|
||||
{
|
||||
$src_width = $width = $this->getWidth();
|
||||
$src_height = $height = $this->getHeight();
|
||||
|
||||
$src_y = $src_x = 0;
|
||||
|
||||
switch ($mode) {
|
||||
case 'vertical':
|
||||
$src_y = $height - 1;
|
||||
$src_height = $height * (-1);
|
||||
break;
|
||||
|
||||
case 'horizontal':
|
||||
$src_x = $width - 1;
|
||||
$src_width = $width * (-1);
|
||||
break;
|
||||
|
||||
case 'both':
|
||||
$src_x = $width - 1;
|
||||
$src_y = $height - 1;
|
||||
$src_width = $width * (-1);
|
||||
$src_height = $height * (-1);
|
||||
break;
|
||||
|
||||
default:
|
||||
return false;
|
||||
}
|
||||
|
||||
$new_image = imagecreatetruecolor($width, $height);
|
||||
|
||||
if ($success = imagecopyresampled($new_image, $this->image, 0, 0, $src_x, $src_y, $width, $height, $src_width, $src_height)) {
|
||||
$this->image = $new_image;
|
||||
}
|
||||
|
||||
return $success;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user