@lightningjs/renderer 0.7.1 → 0.7.3

package/src/core/lib/textureCompression.ts

@@ -0,0 +1,152 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * 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.
+ */
+
+import { type TextureData } from '../textures/Texture.js';
+
+/**
+ * Tests if the given location is a compressed texture container
+ * @param url
+ * @remarks
+ * This function is used to determine if the given image url is a compressed
+ * and only supports the following extensions: .ktx and .pvr
+ * @returns
+ */
+export function isCompressedTextureContainer(url: string): boolean {
+  return /\.(ktx|pvr)$/.test(url);
+}
+
+/**
+ * Loads a compressed texture container
+ * @param url
+ * @returns
+ */
+export const loadCompressedTexture = async (
+  url: string,
+): Promise<TextureData> => {
+  const response = await fetch(url);
+  const arrayBuffer = await response.arrayBuffer();
+
+  if (url.indexOf('.ktx') !== -1) {
+    return loadKTXData(arrayBuffer);
+  }
+
+  return loadPVRData(arrayBuffer);
+};
+
+/**
+ * Loads a KTX texture container and returns the texture data
+ * @param buffer
+ * @returns
+ */
+const loadKTXData = async (buffer: ArrayBuffer): Promise<TextureData> => {
+  const view = new DataView(buffer);
+  const littleEndian = view.getUint32(12) === 16909060 ? true : false;
+  const mipmaps = [];
+
+  const data = {
+    glInternalFormat: view.getUint32(28, littleEndian),
+    pixelWidth: view.getUint32(36, littleEndian),
+    pixelHeight: view.getUint32(40, littleEndian),
+    numberOfMipmapLevels: view.getUint32(56, littleEndian),
+    bytesOfKeyValueData: view.getUint32(60, littleEndian),
+  };
+
+  let offset = 64;
+
+  // Key Value Pairs of data start at byte offset 64
+  // But the only known kvp is the API version, so skipping parsing.
+  offset += data.bytesOfKeyValueData;
+
+  for (let i = 0; i < data.numberOfMipmapLevels; i++) {
+    const imageSize = view.getUint32(offset);
+    offset += 4;
+
+    mipmaps.push(view.buffer.slice(offset, imageSize));
+    offset += imageSize;
+  }
+
+  return {
+    data: {
+      glInternalFormat: data.glInternalFormat,
+      mipmaps,
+      width: data.pixelWidth || 0,
+      height: data.pixelHeight || 0,
+      type: 'ktx',
+    },
+    premultiplyAlpha: false,
+  };
+};
+
+/**
+ * Loads a PVR texture container and returns the texture data
+ * @param buffer
+ * @returns
+ */
+const loadPVRData = async (buffer: ArrayBuffer): Promise<TextureData> => {
+  // pvr header length in 32 bits
+  const pvrHeaderLength = 13;
+  // for now only we only support: COMPRESSED_RGB_ETC1_WEBGL
+  const pvrFormatEtc1 = 0x8d64;
+  const pvrWidth = 7;
+  const pvrHeight = 6;
+  const pvrMipmapCount = 11;
+  const pvrMetadata = 12;
+  const arrayBuffer = buffer;
+  const header = new Int32Array(arrayBuffer, 0, pvrHeaderLength);
+
+  // @ts-expect-error Object possibly undefined
+  // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
+  const dataOffset = header[pvrMetadata] + 52;
+  const pvrtcData = new Uint8Array(arrayBuffer, dataOffset);
+  const mipmaps = [];
+  const data = {
+    pixelWidth: header[pvrWidth],
+    pixelHeight: header[pvrHeight],
+    numberOfMipmapLevels: header[pvrMipmapCount] || 0,
+  };
+
+  let offset = 0;
+  let width = data.pixelWidth || 0;
+  let height = data.pixelHeight || 0;
+
+  for (let i = 0; i < data.numberOfMipmapLevels; i++) {
+    const level = ((width + 3) >> 2) * ((height + 3) >> 2) * 8;
+    const view = new Uint8Array(
+      arrayBuffer,
+      pvrtcData.byteOffset + offset,
+      level,
+    );
+
+    mipmaps.push(view);
+    offset += level;
+    width = width >> 1;
+    height = height >> 1;
+  }
+
+  return {
+    data: {
+      glInternalFormat: pvrFormatEtc1,
+      mipmaps: mipmaps,
+      width: data.pixelWidth || 0,
+      height: data.pixelHeight || 0,
+      type: 'pvr',
+    },
+    premultiplyAlpha: false,
+  };
+};

