org.trianacode.taskgraph

Class TaskLayoutUtils

java.lang.Object

org.trianacode.taskgraph.TaskLayoutUtils

public class TaskLayoutUtils
extends java.lang.Object

A set of utils for manipulating the location of tasks (as stored in their GUI_XPOS and DEPRECATED_GUI_YPOS parameters). Note that the methods here assume that visually all the tasks are zero width and height! The actual width and heigth of tasks should be factored in by the graphical engine.

Constructor Summary

Constructors

Constructor and Description
TaskLayoutUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static TRectangle	getBoundingBox(Task[] tasks)
static TPoint	getPosition(Tool task)
static TPoint	getPosition(Tool task, TaskLayoutDetails layout)
static Task	replaceTask(Task curtask, Tool newtool, boolean rename) Replaces a current task with a new tool (instance id is preserved)
static Task	replaceTask(Task curtask, Tool newtool, boolean rename, boolean preserveinst) Replaces a current task with a new tool.
static void	resolveGroupNodes(TaskGraph taskgraph) Sets unconnected task nodes as group input/output nodes.
static void	setPosition(Task task, TPoint pos) Sets the position of the specified task using Triana's co-ordinate system.
static void	setPosition(Task task, TPoint pos, TaskLayoutDetails details) Sets the position of the specified task on the triana workspace using the specified task layout details.
static void	setPosition(Tool tool, TPoint pos) Sets the position of the specified task using Triana's co-ordinate system.
static void	setPosition(Tool tool, TPoint pos, TaskLayoutDetails details) Sets the position of the specified task on the triana workspace using the specified task layout details.
static void	translate(Task[] tasks, double xdist, double ydist) Translates the specified tasks by the specified x and y distances
static void	translate(Task[] tasks, int xdist, int ydist, TaskLayoutDetails details) Translates the specified tasks by the specified x and y distances
static void	translate(Task task, double xdist, double ydist) Translates the task by the specified x and y distances
static void	translateTo(Task[] tasks, TPoint point) Translates the specified tasks so that the top lefthand corner is at the specified point
static void	translateToOrigin(Task[] tasks) Translates the specified tasks so that the top lefthand corner is at the origin (x=0, y=0).
static void	translateToOrigin(Task[] tasks, int border)

Methods inherited from class java.lang.Object

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

Constructor Detail

TaskLayoutUtils

public TaskLayoutUtils()

Method Detail

getPosition

public static TPoint getPosition(Tool task)

Returns:

the position of the specfied task in the triana co-ordinate system

getPosition

public static TPoint getPosition(Tool task,
                 TaskLayoutDetails layout)

Returns:

the position of the specfied task on the triana workspace using the specified task layout details

setPosition

public static void setPosition(Task task,
               TPoint pos)

Sets the position of the specified task using Triana's co-ordinate system.

setPosition

public static void setPosition(Task task,
               TPoint pos,
               TaskLayoutDetails details)

Sets the position of the specified task on the triana workspace using the specified task layout details.

setPosition

public static void setPosition(Tool tool,
               TPoint pos)

Sets the position of the specified task using Triana's co-ordinate system.

setPosition

public static void setPosition(Tool tool,
               TPoint pos,
               TaskLayoutDetails details)

Sets the position of the specified task on the triana workspace using the specified task layout details.

translate

public static void translate(Task task,
             double xdist,
             double ydist)

Translates the task by the specified x and y distances

translate

public static void translate(Task[] tasks,
             double xdist,
             double ydist)

Translates the specified tasks by the specified x and y distances

translate

public static void translate(Task[] tasks,
             int xdist,
             int ydist,
             TaskLayoutDetails details)

Translates the specified tasks by the specified x and y distances

translateToOrigin

public static void translateToOrigin(Task[] tasks)

Translates the specified tasks so that the top lefthand corner is at the origin (x=0, y=0).

translateToOrigin

public static void translateToOrigin(Task[] tasks,
                     int border)

translateTo

public static void translateTo(Task[] tasks,
               TPoint point)

Translates the specified tasks so that the top lefthand corner is at the specified point

getBoundingBox

public static TRectangle getBoundingBox(Task[] tasks)

Returns:

the bounding box surrounding the specified tasks

replaceTask

public static Task replaceTask(Task curtask,
               Tool newtool,
               boolean rename)
                        throws TaskGraphException

Replaces a current task with a new tool (instance id is preserved)

Throws:

TaskGraphException

replaceTask

public static Task replaceTask(Task curtask,
               Tool newtool,
               boolean rename,
               boolean preserveinst)
                        throws TaskGraphException

Replaces a current task with a new tool.

Note that newtool is a task with no parent it is automatically disposed after the replacement task has been created.

Parameters:

curtask - the task being replaced

newtool - the tool used to replace the existing task

rename - true if the new task should take the same name as the existing task

preserveinst - true if the new task should preseve the instance id of newtool

Throws:

TaskGraphException

resolveGroupNodes

public static void resolveGroupNodes(TaskGraph taskgraph)
                              throws TaskGraphException

Sets unconnected task nodes as group input/output nodes.

Throws:

TaskGraphException