phpOMS/Utils/Barcode/C128Abstract.php

393 lines
8.6 KiB
PHP

<?php
/**
* Orange Management
*
* PHP Version 7.2
*
* @package TBD
* @copyright Dennis Eichhorn
* @license OMS License 1.0
* @version 1.0.0
* @link http://website.orange-management.de
*/
declare(strict_types=1);
namespace phpOMS\Utils\Barcode;
use phpOMS\Stdlib\Base\Exception\InvalidEnumValue;
/**
* Code 128 abstract class.
*
* @package Log
* @license OMS License 1.0
* @link http://website.orange-management.de
* @since 1.0.0
*
* @SuppressWarnings(PHPMD.CamelCasePropertyName)
* @SuppressWarnings(PHPMD.CamelCaseVariableName)
*/
abstract class C128Abstract
{
/**
* Checksum.
*
* @var int
* @since 1.0.0
*/
protected static $CHECKSUM = 0;
/**
* Char weighted array.
*
* @var string[]
* @since 1.0.0
*/
protected static $CODEARRAY = [];
/**
* Code start.
*
* @var string
* @since 1.0.0
*/
protected static $CODE_START = '';
/**
* Code end.
*
* @var string
* @since 1.0.0
*/
protected static $CODE_END = '';
/**
* Orientation.
*
* @var int
* @since 1.0.0
*/
protected $orientation = 0;
/**
* Barcode dimension.
*
* @todo : Implement!
*
* @var int[]
* @since 1.0.0
*/
protected $dimension = ['width' => 0, 'height' => 0];
/**
* Barcode dimension.
*
* @todo : Implement!
*
* @var int
* @since 1.0.0
*/
protected $margin = 10;
/**
* Content to encrypt.
*
* @var string
* @since 1.0.0
*/
protected $content = '';
/**
* Show text below barcode.
*
* @var bool
* @since 1.0.0
*/
protected $showText = true;
/**
* Background color.
*
* @var int[]
* @since 1.0.0
*/
protected $background = ['r' => 0, 'g' => 0, 'b' => 0, 'a' => 0];
/**
* Front color.
*
* @var int[]
* @since 1.0.0
*/
protected $front = ['r' => 0, 'g' => 0, 'b' => 0, 'a' => 0];
/**
* Constructor
*
* @param string $content Content to encrypt
* @param int $width Barcode width
* @param int $height Barcode height
* @param int $orientation Orientation of the barcode
*
* @todo : add mirror parameter
*
* @since 1.0.0
*/
public function __construct(string $content = '', int $width = 100, int $height = 20, int $orientation = OrientationType::HORIZONTAL)
{
$this->content = $content;
$this->setDimension($width, $height);
$this->setOrientation($orientation);
}
/**
* Set barcode dimensions
*
* @param int $width Barcode width
* @param int $height Barcode height
*
* @return void
*
* @since 1.0.0
*/
public function setDimension(int $width, int $height) : void
{
if ($width < 0) {
throw new \OutOfBoundsException($width);
}
if ($height < 0) {
throw new \OutOfBoundsException($height);
}
$this->dimension['width'] = $width;
$this->dimension['height'] = $height;
}
/**
* Set barcode margins
*
* @param int $margin Barcode margin
*
* @return void
*
* @since 1.0.0
*/
public function setMargin(int $margin) : void
{
$this->margin = $margin;
}
/**
* Set barcode orientation
*
* @param int $orientation Barcode orientation
*
* @return void
*
* @since 1.0.0
*/
public function setOrientation(int $orientation) : void
{
if (!OrientationType::isValidValue($orientation)) {
throw new InvalidEnumValue($orientation);
}
$this->orientation = $orientation;
}
/**
* Get content
*
* @return string
*
* @since 1.0.0
*/
public function getContent() : string
{
return $this->content;
}
/**
* Set content to encrypt
*
* @param string $content Barcode content
*
* @return void
*
* @since 1.0.0
*/
public function setContent(string $content) : void
{
$this->content = $content;
}
/**
* Get image reference
*
* @return mixed
*
* @since 1.0.0
*/
public function get()
{
$codeString = static::$CODE_START . $this->generateCodeString() . static::$CODE_END;
return $this->createImage($codeString);
}
/**
* Save to file
*
* @param string $file File path/name
*
* @return void
*
* @since 1.0.0
*/
public function saveToPngFile(string $file) : void
{
$res = $this->get();
imagepng($res, $file);
imagedestroy($res);
}
/**
* Save to file
*
* @param string $file File path/name
*
* @return void
*
* @since 1.0.0
*/
public function saveToJpgFile(string $file) : void
{
$res = $this->get();
imagejpeg($res, $file);
imagedestroy($res);
}
/**
* Generate weighted code string
*
* @return string
*
* @since 1.0.0
*/
protected function generateCodeString() : string
{
$keys = array_keys(static::$CODEARRAY);
$values = array_flip($keys);
$codeString = '';
$length = strlen($this->content);
$checksum = static::$CHECKSUM;
for ($pos = 1; $pos <= $length; $pos++) {
$activeKey = substr($this->content, ($pos - 1), 1);
$codeString .= static::$CODEARRAY[$activeKey];
$checksum += $values[$activeKey] * $pos;
}
$codeString .= static::$CODEARRAY[$keys[($checksum - (intval($checksum / 103) * 103))]];
return $codeString;
}
/**
* Create barcode image
*
* @param string $codeString Code string to render
*
* @return mixed
*
* @since 1.0.0
*/
protected function createImage(string $codeString)
{
$dimensions = $this->calculateDimensions($codeString);
$image = imagecreate($dimensions['width'], $dimensions['height']);
$black = imagecolorallocate($image, 0, 0, 0);
$white = imagecolorallocate($image, 255, 255, 255);
$location = 0;
$length = strlen($codeString);
imagefill($image, 0, 0, $white);
for ($position = 1; $position <= $length; $position++) {
$cur_size = $location + (int) (substr($codeString, ($position - 1), 1));
if ($this->orientation === OrientationType::HORIZONTAL) {
imagefilledrectangle(
$image,
$location + $this->margin,
0 + $this->margin,
$cur_size + $this->margin,
$dimensions['height'] - $this->margin,
($position % 2 == 0 ? $white : $black)
);
} else {
imagefilledrectangle(
$image,
0 + $this->margin,
$location + $this->margin,
$dimensions['width'] - $this->margin,
$cur_size + $this->margin,
($position % 2 == 0 ? $white : $black)
);
}
$location = $cur_size;
}
return $image;
}
/**
* Calculate the code length for image dimensions
*
* @param string $codeString Code string to render
*
* @return int Length of the code
*
* @since 1.0.0
*/
private function calculateCodeLength(string $codeString) : int
{
$codeLength = 0;
$length = strlen($codeString);
for ($i = 1; $i <= $length; ++$i) {
$codeLength = $codeLength + (int) (substr($codeString, ($i - 1), 1));
}
return $codeLength;
}
/**
* Calculate the code dimensions
*
* @param string $codeString Code string to render
*
* @return array<string, int>
*
* @since 1.0.0
*/
private function calculateDimensions(string $codeString) : array
{
$codeLength = $this->calculateCodeLength($codeString);
$dimensions = ['width' => 0, 'height' => 0];
if ($this->orientation === OrientationType::HORIZONTAL) {
$dimensions['width'] = $codeLength + $this->margin * 2;
$dimensions['height'] = $this->dimension['height'];
} else {
$dimensions['width'] = $this->dimension['width'];
$dimensions['height'] = $codeLength + $this->margin;
}
return $dimensions;
}
}