Mercurial > hg > digilib-old
annotate client/digitallibrary/jquery/jquery.digilib.geometry.js @ 867:987cfe401970 stream
add default error message type config.
| author | robcast |
|---|---|
| date | Thu, 10 Mar 2011 21:21:10 +0100 |
| parents | c662bf335881 |
| children | 971b7122930f |
| rev | line source |
|---|---|
| 785 | 1 /** required digilib geometry plugin |
| 2 */ | |
| 3 | |
| 4 (function($) { | |
| 5 //var dlGeometry = function() { | |
| 6 /* | |
| 7 * Size class | |
| 8 */ | |
| 9 var size = function(w, h) { | |
| 10 var that; | |
| 11 if (typeof w === "object") { | |
| 12 // assume its size | |
| 13 that = { | |
| 14 width : w.width, | |
| 15 height : w.height | |
| 16 }; | |
| 17 } else { | |
| 18 that = { | |
| 19 width : parseFloat(w), | |
| 20 height : parseFloat(h) | |
| 21 }; | |
| 22 } | |
| 23 that.equals = function(other) { | |
| 24 return (this.width === other.width && this.height === other.height); | |
| 25 }; | |
| 26 that.toString = function() { | |
| 27 return (this.width + "x" + this.height); | |
| 28 }; | |
| 29 return that; | |
| 30 }; | |
| 31 | |
| 32 /* | |
| 33 * Position class | |
| 34 */ | |
| 35 var position = function(x, y) { | |
| 36 var that; | |
| 37 if (typeof x === "object") { | |
| 38 if (x instanceof jQuery) { | |
| 39 // jQuery object | |
| 40 var pos = x.offset(); | |
| 41 that = { | |
| 42 x : pos.left, | |
| 43 y : pos.top | |
| 44 }; | |
| 45 } else { | |
| 46 if (x.x != null) { | |
| 47 // position object | |
| 48 that = { | |
| 49 x : x.x, | |
| 50 y : x.y | |
| 51 }; | |
| 52 } | |
| 53 if (x.pageX != null) { | |
| 54 // event object | |
| 55 that = { | |
| 56 x : x.pageX, | |
| 57 y : x.pageY | |
| 58 }; | |
| 59 } | |
| 60 } | |
| 61 } else { | |
| 62 that = { | |
| 63 x : parseFloat(x), | |
| 64 y : parseFloat(y) | |
| 65 }; | |
| 66 } | |
| 67 that.equals = function(other) { | |
| 68 return (this.x === other.x && this.y === other.y); | |
| 69 }; | |
| 70 // add position other to this | |
| 71 that.add = function(other) { | |
| 72 this.x += other.x; | |
| 73 this.y += other.y; | |
| 74 return this; | |
| 75 }; | |
| 76 // returns negative position | |
| 77 that.neg = function() { | |
| 78 return position({ | |
| 79 x : -this.x, | |
| 80 y : -this.y | |
| 81 }); | |
| 82 }; | |
| 83 // returns new position that is the difference between this and other | |
| 84 that.delta = function(other) { | |
| 85 return position({ | |
| 86 x : other.x - this.x, | |
| 87 y : other.y - this.y | |
| 88 }); | |
| 89 }; | |
| 90 // adjusts position $elem to this position | |
| 91 that.adjustDiv = function($elem) { | |
| 92 $elem.offset({ | |
| 93 left : this.x, | |
| 94 top : this.y | |
| 95 }); | |
| 96 }; | |
| 97 // returns distance of this position to pos (length if pos == null) | |
| 98 that.distance = function(pos) { | |
| 99 if (pos == null) { | |
| 100 pos = { | |
| 101 x : 0, | |
| 102 y : 0 | |
| 103 }; | |
| 104 } | |
| 105 var dx = pos.x - this.x; | |
| 106 var dy = pos.y - this.y; | |
| 107 return Math.sqrt(dx * dx + dy * dy); | |
| 108 }; | |
| 109 that.toString = function() { | |
| 110 return (this.x + "," + this.y); | |
| 111 }; | |
| 112 return that; | |
| 113 }; | |
| 114 /* | |
| 115 * Rectangle class | |
| 116 */ | |
| 117 var rectangle = function(x, y, w, h) { | |
| 118 var that = {}; | |
| 119 if (typeof x === "object") { | |
| 120 if (x instanceof jQuery) { | |
| 121 // jQuery object | |
| 122 var pos = x.offset(); | |
| 123 that = { | |
| 124 x : pos.left, | |
| 125 y : pos.top, | |
| 126 width : x.width(), | |
| 127 height : x.height() | |
| 128 }; | |
| 129 } else if (y == null) { | |
| 130 // assume x is rectangle | |
| 131 that = { | |
| 132 x : x.x, | |
| 133 y : x.y, | |
| 134 width : x.width, | |
| 135 height : x.height | |
| 136 }; | |
| 137 } else { | |
| 138 // assume x and y are Position | |
| 139 that = { | |
| 140 x : Math.min(x.x, y.x), | |
| 141 y : Math.min(x.y, y.y), | |
| 142 width : Math.abs(y.x - x.x), | |
| 143 height : Math.abs(y.y - x.y) | |
| 144 }; | |
| 145 } | |
| 146 } else { | |
| 147 that = { | |
| 148 x : parseFloat(x), | |
| 149 y : parseFloat(y), | |
| 150 width : parseFloat(w), | |
| 151 height : parseFloat(h) | |
| 152 }; | |
| 153 } | |
| 154 // returns a copy of this Rectangle | |
| 155 that.copy = function() { | |
| 156 return rectangle(this); | |
| 157 }; | |
| 158 // returns the position of this Rectangle | |
| 159 that.getPosition = function() { | |
| 160 return position(this); | |
| 161 }; | |
| 162 // returns the size of this Rectangle | |
| 163 that.getSize = function() { | |
| 164 return size(this); | |
| 165 }; | |
| 166 // returns the upper left corner position | |
| 167 that.getPt1 = that.getPosition; | |
| 168 // returns the lower right corner position of this Rectangle | |
| 169 that.getPt2 = function() { | |
| 170 return position({ | |
| 171 x : this.x + this.width, | |
| 172 y : this.y + this.height | |
| 173 }); | |
| 174 }; | |
| 175 // sets the upper left corner position to pos | |
| 176 that.setPosition = function(pos) { | |
| 177 this.x = pos.x; | |
| 178 this.y = pos.y; | |
| 179 return this; | |
| 180 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
181 // adds pos to the position |
| 785 | 182 that.setPt1 = that.setPosition; // TODO: not really the same |
| 183 that.addPosition = function(pos) { | |
| 184 this.x += pos.x; | |
| 185 this.y += pos.y; | |
| 186 return this; | |
| 187 }; | |
| 188 // sets the lower right corner to position pos | |
| 189 that.setPt2 = function(pos) { | |
| 190 this.width = pos.x - this.x; | |
| 191 this.height = pos.y - this.y; | |
| 192 return this; | |
| 193 }; | |
| 194 // returns the center position of this Rectangle | |
| 195 that.getCenter = function() { | |
| 196 return position({ | |
| 197 x : this.x + this.width / 2, | |
| 198 y : this.y + this.height / 2 | |
| 199 }); | |
| 200 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
201 // moves this rectangle's center to position pos |
| 785 | 202 that.setCenter = function(pos) { |
| 203 this.x = pos.x - this.width / 2; | |
| 204 this.y = pos.y - this.height / 2; | |
| 205 return this; | |
| 206 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
207 // returns true if both rectangles have equal position and proportion |
| 785 | 208 that.equals = function(other) { |
| 209 var eq = (this.x === other.x && this.y === other.y && this.width === other.width); | |
| 210 return eq; | |
| 211 }; | |
| 212 // returns the area of this Rectangle | |
| 213 that.getArea = function() { | |
| 214 return (this.width * this.height); | |
| 215 }; | |
| 216 // eliminates negative width and height | |
| 217 that.normalize = function() { | |
| 218 var p = this.getPt2(); | |
| 219 this.x = Math.min(this.x, p.x); | |
| 220 this.y = Math.min(this.y, p.y); | |
| 221 this.width = Math.abs(this.width); | |
| 222 this.height = Math.abs(this.height); | |
| 223 return this; | |
| 224 }; | |
| 225 // returns if Position "pos" lies inside of this rectangle | |
| 226 that.containsPosition = function(pos) { | |
| 227 var ct = ((pos.x >= this.x) && (pos.y >= this.y) | |
| 228 && (pos.x <= this.x + this.width) && (pos.y <= this.y | |
| 229 + this.height)); | |
| 230 return ct; | |
| 231 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
232 // returns true if rectangle "rect" is contained in this rectangle |
| 785 | 233 that.containsRect = function(rect) { |
| 234 return (this.containsPosition(rect.getPt1()) && this | |
| 235 .containsPosition(rect.getPt2())); | |
| 236 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
237 // returns true if rectangle "rect" and this rectangle overlap |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
238 that.overlapsRect = function(rect) { |
| 812 | 239 return this.intersect(rect) != null; |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
240 }; |
| 785 | 241 // changes this rectangle's x/y values so it stays inside of rectangle |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
242 // "rect", keeping the proportions |
| 785 | 243 that.stayInside = function(rect) { |
| 812 | 244 this.x = Math.max(this.x, rect.x); |
| 245 this.y = Math.max(this.y, rect.y); | |
| 785 | 246 if (this.x + this.width > rect.x + rect.width) { |
| 247 this.x = rect.x + rect.width - this.width; | |
| 248 } | |
| 249 if (this.y + this.height > rect.y + rect.height) { | |
| 250 this.y = rect.y + rect.height - this.height; | |
| 251 } | |
| 252 return this; | |
| 253 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
254 // clips this rectangle so it stays inside of rectangle "rect" |
| 785 | 255 that.clipTo = function(rect) { |
| 256 var p1 = rect.getPt1(); | |
| 257 var p2 = rect.getPt2(); | |
| 258 var this2 = this.getPt2(); | |
| 259 this.setPosition(position(Math.max(this.x, p1.x), Math.max(this.y, p1.y))); | |
| 260 this.setPt2(position(Math.min(this2.x, p2.x), Math.min(this2.y, p2.y))); | |
| 261 return this; | |
| 262 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
263 // returns the intersection of rectangle "rect" and this one |
| 785 | 264 that.intersect = function(rect) { |
| 847 | 265 var r = rect.copy(); |
| 266 var result = r.clipTo(this); | |
| 267 if (result.width < 0 || result.height < 0) result = null; | |
| 268 return result; | |
| 785 | 269 }; |
| 812 | 270 |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
271 // returns a copy of rectangle "rect" that fits into this one |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
272 // (moving it first) |
| 785 | 273 that.fit = function(rect) { |
| 847 | 274 var r = rect.copy(); |
| 275 r.x = Math.max(r.x, this.x); | |
| 276 r.y = Math.max(r.y, this.x); | |
| 277 if (r.x + r.width > this.x + this.width) { | |
| 278 r.x = this.x + this.width - r.width; | |
| 785 | 279 } |
| 847 | 280 if (r.y + r.height > this.y + this.height) { |
| 281 r.y = this.y + this.height - r.height; | |
| 785 | 282 } |
| 847 | 283 return r.intersect(this); |
| 785 | 284 }; |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
285 // adjusts position and size of jQuery element "$elem" to this rectangle |
| 785 | 286 that.adjustDiv = function($elem) { |
| 287 $elem.offset({ | |
| 288 left : this.x, | |
| 289 top : this.y | |
| 290 }); | |
| 291 $elem.width(this.width).height(this.height); | |
| 292 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
293 // returns position and size of this rectangle in css-compatible format |
| 785 | 294 that.getAsCss = function() { |
| 295 return { | |
| 296 left : this.x, | |
| 297 top : this.y, | |
| 298 width : this.width, | |
| 299 height : this.height | |
| 300 }; | |
| 301 }; | |
|
807
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
302 // returns position and size of this rectangle formatted for SVG attributes |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
303 that.getAsSvg = function() { |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
304 return [this.x, this.y, this.width, this.height].join(" "); |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
305 }; |
|
1b1728926534
geometry: overlapsRect() plus some comment clarifications
hertzhaft
parents:
793
diff
changeset
|
306 // returns size and position of this rectangle formatted for ??? (w x h@x,y) |
| 785 | 307 that.toString = function() { |
| 308 return this.width + "x" + this.height + "@" + this.x + "," + this.y; | |
| 309 }; | |
| 310 return that; | |
| 311 }; | |
| 312 | |
| 313 /* | |
| 314 * Transform class | |
| 315 * | |
| 316 * defines a class of affine transformations | |
| 317 */ | |
| 318 var transform = function(spec) { | |
| 319 var that = { | |
| 320 m00 : 1.0, | |
| 321 m01 : 0.0, | |
| 322 m02 : 0.0, | |
| 323 m10 : 0.0, | |
| 324 m11 : 1.0, | |
| 325 m12 : 0.0, | |
| 326 m20 : 0.0, | |
| 327 m21 : 0.0, | |
| 328 m22 : 1.0 | |
| 329 }; | |
| 330 if (spec) { | |
| 331 jQuery.extend(that, spec); | |
| 332 } | |
| 333 ; | |
| 334 that.concat = function(trafA) { | |
| 335 // add Transform trafA to this Transform (i.e. this = trafC = trafA | |
| 336 // * this) | |
| 337 var trafC = {}; | |
| 338 for ( var i = 0; i < 3; i++) { | |
| 339 for ( var j = 0; j < 3; j++) { | |
| 340 var c = 0.0; | |
| 341 for ( var k = 0; k < 3; k++) { | |
| 342 c += trafA["m" + i + k] * this["m" + k + j]; | |
| 343 } | |
| 344 trafC["m" + i + j] = c; | |
| 345 } | |
| 346 } | |
| 347 jQuery.extend(this, trafC); | |
| 348 return this; | |
| 349 }; | |
| 350 that.transform = function(rect) { | |
| 351 // returns transformed Rectangle or Position with this Transform | |
| 352 // applied | |
| 353 var x = this.m00 * rect.x + this.m01 * rect.y + this.m02; | |
| 354 var y = this.m10 * rect.x + this.m11 * rect.y + this.m12; | |
| 355 var pt = position(x, y); | |
| 356 if (rect.width) { | |
| 357 // transform the other corner point | |
| 358 var pt2 = this.transform(rect.getPt2()); | |
| 359 return rectangle(pt, pt2); | |
| 360 } | |
| 361 return pt; | |
| 362 }; | |
| 363 that.invtransform = function(rect) { | |
| 364 // returns transformed Rectangle or Position with the inverse of | |
| 365 // this Transform applied | |
| 366 var det = this.m00 * this.m11 - this.m01 * this.m10; | |
| 367 var x = (this.m11 * rect.x - this.m01 * rect.y - this.m11 | |
| 368 * this.m02 + this.m01 * this.m12) | |
| 369 / det; | |
| 370 var y = (-this.m10 * rect.x + this.m00 * rect.y + this.m10 | |
| 371 * this.m02 - this.m00 * this.m12) | |
| 372 / det; | |
| 373 var pt = position(x, y); | |
| 374 if (rect.width) { | |
| 375 // transform the other corner point | |
| 376 var pt2 = this.invtransform(rect.getPt2()); | |
| 377 return rectangle(pt, pt2); | |
| 378 } | |
| 379 return pt; | |
| 380 }; | |
| 381 that.toString = function(pretty) { | |
| 382 var s = '['; | |
| 383 if (pretty) | |
| 384 s += '\n'; | |
| 385 for ( var i = 0; i < 3; ++i) { | |
| 386 s += '['; | |
| 387 for ( var j = 0; j < 3; ++j) { | |
| 388 if (j) | |
| 389 s += ','; | |
| 390 s += this['m' + i + j]; | |
| 391 } | |
| 392 s += ']'; | |
| 393 if (pretty) | |
| 394 s += '\n'; | |
| 395 } | |
| 396 s += ']'; | |
| 397 if (pretty) | |
| 398 s += '\n'; | |
| 399 return s; | |
| 400 }; | |
| 401 // add class methods to instance | |
| 402 that.getRotation = transform.getRotation; | |
| 403 that.getRotationAround = transform.getRotationAround; | |
| 404 that.getTranslation = transform.getTranslation; | |
| 405 that.getMirror = transform.getMirror; | |
| 406 that.getScale = transform.getScale; | |
| 407 | |
| 408 return that; | |
| 409 }; | |
| 410 | |
| 411 transform.getRotation = function(angle) { | |
| 412 // returns a Transform that is a rotation by angle degrees around [0,0] | |
| 413 if (angle !== 0) { | |
| 414 var t = Math.PI * parseFloat(angle) / 180.0; | |
| 415 var cost = Math.cos(t); | |
| 416 var sint = Math.sin(t); | |
| 417 var traf = { | |
| 418 m00 : cost, | |
| 419 m01 : -sint, | |
| 420 m10 : sint, | |
| 421 m11 : cost | |
| 422 }; | |
| 423 return transform(traf); | |
| 424 } | |
| 425 return transform(); | |
| 426 }; | |
| 427 | |
| 428 transform.getRotationAround = function(angle, pos) { | |
| 429 // returns a Transform that is a rotation by angle degrees around pos | |
| 430 var traf = transform.getTranslation(pos.neg()); | |
| 431 traf.concat(transform.getRotation(angle)); | |
| 432 traf.concat(transform.getTranslation(pos)); | |
| 433 return traf; | |
| 434 }; | |
| 435 | |
| 436 transform.getTranslation = function(pos) { | |
| 437 // returns a Transform that is a translation by [pos.x, pos,y] | |
| 438 var traf = { | |
| 439 m02 : pos.x, | |
| 440 m12 : pos.y | |
| 441 }; | |
| 442 return transform(traf); | |
| 443 }; | |
| 444 | |
| 445 transform.getMirror = function(type) { | |
| 446 // returns a Transform that is a mirror about the axis type | |
| 447 if (type === 'x') { | |
| 448 var traf = { | |
| 449 m00 : 1, | |
| 450 m11 : -1 | |
| 451 }; | |
| 452 } else { | |
| 453 var traf = { | |
| 454 m00 : -1, | |
| 455 m11 : 1 | |
| 456 }; | |
| 457 } | |
| 458 return transform(traf); | |
| 459 }; | |
| 460 | |
| 461 transform.getScale = function(size) { | |
| 462 // returns a Transform that is a scale by [size.width, size.height] | |
| 463 var traf = { | |
| 464 m00 : size.width, | |
| 465 m11 : size.height | |
| 466 }; | |
| 467 return transform(traf); | |
| 468 }; | |
| 469 | |
| 786 | 470 // export constructor functions to digilib plugin |
|
793
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
471 var geometry = { |
| 786 | 472 size : size, |
| 473 position : position, | |
| 474 rectangle : rectangle, | |
| 475 transform : transform | |
|
793
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
476 }; |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
477 // install function called by digilib on plugin object |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
478 var install = function() { |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
479 // add constructor object to fn |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
480 this.fn.geometry = geometry; |
| 785 | 481 }; |
|
793
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
482 // digilib plugin object |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
483 var plugin = { |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
484 name : 'geometry', |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
485 install : install, |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
486 fn : {}, |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
487 // TODO: remove old init |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
488 init : init |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
489 }; |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
490 // TODO: remove old version of init returning contructor |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
491 var init = function () { |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
492 return geometry; |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
493 }; |
|
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
494 // plug into digilib |
| 786 | 495 if ($.fn.digilib == null) { |
| 496 $.error("jquery.digilib.geometry must be loaded after jquery.digilib!"); | |
| 497 } else { | |
|
793
63c1b33e38b1
documentation for new plugin api in jquery-digilib-plugin.txt.
robcast
parents:
788
diff
changeset
|
498 $.fn.digilib('plugin', plugin); |
| 786 | 499 } |
| 785 | 500 })(jQuery); |