/** * @license * Copyright 2019 Google LLC * SPDX-License-Identifier: Apache-2.0 */ /** * @fileoverview Methods for graphically rendering a block as SVG. */ 'use strict'; /** * Methods for graphically rendering a block as SVG. * @class */ goog.module('Blockly.blockRendering.Drawer'); 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'); const {Connection} = goog.require('Blockly.blockRendering.Connection'); /* eslint-disable-next-line no-unused-vars */ const {ConstantProvider, Notch, PuzzleTab} = goog.requireType('Blockly.blockRendering.ConstantProvider'); /* eslint-disable-next-line no-unused-vars */ const {ExternalValueInput} = goog.requireType('Blockly.blockRendering.ExternalValueInput'); /* 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 {PreviousConnection} = goog.requireType('Blockly.blockRendering.PreviousConnection'); /* 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'); /** * An object that draws a block based on the given rendering information. * @alias Blockly.blockRendering.Drawer */ class Drawer { /** * @param {!BlockSvg} block The block to render. * @param {!RenderInfo} info An object containing all * information needed to render this block. * @package */ constructor(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 */ draw() { 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 */ recordSizeOnBlock_() { // 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 */ hideHiddenIcons_() { 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 */ drawOutline_() { 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 */ drawTop_() { 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) && elem instanceof Connection) { this.outlinePath_ += (/** @type {!Notch} */ ( (/** @type {!PreviousConnection} */ (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 */ drawJaggedEdge_(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 */ drawValueInput_(row) { const input = /** @type {!ExternalValueInput|!InlineInput} */ (row.getLastInput()); this.positionExternalValueConnection_(row); const pathDown = (typeof input.shape.pathDown === 'function') ? (/** @type {function(number)} */ (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 */ drawStatementInput_(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 = (/** @type {!Notch} */ (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 */ drawRightSideRow_(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 */ drawBottom_() { 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) && elem instanceof Connection) { outlinePath += (/** @type {!Notch} */ (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 */ drawLeft_() { const outputConnection = this.info_.outputConnection; this.positionOutputConnection_(); if (outputConnection) { const tabBottom = outputConnection.connectionOffsetY + outputConnection.height; const pathUp = (typeof outputConnection.shape.pathUp === 'function') ? (/** @type {function(number)} */ (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 */ drawInternals_() { 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 */ layoutField_(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 */ drawInlineInput_(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) + (/** @type {!PuzzleTab} */ (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 */ positionInlineInputConnection_(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 */ positionStatementInputConnection_(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 */ positionExternalValueConnection_(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 */ positionPreviousConnection_() { 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 */ positionNextConnection_() { 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 */ positionOutputConnection_() { 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 = Drawer;