@itwin/core-backend 3.0.0-dev.100

package/lib/cjs/DevTools.js

@@ -0,0 +1,155 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevTools = exports.DevToolsStatsFormatter = void 0;
+const os = require("os");
+const process = require("process");
+const core_bentley_1 = require("@itwin/core-bentley");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const IModelHost_1 = require("./IModelHost");
+// cspell:ignore ppid elap
+const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.DevTools;
+/** Utility to format the JSON created by DevTools.stats() to include the appropriate units
+ * @internal
+ */
+class DevToolsStatsFormatter {
+    /** Converts the input stats to another JSON object with the appropriate units setup for various fields */
+    static toFormattedJson(stats) {
+        // Serialize the stats to a string with a replacer that sets up units during the serialization
+        const statsStr = JSON.stringify(stats, DevToolsStatsFormatter._replacer);
+        // Deserialize back to JSON
+        return JSON.parse(statsStr);
+    }
+}
+exports.DevToolsStatsFormatter = DevToolsStatsFormatter;
+DevToolsStatsFormatter._megaByteProps = ["totalmem", "freemem", "rss", "heapTotal", "heapUsed", "external"];
+DevToolsStatsFormatter._percentProps = ["user", "nice", "sys", "idle", "irq", "cpuUsage"];
+DevToolsStatsFormatter._mHzProps = ["speed"];
+DevToolsStatsFormatter._secondsProps = ["uptime"];
+/** Replacer that includes units - can be used with JSON.stringify()  */
+DevToolsStatsFormatter._replacer = (key, value) => {
+    if (DevToolsStatsFormatter._megaByteProps.includes(key))
+        return `${value.toFixed()} MB`;
+    if (DevToolsStatsFormatter._percentProps.includes(key))
+        return `${value.toFixed()}%`;
+    if (DevToolsStatsFormatter._mHzProps.includes(key))
+        return `${value.toString()} MHz`;
+    if (DevToolsStatsFormatter._secondsProps.includes(key))
+        return `${value.toFixed()} secs`;
+    return value;
+};
+/**
+ * Internal diagnostic utility
+ * @internal
+ */
+class DevTools {
+    /** Receives a ping and returns true */
+    static ping() {
+        core_bentley_1.Logger.logInfo(loggerCategory, "Received ping at backend");
+        return true;
+    }
+    static hrtimeToMS(hrtime) {
+        return hrtime[0] * 1000 + hrtime[1] / 1000000;
+    }
+    static bytesToMegaBytes(bytes) {
+        const megaBytes = bytes / Math.pow(1024, 2);
+        return Math.round(megaBytes * 100) / 100;
+    }
+    static evaluateCpuUsage() {
+        const NUMBER_OF_CPUS = os.cpus().length;
+        const startTime = process.hrtime();
+        const startUsage = process.cpuUsage();
+        // spin the CPU for 500 milliseconds
+        const now = Date.now();
+        while (Date.now() - now < 500)
+            ;
+        const elapTime = process.hrtime(startTime);
+        const elapUsage = process.cpuUsage(startUsage);
+        const elapTimeMS = this.hrtimeToMS(elapTime);
+        const elapUserMS = elapUsage.user / 1000; // microseconds to milliseconds
+        const elapSystMS = elapUsage.system / 1000;
+        const cpuPercent = Math.round((100 * (elapUserMS + elapSystMS) / elapTimeMS / NUMBER_OF_CPUS));
+        return cpuPercent;
+    }
+    static evaluateCpus() {
+        // Create a clone
+        const srcCpus = os.cpus();
+        const cpus = new Array(srcCpus.length);
+        let ii = 0;
+        for (const srcCpu of srcCpus)
+            cpus[ii++] = { ...srcCpu };
+        // Evaluate cpu usage as percentages
+        for (const cpu of Object.values(cpus)) {
+            const total = Object.values(cpu.times).reduce((_total, currValue) => _total += currValue, 0);
+            const cpuTimes = cpu.times;
+            for (const type of Object.keys(cpuTimes)) {
+                const cpuPercent = Math.round(100 * cpuTimes[type] / total);
+                cpuTimes[type] = cpuPercent;
+            }
+        }
+        return cpus;
+    }
+    static evaluateMemoryUsage() {
+        // Create a clone
+        const memUsage = { ...process.memoryUsage() };
+        const memUsageObj = memUsage;
+        // Evaluate memory usage as mega bytes
+        for (const type of Object.keys(memUsageObj)) {
+            memUsageObj[type] = this.bytesToMegaBytes(memUsageObj[type]);
+        }
+        return memUsage;
+    }
+    static evaluateProcessStats() {
+        return {
+            uptime: process.uptime(),
+            pid: process.pid,
+            ppid: process.ppid,
+            memoryUsage: this.evaluateMemoryUsage(),
+        };
+    }
+    static evaluateOsStats() {
+        return {
+            platform: os.platform(),
+            hostname: os.hostname(),
+            totalmem: this.bytesToMegaBytes(os.totalmem()),
+            freemem: this.bytesToMegaBytes(os.freemem()),
+            uptime: os.uptime(),
+            cpus: this.evaluateCpus(),
+            cpuUsage: this.evaluateCpuUsage(),
+        };
+    }
+    /** Returns JSON object with backend statistics */
+    static stats() {
+        try {
+            const stats = {
+                os: this.evaluateOsStats(),
+                process: this.evaluateProcessStats(),
+            };
+            return stats;
+        }
+        catch (error) {
+            core_bentley_1.Logger.logError(loggerCategory, "Could not fetch stats at backend");
+            throw error;
+        }
+    }
+    /** Sets up a log level at the backend and returns the old log level */
+    static setLogLevel(inLoggerCategory, newLevel) {
+        const oldLevel = core_bentley_1.Logger.getLevel(inLoggerCategory);
+        core_bentley_1.Logger.logInfo(loggerCategory, `Setting log level`, () => ({ loggerCategory: inLoggerCategory, oldLevel, newLevel }));
+        core_bentley_1.Logger.setLevel(inLoggerCategory, newLevel);
+        IModelHost_1.IModelHost.platform.clearLogLevelCache();
+        return oldLevel;
+    }
+    /** Obtains the backend application and iModel.js versions */
+    static versions() {
+        return {
+            application: IModelHost_1.IModelHost.applicationVersion,
+            iModelJs: require("../../package.json").version, // eslint-disable-line @typescript-eslint/no-var-requires
+        };
+    }
+}
+exports.DevTools = DevTools;
+//# sourceMappingURL=DevTools.js.map

