Class: Renderer

CAUTION: Keep in place! Used by Canvas.

answer the column index under the coordinate at pixelX

Answer specific data cell coordinates given mouse coordinates in pixels.

Requested column may not be visible due to being scrolled out of view.

Requested column may not be visible due to being scrolled out of view or if the column is inactive.

Requested row may not be visible due to being scrolled out of view.

Requested row may not be visible due to being outside the bounds of the rendered grid.

This method will be called upon instantiation of this class or of any class that extends from this class.

All initialize() methods in the inheritance chain are called, in turn, each with the same parameters that were passed to the constructor, beginning with that of the most "senior" class through that of the class of the new instance.

Requested column may not be visible due to being scrolled out of view.

Requested column may not be visible due to being scrolled out of view or if the column is inactive.

Requested row may not be visible due to being scrolled out of view.

Requested row may not be visible due to being outside the bounds of the rendered grid.

This is the entry point from fin-canvas.

Paints all the cells of a grid, one column at a time, but only as needed.

Paints all the cells of a grid, one row at a time.

On reset

Defers to paintCellsByColumnsAndRows, which clears the canvas, draws the grid, and draws the grid lines.

On the next call (afer reset)

First, a background rect is drawn using the grid background color.

Then, each cell is drawn. If its background differs from the grid background, the background is repainted.

try...catch surrounds each cell paint in case a cell renderer throws an error. The error message is error-logged to console AND displayed in cell.

On subsequent calls

Iterates through each cell, calling _paintCell with undefined prefill color. This signifies partial render to the SimpleCell cell renderer, which only renders the cell when it's text, font, or colors have changed.

Each cell to be rendered is described by a CellEvent object. For performance reasons, to avoid constantly instantiating these objects, we maintain a pool of these. When the grid shape changes, we reset their coordinates by setting reset on each.

See also the discussion of clipping in paintCellsByColumns.

Paints all the cells of a grid, one column at a time.

First, a background rect is drawn using the grid background color.

Then, if there are any columns with their own background color that differs from the grid background color, these are consolidated and the consolidated groups of column backgrounds are all drawn before iterating through cells. Note that these column rects are not suitable for clipping overflow text from previous columns. If you have overflow text, either turn on clipping (grid.properties.columnClip = true but big performance hit) or turn on one of the truncateTextWithEllipsis options.

try...catch surrounds each cell paint in case a cell renderer throws an error. The error message is error-logged to console AND displayed in cell.

Each cell to be rendered is described by a CellEvent object. For performance reasons, to avoid constantly instantiating these objects, we maintain a pool of these. When the grid shape changes, we reset their coordinates by setting reset on each.

Regading clipping. The reason for clipping is to prevent text from overflowing into the next column. However there is a serious performance cost.

For performance reasons _paintCell does not set up a clipping region for each cell. However, iff grid property columnClip is truthy, this grid renderer will set up a clipping region to prevent text overflow to right. If columnClip is null, a clipping region will only be set up on the last column. Otherwise, there will be no clipping region.

The idea of clipping just the last column is because in addition to the optional graphics clipping, we also clip ("truncate") text. Text can be truncated conservatively so it will never overflow. The problem with this is that characters vanish as they hit the right cell boundary, which may or may be obvious depending on font size. Alternatively, text can be truncated so that the overflow will be a maximum of 1 character. This allows partial characters to be rendered. But this is where graphics clipping is required.

When renderering column by column as this particular renderer does, and when the background color of the next cell to the right is opaque (alpha = 1), clipping can be turned off because each column will overpaint any text that overflowed from the one before. However, any text that overflows the last column will paint into unused canvas region to the right of the grid. This is the raison d'être for "clip last column only" option mentioned above (when columnClip is set to null). To avoid even this performance cost (of clipping just the last column), column widths can be set to fill the available canvas.

Note that text never overflows to left because text starting point is never < 0. The reason we don't clip to the left is for cell renderers that need to re-render to the left to produce a merged cell effect, such as grouped column header.

Paints all the cells of a grid, one column at a time.

First, a background rect is drawn using the grid background color.

Then, if there are any rows with their own background color that differs from the grid background color, these are consolidated and the consolidated groups of row backgrounds are all drawn before iterating through cells. These row backgrounds get priority over column backgrounds.

If there are no such row background rects to draw, the column rects are consolidated and drawn instead (again, before the cells). Note that these column rects are not suitable for clipping overflow text from previous columns. If you have overflow text, either turn on clipping (big performance hit) or turn on one of the truncateTextWithEllipsis options.

try...catch surrounds each cell paint in case a cell renderer throws an error. The error message is error-logged to console AND displayed in cell.

Each cell to be rendered is described by a CellEvent object. For performance reasons, to avoid constantly instantiating these objects, we maintain a pool of these. When the grid shape changes, we reset their coordinates by setting reset on each.

See also the discussion of clipping in paintCellsByColumns.

Paints all the cells of a grid, one column at a time.

In this grid renderer, a background rect is not drawn using the grid background color.

Rather, all columns paint their own background rects, with color defaulting to grid background color.

The idea of painting each column rect is to "clip" text that might have overflowed from the previous column by painting over it with the background from this column. Only the last column will show overflowing text, and only if the canvas width exceeds the grid width. If this is the case, you can turn on clipping for the last column only by setting columnClip to true for the last column.

NOTE: As a convenience feature, setting columnClip to null will clip only the last column, so simply setting it on the grid (rather than the last column) will have the same effect. This is much more convenient because you don't have to worry about the last column being redefined (moved, hidden, etc).

try...catch surrounds each cell paint in case a cell renderer throws an error. The error message is error-logged to console AND displayed in cell.

Each cell to be rendered is described by a CellEvent object. For performance reasons, to avoid constantly instantiating these objects, we maintain a pool of these. When the grid shape changes, we reset their coordinates by setting reset on each.

See also the discussion of clipping in paintCellsByColumnsDiscrete.

NOTE: This grid renderer is not as performant as the others and it's use is not recommended if you care about performance. The reasons for the wanting performance are unclear, possibly having to do with the way Chrome optimizes access to the column objects?

Paints all the cells of a grid, one row at a time.

First, a background rect is drawn using the grid background color.

Then, if there are any rows with their own background color that differs from the grid background color, these are consolidated and the consolidated groups of row backgrounds are all drawn before iterating through cells.

try...catch surrounds each cell paint in case a cell renderer throws an error. The error message is error-logged to console AND displayed in cell.

Each cell to be rendered is described by a CellEvent object. For performance reasons, to avoid constantly instantiating these objects, we maintain a pool of these. When the grid shape changes, we reset their coordinates by setting reset on each.

See also the discussion of clipping in paintCellsByColumns.

We opted to not paint borders for each cell as that was extremely expensive. Instead we draw grid lines here.

This is the main forking of the renderering task.

copy each overrides specified area to it's target and blank out the source area

iterate the renderering overrides and manifest each

Previously used by fin-canvas.