/** * @license * Copyright 2019 Google LLC * SPDX-License-Identifier: Apache-2.0 */ /** * @fileoverview Methods for graphically rendering a block as SVG. * @author fenichel@google.com (Rachel Fenichel) */ 'use strict'; /** * Methods for graphically rendering a block as SVG. * @class */ goog.module('Blockly.blockRendering.Drawer'); /* eslint-disable-next-line no-unused-vars */ const ConstantProvider = goog.requireType('Blockly.blockRendering.ConstantProvider'); /* eslint-disable-next-line no-unused-vars */ const Field = goog.requireType('Blockly.blockRendering.Field'); /* eslint-disable-next-line no-unused-vars */ const Icon = goog.requireType('Blockly.blockRendering.Icon'); /* eslint-disable-next-line no-unused-vars */ const InlineInput = goog.requireType('Blockly.blockRendering.InlineInput'); /* eslint-disable-next-line no-unused-vars */ const RenderInfo = goog.requireType('Blockly.blockRendering.RenderInfo'); /* eslint-disable-next-line no-unused-vars */ const Row = goog.requireType('Blockly.blockRendering.Row'); const Types = goog.require('Blockly.blockRendering.Types'); const debug = goog.require('Blockly.blockRendering.debug'); const svgPaths = goog.require('Blockly.utils.svgPaths'); /* eslint-disable-next-line no-unused-vars */ const {BlockSvg} = goog.requireType('Blockly.BlockSvg'); /** * An object that draws a block based on the given rendering information. * @param {!BlockSvg} block The block to render. * @param {!RenderInfo} info An object containing all * information needed to render this block. * @package * @constructor * @alias Blockly.blockRendering.Drawer */ const Drawer = function(block, info) { this.block_ = block; this.info_ = info; this.topLeft_ = block.getRelativeToSurfaceXY(); this.outlinePath_ = ''; this.inlinePath_ = ''; /** * The renderer's constant provider. * @type {!ConstantProvider} * @protected */ this.constants_ = info.getRenderer().getConstants(); }; /** * Draw the block to the workspace. Here "drawing" means setting SVG path * elements and moving fields, icons, and connections on the screen. * * The pieces of the paths are pushed into arrays of "steps", which are then * joined with spaces and set directly on the block. This guarantees that * the steps are separated by spaces for improved readability, but isn't * required. * @package */ Drawer.prototype.draw = function() { this.hideHiddenIcons_(); this.drawOutline_(); this.drawInternals_(); this.block_.pathObject.setPath(this.outlinePath_ + '\n' + this.inlinePath_); if (this.info_.RTL) { this.block_.pathObject.flipRTL(); } if (debug.isDebuggerEnabled()) { this.block_.renderingDebugger.drawDebug(this.block_, this.info_); } this.recordSizeOnBlock_(); }; /** * Save sizing information back to the block * Most of the rendering information can be thrown away at the end of the * render. Anything that needs to be kept around should be set in this function. * @protected */ Drawer.prototype.recordSizeOnBlock_ = function() { // This is used when the block is reporting its size to anyone else. // The dark path adds to the size of the block in both X and Y. this.block_.height = this.info_.height; this.block_.width = this.info_.widthWithChildren; }; /** * Hide icons that were marked as hidden. * @protected */ Drawer.prototype.hideHiddenIcons_ = function() { for (let i = 0, iconInfo; (iconInfo = this.info_.hiddenIcons[i]); i++) { iconInfo.icon.iconGroup_.setAttribute('display', 'none'); } }; /** * Create the outline of the block. This is a single continuous path. * @protected */ Drawer.prototype.drawOutline_ = function() { this.drawTop_(); for (let r = 1; r < this.info_.rows.length - 1; r++) { const row = this.info_.rows[r]; if (row.hasJaggedEdge) { this.drawJaggedEdge_(row); } else if (row.hasStatement) { this.drawStatementInput_(row); } else if (row.hasExternalInput) { this.drawValueInput_(row); } else { this.drawRightSideRow_(row); } } this.drawBottom_(); this.drawLeft_(); }; /** * Add steps for the top corner of the block, taking into account * details such as hats and rounded corners. * @protected */ Drawer.prototype.drawTop_ = function() { const topRow = this.info_.topRow; const elements = topRow.elements; this.positionPreviousConnection_(); this.outlinePath_ += svgPaths.moveBy(topRow.xPos, this.info_.startY); for (let i = 0, elem; (elem = elements[i]); i++) { if (Types.isLeftRoundedCorner(elem)) { this.outlinePath_ += this.constants_.OUTSIDE_CORNERS.topLeft; } else if (Types.isRightRoundedCorner(elem)) { this.outlinePath_ += this.constants_.OUTSIDE_CORNERS.topRight; } else if (Types.isPreviousConnection(elem)) { this.outlinePath_ += elem.shape.pathLeft; } else if (Types.isHat(elem)) { this.outlinePath_ += this.constants_.START_HAT.path; } else if (Types.isSpacer(elem)) { this.outlinePath_ += svgPaths.lineOnAxis('h', elem.width); } // No branch for a square corner, because it's a no-op. } this.outlinePath_ += svgPaths.lineOnAxis('v', topRow.height); }; /** * Add steps for the jagged edge of a row on a collapsed block. * @param {!Row} row The row to draw the side of. * @protected */ Drawer.prototype.drawJaggedEdge_ = function(row) { const remainder = row.height - this.constants_.JAGGED_TEETH.height; this.outlinePath_ += this.constants_.JAGGED_TEETH.path + svgPaths.lineOnAxis('v', remainder); }; /** * Add steps for an external value input, rendered as a notch in the side * of the block. * @param {!Row} row The row that this input belongs to. * @protected */ Drawer.prototype.drawValueInput_ = function(row) { const input = row.getLastInput(); this.positionExternalValueConnection_(row); const pathDown = (typeof input.shape.pathDown == 'function') ? input.shape.pathDown(input.height) : input.shape.pathDown; this.outlinePath_ += svgPaths.lineOnAxis('H', input.xPos + input.width) + pathDown + svgPaths.lineOnAxis('v', row.height - input.connectionHeight); }; /** * Add steps for a statement input. * @param {!Row} row The row that this input belongs to. * @protected */ Drawer.prototype.drawStatementInput_ = function(row) { const input = row.getLastInput(); // Where to start drawing the notch, which is on the right side in LTR. const x = input.xPos + input.notchOffset + input.shape.width; const innerTopLeftCorner = input.shape.pathRight + svgPaths.lineOnAxis( 'h', -(input.notchOffset - this.constants_.INSIDE_CORNERS.width)) + this.constants_.INSIDE_CORNERS.pathTop; const innerHeight = row.height - (2 * this.constants_.INSIDE_CORNERS.height); this.outlinePath_ += svgPaths.lineOnAxis('H', x) + innerTopLeftCorner + svgPaths.lineOnAxis('v', innerHeight) + this.constants_.INSIDE_CORNERS.pathBottom + svgPaths.lineOnAxis('H', row.xPos + row.width); this.positionStatementInputConnection_(row); }; /** * Add steps for the right side of a row that does not have value or * statement input connections. * @param {!Row} row The row to draw the side of. * @protected */ Drawer.prototype.drawRightSideRow_ = function(row) { this.outlinePath_ += svgPaths.lineOnAxis('V', row.yPos + row.height); }; /** * Add steps for the bottom edge of a block, possibly including a notch * for the next connection. * @protected */ Drawer.prototype.drawBottom_ = function() { const bottomRow = this.info_.bottomRow; const elems = bottomRow.elements; this.positionNextConnection_(); let rightCornerYOffset = 0; let outlinePath = ''; for (let i = elems.length - 1, elem; (elem = elems[i]); i--) { if (Types.isNextConnection(elem)) { outlinePath += elem.shape.pathRight; } else if (Types.isLeftSquareCorner(elem)) { outlinePath += svgPaths.lineOnAxis('H', bottomRow.xPos); } else if (Types.isLeftRoundedCorner(elem)) { outlinePath += this.constants_.OUTSIDE_CORNERS.bottomLeft; } else if (Types.isRightRoundedCorner(elem)) { outlinePath += this.constants_.OUTSIDE_CORNERS.bottomRight; rightCornerYOffset = this.constants_.OUTSIDE_CORNERS.rightHeight; } else if (Types.isSpacer(elem)) { outlinePath += svgPaths.lineOnAxis('h', elem.width * -1); } } this.outlinePath_ += svgPaths.lineOnAxis('V', bottomRow.baseline - rightCornerYOffset); this.outlinePath_ += outlinePath; }; /** * Add steps for the left side of the block, which may include an output * connection * @protected */ Drawer.prototype.drawLeft_ = function() { const outputConnection = this.info_.outputConnection; this.positionOutputConnection_(); if (outputConnection) { const tabBottom = outputConnection.connectionOffsetY + outputConnection.height; const pathUp = (typeof outputConnection.shape.pathUp == 'function') ? outputConnection.shape.pathUp(outputConnection.height) : outputConnection.shape.pathUp; // Draw a line up to the bottom of the tab. this.outlinePath_ += svgPaths.lineOnAxis('V', tabBottom) + pathUp; } // Close off the path. This draws a vertical line up to the start of the // block's path, which may be either a rounded or a sharp corner. this.outlinePath_ += 'z'; }; /** * Draw the internals of the block: inline inputs, fields, and icons. These do * not depend on the outer path for placement. * @protected */ Drawer.prototype.drawInternals_ = function() { for (let i = 0, row; (row = this.info_.rows[i]); i++) { for (let j = 0, elem; (elem = row.elements[j]); j++) { if (Types.isInlineInput(elem)) { this.drawInlineInput_( /** @type {!InlineInput} */ (elem)); } else if (Types.isIcon(elem) || Types.isField(elem)) { this.layoutField_( /** @type {!Field|!Icon} */ (elem)); } } } }; /** * Push a field or icon's new position to its SVG root. * @param {!Icon|!Field} fieldInfo * The rendering information for the field or icon. * @protected */ Drawer.prototype.layoutField_ = function(fieldInfo) { let svgGroup; if (Types.isField(fieldInfo)) { svgGroup = fieldInfo.field.getSvgRoot(); } else if (Types.isIcon(fieldInfo)) { svgGroup = fieldInfo.icon.iconGroup_; } const yPos = fieldInfo.centerline - fieldInfo.height / 2; let xPos = fieldInfo.xPos; let scale = ''; if (this.info_.RTL) { xPos = -(xPos + fieldInfo.width); if (fieldInfo.flipRtl) { xPos += fieldInfo.width; scale = 'scale(-1 1)'; } } if (Types.isIcon(fieldInfo)) { svgGroup.setAttribute('display', 'block'); svgGroup.setAttribute('transform', 'translate(' + xPos + ',' + yPos + ')'); fieldInfo.icon.computeIconLocation(); } else { svgGroup.setAttribute( 'transform', 'translate(' + xPos + ',' + yPos + ')' + scale); } if (this.info_.isInsertionMarker) { // Fields and icons are invisible on insertion marker. They still have to // be rendered so that the block can be sized correctly. svgGroup.setAttribute('display', 'none'); } }; /** * Add steps for an inline input. * @param {!InlineInput} input The information about the * input to render. * @protected */ Drawer.prototype.drawInlineInput_ = function(input) { const width = input.width; const height = input.height; const yPos = input.centerline - height / 2; const connectionTop = input.connectionOffsetY; const connectionBottom = input.connectionHeight + connectionTop; const connectionRight = input.xPos + input.connectionWidth; this.inlinePath_ += svgPaths.moveTo(connectionRight, yPos) + svgPaths.lineOnAxis('v', connectionTop) + input.shape.pathDown + svgPaths.lineOnAxis('v', height - connectionBottom) + svgPaths.lineOnAxis('h', width - input.connectionWidth) + svgPaths.lineOnAxis('v', -height) + 'z'; this.positionInlineInputConnection_(input); }; /** * Position the connection on an inline value input, taking into account * RTL and the small gap between the parent block and child block which lets the * parent block's dark path show through. * @param {InlineInput} input The information about * the input that the connection is on. * @protected */ Drawer.prototype.positionInlineInputConnection_ = function(input) { const yPos = input.centerline - input.height / 2; // Move the connection. if (input.connectionModel) { // xPos already contains info about startX let connX = input.xPos + input.connectionWidth + input.connectionOffsetX; if (this.info_.RTL) { connX *= -1; } input.connectionModel.setOffsetInBlock( connX, yPos + input.connectionOffsetY); } }; /** * Position the connection on a statement input, taking into account * RTL and the small gap between the parent block and child block which lets the * parent block's dark path show through. * @param {!Row} row The row that the connection is on. * @protected */ Drawer.prototype.positionStatementInputConnection_ = function(row) { const input = row.getLastInput(); if (input.connectionModel) { let connX = row.xPos + row.statementEdge + input.notchOffset; if (this.info_.RTL) { connX *= -1; } input.connectionModel.setOffsetInBlock(connX, row.yPos); } }; /** * Position the connection on an external value input, taking into account * RTL and the small gap between the parent block and child block which lets the * parent block's dark path show through. * @param {!Row} row The row that the connection is on. * @protected */ Drawer.prototype.positionExternalValueConnection_ = function(row) { const input = row.getLastInput(); if (input.connectionModel) { let connX = row.xPos + row.width; if (this.info_.RTL) { connX *= -1; } input.connectionModel.setOffsetInBlock(connX, row.yPos); } }; /** * Position the previous connection on a block. * @protected */ Drawer.prototype.positionPreviousConnection_ = function() { const topRow = this.info_.topRow; if (topRow.connection) { const x = topRow.xPos + topRow.notchOffset; const connX = (this.info_.RTL ? -x : x); topRow.connection.connectionModel.setOffsetInBlock(connX, 0); } }; /** * Position the next connection on a block. * @protected */ Drawer.prototype.positionNextConnection_ = function() { const bottomRow = this.info_.bottomRow; if (bottomRow.connection) { const connInfo = bottomRow.connection; const x = connInfo.xPos; // Already contains info about startX. const connX = (this.info_.RTL ? -x : x); connInfo.connectionModel.setOffsetInBlock(connX, bottomRow.baseline); } }; /** * Position the output connection on a block. * @protected */ Drawer.prototype.positionOutputConnection_ = function() { if (this.info_.outputConnection) { const x = this.info_.startX + this.info_.outputConnection.connectionOffsetX; const connX = this.info_.RTL ? -x : x; this.block_.outputConnection.setOffsetInBlock( connX, this.info_.outputConnection.connectionOffsetY); } }; exports = Drawer;