edu.mit.blocks.renderable

Class BlockUtilities

java.lang.Object

edu.mit.blocks.renderable.BlockUtilities

public class BlockUtilities
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
BlockUtilities()

Method Summary

Modifier and Type	Method and Description
static boolean	blockExists(Workspace workspace, BlockNode node) Checks to see if the block still exists
static RenderableBlock	cloneBlock(Block myblock)
static void	deleteBlock(RenderableBlock block)
static java.lang.String	disambiguousStringRep(RenderableBlock block) Creates a string representation for the given RenderableBlock that is disambiguated from string representations for blocks with the same label by appending socket information to the end of the block's label.
static java.util.List<TextualFactoryBlock>	getAllMatchingBlocks(Workspace workspace, java.lang.String keyword)
static RenderableBlock	getBlock(Workspace workspace, java.lang.String genusName, java.lang.String label) Returns a new RenderableBlock instance with the matching genusName.
static java.util.List<TextualFactoryBlock>	getDigits(Workspace workspace, java.lang.String digits)
static java.util.List<TextualFactoryBlock>	getPlusBlocks(Workspace workspace, java.lang.String plus)
static boolean	isLabelValid(Block block, java.lang.String label)
static boolean	isLabelValid(Workspace workspace, java.lang.Long blockID, java.lang.String label) Returns true if the specified label is valid according to the specifications of this block's genus.
static BlockNode	makeNodeWithChildren(Workspace workspace, java.lang.Long blockID)
static BlockNode	makeNodeWithStack(Workspace workspace, java.lang.Long blockID)
static RenderableBlock	makeRenderable(Workspace workspace, BlockNode node, WorkspaceWidget widget)
static void	reset()
static void	setZoomLevel(double newZoom)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BlockUtilities

public BlockUtilities()

Method Detail

reset

public static void reset()

setZoomLevel

public static void setZoomLevel(double newZoom)

isLabelValid

public static boolean isLabelValid(Workspace workspace,
                                   java.lang.Long blockID,
                                   java.lang.String label)

Returns true if the specified label is valid according to the specifications of this block's genus. For example, if this block's label must be unique (as specified from its genus), this method verifies that its label is unique relative to the other instances present.

Parameters:

label - the String block label to test

Returns:

true if the specified label is valid according to the specifications of this block's genus.

isLabelValid

public static boolean isLabelValid(Block block,
                                   java.lang.String label)

deleteBlock

public static void deleteBlock(RenderableBlock block)

cloneBlock

public static RenderableBlock cloneBlock(Block myblock)

disambiguousStringRep

public static java.lang.String disambiguousStringRep(RenderableBlock block)

Creates a string representation for the given RenderableBlock that is disambiguated from string representations for blocks with the same label by appending socket information to the end of the block's label. The created string is in the form: BlockLabel [socketLabel1, ..., socketLabelN]

Parameters:

block - the FactoryRenderableBlock to create a string representation of

Returns:

a String containing the given block's keyword with a list of its socket labels appended to the end.

getAllMatchingBlocks

public static java.util.List<TextualFactoryBlock> getAllMatchingBlocks(Workspace workspace,
                                                                       java.lang.String keyword)

Parameters:

workspace - The workspace in use

keyword -

Returns:

List of TextualFactoryBlocks, {T}, such that: T.toString contains keyword T == null if no matching blocks were found T.toString is unique for each T

getPlusBlocks

public static java.util.List<TextualFactoryBlock> getPlusBlocks(Workspace workspace,
                                                                java.lang.String plus)

Parameters:

plus -

Returns:

List containing the two "+" TextualFactoryBlocks and any other blocks containing "+"

getDigits

public static java.util.List<TextualFactoryBlock> getDigits(Workspace workspace,
                                                            java.lang.String digits)

Parameters:

workspace -

digits -

Returns:

List containing a number TextualFactoryBlock and any other blocks containing the numbers

getBlock

public static RenderableBlock getBlock(Workspace workspace,
                                       java.lang.String genusName,
                                       java.lang.String label)

Returns a new RenderableBlock instance with the matching genusName. New block will also have matching label is label is not-null. May return null.

Parameters:

workspace - The workspace to use

genusName -

label -

Returns:

A new RenderableBlock with matching genusName and label (if label is not-null). If no matching blocks were found, return null.

makeNodeWithChildren

public static BlockNode makeNodeWithChildren(Workspace workspace,
                                             java.lang.Long blockID)

makeNodeWithStack

public static BlockNode makeNodeWithStack(Workspace workspace,
                                          java.lang.Long blockID)

blockExists

public static boolean blockExists(Workspace workspace,
                                  BlockNode node)

Checks to see if the block still exists

Returns:

True if renderable block is still there, False otherwise

makeRenderable

public static RenderableBlock makeRenderable(Workspace workspace,
                                             BlockNode node,
                                             WorkspaceWidget widget)