package/lib/cjs/DevTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevTools.js","sourceRoot":"","sources":["../../src/DevTools.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport * as os from \"os\";\r\nimport * as process from \"process\";\r\nimport { Logger, LogLevel } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n// cspell:ignore ppid elap\r\n\r\nconst loggerCategory: string = BackendLoggerCategory.DevTools;\r\n\r\ninterface StringIndexedObject<T> {\r\n  [index: string]: T;\r\n}\r\n\r\n/**\r\n * Performance and Memory statistics of backend\r\n * @internal\r\n */\r\nexport interface DevToolsStats {\r\n  os: DevToolsOsStats;\r\n  process: DevToolsProcessStats;\r\n}\r\n\r\n/**\r\n * OS stats of backend\r\n * @internal\r\n */\r\nexport interface DevToolsOsStats {\r\n  platform: NodeJS.Platform;\r\n  hostname: string;\r\n  totalmem: number;\r\n  freemem: number;\r\n  uptime: number;\r\n  cpus: os.CpuInfo[];\r\n  cpuUsage: number;\r\n}\r\n\r\n/**\r\n * Process stats of backend\r\n * @internal\r\n */\r\nexport interface DevToolsProcessStats {\r\n  uptime: number;\r\n  pid: number;\r\n  ppid: number;\r\n  memoryUsage: NodeJS.MemoryUsage;\r\n}\r\n\r\n/** Utility to format the JSON created by DevTools.stats() to include the appropriate units\r\n * @internal\r\n */\r\nexport class DevToolsStatsFormatter {\r\n  private static readonly _megaByteProps = [\"totalmem\", \"freemem\", \"rss\", \"heapTotal\", \"heapUsed\", \"external\"];\r\n  private static readonly _percentProps = [\"user\", \"nice\", \"sys\", \"idle\", \"irq\", \"cpuUsage\"];\r\n  private static readonly _mHzProps = [\"speed\"];\r\n  private static readonly _secondsProps = [\"uptime\"];\r\n\r\n  /** Replacer that includes units - can be used with JSON.stringify()  */\r\n  private static _replacer = (key: string, value: any) => {\r\n    if (DevToolsStatsFormatter._megaByteProps.includes(key))\r\n      return `${value.toFixed()} MB`;\r\n    if (DevToolsStatsFormatter._percentProps.includes(key))\r\n      return `${value.toFixed()}%`;\r\n    if (DevToolsStatsFormatter._mHzProps.includes(key))\r\n      return `${value.toString()} MHz`;\r\n    if (DevToolsStatsFormatter._secondsProps.includes(key))\r\n      return `${value.toFixed()} secs`;\r\n    return value;\r\n  };\r\n\r\n  /** Converts the input stats to another JSON object with the appropriate units setup for various fields */\r\n  public static toFormattedJson(stats: any) {\r\n    // Serialize the stats to a string with a replacer that sets up units during the serialization\r\n    const statsStr = JSON.stringify(stats, DevToolsStatsFormatter._replacer);\r\n\r\n    // Deserialize back to JSON\r\n    return JSON.parse(statsStr);\r\n  }\r\n}\r\n\r\n/**\r\n * Internal diagnostic utility\r\n * @internal\r\n */\r\nexport class DevTools {\r\n\r\n  /** Receives a ping and returns true */\r\n  public static ping(): boolean {\r\n    Logger.logInfo(loggerCategory, \"Received ping at backend\");\r\n    return true;\r\n  }\r\n\r\n  private static hrtimeToMS(hrtime: any) {\r\n    return hrtime[0] * 1000 + hrtime[1] / 1000000;\r\n  }\r\n\r\n  private static bytesToMegaBytes(bytes: number): number {\r\n    const megaBytes = bytes / Math.pow(1024, 2);\r\n    return Math.round(megaBytes * 100) / 100;\r\n  }\r\n\r\n  private static evaluateCpuUsage(): number {\r\n    const NUMBER_OF_CPUS = os.cpus().length;\r\n    const startTime = process.hrtime();\r\n    const startUsage = process.cpuUsage();\r\n\r\n    // spin the CPU for 500 milliseconds\r\n    const now = Date.now();\r\n    while (Date.now() - now < 500);\r\n\r\n    const elapTime = process.hrtime(startTime);\r\n    const elapUsage = process.cpuUsage(startUsage);\r\n\r\n    const elapTimeMS = this.hrtimeToMS(elapTime);\r\n\r\n    const elapUserMS = elapUsage.user / 1000; // microseconds to milliseconds\r\n    const elapSystMS = elapUsage.system / 1000;\r\n    const cpuPercent = Math.round((100 * (elapUserMS + elapSystMS) / elapTimeMS / NUMBER_OF_CPUS));\r\n\r\n    return cpuPercent;\r\n  }\r\n\r\n  private static evaluateCpus(): os.CpuInfo[] {\r\n    // Create a clone\r\n    const srcCpus = os.cpus();\r\n    const cpus = new Array<os.CpuInfo>(srcCpus.length);\r\n    let ii = 0;\r\n    for (const srcCpu of srcCpus)\r\n      cpus[ii++] = { ...srcCpu };\r\n\r\n    // Evaluate cpu usage as percentages\r\n    for (const cpu of Object.values(cpus)) {\r\n      const total = Object.values(cpu.times).reduce((_total: number, currValue) => _total += currValue, 0);\r\n      const cpuTimes = cpu.times as StringIndexedObject<number>;\r\n      for (const type of Object.keys(cpuTimes)) {\r\n        const cpuPercent = Math.round(100 * cpuTimes[type] / total);\r\n        cpuTimes[type] = cpuPercent;\r\n      }\r\n    }\r\n    return cpus;\r\n  }\r\n\r\n  private static evaluateMemoryUsage() {\r\n    // Create a clone\r\n    const memUsage = { ...process.memoryUsage() } as NodeJS.MemoryUsage;\r\n    const memUsageObj = (memUsage as any) as StringIndexedObject<number>;\r\n    // Evaluate memory usage as mega bytes\r\n    for (const type of Object.keys(memUsageObj)) {\r\n      memUsageObj[type] = this.bytesToMegaBytes(memUsageObj[type]);\r\n    }\r\n    return memUsage;\r\n  }\r\n\r\n  private static evaluateProcessStats(): DevToolsProcessStats {\r\n    return {\r\n      uptime: process.uptime(),\r\n      pid: process.pid,\r\n      ppid: process.ppid,\r\n      memoryUsage: this.evaluateMemoryUsage(),\r\n    } as DevToolsProcessStats;\r\n  }\r\n\r\n  private static evaluateOsStats(): DevToolsOsStats {\r\n    return {\r\n      platform: os.platform(),\r\n      hostname: os.hostname(),\r\n      totalmem: this.bytesToMegaBytes(os.totalmem()),\r\n      freemem: this.bytesToMegaBytes(os.freemem()),\r\n      uptime: os.uptime(),\r\n      cpus: this.evaluateCpus(),\r\n      cpuUsage: this.evaluateCpuUsage(),\r\n    } as DevToolsOsStats;\r\n  }\r\n\r\n  /** Returns JSON object with backend statistics */\r\n  public static stats(): DevToolsStats {\r\n    try {\r\n      const stats = {\r\n        os: this.evaluateOsStats(),\r\n        process: this.evaluateProcessStats(),\r\n      } as DevToolsStats;\r\n      return stats;\r\n    } catch (error) {\r\n      Logger.logError(loggerCategory, \"Could not fetch stats at backend\");\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /** Sets up a log level at the backend and returns the old log level */\r\n  public static setLogLevel(inLoggerCategory: string, newLevel: LogLevel): LogLevel | undefined {\r\n    const oldLevel = Logger.getLevel(inLoggerCategory);\r\n    Logger.logInfo(loggerCategory, `Setting log level`, () => ({ loggerCategory: inLoggerCategory, oldLevel, newLevel }));\r\n    Logger.setLevel(inLoggerCategory, newLevel);\r\n    IModelHost.platform.clearLogLevelCache();\r\n    return oldLevel;\r\n  }\r\n\r\n  /** Obtains the backend application and iModel.js versions */\r\n  public static versions() {\r\n    return {\r\n      application: IModelHost.applicationVersion,\r\n      iModelJs: require(\"../../package.json\").version, // eslint-disable-line @typescript-eslint/no-var-requires\r\n    };\r\n  }\r\n}\r\n"]}

