react-native-scanbot-barcode-scanner-sdk 7.1.2-rc.2 → 8.0.0-rc.1

package/src/{imageRef → types/core/image}/ImageRefTypes.ts

@@ -1,15 +1,75 @@
 /// Auto-generated with ScanbotSDKCodegenV3. Modifications will be overwritten.
 /// Generated from core/schemas/ImageRefTypes.yaml
 
-import { ImageRotation } from '../imageRef/ImageTypes';
-import { RefCountedObjectProfile } from '../imageRef/ObjectPoolTypes';
-import { ToJsonConfiguration } from '../utils/json/JsonSerializationTypes';
-import { DeepPartial, PartiallyConstructible, Rectangle } from '../utils/utils';
+import { ToJsonConfiguration } from '../common/JsonSerializationTypes';
+import { RefCountedObjectProfile } from '../utils/ObjectPoolTypes';
+import type { Rectangle } from '../utils/utils';
+import { DeepPartial } from '../utils/utils';
+import { ImageOrigin, ImageRotation } from './ImageTypes';
+
+/**
+Color conversion to apply during image loading.
+
+- `GRAY`:
+   Load image as grayscale.
+- `COLOR`:
+   Load image as 3-channel BGR.
+- `ANY_COLOR`:
+   Load image as 3-channel BGR if the source color space is color, otherwise as single-channel grayscale. Alpha channel is discarded.
+- `UNCHANGED`:
+   Load image as-is, preserving the alpha channel if it exists.
+*/
+export type ColorConversion =
+  /**
+    Load image as grayscale.
+    */
+  | 'GRAY'
+  /**
+    Load image as 3-channel BGR.
+    */
+  | 'COLOR'
+  /**
+    Load image as 3-channel BGR if the source color space is color, otherwise as single-channel grayscale. Alpha channel is discarded.
+    */
+  | 'ANY_COLOR'
+  /**
+    Load image as-is, preserving the alpha channel if it exists.
+    */
+  | 'UNCHANGED';
+
+/** @hidden */
+export const ColorConversionValues: ReadonlyArray<ColorConversion> = [
+  'GRAY',
+  'COLOR',
+  'ANY_COLOR',
+  'UNCHANGED',
+] as const;
+
+/**
+Canvas color to use when converting images with alpha channel to images without alpha channel.
+
+- `WHITE`:
+   White canvas color.
+- `BLACK`:
+   Black canvas color.
+*/
+export type CanvasColor =
+  /**
+    White canvas color.
+    */
+  | 'WHITE'
+  /**
+    Black canvas color.
+    */
+  | 'BLACK';
+
+/** @hidden */
+export const CanvasColorValues: ReadonlyArray<CanvasColor> = ['WHITE', 'BLACK'] as const;
 
 /**
 Image Info.
 */