package/src/core/lib/utils.ts

@@ -1,241 +1,241 @@
-/*
- * If not stated otherwise in this file or this component's LICENSE file the
- * following copyright and licenses apply:
- *
- * Copyright 2023 Comcast Cable Communications Management, LLC.
- *
- * 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.
- */
-
-export type RGBA = [r: number, g: number, b: number, a: number];
-export const getNormalizedRgbaComponents = (rgba: number): RGBA => {
-  const r = rgba >>> 24;
-  const g = (rgba >>> 16) & 0xff;
-  const b = (rgba >>> 8) & 0xff;
-  const a = rgba & 0xff;
-  return [r / 255, g / 255, b / 255, a / 255];
-};
-
-export const getRgbaComponents = (rgba: number): RGBA => {
-  const r = rgba >>> 24;
-  const g = (rgba >>> 16) & 0xff;
-  const b = (rgba >>> 8) & 0xff;
-  const a = rgba & 0xff;
-  return [r, g, b, a];
-};
-
-export const norm = (rgba: number): number => {
-  const r = rgba >>> 24;
-  const g = (rgba >>> 16) & 0xff;
-  const b = (rgba >>> 8) & 0xff;
-  const a = rgba & 0xff;
-  const rgbaArr: RGBA = [r / 255, g / 255, b / 255, a / 255];
-
-  rgbaArr[0] = Math.max(0, Math.min(255, rgbaArr[0]));
-  rgbaArr[1] = Math.max(0, Math.min(255, rgbaArr[1]));
-  rgbaArr[2] = Math.max(0, Math.min(255, rgbaArr[2]));
-  rgbaArr[3] = Math.max(0, Math.min(255, rgbaArr[3]));
-  let v =
-    ((rgbaArr[3] | 0) << 24) +
-    ((rgbaArr[0] | 0) << 16) +
-    ((rgbaArr[1] | 0) << 8) +
-    (rgbaArr[2] | 0);
-  if (v < 0) {
-    v = 0xffffffff + v + 1;
-  }
-  return v;
-};
-
-export function getNormalizedAlphaComponent(rgba: number): number {
-  return (rgba & 0xff) / 255.0;
-}
-
-/**
- * Get a CSS color string from a RGBA color
- *
- * @param color
- * @returns
- */
-export function getRgbaString(color: RGBA) {
-  const r = Math.floor(color[0] * 255.0);
-  const g = Math.floor(color[1] * 255.0);
-  const b = Math.floor(color[2] * 255.0);
-  const a = Math.floor(color[3] * 255.0);
-  return `rgba(${r},${g},${b},${a.toFixed(4)})`;
-}
-
-export interface Rect {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-
-export interface RectWithValid extends Rect {
-  valid: boolean;
-}
-
-export interface Bound {
-  x1: number;
-  y1: number;
-  x2: number;
-  y2: number;
-}
-
-export interface BoundWithValid extends Bound {
-  valid: boolean;
-}
-
-export function createBound<T extends Bound = Bound>(
-  x1: number,
-  y1: number,
-  x2: number,
-  y2: number,
-  out?: T,
-): T {
-  if (out) {
-    out.x1 = x1;
-    out.y1 = y1;
-    out.x2 = x2;
-    out.y2 = y2;
-    return out;
-  }
-  return {
-    x1,
-    y1,
-    x2,
-    y2,
-  } as T;
-}
-
-export function intersectBound<T extends Bound = Bound>(
-  a: Bound,
-  b: Bound,
-  out?: T,
-): T {
-  const intersection = createBound(
-    Math.max(a.x1, b.x1),
-    Math.max(a.y1, b.y1),
-    Math.min(a.x2, b.x2),
-    Math.min(a.y2, b.y2),
-    out,
-  );
-  if (intersection.x1 < intersection.x2 && intersection.y1 < intersection.y2) {
-    return intersection;
-  }
-  return createBound(0, 0, 0, 0, intersection);
-}
-
-export function boundsOverlap(a: Bound, b: Bound): boolean {
-  return a.x1 < b.x2 && a.x2 > b.x1 && a.y1 < b.y2 && a.y2 > b.y1;
-}
-
-export function convertBoundToRect(bound: Bound): Rect;
-export function convertBoundToRect<T extends Rect = Rect>(
-  bound: Bound,
-  out: T,
-): T;
-export function convertBoundToRect(bound: Bound, out?: Rect): Rect {
-  if (out) {
-    out.x = bound.x1;
-    out.y = bound.y1;
-    out.width = bound.x2 - bound.x1;
-    out.height = bound.y2 - bound.y1;
-    return out;
-  }
-  return {
-    x: bound.x1,
-    y: bound.y1,
-    width: bound.x2 - bound.x1,
-    height: bound.y2 - bound.y1,
-  };
-}
-
-export function intersectRect(a: Rect, b: Rect): Rect;
-export function intersectRect<T extends Rect = Rect>(
-  a: Rect,
-  b: Rect,
-  out: T,
-): T;
-export function intersectRect(a: Rect, b: Rect, out?: Rect): Rect {
-  const x = Math.max(a.x, b.x);
-  const y = Math.max(a.y, b.y);
-  const width = Math.min(a.x + a.width, b.x + b.width) - x;
-  const height = Math.min(a.y + a.height, b.y + b.height) - y;
-  if (width > 0 && height > 0) {
-    if (out) {
-      out.x = x;
-      out.y = y;
-      out.width = width;
-      out.height = height;
-      return out;
-    }
-    return {
-      x,
-      y,
-      width,
-      height,
-    };
-  }
-  if (out) {
-    out.x = 0;
-    out.y = 0;
-    out.width = 0;
-    out.height = 0;
-    return out;
-  }
-  return {
-    x: 0,
-    y: 0,
-    width: 0,
-    height: 0,
-  };
-}
-
-export function copyRect(a: Rect): Rect;
-export function copyRect<T extends Rect = Rect>(a: Rect, out: T): T;
-export function copyRect(a: Rect, out?: Rect): Rect {
-  if (out) {
-    out.x = a.x;
-    out.y = a.y;
-    out.width = a.width;
-    out.height = a.height;
-    return out;
-  }
-  return {
-    x: a.x,
-    y: a.y,
-    width: a.width,
-    height: a.height,
-  };
-}
-
-export function compareRect(a: Rect | null, b: Rect | null): boolean {
-  if (a === b) {
-    return true;
-  }
-  if (a === null || b === null) {
-    return false;
-  }
-  return (
-    a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height
-  );
-}
-
-export function isBoundPositive(bound: Bound): boolean {
-  return bound.x1 < bound.x2 && bound.y1 < bound.y2;
-}
-
-export function isRectPositive(rect: Rect): boolean {
-  return rect.width > 0 && rect.height > 0;
-}
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * 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.
+ */
+
+export type RGBA = [r: number, g: number, b: number, a: number];
+export const getNormalizedRgbaComponents = (rgba: number): RGBA => {
+  const r = rgba >>> 24;
+  const g = (rgba >>> 16) & 0xff;
+  const b = (rgba >>> 8) & 0xff;
+  const a = rgba & 0xff;
+  return [r / 255, g / 255, b / 255, a / 255];
+};
+
+export const getRgbaComponents = (rgba: number): RGBA => {
+  const r = rgba >>> 24;
+  const g = (rgba >>> 16) & 0xff;
+  const b = (rgba >>> 8) & 0xff;
+  const a = rgba & 0xff;
+  return [r, g, b, a];
+};
+
+export const norm = (rgba: number): number => {
+  const r = rgba >>> 24;
+  const g = (rgba >>> 16) & 0xff;
+  const b = (rgba >>> 8) & 0xff;
+  const a = rgba & 0xff;
+  const rgbaArr: RGBA = [r / 255, g / 255, b / 255, a / 255];
+
+  rgbaArr[0] = Math.max(0, Math.min(255, rgbaArr[0]));
+  rgbaArr[1] = Math.max(0, Math.min(255, rgbaArr[1]));
+  rgbaArr[2] = Math.max(0, Math.min(255, rgbaArr[2]));
+  rgbaArr[3] = Math.max(0, Math.min(255, rgbaArr[3]));
+  let v =
+    ((rgbaArr[3] | 0) << 24) +
+    ((rgbaArr[0] | 0) << 16) +
+    ((rgbaArr[1] | 0) << 8) +
+    (rgbaArr[2] | 0);
+  if (v < 0) {
+    v = 0xffffffff + v + 1;
+  }
+  return v;
+};
+
+export function getNormalizedAlphaComponent(rgba: number): number {
+  return (rgba & 0xff) / 255.0;
+}
+
+/**
+ * Get a CSS color string from a RGBA color
+ *
+ * @param color
+ * @returns
+ */
+export function getRgbaString(color: RGBA) {
+  const r = Math.floor(color[0] * 255.0);
+  const g = Math.floor(color[1] * 255.0);
+  const b = Math.floor(color[2] * 255.0);
+  const a = Math.floor(color[3] * 255.0);
+  return `rgba(${r},${g},${b},${a.toFixed(4)})`;
+}
+
+export interface Rect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export interface RectWithValid extends Rect {
+  valid: boolean;
+}
+
+export interface Bound {
+  x1: number;
+  y1: number;
+  x2: number;
+  y2: number;
+}
+
+export interface BoundWithValid extends Bound {
+  valid: boolean;
+}
+
+export function createBound<T extends Bound = Bound>(
+  x1: number,
+  y1: number,
+  x2: number,
+  y2: number,
+  out?: T,
+): T {
+  if (out) {
+    out.x1 = x1;
+    out.y1 = y1;
+    out.x2 = x2;
+    out.y2 = y2;
+    return out;
+  }
+  return {
+    x1,
+    y1,
+    x2,
+    y2,
+  } as T;
+}
+
+export function intersectBound<T extends Bound = Bound>(
+  a: Bound,
+  b: Bound,
+  out?: T,
+): T {
+  const intersection = createBound(
+    Math.max(a.x1, b.x1),
+    Math.max(a.y1, b.y1),
+    Math.min(a.x2, b.x2),
+    Math.min(a.y2, b.y2),
+    out,
+  );
+  if (intersection.x1 < intersection.x2 && intersection.y1 < intersection.y2) {
+    return intersection;
+  }
+  return createBound(0, 0, 0, 0, intersection);
+}
+
+export function boundsOverlap(a: Bound, b: Bound): boolean {
+  return a.x1 < b.x2 && a.x2 > b.x1 && a.y1 < b.y2 && a.y2 > b.y1;
+}
+
+export function convertBoundToRect(bound: Bound): Rect;
+export function convertBoundToRect<T extends Rect = Rect>(
+  bound: Bound,
+  out: T,
+): T;
+export function convertBoundToRect(bound: Bound, out?: Rect): Rect {
+  if (out) {
+    out.x = bound.x1;
+    out.y = bound.y1;
+    out.width = bound.x2 - bound.x1;
+    out.height = bound.y2 - bound.y1;
+    return out;
+  }
+  return {
+    x: bound.x1,
+    y: bound.y1,
+    width: bound.x2 - bound.x1,
+    height: bound.y2 - bound.y1,
+  };
+}
+
+export function intersectRect(a: Rect, b: Rect): Rect;
+export function intersectRect<T extends Rect = Rect>(
+  a: Rect,
+  b: Rect,
+  out: T,
+): T;
+export function intersectRect(a: Rect, b: Rect, out?: Rect): Rect {
+  const x = Math.max(a.x, b.x);
+  const y = Math.max(a.y, b.y);
+  const width = Math.min(a.x + a.width, b.x + b.width) - x;
+  const height = Math.min(a.y + a.height, b.y + b.height) - y;
+  if (width > 0 && height > 0) {
+    if (out) {
+      out.x = x;
+      out.y = y;
+      out.width = width;
+      out.height = height;
+      return out;
+    }
+    return {
+      x,
+      y,
+      width,
+      height,
+    };
+  }
+  if (out) {
+    out.x = 0;
+    out.y = 0;
+    out.width = 0;
+    out.height = 0;
+    return out;
+  }
+  return {
+    x: 0,
+    y: 0,
+    width: 0,
+    height: 0,
+  };
+}
+
+export function copyRect(a: Rect): Rect;
+export function copyRect<T extends Rect = Rect>(a: Rect, out: T): T;
+export function copyRect(a: Rect, out?: Rect): Rect {
+  if (out) {
+    out.x = a.x;
+    out.y = a.y;
+    out.width = a.width;
+    out.height = a.height;
+    return out;
+  }
+  return {
+    x: a.x,
+    y: a.y,
+    width: a.width,
+    height: a.height,
+  };
+}
+
+export function compareRect(a: Rect | null, b: Rect | null): boolean {
+  if (a === b) {
+    return true;
+  }
+  if (a === null || b === null) {
+    return false;
+  }
+  return (
+    a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height
+  );
+}
+
+export function isBoundPositive(bound: Bound): boolean {
+  return bound.x1 < bound.x2 && bound.y1 < bound.y2;
+}
+
+export function isRectPositive(rect: Rect): boolean {
+  return rect.width > 0 && rect.height > 0;
+}