98 lines
2.9 KiB
TypeScript
98 lines
2.9 KiB
TypeScript
/**
|
|
* Copyright (c) 2017 The xterm.js authors. All rights reserved.
|
|
* @license MIT
|
|
*/
|
|
|
|
import { ITerminal } from '../../Types';
|
|
import { generateConfig, configEquals } from './CharAtlasUtils';
|
|
import { BaseCharAtlas } from 'browser/renderer/atlas/BaseCharAtlas';
|
|
import { DynamicCharAtlas } from './DynamicCharAtlas';
|
|
import { ICharAtlasConfig } from './Types';
|
|
import { IColorSet } from 'browser/Types';
|
|
|
|
interface ICharAtlasCacheEntry {
|
|
atlas: BaseCharAtlas;
|
|
config: ICharAtlasConfig;
|
|
// N.B. This implementation potentially holds onto copies of the terminal forever, so
|
|
// this may cause memory leaks.
|
|
ownedBy: ITerminal[];
|
|
}
|
|
|
|
const charAtlasCache: ICharAtlasCacheEntry[] = [];
|
|
|
|
/**
|
|
* Acquires a char atlas, either generating a new one or returning an existing
|
|
* one that is in use by another terminal.
|
|
* @param terminal The terminal.
|
|
* @param colors The colors to use.
|
|
*/
|
|
export function acquireCharAtlas(
|
|
terminal: ITerminal,
|
|
colors: IColorSet,
|
|
scaledCharWidth: number,
|
|
scaledCharHeight: number
|
|
): BaseCharAtlas {
|
|
const newConfig = generateConfig(scaledCharWidth, scaledCharHeight, terminal, colors);
|
|
|
|
// Check to see if the terminal already owns this config
|
|
for (let i = 0; i < charAtlasCache.length; i++) {
|
|
const entry = charAtlasCache[i];
|
|
const ownedByIndex = entry.ownedBy.indexOf(terminal);
|
|
if (ownedByIndex >= 0) {
|
|
if (configEquals(entry.config, newConfig)) {
|
|
return entry.atlas;
|
|
}
|
|
// The configs differ, release the terminal from the entry
|
|
if (entry.ownedBy.length === 1) {
|
|
entry.atlas.dispose();
|
|
charAtlasCache.splice(i, 1);
|
|
} else {
|
|
entry.ownedBy.splice(ownedByIndex, 1);
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
// Try match a char atlas from the cache
|
|
for (let i = 0; i < charAtlasCache.length; i++) {
|
|
const entry = charAtlasCache[i];
|
|
if (configEquals(entry.config, newConfig)) {
|
|
// Add the terminal to the cache entry and return
|
|
entry.ownedBy.push(terminal);
|
|
return entry.atlas;
|
|
}
|
|
}
|
|
|
|
const newEntry: ICharAtlasCacheEntry = {
|
|
atlas: new DynamicCharAtlas(
|
|
document,
|
|
newConfig
|
|
),
|
|
config: newConfig,
|
|
ownedBy: [terminal]
|
|
};
|
|
charAtlasCache.push(newEntry);
|
|
return newEntry.atlas;
|
|
}
|
|
|
|
/**
|
|
* Removes a terminal reference from the cache, allowing its memory to be freed.
|
|
* @param terminal The terminal to remove.
|
|
*/
|
|
export function removeTerminalFromCache(terminal: ITerminal): void {
|
|
for (let i = 0; i < charAtlasCache.length; i++) {
|
|
const index = charAtlasCache[i].ownedBy.indexOf(terminal);
|
|
if (index !== -1) {
|
|
if (charAtlasCache[i].ownedBy.length === 1) {
|
|
// Remove the cache entry if it's the only terminal
|
|
charAtlasCache[i].atlas.dispose();
|
|
charAtlasCache.splice(i, 1);
|
|
} else {
|
|
// Remove the reference from the cache entry
|
|
charAtlasCache[i].ownedBy.splice(index, 1);
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
}
|