eiac/xterm.js
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

add ability to register/deregister character joiner

Browse Source
This commit is contained in:
Jeff Principe
2018-06-02 10:24:52 -07:00
parent c192a27d93
commit eabb25c796
9 changed files with 355 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/renderer/TextRenderLayer.ts
+145 -8
View File
@@ -4,11 +4,12 @@
*/
import { CHAR_DATA_ATTR_INDEX, CHAR_DATA_CODE_INDEX, CHAR_DATA_CHAR_INDEX, CHAR_DATA_WIDTH_INDEX } from '../Buffer';
import { FLAGS, IColorSet, IRenderDimensions } from './Types';
import { FLAGS, IColorSet, IRenderDimensions, ICharacterJoiner } from './Types';
import { CharData, ITerminal } from '../Types';
import { INVERTED_DEFAULT_COLOR } from './atlas/Types';
import { GridCache } from './GridCache';
import { BaseRenderLayer } from './BaseRenderLayer';
import { merge } from '../utils/MergeRanges';
/**
* This CharData looks like a null character, which will forc a clear and render
@@ -22,6 +23,7 @@ export class TextRenderLayer extends BaseRenderLayer {
private _characterWidth: number;
private _characterFont: string;
private _characterOverlapCache: { [key: string]: boolean } = {};
private _joiners: ICharacterJoiner[] = [];
constructor(container: HTMLElement, zIndex: number, colors: IColorSet, alpha: boolean) {
super(container, 'text', zIndex, alpha, colors);
@@ -52,6 +54,7 @@ export class TextRenderLayer extends BaseRenderLayer {
terminal: ITerminal,
firstRow: number,
lastRow: number,
foreground: boolean,
callback: (
code: number,
char: string,
@@ -66,10 +69,12 @@ export class TextRenderLayer extends BaseRenderLayer {
for (let y = firstRow; y <= lastRow; y++) {
const row = y + terminal.buffer.ydisp;
const line = terminal.buffer.lines.get(row);
let index = 0;
const joinedRanges = foreground ? this._getJoinedCharacters(terminal, row) : [];
for (let x = 0; x < terminal.cols; x++) {
const charData = line[x];
let charData = line[x];
const code: number = <number>charData[CHAR_DATA_CODE_INDEX];
const char: string = charData[CHAR_DATA_CHAR_INDEX];
let char: string = charData[CHAR_DATA_CHAR_INDEX];
const attr: number = charData[CHAR_DATA_ATTR_INDEX];
let width: number = charData[CHAR_DATA_WIDTH_INDEX];
@@ -79,6 +84,41 @@ export class TextRenderLayer extends BaseRenderLayer {
continue;
}
// Just in case we ended up in the middle of a range, lop off any
// ranges that have already passed
while (joinedRanges.length > 0 && joinedRanges[0][0] < x) {
joinedRanges.shift();
}
// Process any joined character ranges as needed. Because of how the
// ranges are produced, we know that they are valid for the characters
// and attributes of our input.
let lastCharX = x;
if (joinedRanges.length > 0 && x === joinedRanges[0][0]) {
const range = joinedRanges.shift();
// We need to start the searching at the next character
lastCharX++;
index++;
// Build up the string
for (; lastCharX < terminal.cols && index < range[1]; lastCharX++) {
charData = line[lastCharX];
if (charData[CHAR_DATA_WIDTH_INDEX] !== 0) {
char += charData[CHAR_DATA_CHAR_INDEX];
index++;
}
}
// Update our data accordingly. We use the width of the last character
// for the rest of the checks and decrement our column/index so that
// they align with the last character matched rather than the next
// character in the sequence.
width = charData[CHAR_DATA_WIDTH_INDEX];
lastCharX--;
index--;
}
// If the character is an overlapping char and the character to the right is a
// space, take ownership of the cell to the right.
if (this._isOverlapping(charData)) {
@@ -89,7 +129,7 @@ export class TextRenderLayer extends BaseRenderLayer {
// get removed, and `a` would not re-render because it thinks it's
// already in the correct state.
// this._state.cache[x][y] = OVERLAP_OWNED_CHAR_DATA;
if (x < line.length - 1 && line[x + 1][CHAR_DATA_CODE_INDEX] === 32 /*' '*/) {
if (lastCharX < line.length - 1 && line[lastCharX + 1][CHAR_DATA_CODE_INDEX] === 32 /*' '*/) {
width = 2;
// this._clearChar(x + 1, y);
// The overlapping char's char data will force a clear and render when the
@@ -116,7 +156,19 @@ export class TextRenderLayer extends BaseRenderLayer {
}
}
callback(code, char, width, x, y, fg, bg, flags);
callback(
char.length === 1 ? code : Infinity,
char,
char.length + width - 1,
x,
y,
fg,
bg,
flags
);
x = lastCharX;
index++;
}
}
}
@@ -134,7 +186,7 @@ export class TextRenderLayer extends BaseRenderLayer {
ctx.save();
this._forEachCell(terminal, firstRow, lastRow, (code, char, width, x, y, fg, bg, flags) => {
this._forEachCell(terminal, firstRow, lastRow, false, (code, char, width, x, y, fg, bg, flags) => {
// libvte and xterm both draw the background (but not foreground) of invisible characters,
// so we should too.
let nextFillStyle = null; // null represents default background color
@@ -176,7 +228,7 @@ export class TextRenderLayer extends BaseRenderLayer {
}
private _drawForeground(terminal: ITerminal, firstRow: number, lastRow: number): void {
this._forEachCell(terminal, firstRow, lastRow, (code, char, width, x, y, fg, bg, flags) => {
this._forEachCell(terminal, firstRow, lastRow, true, (code, char, width, x, y, fg, bg, flags) => {
if (flags & FLAGS.INVISIBLE) {
return;
}
@@ -190,7 +242,7 @@ export class TextRenderLayer extends BaseRenderLayer {
} else {
this._ctx.fillStyle = this._colors.foreground.css;
}
this.fillBottomLineAtCells(x, y);
this.fillBottomLineAtCells(x, y, width);
this._ctx.restore();
}
this.drawChar(
@@ -219,6 +271,19 @@ export class TextRenderLayer extends BaseRenderLayer {
this.setTransparency(terminal, terminal.options.allowTransparency);
}
public registerCharacterJoiner(joiner: ICharacterJoiner): void {
this._joiners.push(joiner);
}
public deregisterCharacterJoiner(joinerId: number): void {
for (let i = 0; i < this._joiners.length; i++) {
if (this._joiners[i].id === joinerId) {
this._joiners.splice(i, 1);
return;
}
}
}
/**
* Whether a character is overlapping to the next cell.
*/
@@ -258,6 +323,78 @@ export class TextRenderLayer extends BaseRenderLayer {
return overlaps;
}
private _getJoinedCharacters(terminal: ITerminal, row: number): [number, number][] {
if (this._joiners.length === 0) {
return [];
}
const line = terminal.buffer.lines.get(row);
if (line.length === 0) {
return [];
}
const ranges: [number, number][] = [];
const lineStr = terminal.buffer.translateBufferLineToString(row, true);
let currentIndex = 0;
let rangeStartIndex = 0;
let rangeAttr = line[0][CHAR_DATA_ATTR_INDEX] >> 9;
for (let x = 0; x < terminal.cols; x++) {
const charData = line[x];
const width = charData[CHAR_DATA_WIDTH_INDEX];
const attr = charData[CHAR_DATA_ATTR_INDEX] >> 9;
if (width === 0) {
// If this character is of width 0, skip it
continue;
}
// End of range
if (attr !== rangeAttr) {
// If we ended up with a sequence of more than one character, look for
// ranges to join
if (currentIndex - rangeStartIndex > 1) {
const subRanges = this._getSubRanges(lineStr, rangeStartIndex, currentIndex);
for (let i = 0; i < subRanges.length; i++) {
ranges.push(subRanges[i]);
}
}
// Reset our markers for a new range
rangeStartIndex = x;
rangeAttr = attr;
}
currentIndex++;
}
// Process any trailing ranges
if (currentIndex - rangeStartIndex > 1) {
const subRanges = this._getSubRanges(lineStr, rangeStartIndex, currentIndex);
for (let i = 0; i < subRanges.length; i++) {
ranges.push(subRanges[i]);
}
}
return ranges;
}
private _getSubRanges(line: string, startIndex: number, endIndex: number): [number, number][] {
const text = line.substring(startIndex, endIndex);
// At this point we already know that there is at least one joiner so
// we can just pull its value and assign it directly rather than
// merging it into an empty array, which incurs unnecessary writes.
const subRanges: [number, number][] = this._joiners[0].handler(text);
for (let i = 1; i < this._joiners.length; i++) {
// We merge any overlapping ranges across the different joiners
const joinerSubRanges = this._joiners[i].handler(text);
for (let j = 0; j < joinerSubRanges.length; j++) {
merge(subRanges, joinerSubRanges[j]);
}
}
return subRanges.map<[number, number]>(range => [range[0] + startIndex, range[1] + endIndex]);
}
/**
* Clear the charcater at the cell specified.
* @param x The column of the char.