-export class ImageInfo extends PartiallyConstructible {
+export class ImageInfo {
   /**
     Image height in pixels.
     */
@@ -25,7 +85,6 @@ export class ImageInfo extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageInfo>`} */
   public constructor(source: DeepPartial<ImageInfo> = {}) {
-    super();
     if (source.height !== undefined) {
       this.height = source.height;
     } else {
@@ -64,9 +123,26 @@ Image Ref Path Load Mode.
 - `LAZY_WITH_COPY`:
    Image is loaded into memory the first time it's requested. Specified path is copied into internal directory and so isn't required to exist at the time of loading.
 */
-export type PathLoadMode = 'EAGER' | 'LAZY' | 'LAZY_WITH_COPY';
+export type PathLoadMode =
+  /**
+    Image is immediately loaded into memory.
+    */
+  | 'EAGER'
+  /**
+    Image is loaded into memory the first time it's requested. Specified path must exist at the time of loading.
+    */
+  | 'LAZY'
+  /**
+    Image is loaded into memory the first time it's requested. Specified path is copied into internal directory and so isn't required to exist at the time of loading.
+    */
+  | 'LAZY_WITH_COPY';
 
-export const PathLoadModeValues: PathLoadMode[] = ['EAGER', 'LAZY', 'LAZY_WITH_COPY'];
+/** @hidden */
+export const PathLoadModeValues: ReadonlyArray<PathLoadMode> = [
+  'EAGER',
+  'LAZY',
+  'LAZY_WITH_COPY',
+] as const;
 
 /**
 Image Ref Buffer Load Mode.
@@ -76,9 +152,18 @@ Image Ref Buffer Load Mode.
 - `LAZY`:
    Image is decoded the first time it's requested.
 */
-export type BufferLoadMode = 'EAGER' | 'LAZY';
+export type BufferLoadMode =
+  /**
+    Image is immediately decoded.
+    */
+  | 'EAGER'
+  /**
+    Image is decoded the first time it's requested.
+    */
+  | 'LAZY';
 
-export const BufferLoadModeValues: BufferLoadMode[] = ['EAGER', 'LAZY'];
+/** @hidden */
+export const BufferLoadModeValues: ReadonlyArray<BufferLoadMode> = ['EAGER', 'LAZY'] as const;
 
 /**
 Image Encoding Format.
@@ -88,9 +173,18 @@ Image Encoding Format.
 - `PNG`:
    PNG encoding.
 */
-export type EncodingFormat = 'JPEG' | 'PNG';
+export type EncodingFormat =
+  /**
+    JPEG encoding.
+    */
+  | 'JPEG'
+  /**
+    PNG encoding.
+    */
+  | 'PNG';
 
-export const EncodingFormatValues: EncodingFormat[] = ['JPEG', 'PNG'];
+/** @hidden */
+export const EncodingFormatValues: ReadonlyArray<EncodingFormat> = ['JPEG', 'PNG'] as const;
 
 /**
 Encryption/Decryption mode to be used when an image is loaded/saved.
@@ -98,47 +192,90 @@ Encryption/Decryption mode to be used when an image is loaded/saved.
 - `REQUIRED`:
    Encryption/Decryption is used when loading/saving an image. A crypting provider must first be set using `ImageRef.setStorageCryptingProvider`. If no provider is set, the loading/saving operation will fail.
 - `DISABLED`:
-   Encryption/Decryption is not used when loading/saving an image.
-- `IF_AVAILABLE`:
-   Encryption/Decryption is used when loading/saving an image if a crypting provider is set using `ImageRef.setStorageCryptingProvider`.
+   Encryption is not used when loading or saving images. Trying to load an encrypted image will fail.
+- `AUTO`:
+   When saving, images are encrypted only if a crypting provider is set using `ImageRef.setStorageCryptingProvider`.
+   When loading, images will be decrypted if they're encrypted and a crypting provider is set, and loaded as-is otherwise.
 */
-export type EncryptionMode = 'REQUIRED' | 'DISABLED' | 'IF_AVAILABLE';
+export type EncryptionMode =
+  /**
+    Encryption/Decryption is used when loading/saving an image. A crypting provider must first be set using `ImageRef.setStorageCryptingProvider`. If no provider is set, the loading/saving operation will fail.
+    */
+  | 'REQUIRED'
+  /**
+    Encryption is not used when loading or saving images. Trying to load an encrypted image will fail.
+    */
+  | 'DISABLED'
+  /**
+    When saving, images are encrypted only if a crypting provider is set using `ImageRef.setStorageCryptingProvider`.
+    When loading, images will be decrypted if they're encrypted and a crypting provider is set, and loaded as-is otherwise.
+    */
+  | 'AUTO';
 
-export const EncryptionModeValues: EncryptionMode[] = ['REQUIRED', 'DISABLED', 'IF_AVAILABLE'];
+/** @hidden */
+export const EncryptionModeValues: ReadonlyArray<EncryptionMode> = [
+  'REQUIRED',
+  'DISABLED',
+  'AUTO',
+] as const;
 
 /**
 Basic options for loading image.
 */
-export class BasicImageLoadOptions extends PartiallyConstructible {
+export class BasicImageLoadOptions {
   /**
-    Region of interest.
+    If the rect is not empty, the image will be cropped to this rect before processing.
     */
-  public roi: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  public cropRect: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  /**
+    CanvasColor color to use when converting images with alpha channel to images without alpha channel.
+    
+    Default is WHITE
+    */
+  public canvasColor: CanvasColor = 'WHITE';
 
   /** @param source {@displayType `DeepPartial<BasicImageLoadOptions>`} */
   public constructor(source: DeepPartial<BasicImageLoadOptions> = {}) {
-    super();
-    if (source.roi !== undefined) {
-      this.roi = {
-        x: source.roi.x,
-        y: source.roi.y,
-        width: source.roi.width,
-        height: source.roi.height,
+    if (source.cropRect !== undefined) {
+      this.cropRect = {
+        x: source.cropRect.x,
+        y: source.cropRect.y,
+        width: source.cropRect.width,
+        height: source.cropRect.height,
       };
     }
+    if (source.canvasColor !== undefined) {
+      this.canvasColor = source.canvasColor;
+    }
   }
 }
 
 /**
 Options for loading images that come from sensor.
 */
-export class RawImageLoadOptions extends PartiallyConstructible {
+export class RawImageLoadOptions {
+  /**
+    If the rect is not empty, the image will be cropped to this rect before processing.
+    */
+  public cropRect: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
   /**
-    Region of interest.
+    Location of the image origin in the image coordinate system. 
+    During loading images are flipped such that after the flip their new origin is in their top-left corner. 
+    For example, an image coming from the front camera might have its origin set to the top-right, which will flip it along its vertical axis to create a mirror effect.
+    
+    The origin is interpreted net of the image orientation. The origin rotates together with the image. The origin value is interpreted and the resulting flip executed AFTER the image matrix has been reoriented to have a neutral orientation.
+    
+    Default is TOP_LEFT
+    */
+  public origin: ImageOrigin = 'TOP_LEFT';
+  /**
+    CanvasColor color to use when converting images with alpha channel to images without alpha channel.
+    
+    Default is WHITE
     */
-  public roi: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  public canvasColor: CanvasColor = 'WHITE';
   /**
-    Rotation that should be applied to the image to recover correct orientation.
+    Rotation that should be applied to the image to recover correct orientation. Is applied before cropping.
     
     Default is NONE
     */
@@ -146,15 +283,20 @@ export class RawImageLoadOptions extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<RawImageLoadOptions>`} */
   public constructor(source: DeepPartial<RawImageLoadOptions> = {}) {
-    super();
-    if (source.roi !== undefined) {
-      this.roi = {
-        x: source.roi.x,
-        y: source.roi.y,
-        width: source.roi.width,
-        height: source.roi.height,
+    if (source.cropRect !== undefined) {
+      this.cropRect = {
+        x: source.cropRect.x,
+        y: source.cropRect.y,
+        width: source.cropRect.width,
+        height: source.cropRect.height,
       };
     }
+    if (source.origin !== undefined) {
+      this.origin = source.origin;
+    }
+    if (source.canvasColor !== undefined) {
+      this.canvasColor = source.canvasColor;
+    }
     if (source.orientation !== undefined) {
       this.orientation = source.orientation;
     }
@@ -164,11 +306,23 @@ export class RawImageLoadOptions extends PartiallyConstructible {
 /**
 Options for loading image from path.
 */
-export class PathImageLoadOptions extends PartiallyConstructible {
+export class PathImageLoadOptions {
+  /**
+    If the rect is not empty, the image will be cropped to this rect before processing.
+    */
+  public cropRect: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  /**
+    Color conversion to apply during image loading.
+    
+    Default is ANY_COLOR
+    */
+  public colorConversion: ColorConversion = 'ANY_COLOR';
   /**
-    Region of interest.
+    CanvasColor color to use when converting images with alpha channel to images without alpha channel.
+    
+    Default is WHITE
     */
-  public roi: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  public canvasColor: CanvasColor = 'WHITE';
   /**
     Load mode.
     
@@ -178,21 +332,26 @@ export class PathImageLoadOptions extends PartiallyConstructible {
   /**
     Encryption mode.
     
-    Default is IF_AVAILABLE
+    Default is AUTO
     */
-  public encryptionMode: EncryptionMode = 'IF_AVAILABLE';
+  public encryptionMode: EncryptionMode = 'AUTO';
 
   /** @param source {@displayType `DeepPartial<PathImageLoadOptions>`} */
   public constructor(source: DeepPartial<PathImageLoadOptions> = {}) {
-    super();
-    if (source.roi !== undefined) {
-      this.roi = {
-        x: source.roi.x,
-        y: source.roi.y,
-        width: source.roi.width,
-        height: source.roi.height,
+    if (source.cropRect !== undefined) {
+      this.cropRect = {
+        x: source.cropRect.x,
+        y: source.cropRect.y,
+        width: source.cropRect.width,
+        height: source.cropRect.height,
       };
     }
+    if (source.colorConversion !== undefined) {
+      this.colorConversion = source.colorConversion;
+    }
+    if (source.canvasColor !== undefined) {
+      this.canvasColor = source.canvasColor;
+    }
     if (source.loadMode !== undefined) {
       this.loadMode = source.loadMode;
     }
@@ -205,11 +364,23 @@ export class PathImageLoadOptions extends PartiallyConstructible {
 /**
 Options for loading image from buffer.
 */
-export class BufferImageLoadOptions extends PartiallyConstructible {
+export class BufferImageLoadOptions {
   /**
-    Region of interest.
+    If the rect is not empty, the image will be cropped to this rect before processing.
     */
-  public roi: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  public cropRect: Rectangle = { x: 0, y: 0, width: 0, height: 0 };
+  /**
+    Color conversion to apply during image loading.
+    
+    Default is ANY_COLOR
+    */
+  public colorConversion: ColorConversion = 'ANY_COLOR';
+  /**
+    CanvasColor color to use when converting images with alpha channel to images without alpha channel.
+    
+    Default is WHITE
+    */
+  public canvasColor: CanvasColor = 'WHITE';
   /**
     Load mode.
     
@@ -219,15 +390,20 @@ export class BufferImageLoadOptions extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<BufferImageLoadOptions>`} */
   public constructor(source: DeepPartial<BufferImageLoadOptions> = {}) {
-    super();
-    if (source.roi !== undefined) {
-      this.roi = {
-        x: source.roi.x,
-        y: source.roi.y,
-        width: source.roi.width,
-        height: source.roi.height,
+    if (source.cropRect !== undefined) {
+      this.cropRect = {
+        x: source.cropRect.x,
+        y: source.cropRect.y,
+        width: source.cropRect.width,
+        height: source.cropRect.height,
       };
     }
+    if (source.colorConversion !== undefined) {
+      this.colorConversion = source.colorConversion;
+    }
+    if (source.canvasColor !== undefined) {
+      this.canvasColor = source.canvasColor;
+    }
     if (source.loadMode !== undefined) {
       this.loadMode = source.loadMode;
     }
@@ -237,7 +413,7 @@ export class BufferImageLoadOptions extends PartiallyConstructible {
 /**
 Options for saving image to a path.
 */
-export class SaveImageOptions extends PartiallyConstructible {
+export class SaveImageOptions {
   /**
     Quality parameter is for jpeg only and is in range 0 to 100. If -1, then settings from hibernation are used.
     In case when the Image Ref was created with a lazy load mode and originally has the same format as the requested to save,
@@ -250,13 +426,12 @@ export class SaveImageOptions extends PartiallyConstructible {
   /**
     Encryption mode.
     
-    Default is IF_AVAILABLE
+    Default is AUTO
     */
-  public encryptionMode: EncryptionMode = 'IF_AVAILABLE';
+  public encryptionMode: EncryptionMode = 'AUTO';
 
   /** @param source {@displayType `DeepPartial<SaveImageOptions>`} */
   public constructor(source: DeepPartial<SaveImageOptions> = {}) {
-    super();
     if (source.quality !== undefined) {
       this.quality = source.quality;
     }
@@ -269,7 +444,7 @@ export class SaveImageOptions extends PartiallyConstructible {
 /**
 Options for encoding image.
 */
-export class EncodeImageOptions extends PartiallyConstructible {
+export class EncodeImageOptions {
   /**
     Quality parameter is for jpeg only and is in range 0 to 100. If -1, then settings from hibernation are used.
     In case when the Image Ref was created with a lazy load mode and originally has the same format as the requested to save,
@@ -288,7 +463,6 @@ export class EncodeImageOptions extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<EncodeImageOptions>`} */
   public constructor(source: DeepPartial<EncodeImageOptions> = {}) {
-    super();
     if (source.quality !== undefined) {
       this.quality = source.quality;
     }
@@ -314,21 +488,46 @@ The type of source which originated the underlying image.
 - `OTHER`:
    ImageRef was created from another type, e.g. from custom loader.
 */
-export type ImageSourceType = 'API' | 'PLATFORM_IMAGE' | 'CAMERA' | 'FILE' | 'BUFFER' | 'OTHER';
+export type ImageSourceType =
+  /**
+    ImageRef was created by a call to an SDK feature, such as a scanner, image processor, etc.
+    */
+  | 'API'
+  /**
+    ImageRef was created from a platform image, e.g. Bitmap on Android, UIImage on iOS.
+    */
+  | 'PLATFORM_IMAGE'
+  /**
+    ImageRef was created from data from the camera.
+    */
+  | 'CAMERA'
+  /**
+    ImageRef was created from a file.
+    */
+  | 'FILE'
+  /**
+    ImageRef was created from an encoded buffer.
+    */
+  | 'BUFFER'
+  /**
+    ImageRef was created from another type, e.g. from custom loader.
+    */
+  | 'OTHER';
 
-export const ImageSourceTypeValues: ImageSourceType[] = [
+/** @hidden */
+export const ImageSourceTypeValues: ReadonlyArray<ImageSourceType> = [
   'API',
   'PLATFORM_IMAGE',
   'CAMERA',
   'FILE',
   'BUFFER',
   'OTHER',
-];
+] as const;
 
 /**
 Description of source from which the ImageRef was created.
 */
-export class ImageSource extends PartiallyConstructible {
+export class ImageSource {
   /**
     Source type from which the ImageRef was created.
     */
@@ -340,7 +539,6 @@ export class ImageSource extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageSource>`} */
   public constructor(source: DeepPartial<ImageSource> = {}) {
-    super();
     if (source.type !== undefined) {
       this.type = source.type;
     } else {
@@ -366,7 +564,7 @@ export class ImageSource extends PartiallyConstructible {
 /**
 ImageRef profile part specific to image information.
 */
-export class ImageProfile extends PartiallyConstructible {
+export class ImageProfile {
   /**
     Memory consumption of a memory-backed bitmap. Zero, if the image is hibernating.
     
@@ -382,7 +580,6 @@ export class ImageProfile extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageProfile>`} */
   public constructor(source: DeepPartial<ImageProfile> = {}) {
-    super();
     if (source.bitmapMemoryConsumption !== undefined) {
       this.bitmapMemoryConsumption = source.bitmapMemoryConsumption;
     }
@@ -404,7 +601,7 @@ export class ImageProfile extends PartiallyConstructible {
 /**
 ImageRef profile which provides detailed information about stored object.
 */
-export class ImageRefProfile extends PartiallyConstructible {
+export class ImageRefProfile {
   /**
     Information about the strong and serialized references to the image.
     */
@@ -420,7 +617,6 @@ export class ImageRefProfile extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageRefProfile>`} */
   public constructor(source: DeepPartial<ImageRefProfile> = {}) {
-    super();
     if (source.refInfo !== undefined) {
       this.refInfo = new RefCountedObjectProfile(source.refInfo);
     } else {
@@ -452,7 +648,7 @@ export class ImageRefProfile extends PartiallyConstructible {
 /**
 Snapshot of all alive ImageRefs.
 */
-export class ImageRefPoolSnapshot extends PartiallyConstructible {
+export class ImageRefPoolSnapshot {
   /**
     Detailed profiles of all alive ImageRefs.
     */
@@ -466,9 +662,8 @@ export class ImageRefPoolSnapshot extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageRefPoolSnapshot>`} */
   public constructor(source: DeepPartial<ImageRefPoolSnapshot> = {}) {
-    super();
     if (source.imageRefProfiles !== undefined) {
-      this.imageRefProfiles = source.imageRefProfiles.map((it: any) => {
+      this.imageRefProfiles = source.imageRefProfiles.map((it: DeepPartial<ImageRefProfile>) => {
         return new ImageRefProfile(it);
       });
     } else {
@@ -494,7 +689,7 @@ export class ImageRefPoolSnapshot extends PartiallyConstructible {
 /**
 difference between two snapshots.
 */
-export class ImageRefPoolSnapshotsDiff extends PartiallyConstructible {
+export class ImageRefPoolSnapshotsDiff {
   /**
     Difference between total memory consumption in two snapshots.
     
@@ -516,26 +711,25 @@ export class ImageRefPoolSnapshotsDiff extends PartiallyConstructible {
 
   /** @param source {@displayType `DeepPartial<ImageRefPoolSnapshotsDiff>`} */
   public constructor(source: DeepPartial<ImageRefPoolSnapshotsDiff> = {}) {
-    super();
     if (source.totalMemoryConsumptionDiff !== undefined) {
       this.totalMemoryConsumptionDiff = source.totalMemoryConsumptionDiff;
     }
     if (source.removed !== undefined) {
-      this.removed = source.removed.map((it: any) => {
+      this.removed = source.removed.map((it: DeepPartial<string>) => {
         return it;
       });
     } else {
       throw new Error('removed must be present in constructor argument');
     }
     if (source.added !== undefined) {
-      this.added = source.added.map((it: any) => {
+      this.added = source.added.map((it: DeepPartial<string>) => {
         return it;
       });
     } else {
       throw new Error('added must be present in constructor argument');
     }
     if (source.modified !== undefined) {
-      this.modified = source.modified.map((it: any) => {
+      this.modified = source.modified.map((it: DeepPartial<string>) => {
         return it;
       });
     } else {

package/src/types/core/image/ImageTypes.ts

@@ -0,0 +1,78 @@
+/// Auto-generated with ScanbotSDKCodegenV3. Modifications will be overwritten.
+/// Generated from core/schemas/ImageTypes.yaml
+
+/**
+Image rotation.
+
+- `NONE`:
+   No rotation.
+- `CLOCKWISE_90`:
+   90 degrees clockwise rotation.
+- `CLOCKWISE_180`:
+   180 degrees rotation.
+- `COUNTERCLOCKWISE_90`:
+   90 degrees counterclockwise rotation.
+*/
+export type ImageRotation =
+  /**
+    No rotation.
+    */
+  | 'NONE'
+  /**
+    90 degrees clockwise rotation.
+    */
+  | 'CLOCKWISE_90'
+  /**
+    180 degrees rotation.
+    */
+  | 'CLOCKWISE_180'
+  /**
+    90 degrees counterclockwise rotation.
+    */
+  | 'COUNTERCLOCKWISE_90';
+
+/** @hidden */
+export const ImageRotationValues: ReadonlyArray<ImageRotation> = [
+  'NONE',
+  'CLOCKWISE_90',
+  'CLOCKWISE_180',
+  'COUNTERCLOCKWISE_90',
+] as const;
+
+/**
+Location of the image origin in the image coordinate system.
+
+- `TOP_LEFT`:
+   Origin is at the top left corner of the image.
+- `TOP_RIGHT`:
+   Origin is at the top right corner of the image.
+- `BOTTOM_LEFT`:
+   Origin is at the bottom left corner of the image.
+- `BOTTOM_RIGHT`:
+   Origin is at the bottom right corner of the image.
+*/
+export type ImageOrigin =
+  /**
+    Origin is at the top left corner of the image.
+    */
+  | 'TOP_LEFT'
+  /**
+    Origin is at the top right corner of the image.
+    */
+  | 'TOP_RIGHT'
+  /**
+    Origin is at the bottom left corner of the image.
+    */
+  | 'BOTTOM_LEFT'
+  /**
+    Origin is at the bottom right corner of the image.
+    */
+  | 'BOTTOM_RIGHT';
+
+/** @hidden */
+export const ImageOriginValues: ReadonlyArray<ImageOrigin> = [
+  'TOP_LEFT',
+  'TOP_RIGHT',
+  'BOTTOM_LEFT',
+  'BOTTOM_RIGHT',
+] as const;