aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/chillerlan/php-qrcode/src/Detector/FinderPattern.php
blob: 3ae4650ad042ec17051cbb5d30b4b31907222c42 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<?php
/**
 * Class FinderPattern
 *
 * @created      17.01.2021
 * @author       ZXing Authors
 * @author       Smiley <smiley@chillerlan.net>
 * @copyright    2021 Smiley
 * @license      Apache-2.0
 */

namespace chillerlan\QRCode\Detector;

use function sqrt;

/**
 * Encapsulates a finder pattern, which are the three square patterns found in
 * the corners of QR Codes. It also encapsulates a count of similar finder patterns,
 * as a convenience to the finder's bookkeeping.
 *
 * @author Sean Owen
 */
final class FinderPattern extends ResultPoint{

	private int $count;

	/**
	 *
	 */
	public function __construct(float $posX, float $posY, float $estimatedModuleSize, ?int $count = null){
		parent::__construct($posX, $posY, $estimatedModuleSize);

		$this->count = ($count ?? 1);
	}

	/**
	 *
	 */
	public function getCount():int{
		return $this->count;
	}

	/**
	 * @param \chillerlan\QRCode\Detector\FinderPattern $b second pattern
	 *
	 * @return float distance between two points
	 */
	public function getDistance(FinderPattern $b):float{
		return self::distance($this->x, $this->y, $b->x, $b->y);
	}

	/**
	 * Get square of distance between a and b.
	 */
	public function getSquaredDistance(FinderPattern $b):float{
		return self::squaredDistance($this->x, $this->y, $b->x, $b->y);
	}

	/**
	 * Combines this object's current estimate of a finder pattern position and module size
	 * with a new estimate. It returns a new FinderPattern containing a weighted average
	 * based on count.
	 */
	public function combineEstimate(float $i, float $j, float $newModuleSize):self{
		$combinedCount = ($this->count + 1);

		return new self(
			($this->count * $this->x + $j) / $combinedCount,
			($this->count * $this->y + $i) / $combinedCount,
			($this->count * $this->estimatedModuleSize + $newModuleSize) / $combinedCount,
			$combinedCount
		);
	}

	/**
	 *
	 */
	private static function squaredDistance(float $aX, float $aY, float $bX, float $bY):float{
		$xDiff = ($aX - $bX);
		$yDiff = ($aY - $bY);

		return ($xDiff * $xDiff + $yDiff * $yDiff);
	}

	/**
	 *
	 */
	public static function distance(float $aX, float $aY, float $bX, float $bY):float{
		return sqrt(self::squaredDistance($aX, $aY, $bX, $bY));
	}

}