package/lib/cjs/DisplayStyle.d.ts

@@ -0,0 +1,107 @@
+/** @packageDocumentation
+ * @module ViewDefinitions
+ */
+import { Id64Set, Id64String } from "@itwin/core-bentley";
+import { Code, CodeScopeProps, ColorDef, DisplayStyle3dProps, DisplayStyle3dSettings, DisplayStyle3dSettingsProps, DisplayStyleProps, DisplayStyleSettings, RenderSchedule, ViewFlags } from "@itwin/core-common";
+import { DefinitionElement } from "./Element";
+import { IModelCloneContext } from "./IModelCloneContext";
+import { IModelDb } from "./IModelDb";
+/** A DisplayStyle defines the parameters for 'styling' the contents of a view.
+ * Internally a DisplayStyle consists of a dictionary of several named 'styles' describing specific aspects of the display style as a whole.
+ * Many ViewDefinitions may share the same DisplayStyle.
+ * @public
+ */
+export declare abstract class DisplayStyle extends DefinitionElement implements DisplayStyleProps {
+    /** @internal */
+    static get className(): string;
+    abstract get settings(): DisplayStyleSettings;
+    /** @internal */
+    protected constructor(props: DisplayStyleProps, iModel: IModelDb);
+    /** Create a Code for a DisplayStyle given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     * @param iModel  The IModelDb
+     * @param scopeModelId The Id of the DefinitionModel that contains the DisplayStyle and provides the scope for its name.
+     * @param codeValue The DisplayStyle name
+     */
+    static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code;
+    /** @alpha */
+    protected collectPredecessorIds(predecessorIds: Id64Set): void;
+    /** @alpha */
+    protected static onCloned(context: IModelCloneContext, sourceElementProps: DisplayStyleProps, targetElementProps: DisplayStyleProps): void;
+    loadScheduleScript(): RenderSchedule.ScriptReference | undefined;
+}
+/** A DisplayStyle for 2d views.
+ * @public
+ */
+export declare class DisplayStyle2d extends DisplayStyle {
+    /** @internal */
+    static get className(): string;
+    private readonly _settings;
+    get settings(): DisplayStyleSettings;
+    /** @internal */
+    constructor(props: DisplayStyleProps, iModel: IModelDb);
+    /** Create a DisplayStyle2d for use by a ViewDefinition.
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name/CodeValue of the DisplayStyle2d
+     * @returns The newly constructed DisplayStyle2d element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DisplayStyle2d;
+    /** Insert a DisplayStyle2d for use by a ViewDefinition.
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new DisplayStyle2d into this DefinitionModel
+     * @param name The name of the DisplayStyle2d
+     * @returns The Id of the newly inserted DisplayStyle2d element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string): Id64String;
+}
+/** Describes initial settings for a new [[DisplayStyle3d]].
+ * Most properties are inherited from [DisplayStyle3dSettingsProps]($common), but for backwards compatibility reasons, this interface is slightly awkward:
+ * - It adds a `viewFlags` member that differs only in case and type from [DisplayStyleSettingsProps.viewflags]($common); and
+ * - It extends the type of [DisplayStyleSettingsProps.backgroundColor]($common) to include [ColorDef]($common).
+ * These idiosyncrasies will be addressed in a future version of core-backend.
+ * @see [[DisplayStyle3d.create]].
+ * @public
+ */
+export interface DisplayStyleCreationOptions extends Omit<DisplayStyle3dSettingsProps, "backgroundColor" | "scheduleScript"> {
+    /** If supplied, the [ViewFlags]($common) applied by the display style.
+     * If undefined, [DisplayStyle3dSettingsProps.viewflags]($common) will be used if present (note the difference in case); otherwise, default-constructed [ViewFlags]($common) will be used.
+     */
+    viewFlags?: ViewFlags;
+    backgroundColor?: ColorDef | number;
+}
+/** A DisplayStyle for 3d views.
+ * See [how to create a DisplayStyle3d]$(docs/learning/backend/CreateElements.md#DisplayStyle3d).
+ * @public
+ */
+export declare class DisplayStyle3d extends DisplayStyle implements DisplayStyle3dProps {
+    /** @internal */
+    static get className(): string;
+    private readonly _settings;
+    get settings(): DisplayStyle3dSettings;
+    /** @internal */
+    constructor(props: DisplayStyle3dProps, iModel: IModelDb);
+    /** @alpha */
+    protected collectPredecessorIds(predecessorIds: Id64Set): void;
+    /** @alpha */
+    protected static onCloned(context: IModelCloneContext, sourceElementProps: DisplayStyle3dProps, targetElementProps: DisplayStyle3dProps): void;
+    /** Create a DisplayStyle3d for use by a ViewDefinition.
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name/CodeValue of the DisplayStyle3d
+     * @returns The newly constructed DisplayStyle3d element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, options?: DisplayStyleCreationOptions): DisplayStyle3d;
+    /**
+     * Insert a DisplayStyle3d for use by a ViewDefinition.
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new DisplayStyle3d into this [[DefinitionModel]]
+     * @param name The name of the DisplayStyle3d
+     * @returns The Id of the newly inserted DisplayStyle3d element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, options?: DisplayStyleCreationOptions): Id64String;
+}
+//# sourceMappingURL=DisplayStyle.d.ts.map

package/lib/cjs/DisplayStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayStyle.d.ts","sourceRoot":"","sources":["../../src/DisplayStyle.ts"],"names":[],"mappings":"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"}

package/lib/cjs/DisplayStyle.js

@@ -0,0 +1,292 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ViewDefinitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisplayStyle3d = exports.DisplayStyle2d = exports.DisplayStyle = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const Element_1 = require("./Element");
+/** A DisplayStyle defines the parameters for 'styling' the contents of a view.
+ * Internally a DisplayStyle consists of a dictionary of several named 'styles' describing specific aspects of the display style as a whole.
+ * Many ViewDefinitions may share the same DisplayStyle.
+ * @public
+ */
+class DisplayStyle extends Element_1.DefinitionElement {
+    /** @internal */
+    static get className() { return "DisplayStyle"; }
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+    }
+    /** Create a Code for a DisplayStyle given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     * @param iModel  The IModelDb
+     * @param scopeModelId The Id of the DefinitionModel that contains the DisplayStyle and provides the scope for its name.
+     * @param codeValue The DisplayStyle name
+     */
+    static createCode(iModel, scopeModelId, codeValue) {
+        const codeSpec = iModel.codeSpecs.getByName(core_common_1.BisCodeSpec.displayStyle);
+        return new core_common_1.Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });
+    }
+    /** @alpha */
+    collectPredecessorIds(predecessorIds) {
+        super.collectPredecessorIds(predecessorIds);
+        for (const [id] of this.settings.subCategoryOverrides) {
+            predecessorIds.add(id);
+        }
+        for (const excludedElementId of this.settings.excludedElementIds)
+            predecessorIds.add(excludedElementId);
+        if (this.settings.renderTimeline) {
+            predecessorIds.add(this.settings.renderTimeline);
+        }
+        else {
+            const script = this.loadScheduleScript();
+            if (script)
+                script.script.discloseIds(predecessorIds);
+        }
+    }
+    /** @alpha */
+    static onCloned(context, sourceElementProps, targetElementProps) {
+        var _a;
+        super.onCloned(context, sourceElementProps, targetElementProps);
+        if (!context.isBetweenIModels || !((_a = targetElementProps.jsonProperties) === null || _a === void 0 ? void 0 : _a.styles))
+            return;
+        const settings = targetElementProps.jsonProperties.styles;
+        if (settings.subCategoryOvr) {
+            for (let i = 0; i < settings.subCategoryOvr.length; /* */) {
+                const ovr = settings.subCategoryOvr[i];
+                ovr.subCategory = context.findTargetElementId(core_bentley_1.Id64.fromJSON(ovr.subCategory));
+                if (core_bentley_1.Id64.invalid === ovr.subCategory)
+                    settings.subCategoryOvr.splice(i, 1);
+                else
+                    i++;
+            }
+        }
+        if (settings.excludedElements) {
+            const excluded = "string" === typeof settings.excludedElements ? core_bentley_1.CompressedId64Set.decompressArray(settings.excludedElements) : settings.excludedElements;
+            for (let i = 0; i < excluded.length; /* */) {
+                const remapped = context.findTargetElementId(excluded[i]);
+                if (core_bentley_1.Id64.invalid === remapped)
+                    excluded.splice(i, 1);
+                else
+                    excluded[i++] = remapped;
+            }
+            if (0 === excluded.length)
+                delete settings.excludedElements;
+            else
+                settings.excludedElements = core_bentley_1.CompressedId64Set.compressIds(core_bentley_1.OrderedId64Iterable.sortArray(excluded));
+        }
+        // eslint-disable-next-line deprecation/deprecation
+        if (settings.renderTimeline) {
+            const renderTimeline = context.findTargetElementId(settings.renderTimeline);
+            if (core_bentley_1.Id64.isValid(renderTimeline))
+                settings.renderTimeline = renderTimeline;
+            else
+                delete settings.renderTimeline;
+        }
+        else if (settings.scheduleScript) { // eslint-disable-line deprecation/deprecation
+            // eslint-disable-next-line deprecation/deprecation
+            const scheduleScript = Element_1.RenderTimeline.remapScript(context, settings.scheduleScript);
+            if (scheduleScript.length > 0)
+                settings.scheduleScript = scheduleScript; // eslint-disable-line deprecation/deprecation
+            else
+                delete settings.scheduleScript; // eslint-disable-line deprecation/deprecation
+        }
+    }
+    loadScheduleScript() {
+        let script;
+        let sourceId;
+        if (this.settings.renderTimeline) {
+            const timeline = this.iModel.elements.tryGetElement(this.settings.renderTimeline);
+            if (timeline) {
+                script = core_common_1.RenderSchedule.Script.fromJSON(timeline.scriptProps);
+                sourceId = timeline.id;
+            }
+        }
+        else if (this.settings.scheduleScriptProps) { // eslint-disable-line deprecation/deprecation
+            // eslint-disable-next-line deprecation/deprecation
+            script = core_common_1.RenderSchedule.Script.fromJSON(this.settings.scheduleScriptProps);
+            sourceId = this.id;
+        }
+        return undefined !== sourceId && undefined !== script ? new core_common_1.RenderSchedule.ScriptReference(sourceId, script) : undefined;
+    }
+}
+exports.DisplayStyle = DisplayStyle;
+/** A DisplayStyle for 2d views.
+ * @public
+ */
+class DisplayStyle2d extends DisplayStyle {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this._settings = new core_common_1.DisplayStyleSettings(this.jsonProperties);
+    }
+    /** @internal */
+    static get className() { return "DisplayStyle2d"; }
+    get settings() { return this._settings; }
+    /** Create a DisplayStyle2d for use by a ViewDefinition.
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name/CodeValue of the DisplayStyle2d
+     * @returns The newly constructed DisplayStyle2d element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb, definitionModelId, name) {
+        const displayStyleProps = {
+            classFullName: this.classFullName,
+            code: this.createCode(iModelDb, definitionModelId, name),
+            model: definitionModelId,
+            isPrivate: false,
+            jsonProperties: {
+                styles: {
+                    backgroundColor: 0,
+                    monochromeColor: core_common_1.ColorDef.white.toJSON(),
+                    viewflags: core_common_1.ViewFlags.defaults,
+                },
+            },
+        };
+        return new DisplayStyle2d(displayStyleProps, iModelDb);
+    }
+    /** Insert a DisplayStyle2d for use by a ViewDefinition.
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new DisplayStyle2d into this DefinitionModel
+     * @param name The name of the DisplayStyle2d
+     * @returns The Id of the newly inserted DisplayStyle2d element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb, definitionModelId, name) {
+        const displayStyle = this.create(iModelDb, definitionModelId, name);
+        return iModelDb.elements.insertElement(displayStyle);
+    }
+}
+exports.DisplayStyle2d = DisplayStyle2d;
+/** A DisplayStyle for 3d views.
+ * See [how to create a DisplayStyle3d]$(docs/learning/backend/CreateElements.md#DisplayStyle3d).
+ * @public
+ */
+class DisplayStyle3d extends DisplayStyle {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this._settings = new core_common_1.DisplayStyle3dSettings(this.jsonProperties);
+    }
+    /** @internal */
+    static get className() { return "DisplayStyle3d"; }
+    get settings() { return this._settings; }
+    /** @alpha */
+    collectPredecessorIds(predecessorIds) {
+        var _a, _b;
+        super.collectPredecessorIds(predecessorIds);
+        const skyBoxImageProps = (_b = (_a = this.settings.environment) === null || _a === void 0 ? void 0 : _a.sky) === null || _b === void 0 ? void 0 : _b.image;
+        if (skyBoxImageProps === null || skyBoxImageProps === void 0 ? void 0 : skyBoxImageProps.texture) {
+            predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.texture));
+        }
+        if (skyBoxImageProps === null || skyBoxImageProps === void 0 ? void 0 : skyBoxImageProps.textures) {
+            if (skyBoxImageProps.textures.back) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.back));
+            }
+            if (skyBoxImageProps.textures.bottom) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.bottom));
+            }
+            if (skyBoxImageProps.textures.front) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.front));
+            }
+            if (skyBoxImageProps.textures.left) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.left));
+            }
+            if (skyBoxImageProps.textures.right) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.right));
+            }
+            if (skyBoxImageProps.textures.top) {
+                predecessorIds.add(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.top));
+            }
+        }
+        if (this.settings.planProjectionSettings) {
+            for (const planProjectionSetting of this.settings.planProjectionSettings) {
+                predecessorIds.add(planProjectionSetting[0]);
+            }
+        }
+    }
+    /** @alpha */
+    static onCloned(context, sourceElementProps, targetElementProps) {
+        var _a, _b, _c, _d, _e, _f;
+        super.onCloned(context, sourceElementProps, targetElementProps);
+        if (context.isBetweenIModels) {
+            const skyBoxImageProps = (_d = (_c = (_b = (_a = targetElementProps === null || targetElementProps === void 0 ? void 0 : targetElementProps.jsonProperties) === null || _a === void 0 ? void 0 : _a.styles) === null || _b === void 0 ? void 0 : _b.environment) === null || _c === void 0 ? void 0 : _c.sky) === null || _d === void 0 ? void 0 : _d.image;
+            if (skyBoxImageProps === null || skyBoxImageProps === void 0 ? void 0 : skyBoxImageProps.texture) {
+                const textureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.texture));
+                skyBoxImageProps.texture = core_bentley_1.Id64.isValidId64(textureId) ? textureId : undefined;
+            }
+            if (skyBoxImageProps === null || skyBoxImageProps === void 0 ? void 0 : skyBoxImageProps.textures) {
+                const backTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.back));
+                skyBoxImageProps.textures.back = core_bentley_1.Id64.isValidId64(backTextureId) ? backTextureId : undefined;
+                const bottomTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.bottom));
+                skyBoxImageProps.textures.bottom = core_bentley_1.Id64.isValidId64(bottomTextureId) ? bottomTextureId : undefined;
+                const frontTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.front));
+                skyBoxImageProps.textures.front = core_bentley_1.Id64.isValidId64(frontTextureId) ? frontTextureId : undefined;
+                const leftTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.left));
+                skyBoxImageProps.textures.left = core_bentley_1.Id64.isValidId64(leftTextureId) ? leftTextureId : undefined;
+                const rightTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.right));
+                skyBoxImageProps.textures.right = core_bentley_1.Id64.isValidId64(rightTextureId) ? rightTextureId : undefined;
+                const topTextureId = context.findTargetElementId(core_bentley_1.Id64.fromJSON(skyBoxImageProps.textures.top));
+                skyBoxImageProps.textures.top = core_bentley_1.Id64.isValidId64(topTextureId) ? topTextureId : undefined;
+            }
+            if ((_f = (_e = targetElementProps === null || targetElementProps === void 0 ? void 0 : targetElementProps.jsonProperties) === null || _e === void 0 ? void 0 : _e.styles) === null || _f === void 0 ? void 0 : _f.planProjections) {
+                const remappedPlanProjections = {};
+                for (const entry of Object.entries(targetElementProps.jsonProperties.styles.planProjections)) {
+                    const remappedModelId = context.findTargetElementId(entry[0]);
+                    if (core_bentley_1.Id64.isValidId64(remappedModelId)) {
+                        remappedPlanProjections[remappedModelId] = entry[1];
+                    }
+                }
+                targetElementProps.jsonProperties.styles.planProjections = remappedPlanProjections;
+            }
+        }
+    }
+    /** Create a DisplayStyle3d for use by a ViewDefinition.
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name/CodeValue of the DisplayStyle3d
+     * @returns The newly constructed DisplayStyle3d element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb, definitionModelId, name, options) {
+        var _a, _b;
+        options = options !== null && options !== void 0 ? options : {};
+        let viewflags = (_a = options.viewFlags) === null || _a === void 0 ? void 0 : _a.toJSON();
+        if (!viewflags)
+            viewflags = (_b = options.viewflags) !== null && _b !== void 0 ? _b : new core_common_1.ViewFlags().toJSON();
+        const backgroundColor = options.backgroundColor instanceof core_common_1.ColorDef ? options.backgroundColor.toJSON() : options.backgroundColor;
+        const settings = {
+            ...options,
+            viewflags,
+            backgroundColor,
+        };
+        const displayStyleProps = {
+            classFullName: this.classFullName,
+            code: this.createCode(iModelDb, definitionModelId, name),
+            model: definitionModelId,
+            jsonProperties: { styles: settings },
+            isPrivate: false,
+        };
+        return new DisplayStyle3d(displayStyleProps, iModelDb);
+    }
+    /**
+     * Insert a DisplayStyle3d for use by a ViewDefinition.
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new DisplayStyle3d into this [[DefinitionModel]]
+     * @param name The name of the DisplayStyle3d
+     * @returns The Id of the newly inserted DisplayStyle3d element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb, definitionModelId, name, options) {
+        const displayStyle = this.create(iModelDb, definitionModelId, name, options);
+        return iModelDb.elements.insertElement(displayStyle);
+    }
+}
+exports.DisplayStyle3d = DisplayStyle3d;
+//# sourceMappingURL=DisplayStyle.js.map

package/lib/cjs/DisplayStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayStyle.js","sourceRoot":"","sources":["../../src/DisplayStyle.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module ViewDefinitions\r\n */\r\n\r\nimport { CompressedId64Set, Id64, Id64Array, Id64Set, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport {\r\n  BisCodeSpec, Code, CodeScopeProps, CodeSpec, ColorDef, DisplayStyle3dProps, DisplayStyle3dSettings, DisplayStyle3dSettingsProps,\r\n  DisplayStyleProps, DisplayStyleSettings, PlanProjectionSettingsProps, RenderSchedule, SkyBoxImageProps, ViewFlags,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement, RenderTimeline } from \"./Element\";\r\nimport { IModelCloneContext } from \"./IModelCloneContext\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** A DisplayStyle defines the parameters for 'styling' the contents of a view.\r\n * Internally a DisplayStyle consists of a dictionary of several named 'styles' describing specific aspects of the display style as a whole.\r\n * Many ViewDefinitions may share the same DisplayStyle.\r\n * @public\r\n */\r\nexport abstract class DisplayStyle extends DefinitionElement implements DisplayStyleProps {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DisplayStyle\"; }\r\n  public abstract get settings(): DisplayStyleSettings;\r\n\r\n  /** @internal */\r\n  protected constructor(props: DisplayStyleProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n  }\r\n\r\n  /** Create a Code for a DisplayStyle given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the DisplayStyle and provides the scope for its name.\r\n   * @param codeValue The DisplayStyle name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.displayStyle);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** @alpha */\r\n  protected override collectPredecessorIds(predecessorIds: Id64Set): void {\r\n    super.collectPredecessorIds(predecessorIds);\r\n    for (const [id] of this.settings.subCategoryOverrides) {\r\n      predecessorIds.add(id);\r\n    }\r\n\r\n    for (const excludedElementId of this.settings.excludedElementIds)\r\n      predecessorIds.add(excludedElementId);\r\n\r\n    if (this.settings.renderTimeline) {\r\n      predecessorIds.add(this.settings.renderTimeline);\r\n    } else {\r\n      const script = this.loadScheduleScript();\r\n      if (script)\r\n        script.script.discloseIds(predecessorIds);\r\n    }\r\n  }\r\n\r\n  /** @alpha */\r\n  protected static override onCloned(context: IModelCloneContext, sourceElementProps: DisplayStyleProps, targetElementProps: DisplayStyleProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n\r\n    if (!context.isBetweenIModels || !targetElementProps.jsonProperties?.styles)\r\n      return;\r\n\r\n    const settings = targetElementProps.jsonProperties.styles;\r\n    if (settings.subCategoryOvr) {\r\n      for (let i = 0; i < settings.subCategoryOvr.length; /* */) {\r\n        const ovr = settings.subCategoryOvr[i];\r\n        ovr.subCategory = context.findTargetElementId(Id64.fromJSON(ovr.subCategory));\r\n        if (Id64.invalid === ovr.subCategory)\r\n          settings.subCategoryOvr.splice(i, 1);\r\n        else\r\n          i++;\r\n      }\r\n    }\r\n\r\n    if (settings.excludedElements) {\r\n      const excluded: Id64Array = \"string\" === typeof settings.excludedElements ? CompressedId64Set.decompressArray(settings.excludedElements) : settings.excludedElements;\r\n      for (let i = 0; i < excluded.length; /* */) {\r\n        const remapped = context.findTargetElementId(excluded[i]);\r\n        if (Id64.invalid === remapped)\r\n          excluded.splice(i, 1);\r\n        else\r\n          excluded[i++] = remapped;\r\n      }\r\n\r\n      if (0 === excluded.length)\r\n        delete settings.excludedElements;\r\n      else\r\n        settings.excludedElements = CompressedId64Set.compressIds(OrderedId64Iterable.sortArray(excluded));\r\n    }\r\n\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    if (settings.renderTimeline) {\r\n      const renderTimeline = context.findTargetElementId(settings.renderTimeline);\r\n      if (Id64.isValid(renderTimeline))\r\n        settings.renderTimeline = renderTimeline;\r\n      else\r\n        delete settings.renderTimeline;\r\n    } else if (settings.scheduleScript) { // eslint-disable-line deprecation/deprecation\r\n      // eslint-disable-next-line deprecation/deprecation\r\n      const scheduleScript = RenderTimeline.remapScript(context, settings.scheduleScript);\r\n      if (scheduleScript.length > 0)\r\n        settings.scheduleScript = scheduleScript; // eslint-disable-line deprecation/deprecation\r\n      else\r\n        delete settings.scheduleScript; // eslint-disable-line deprecation/deprecation\r\n    }\r\n  }\r\n\r\n  public loadScheduleScript(): RenderSchedule.ScriptReference | undefined {\r\n    let script;\r\n    let sourceId;\r\n    if (this.settings.renderTimeline) {\r\n      const timeline = this.iModel.elements.tryGetElement<RenderTimeline>(this.settings.renderTimeline);\r\n      if (timeline) {\r\n        script = RenderSchedule.Script.fromJSON(timeline.scriptProps);\r\n        sourceId = timeline.id;\r\n      }\r\n    } else if (this.settings.scheduleScriptProps) { // eslint-disable-line deprecation/deprecation\r\n      // eslint-disable-next-line deprecation/deprecation\r\n      script = RenderSchedule.Script.fromJSON(this.settings.scheduleScriptProps);\r\n      sourceId = this.id;\r\n    }\r\n\r\n    return undefined !== sourceId && undefined !== script ? new RenderSchedule.ScriptReference(sourceId, script) : undefined;\r\n  }\r\n}\r\n\r\n/** A DisplayStyle for 2d views.\r\n * @public\r\n */\r\nexport class DisplayStyle2d extends DisplayStyle {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DisplayStyle2d\"; }\r\n  private readonly _settings: DisplayStyleSettings;\r\n\r\n  public get settings(): DisplayStyleSettings { return this._settings; }\r\n\r\n  /** @internal */\r\n  public constructor(props: DisplayStyleProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this._settings = new DisplayStyleSettings(this.jsonProperties);\r\n  }\r\n  /** Create a DisplayStyle2d for use by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the DisplayStyle2d\r\n   * @returns The newly constructed DisplayStyle2d element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DisplayStyle2d {\r\n    const displayStyleProps: DisplayStyleProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      isPrivate: false,\r\n      jsonProperties: {\r\n        styles: {\r\n          backgroundColor: 0,\r\n          monochromeColor: ColorDef.white.toJSON(),\r\n          viewflags: ViewFlags.defaults,\r\n        },\r\n      },\r\n    };\r\n    return new DisplayStyle2d(displayStyleProps, iModelDb);\r\n  }\r\n  /** Insert a DisplayStyle2d for use by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DisplayStyle2d into this DefinitionModel\r\n   * @param name The name of the DisplayStyle2d\r\n   * @returns The Id of the newly inserted DisplayStyle2d element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string): Id64String {\r\n    const displayStyle = this.create(iModelDb, definitionModelId, name);\r\n    return iModelDb.elements.insertElement(displayStyle);\r\n  }\r\n}\r\n\r\n/** Describes initial settings for a new [[DisplayStyle3d]].\r\n * Most properties are inherited from [DisplayStyle3dSettingsProps]($common), but for backwards compatibility reasons, this interface is slightly awkward:\r\n * - It adds a `viewFlags` member that differs only in case and type from [DisplayStyleSettingsProps.viewflags]($common); and\r\n * - It extends the type of [DisplayStyleSettingsProps.backgroundColor]($common) to include [ColorDef]($common).\r\n * These idiosyncrasies will be addressed in a future version of core-backend.\r\n * @see [[DisplayStyle3d.create]].\r\n * @public\r\n */\r\nexport interface DisplayStyleCreationOptions extends Omit<DisplayStyle3dSettingsProps, \"backgroundColor\" | \"scheduleScript\"> {\r\n  /** If supplied, the [ViewFlags]($common) applied by the display style.\r\n   * If undefined, [DisplayStyle3dSettingsProps.viewflags]($common) will be used if present (note the difference in case); otherwise, default-constructed [ViewFlags]($common) will be used.\r\n   */\r\n  viewFlags?: ViewFlags;\r\n  backgroundColor?: ColorDef | number;\r\n}\r\n\r\n/** A DisplayStyle for 3d views.\r\n * See [how to create a DisplayStyle3d]$(docs/learning/backend/CreateElements.md#DisplayStyle3d).\r\n * @public\r\n */\r\nexport class DisplayStyle3d extends DisplayStyle implements DisplayStyle3dProps {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DisplayStyle3d\"; }\r\n  private readonly _settings: DisplayStyle3dSettings;\r\n\r\n  public get settings(): DisplayStyle3dSettings { return this._settings; }\r\n\r\n  /** @internal */\r\n  public constructor(props: DisplayStyle3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this._settings = new DisplayStyle3dSettings(this.jsonProperties);\r\n  }\r\n\r\n  /** @alpha */\r\n  protected override collectPredecessorIds(predecessorIds: Id64Set): void {\r\n    super.collectPredecessorIds(predecessorIds);\r\n    const skyBoxImageProps: SkyBoxImageProps | undefined = this.settings.environment?.sky?.image;\r\n    if (skyBoxImageProps?.texture) {\r\n      predecessorIds.add(Id64.fromJSON(skyBoxImageProps.texture));\r\n    }\r\n    if (skyBoxImageProps?.textures) {\r\n      if (skyBoxImageProps.textures.back) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.back)); }\r\n      if (skyBoxImageProps.textures.bottom) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.bottom)); }\r\n      if (skyBoxImageProps.textures.front) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.front)); }\r\n      if (skyBoxImageProps.textures.left) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.left)); }\r\n      if (skyBoxImageProps.textures.right) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.right)); }\r\n      if (skyBoxImageProps.textures.top) { predecessorIds.add(Id64.fromJSON(skyBoxImageProps.textures.top)); }\r\n    }\r\n    if (this.settings.planProjectionSettings) {\r\n      for (const planProjectionSetting of this.settings.planProjectionSettings) {\r\n        predecessorIds.add(planProjectionSetting[0]);\r\n      }\r\n    }\r\n  }\r\n  /** @alpha */\r\n  protected static override onCloned(context: IModelCloneContext, sourceElementProps: DisplayStyle3dProps, targetElementProps: DisplayStyle3dProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n    if (context.isBetweenIModels) {\r\n      const skyBoxImageProps: SkyBoxImageProps | undefined = targetElementProps?.jsonProperties?.styles?.environment?.sky?.image;\r\n      if (skyBoxImageProps?.texture) {\r\n        const textureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.texture));\r\n        skyBoxImageProps.texture = Id64.isValidId64(textureId) ? textureId : undefined;\r\n      }\r\n      if (skyBoxImageProps?.textures) {\r\n        const backTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.back));\r\n        skyBoxImageProps.textures.back = Id64.isValidId64(backTextureId) ? backTextureId : undefined;\r\n        const bottomTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.bottom));\r\n        skyBoxImageProps.textures.bottom = Id64.isValidId64(bottomTextureId) ? bottomTextureId : undefined;\r\n        const frontTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.front));\r\n        skyBoxImageProps.textures.front = Id64.isValidId64(frontTextureId) ? frontTextureId : undefined;\r\n        const leftTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.left));\r\n        skyBoxImageProps.textures.left = Id64.isValidId64(leftTextureId) ? leftTextureId : undefined;\r\n        const rightTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.right));\r\n        skyBoxImageProps.textures.right = Id64.isValidId64(rightTextureId) ? rightTextureId : undefined;\r\n        const topTextureId: Id64String = context.findTargetElementId(Id64.fromJSON(skyBoxImageProps.textures.top));\r\n        skyBoxImageProps.textures.top = Id64.isValidId64(topTextureId) ? topTextureId : undefined;\r\n      }\r\n      if (targetElementProps?.jsonProperties?.styles?.planProjections) {\r\n        const remappedPlanProjections: { [modelId: string]: PlanProjectionSettingsProps } = {};\r\n        for (const entry of Object.entries(targetElementProps.jsonProperties.styles.planProjections)) {\r\n          const remappedModelId: Id64String = context.findTargetElementId(entry[0]);\r\n          if (Id64.isValidId64(remappedModelId)) {\r\n            remappedPlanProjections[remappedModelId] = entry[1];\r\n          }\r\n        }\r\n        targetElementProps.jsonProperties.styles.planProjections = remappedPlanProjections;\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Create a DisplayStyle3d for use by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the DisplayStyle3d\r\n   * @returns The newly constructed DisplayStyle3d element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, options?: DisplayStyleCreationOptions): DisplayStyle3d {\r\n    options = options ?? {};\r\n    let viewflags = options.viewFlags?.toJSON();\r\n    if (!viewflags)\r\n      viewflags = options.viewflags ?? new ViewFlags().toJSON();\r\n\r\n    const backgroundColor = options.backgroundColor instanceof ColorDef ? options.backgroundColor.toJSON() : options.backgroundColor;\r\n\r\n    const settings: DisplayStyle3dSettingsProps = {\r\n      ...options,\r\n      viewflags,\r\n      backgroundColor,\r\n    };\r\n\r\n    const displayStyleProps: DisplayStyle3dProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      jsonProperties: { styles: settings },\r\n      isPrivate: false,\r\n\r\n    };\r\n\r\n    return new DisplayStyle3d(displayStyleProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert a DisplayStyle3d for use by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DisplayStyle3d into this [[DefinitionModel]]\r\n   * @param name The name of the DisplayStyle3d\r\n   * @returns The Id of the newly inserted DisplayStyle3d element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, options?: DisplayStyleCreationOptions): Id64String {\r\n    const displayStyle = this.create(iModelDb, definitionModelId, name, options);\r\n    return iModelDb.elements.insertElement(displayStyle);\r\n  }\r\n}\r\n"]}