123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 |
- <?php
- /*
- * Copyright 2007 ZXing authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
- namespace Zxing;
-
- /**
- * <p>Encapsulates the result of decoding a barcode within an image.</p>
- *
- * @author Sean Owen
- */
- final class Result
- {
- /**
- * @var mixed[]|mixed
- */
- private $resultMetadata = null;
- private $timestamp;
-
- public function __construct(
- private $text,
- private $rawBytes,
- private $resultPoints,
- private $format,
- $timestamp = ''
- ) {
- $this->timestamp = $timestamp ?: time();
- }
-
- /**
- * @return raw text encoded by the barcode
- */
- public function getText()
- {
- return $this->text;
- }
-
- /**
- * @return raw bytes encoded by the barcode, if applicable, otherwise {@code null}
- */
- public function getRawBytes()
- {
- return $this->rawBytes;
- }
-
- /**
- * @return points related to the barcode in the image. These are typically points
- * identifying finder patterns or the corners of the barcode. The exact meaning is
- * specific to the type of barcode that was decoded.
- */
- public function getResultPoints()
- {
- return $this->resultPoints;
- }
-
- /**
- * @return {@link BarcodeFormat} representing the format of the barcode that was decoded
- */
- public function getBarcodeFormat()
- {
- return $this->format;
- }
-
- /**
- * @return {@link Map} mapping {@link ResultMetadataType} keys to values. May be
- * {@code null}. This contains optional metadata about what was detected about the barcode,
- * like orientation.
- */
- public function getResultMetadata()
- {
- return $this->resultMetadata;
- }
-
- public function putMetadata($type, $value): void
- {
- $resultMetadata = [];
- if ($this->resultMetadata === null) {
- $this->resultMetadata = [];
- }
- $resultMetadata[$type] = $value;
- }
-
- public function putAllMetadata($metadata): void
- {
- if ($metadata !== null) {
- if ($this->resultMetadata === null) {
- $this->resultMetadata = $metadata;
- } else {
- $this->resultMetadata = array_merge($this->resultMetadata, $metadata);
- }
- }
- }
-
- public function addResultPoints($newPoints): void
- {
- $oldPoints = $this->resultPoints;
- if ($oldPoints === null) {
- $this->resultPoints = $newPoints;
- } elseif ($newPoints !== null && (is_countable($newPoints) ? count($newPoints) : 0) > 0) {
- $allPoints = fill_array(0, (is_countable($oldPoints) ? count($oldPoints) : 0) + (is_countable($newPoints) ? count($newPoints) : 0), 0);
- $allPoints = arraycopy($oldPoints, 0, $allPoints, 0, is_countable($oldPoints) ? count($oldPoints) : 0);
- $allPoints = arraycopy($newPoints, 0, $allPoints, is_countable($oldPoints) ? count($oldPoints) : 0, is_countable($newPoints) ? count($newPoints) : 0);
- $this->resultPoints = $allPoints;
- }
- }
-
- public function getTimestamp()
- {
- return $this->timestamp;
- }
-
- public function toString()
- {
- return $this->text;
- }
- }
|