mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-08-14 17:58:59 +00:00
838e7d5381
git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@5282 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
428 lines
12 KiB
JavaScript
428 lines
12 KiB
JavaScript
/*
|
|
Copyright (c) 2004-2006, The Dojo Foundation
|
|
All Rights Reserved.
|
|
|
|
Licensed under the Academic Free License version 2.1 or above OR the
|
|
modified BSD license. For more information on Dojo licensing, see:
|
|
|
|
http://dojotoolkit.org/community/licensing.shtml
|
|
*/
|
|
|
|
dojo.provide("dojo.gfx.shape");
|
|
|
|
dojo.require("dojo.lang.declare");
|
|
|
|
dojo.require("dojo.gfx.common");
|
|
|
|
dojo.declare("dojo.gfx.Shape", null, {
|
|
// summary: a Shape object, which knows how to apply
|
|
// graphical attributes and transformations
|
|
|
|
initializer: function(){
|
|
|
|
// rawNode: Node: underlying node
|
|
this.rawNode = null;
|
|
|
|
// shape: Object: an abstract shape object
|
|
// (see dojo.gfx.defaultPath,
|
|
// dojo.gfx.defaultPolyline,
|
|
// dojo.gfx.defaultRect,
|
|
// dojo.gfx.defaultEllipse,
|
|
// dojo.gfx.defaultCircle,
|
|
// dojo.gfx.defaultLine,
|
|
// or dojo.gfx.defaultImage)
|
|
this.shape = null;
|
|
|
|
// matrix: dojo.gfx.matrix.Matrix: a transformation matrix
|
|
this.matrix = null;
|
|
|
|
// fillStyle: Object: a fill object
|
|
// (see dojo.gfx.defaultLinearGradient,
|
|
// dojo.gfx.defaultRadialGradient,
|
|
// dojo.gfx.defaultPattern,
|
|
// or dojo.gfx.color.Color)
|
|
this.fillStyle = null;
|
|
|
|
// strokeStyle: Object: a stroke object
|
|
// (see dojo.gfx.defaultStroke)
|
|
this.strokeStyle = null;
|
|
|
|
// bbox: dojo.gfx.Rectangle: a bounding box of this shape
|
|
// (see dojo.gfx.defaultRect)
|
|
this.bbox = null;
|
|
|
|
// virtual group structure
|
|
|
|
// parent: Object: a parent or null
|
|
// (see dojo.gfx.Surface,
|
|
// dojo.gfx.shape.VirtualGroup,
|
|
// or dojo.gfx.Group)
|
|
this.parent = null;
|
|
|
|
// parentMatrix: dojo.gfx.matrix.Matrix
|
|
// a transformation matrix inherited from the parent
|
|
this.parentMatrix = null;
|
|
},
|
|
|
|
// trivial getters
|
|
getNode: function(){
|
|
// summary: returns the current DOM Node or null
|
|
return this.rawNode; // Node
|
|
},
|
|
getShape: function(){
|
|
// summary: returns the current shape object or null
|
|
// (see dojo.gfx.defaultPath,
|
|
// dojo.gfx.defaultPolyline,
|
|
// dojo.gfx.defaultRect,
|
|
// dojo.gfx.defaultEllipse,
|
|
// dojo.gfx.defaultCircle,
|
|
// dojo.gfx.defaultLine,
|
|
// or dojo.gfx.defaultImage)
|
|
return this.shape; // Object
|
|
},
|
|
getTransform: function(){
|
|
// summary: returns the current transformation matrix or null
|
|
return this.matrix; // dojo.gfx.matrix.Matrix
|
|
},
|
|
getFill: function(){
|
|
// summary: returns the current fill object or null
|
|
// (see dojo.gfx.defaultLinearGradient,
|
|
// dojo.gfx.defaultRadialGradient,
|
|
// dojo.gfx.defaultPattern,
|
|
// or dojo.gfx.color.Color)
|
|
return this.fillStyle; // Object
|
|
},
|
|
getStroke: function(){
|
|
// summary: returns the current stroke object or null
|
|
// (see dojo.gfx.defaultStroke)
|
|
return this.strokeStyle; // Object
|
|
},
|
|
getParent: function(){
|
|
// summary: returns the parent or null
|
|
// (see dojo.gfx.Surface,
|
|
// dojo.gfx.shape.VirtualGroup,
|
|
// or dojo.gfx.Group)
|
|
return this.parent; // Object
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box or null
|
|
// (see dojo.gfx.defaultRect)
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
},
|
|
getEventSource: function(){
|
|
// summary: returns a Node, which is used as
|
|
// a source of events for this shape
|
|
return this.rawNode; // Node
|
|
},
|
|
|
|
// empty settings
|
|
|
|
setShape: function(shape){
|
|
// summary: sets a shape object
|
|
// (the default implementation simply ignores it)
|
|
// shape: Object: a shape object
|
|
// (see dojo.gfx.defaultPath,
|
|
// dojo.gfx.defaultPolyline,
|
|
// dojo.gfx.defaultRect,
|
|
// dojo.gfx.defaultEllipse,
|
|
// dojo.gfx.defaultCircle,
|
|
// dojo.gfx.defaultLine,
|
|
// or dojo.gfx.defaultImage)
|
|
return this; // self
|
|
},
|
|
setFill: function(fill){
|
|
// summary: sets a fill object
|
|
// (the default implementation simply ignores it)
|
|
// fill: Object: a fill object
|
|
// (see dojo.gfx.defaultLinearGradient,
|
|
// dojo.gfx.defaultRadialGradient,
|
|
// dojo.gfx.defaultPattern,
|
|
// or dojo.gfx.color.Color)
|
|
return this; // self
|
|
},
|
|
setStroke: function(stroke){
|
|
// summary: sets a stroke object
|
|
// (the default implementation simply ignores it)
|
|
// stroke: Object: a stroke object
|
|
// (see dojo.gfx.defaultStroke)
|
|
return this; // self
|
|
},
|
|
|
|
// z-index
|
|
|
|
moveToFront: function(){
|
|
// summary: moves a shape to front of its parent's list of shapes
|
|
// (the default implementation does nothing)
|
|
return this; // self
|
|
},
|
|
moveToBack: function(){
|
|
// summary: moves a shape to back of its parent's list of shapes
|
|
// (the default implementation does nothing)
|
|
return this;
|
|
},
|
|
|
|
setTransform: function(matrix){
|
|
// summary: sets a transformation matrix
|
|
// matrix: dojo.gfx.matrix.Matrix: a matrix or a matrix-like object
|
|
// (see an argument of dojo.gfx.matrix.Matrix
|
|
// constructor for a list of acceptable arguments)
|
|
this.matrix = dojo.gfx.matrix.clone(matrix ? dojo.gfx.matrix.normalize(matrix) : dojo.gfx.identity, true);
|
|
return this._applyTransform(); // self
|
|
},
|
|
|
|
// apply left & right transformation
|
|
|
|
applyRightTransform: function(matrix){
|
|
// summary: multiplies the existing matrix with an argument on right side
|
|
// (this.matrix * matrix)
|
|
// matrix: dojo.gfx.matrix.Matrix: a matrix or a matrix-like object
|
|
// (see an argument of dojo.gfx.matrix.Matrix
|
|
// constructor for a list of acceptable arguments)
|
|
return matrix ? this.setTransform([this.matrix, matrix]) : this; // self
|
|
},
|
|
applyLeftTransform: function(matrix){
|
|
// summary: multiplies the existing matrix with an argument on left side
|
|
// (matrix * this.matrix)
|
|
// matrix: dojo.gfx.matrix.Matrix: a matrix or a matrix-like object
|
|
// (see an argument of dojo.gfx.matrix.Matrix
|
|
// constructor for a list of acceptable arguments)
|
|
return matrix ? this.setTransform([matrix, this.matrix]) : this; // self
|
|
},
|
|
|
|
applyTransform: function(matrix){
|
|
// summary: a shortcut for dojo.gfx.Shape.applyRight
|
|
// matrix: dojo.gfx.matrix.Matrix: a matrix or a matrix-like object
|
|
// (see an argument of dojo.gfx.matrix.Matrix
|
|
// constructor for a list of acceptable arguments)
|
|
return matrix ? this.setTransform([this.matrix, matrix]) : this; // self
|
|
},
|
|
|
|
// virtual group methods
|
|
|
|
remove: function(silently){
|
|
// summary: removes the shape from its parent's list of shapes
|
|
// silently: Boolean?: if true, do not redraw a picture yet
|
|
if(this.parent){
|
|
this.parent.remove(this, silently);
|
|
}
|
|
return this; // self
|
|
},
|
|
_setParent: function(parent, matrix){
|
|
// summary: sets a parent
|
|
// parent: Object: a parent or null
|
|
// (see dojo.gfx.Surface,
|
|
// dojo.gfx.shape.VirtualGroup,
|
|
// or dojo.gfx.Group)
|
|
// matrix: dojo.gfx.matrix.Matrix:
|
|
// a 2D matrix or a matrix-like object
|
|
this.parent = parent;
|
|
return this._updateParentMatrix(matrix); // self
|
|
},
|
|
_updateParentMatrix: function(matrix){
|
|
// summary: updates the parent matrix with new matrix
|
|
// matrix: dojo.gfx.matrix.Matrix:
|
|
// a 2D matrix or a matrix-like object
|
|
this.parentMatrix = matrix ? dojo.gfx.matrix.clone(matrix) : null;
|
|
return this._applyTransform(); // self
|
|
},
|
|
_getRealMatrix: function(){
|
|
// summary: returns the cumulative ("real") transformation matrix
|
|
// by combining the shape's matrix with its parent's matrix
|
|
return this.parentMatrix ? new dojo.gfx.matrix.Matrix2D([this.parentMatrix, this.matrix]) : this.matrix; // dojo.gfx.matrix.Matrix
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.VirtualGroup", dojo.gfx.Shape, {
|
|
// summary: a virtual group of shapes, which can be used
|
|
// as a foundation for renderer-specific groups, or as a way
|
|
// to logically group shapes (e.g, to propagate matricies)
|
|
|
|
initializer: function() {
|
|
|
|
// children: Array: a list of children
|
|
this.children = [];
|
|
},
|
|
|
|
// group management
|
|
|
|
add: function(shape){
|
|
// summary: adds a shape to the list
|
|
// shape: dojo.gfx.Shape: a shape
|
|
var oldParent = shape.getParent();
|
|
if(oldParent){
|
|
oldParent.remove(shape, true);
|
|
}
|
|
this.children.push(shape);
|
|
return shape._setParent(this, this._getRealMatrix()); // self
|
|
},
|
|
remove: function(shape, silently){
|
|
// summary: removes a shape from the list
|
|
// silently: Boolean?: if true, do not redraw a picture yet
|
|
for(var i = 0; i < this.children.length; ++i){
|
|
if(this.children[i] == shape){
|
|
if(silently){
|
|
// skip for now
|
|
}else{
|
|
shape._setParent(null, null);
|
|
}
|
|
this.children.splice(i, 1);
|
|
break;
|
|
}
|
|
}
|
|
return this; // self
|
|
},
|
|
|
|
// apply transformation
|
|
|
|
_applyTransform: function(){
|
|
// summary: applies a transformation matrix to a group
|
|
var matrix = this._getRealMatrix();
|
|
for(var i = 0; i < this.children.length; ++i){
|
|
this.children[i]._updateParentMatrix(matrix);
|
|
}
|
|
return this; // self
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Rect", dojo.gfx.Shape, {
|
|
// summary: a generic rectangle
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates a rectangle
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultRect, true);
|
|
this.attach(rawNode);
|
|
},
|
|
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box (its shape in this case)
|
|
return this.shape; // dojo.gfx.Rectangle
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Ellipse", dojo.gfx.Shape, {
|
|
// summary: a generic ellipse
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates an ellipse
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultEllipse, true);
|
|
this.attach(rawNode);
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box
|
|
if(!this.bbox){
|
|
var shape = this.shape;
|
|
this.bbox = {x: shape.cx - shape.rx, y: shape.cy - shape.ry,
|
|
width: 2 * shape.rx, height: 2 * shape.ry};
|
|
}
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Circle", dojo.gfx.Shape, {
|
|
// summary: a generic circle
|
|
// (this is a helper object, which is defined for convinience)
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates a circle
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultCircle, true);
|
|
this.attach(rawNode);
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box
|
|
if(!this.bbox){
|
|
var shape = this.shape;
|
|
this.bbox = {x: shape.cx - shape.r, y: shape.cy - shape.r,
|
|
width: 2 * shape.r, height: 2 * shape.r};
|
|
}
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Line", dojo.gfx.Shape, {
|
|
// summary: a generic line
|
|
// (this is a helper object, which is defined for convinience)
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates a line
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultLine, true);
|
|
this.attach(rawNode);
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box
|
|
if(!this.bbox){
|
|
var shape = this.shape;
|
|
this.bbox = {
|
|
x: Math.min(shape.x1, shape.x2),
|
|
y: Math.min(shape.y1, shape.y2),
|
|
width: Math.abs(shape.x2 - shape.x1),
|
|
height: Math.abs(shape.y2 - shape.y1)
|
|
};
|
|
}
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Polyline", dojo.gfx.Shape, {
|
|
// summary: a generic polyline/polygon
|
|
// (this is a helper object, which is defined for convinience)
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates a line
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultPolyline, true);
|
|
this.attach(rawNode);
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box
|
|
if(!this.bbox && this.shape.points.length){
|
|
var p = this.shape.points;
|
|
var l = p.length;
|
|
var t = p[0];
|
|
var bbox = {l: t.x, t: t.y, r: t.x, b: t.y};
|
|
for(var i = 1; i < l; ++i){
|
|
t = p[i];
|
|
if(bbox.l > t.x) bbox.l = t.x;
|
|
if(bbox.r < t.x) bbox.r = t.x;
|
|
if(bbox.t > t.y) bbox.t = t.y;
|
|
if(bbox.b < t.y) bbox.b = t.y;
|
|
}
|
|
this.bbox = {
|
|
x: bbox.l,
|
|
y: bbox.t,
|
|
width: bbox.r - bbox.l,
|
|
height: bbox.b - bbox.t
|
|
};
|
|
}
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
}
|
|
});
|
|
|
|
dojo.declare("dojo.gfx.shape.Image", dojo.gfx.Shape, {
|
|
// summary: a generic image
|
|
// (this is a helper object, which is defined for convinience)
|
|
|
|
initializer: function(rawNode) {
|
|
// summary: creates an image
|
|
// rawNode: Node: a DOM Node
|
|
this.shape = dojo.lang.shallowCopy(dojo.gfx.defaultImage, true);
|
|
this.attach(rawNode);
|
|
},
|
|
getBoundingBox: function(){
|
|
// summary: returns the bounding box
|
|
if(!this.bbox){
|
|
var shape = this.shape;
|
|
this.bbox = {
|
|
x: 0,
|
|
y: 0,
|
|
width: shape.width,
|
|
height: shape.height
|
|
};
|
|
}
|
|
return this.bbox; // dojo.gfx.Rectangle
|
|
}
|
|
});
|