Current File : /home2/selectio/www/mm-tailor-billing/vendor/mike42/escpos-php/src/Mike42/Escpos/CodePage.php
<?php
/**
* This file is part of escpos-php: PHP receipt printer library for use with
* ESC/POS-compatible thermal and impact printers.
*
* Copyright (c) 2014-18 Michael Billington < michael.billington@gmail.com >,
* incorporating modifications by others. See CONTRIBUTORS.md for a full list.
*
* This software is distributed under the terms of the MIT license. See LICENSE.md
* for details.
*/
namespace Mike42\Escpos;
use \InvalidArgumentException;
/**
* Class to handle data about a particular CodePage, as loaded from the receipt print
* database.
*
* Also computes map between UTF-8 and this encoding if necessary, using the iconv library.
*/
class CodePage
{
/**
* The input encoding for generating character maps with iconv.
*/
const INPUT_ENCODING = "UTF-8";
/**
* @var string $data
* Data string, null if not known (can be computed with iconv)
*/
protected $data;
/**
* @var string $iconv
* Iconv encoding name, null if not known
*/
protected $iconv;
/**
* @var string $id
* Internal ID of the CodePage
*/
protected $id;
/**
* @var string $name
* Name of the code page. Substituted with the ID if not set.
*/
protected $name;
/**
* @var string $notes
* Notes on this code page, or null if not set.
*/
protected $notes;
/**
*
* @param string $id
* Unique internal identifier for the CodePage.
* @param array $codePageData
* Associative array of CodePage data, as
* specified by the upstream receipt-print-hq/escpos-printer-db database.
* May contain 'name', 'data', 'iconv', and 'notes' fields.
*/
public function __construct($id, array $codePageData)
{
$this->id = $id;
$this->name = isset($codePageData['name']) ? $codePageData['name'] : $id;
$this->data = isset($codePageData['data']) ? implode("", $codePageData['data']) : null;
$this->iconv = isset($codePageData['iconv']) ? $codePageData['iconv'] : null;
$this->notes = isset($codePageData['notes']) ? $codePageData['notes'] : null;
}
/**
* Get a 128-character data string representing this encoding.
* It will be
* calculated and cached if it was not previously known.
*
* @throws InvalidArgumentException Where the data is now known or computable.
* @return string Data for this encoding.
*/
public function getData()
{
if ($this->data !== null) {
// Return data if known
return $this->data;
}
if ($this->iconv !== null) {
// Calculate with iconv if we know the encoding name
$this->data = self::generateEncodingMap($this->iconv);
return $this->data;
}
// Can't encode..
throw new InvalidArgumentException("Cannot encode this code page");
}
/**
*
* @return string Iconv encoding name, or blank if not set.
*/
public function getIconv()
{
return $this->iconv;
}
/**
*
* @return string Unique identifier of the code page.
*/
public function getId()
{
return $this->id;
}
/**
* Name of the code page.
*/
public function getName()
{
return $this->name;
}
/**
* The notes may explain quirks about a code-page, such as a source if it's non-standard or un-encodeable.
*
* @return string Notes on the code page, or null if not set.
*/
public function getNotes()
{
return $this->notes;
}
/**
*
* @return boolean True if we can encode with this code page (ie, we know what data it holds).
*
* Many printers contain vendor-specific code pages, which are named but have not been identified or
* typed out. For our purposes, this is an "un-encodeable" code page.
*/
public function isEncodable()
{
return $this->iconv !== null || $this->data !== null;
}
/**
* Given an iconv encoding name, generate a 128-character UTF-8 string, containing code points 128-255.
*
* This string is used to map UTF-8 characters to their location in this code page.
*
* @param string $iconvName
* Name of the encoding
* @return string 128-character string in UTF-8.
*/
protected static function generateEncodingMap($iconvName)
{
// Start with array of blanks (" " indicates unknown character).
$charMap = array_fill(0, 128, " ");
// Loop through 128 code points
for ($char = 128; $char <= 255; $char ++) {
// Try to identify the UTF-8 character that would go here
$utf8 = @iconv($iconvName, self::INPUT_ENCODING, chr($char));
if ($utf8 == '') {
continue;
}
if (iconv(self::INPUT_ENCODING, $iconvName, $utf8) != chr($char)) {
// Avoid non-canonical conversions (no known examples)
continue;
}
// Replace the ' ' with the correct character if we found it
$charMap[$char - 128] = $utf8;
}
// Join into a 128-character string and return.
$charMapStr = implode("", $charMap);
assert(mb_strlen($charMapStr, self::INPUT_ENCODING) == 128);
return $charMapStr;
}
}
Mini Shell