@lightningtv/renderer 2.16.1

package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts

@@ -0,0 +1,205 @@
+/*
+ * 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 { expect, describe, it } from 'vitest';
+import { setRenderWindow, type SdfRenderWindow } from './setRenderWindow.js';
+
+function makeRenderWindow(): SdfRenderWindow {
+  return {
+    screen: { x1: 0, y1: 0, x2: 0, y2: 0 },
+    sdf: { x1: 0, y1: 0, x2: 0, y2: 0 },
+    firstLineIdx: 0,
+    numLines: 0,
+    valid: false,
+  };
+}
+
+describe('setRenderWindow', () => {
+  it('should return a empty window when visibleWindow is empty', () => {
+    const rw = makeRenderWindow();
+    setRenderWindow(rw, 0, 0, 0, 10, 0, { x1: 0, y1: 0, x2: 0, y2: 0 }, 1);
+    expect(rw).toEqual({
+      screen: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      sdf: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      firstLineIdx: 0,
+      numLines: 0,
+      valid: true,
+    });
+
+    setRenderWindow(
+      rw,
+      0,
+      0,
+      0,
+      20,
+      0,
+      { x1: 100, y1: 100, x2: 100, y2: 100 },
+      2,
+    );
+    expect(rw).toEqual({
+      screen: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      sdf: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      firstLineIdx: 0,
+      numLines: 0,
+      valid: true,
+    });
+
+    setRenderWindow(
+      rw,
+      100,
+      200,
+      300,
+      10,
+      30,
+      { x1: 0, y1: 0, x2: 0, y2: 0 },
+      1,
+    );
+    expect(rw).toEqual({
+      screen: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      sdf: { x1: 0, y1: 0, x2: 0, y2: 0 },
+      firstLineIdx: 0,
+      numLines: 0,
+      valid: true,
+    });
+    setRenderWindow(
+      rw,
+      400,
+      500,
+      100,
+      20,
+      40,
+      {
+        x1: 100,
+        y1: 100,
+        x2: 100,
+        y2: 100,
+      },
+      1,
+    ),
+      expect(rw).toEqual({
+        screen: { x1: 0, y1: 0, x2: 0, y2: 0 },
+        sdf: { x1: 0, y1: 0, x2: 0, y2: 0 },
+        firstLineIdx: 0,
+        numLines: 0,
+        valid: true,
+      });
+  });
+
+  it('should return a window with no margin around the visible area if lineHeight and/or bufferMargin set are zero', () => {
+    const rw = makeRenderWindow();
+
+    setRenderWindow(rw, 0, 0, 0, 10, 0, { x1: 0, y1: 0, x2: 100, y2: 100 }, 1),
+      expect(rw).toEqual({
+        screen: { x1: 0, y1: 0, x2: 100, y2: 100 },
+        sdf: { x1: 0, y1: 0, x2: 100, y2: 100 },
+        firstLineIdx: 0,
+        numLines: 10,
+        valid: true,
+      });
+
+    setRenderWindow(rw, 0, 0, 0, 10, 0, { x1: 0, y1: 0, x2: 200, y2: 205 }, 2);
+    expect(rw).toEqual({
+      screen: { x1: 0, y1: 0, x2: 200, y2: 210 },
+      sdf: { x1: 0, y1: 0, x2: 100, y2: 105 },
+      firstLineIdx: 0,
+      numLines: 21,
+      valid: true,
+    });
+  });
+
+  it('should return a window with a margin around the visible area (if boundsMargin set)', () => {
+    const rw = makeRenderWindow();
+
+    setRenderWindow(
+      rw,
+      0,
+      0,
+      0,
+      10,
+      100,
+      { x1: 0, y1: 0, x2: 100, y2: 100 },
+      1,
+    ),
+      expect(rw).toEqual({
+        screen: { x1: 0, y1: -100, x2: 100, y2: 200 },
+        sdf: { x1: 0, y1: -100, x2: 100, y2: 200 },
+        firstLineIdx: -10,
+        numLines: 30,
+        valid: true,
+      });
+
+    setRenderWindow(
+      rw,
+      0,
+      0,
+      0,
+      10,
+      200,
+      { x1: 0, y1: 0, x2: 200, y2: 200 },
+      1,
+    );
+    expect(rw).toEqual({
+      screen: { x1: 0, y1: -200, x2: 200, y2: 400 },
+      sdf: { x1: 0, y1: -200, x2: 200, y2: 400 },
+      firstLineIdx: -20,
+      numLines: 60,
+      valid: true,
+    });
+  });
+
+  it('should return a window scrolled to scrollY when set', () => {
+    const rw = makeRenderWindow();
+
+    setRenderWindow(
+      rw,
+      0,
+      0,
+      100,
+      10,
+      100,
+      { x1: 0, y1: 0, x2: 100, y2: 100 },
+      1,
+    ),
+      expect(rw).toEqual({
+        screen: { x1: 0, y1: 0, x2: 100, y2: 300 },
+        sdf: { x1: 0, y1: 0, x2: 100, y2: 300 },
+        firstLineIdx: 0,
+        numLines: 30,
+        valid: true,
+      });
+
+    setRenderWindow(
+      rw,
+      0,
+      0,
+      105,
+      10,
+      100,
+      { x1: 0, y1: 0, x2: 100, y2: 100 },
+      1,
+    ),
+      expect(rw).toEqual({
+        screen: { x1: 0, y1: 0, x2: 100, y2: 310 },
+        sdf: { x1: 0, y1: 0, x2: 100, y2: 310 },
+        firstLineIdx: 0,
+        numLines: 31,
+        valid: true,
+      });
+  });
+});

package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts

@@ -0,0 +1,93 @@
+/*
+ * 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 { isBoundPositive, type Bound } from '../../../../lib/utils.js';
+import type { TrProps } from '../../TextRenderer.js';
+import { roundDownToMultiple, roundUpToMultiple } from './util.js';
+
+export interface SdfRenderWindow {
+  screen: Bound;
+  sdf: Bound;
+  firstLineIdx: number;
+  numLines: number;
+  valid: boolean;
+}
+
+/**
+ * Create a render window from the given parameters.
+ *
+ * @remarks
+ * The render window is a rectangle that defines the area of the text that
+ * should be rendered. It is used to skip rendering parts of the text that
+ * are outside of the render window. The render window is relative to the
+ * text's top left corner of the overrall text.
+ *
+ * @param x The x coordinate of the text element's top left corner relative to the screen.
+ * @param y The y coordinate of the text element's top left corner relative to the screen.
+ * @param scrollY The amount of pixels to scroll the text vertically.
+ * @param lineHeight The number of extra lines to render above and below the visible window.
+ * @param visibleWindow The visible window of the text element relative to the screen
+ * @returns
+ */
+export function setRenderWindow(
+  outRenderWindow: SdfRenderWindow,
+  x: TrProps['x'],
+  y: TrProps['y'],
+  scrollY: TrProps['scrollY'],
+  lineHeight: number,
+  bufferMargin: number,
+  visibleWindow: Bound,
+  fontSizeRatio: number,
+): void {
+  const { screen, sdf } = outRenderWindow;
+  if (!isBoundPositive(visibleWindow)) {
+    screen.x1 = 0;
+    screen.y1 = 0;
+    screen.x2 = 0;
+    screen.y2 = 0;
+    sdf.x1 = 0;
+    sdf.y1 = 0;
+    sdf.x2 = 0;
+    sdf.y2 = 0;
+    outRenderWindow.numLines = 0;
+    outRenderWindow.firstLineIdx = 0;
+  } else {
+    const x1 = visibleWindow.x1 - x;
+    const x2 = x1 + (visibleWindow.x2 - visibleWindow.x1);
+    const y1Base = visibleWindow.y1 - y + scrollY;
+    const y1 = roundDownToMultiple(y1Base - bufferMargin, lineHeight || 1);
+    const y2 = roundUpToMultiple(
+      y1Base + (visibleWindow.y2 - visibleWindow.y1) + bufferMargin,
+      lineHeight || 1,
+    );
+
+    screen.x1 = x1;
+    screen.y1 = y1;
+    screen.x2 = x2;
+    screen.y2 = y2;
+    sdf.x1 = x1 / fontSizeRatio;
+    sdf.y1 = y1 / fontSizeRatio;
+    sdf.x2 = x2 / fontSizeRatio;
+    sdf.y2 = y2 / fontSizeRatio;
+
+    outRenderWindow.numLines = Math.ceil((y2 - y1) / lineHeight);
+    outRenderWindow.firstLineIdx = lineHeight ? Math.floor(y1 / lineHeight) : 0;
+  }
+  outRenderWindow.valid = true;
+}

package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts

@@ -0,0 +1,40 @@
+/*
+ * 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.
+ */
+
+/**
+ * Round up to the nearest multiple of the given number.
+ *
+ * @param value
+ * @param multiple
+ * @returns
+ */
+export function roundUpToMultiple(value: number, multiple: number) {
+  return Math.ceil(value / multiple) * multiple;
+}
+
+/**
+ * Round down to the nearest multiple of the given number.
+ *
+ * @param value
+ * @param multiple
+ * @returns
+ */
+export function roundDownToMultiple(value: number, multiple: number) {
+  return Math.floor(value / multiple) * multiple;
+}