Merge branch '8.2RC'8.2

1 files changed, 217 insertions, 0 deletions

diff --git a/vendor/chillerlan/php-qrcode/src/Output/QRImage.php b/vendor/chillerlan/php-qrcode/src/Output/QRImage.php
new file mode 100644
index 000000000..8f533d341
--- /dev/null
+++ b/vendor/chillerlan/php-qrcode/src/Output/QRImage.php
@@ -0,0 +1,217 @@
+<?php
+/**
+ * Class QRImage
+ *
+ * @filesource   QRImage.php
+ * @created      05.12.2015
+ * @package      chillerlan\QRCode\Output
+ * @author       Smiley <smiley@chillerlan.net>
+ * @copyright    2015 Smiley
+ * @license      MIT
+ *
+ * @noinspection PhpComposerExtensionStubsInspection
+ */
+
+namespace chillerlan\QRCode\Output;
+
+use chillerlan\QRCode\Data\QRMatrix;
+use chillerlan\QRCode\{QRCode, QRCodeException};
+use chillerlan\Settings\SettingsContainerInterface;
+use Exception;
+
+use function array_values, base64_encode, call_user_func, count, extension_loaded, imagecolorallocate, imagecolortransparent,
+	imagecreatetruecolor, imagedestroy, imagefilledrectangle, imagegif, imagejpeg, imagepng, in_array,
+	is_array, ob_end_clean, ob_get_contents, ob_start, range, sprintf;
+
+/**
+ * Converts the matrix into GD images, raw or base64 output (requires ext-gd)
+ *
+ * @see http://php.net/manual/book.image.php
+ */
+class QRImage extends QROutputAbstract{
+
+	/**
+	 * GD image types that support transparency
+	 *
+	 * @var string[]
+	 */
+	protected const TRANSPARENCY_TYPES = [
+		QRCode::OUTPUT_IMAGE_PNG,
+		QRCode::OUTPUT_IMAGE_GIF,
+	];
+
+	protected string $defaultMode = QRCode::OUTPUT_IMAGE_PNG;
+
+	/**
+	 * The GD image resource
+	 *
+	 * @see imagecreatetruecolor()
+	 * @var resource|\GdImage
+	 *
+	 * @phan-suppress PhanUndeclaredTypeProperty
+	 */
+	protected $image;
+
+	/**
+	 * @inheritDoc
+	 *
+	 * @throws \chillerlan\QRCode\QRCodeException
+	 */
+	public function __construct(SettingsContainerInterface $options, QRMatrix $matrix){
+
+		if(!extension_loaded('gd')){
+			throw new QRCodeException('ext-gd not loaded'); // @codeCoverageIgnore
+		}
+
+		parent::__construct($options, $matrix);
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	protected function setModuleValues():void{
+
+		foreach($this::DEFAULT_MODULE_VALUES as $M_TYPE => $defaultValue){
+			$v = $this->options->moduleValues[$M_TYPE] ?? null;
+
+			if(!is_array($v) || count($v) < 3){
+				$this->moduleValues[$M_TYPE] = $defaultValue
+					? [0, 0, 0]
+					: [255, 255, 255];
+			}
+			else{
+				$this->moduleValues[$M_TYPE] = array_values($v);
+			}
+
+		}
+
+	}
+
+	/**
+	 * @inheritDoc
+	 *
+	 * @return string|resource|\GdImage
+	 *
+	 * @phan-suppress PhanUndeclaredTypeReturnType, PhanTypeMismatchReturn
+	 */
+	public function dump(string $file = null){
+		$file ??= $this->options->cachefile;
+
+		$this->image = imagecreatetruecolor($this->length, $this->length);
+
+		// avoid: Indirect modification of overloaded property $imageTransparencyBG has no effect
+		// https://stackoverflow.com/a/10455217
+		$tbg        = $this->options->imageTransparencyBG;
+		/** @phan-suppress-next-line PhanParamTooFewInternalUnpack */
+		$background = imagecolorallocate($this->image, ...$tbg);
+
+		if((bool)$this->options->imageTransparent && in_array($this->options->outputType, $this::TRANSPARENCY_TYPES, true)){
+			imagecolortransparent($this->image, $background);
+		}
+
+		imagefilledrectangle($this->image, 0, 0, $this->length, $this->length, $background);
+
+		foreach($this->matrix->matrix() as $y => $row){
+			foreach($row as $x => $M_TYPE){
+				$this->setPixel($x, $y, $this->moduleValues[$M_TYPE]);
+			}
+		}
+
+		if($this->options->returnResource){
+			return $this->image;
+		}
+
+		$imageData = $this->dumpImage();
+
+		if($file !== null){
+			$this->saveToFile($imageData, $file);
+		}
+
+		if($this->options->imageBase64){
+			$imageData = sprintf('data:image/%s;base64,%s', $this->options->outputType, base64_encode($imageData));
+		}
+
+		return $imageData;
+	}
+
+	/**
+	 * Creates a single QR pixel with the given settings
+	 */
+	protected function setPixel(int $x, int $y, array $rgb):void{
+		imagefilledrectangle(
+			$this->image,
+			$x * $this->scale,
+			$y * $this->scale,
+			($x + 1) * $this->scale,
+			($y + 1) * $this->scale,
+			/** @phan-suppress-next-line PhanParamTooFewInternalUnpack */
+			imagecolorallocate($this->image, ...$rgb)
+		);
+	}
+
+	/**
+	 * Creates the final image by calling the desired GD output function
+	 *
+	 * @throws \chillerlan\QRCode\Output\QRCodeOutputException
+	 */
+	protected function dumpImage():string{
+		ob_start();
+
+		try{
+			call_user_func([$this, $this->outputMode ?? $this->defaultMode]);
+		}
+		// not going to cover edge cases
+		// @codeCoverageIgnoreStart
+		catch(Exception $e){
+			throw new QRCodeOutputException($e->getMessage());
+		}
+		// @codeCoverageIgnoreEnd
+
+		$imageData = ob_get_contents();
+		imagedestroy($this->image);
+
+		ob_end_clean();
+
+		return $imageData;
+	}
+
+	/**
+	 * PNG output
+	 *
+	 * @return void
+	 */
+	protected function png():void{
+		imagepng(
+			$this->image,
+			null,
+			in_array($this->options->pngCompression, range(-1, 9), true)
+				? $this->options->pngCompression
+				: -1
+		);
+	}
+
+	/**
+	 * Jiff - like... JitHub!
+	 *
+	 * @return void
+	 */
+	protected function gif():void{
+		imagegif($this->image);
+	}
+
+	/**
+	 * JPG output
+	 *
+	 * @return void
+	 */
+	protected function jpg():void{
+		imagejpeg(
+			$this->image,
+			null,
+			in_array($this->options->jpegQuality, range(0, 100), true)
+				? $this->options->jpegQuality
+				: 85
+		);
+	}
+
+}