API  0.9.10
CGContext.j
Go to the documentation of this file.
1 /*
2  * CGContext.j
3  * AppKit
4  *
5  * Created by Francisco Tolmasky.
6  * Copyright 2008, 280 North, Inc.
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 
24 @typedef CGContext
25 
29 
33 
39 
72 
83 function CGContextRelease()
84 {
85 }
86 
93 function CGContextRetain(aContext)
94 {
95  return aContext;
96 }
97 
101 // BEGIN CANVAS IF
103 {
112 function CGGStateCreate()
113 {
114  return { alpha:1.0, strokeStyle:"#000", fillStyle:"#ccc", lineWidth:1.0, lineJoin:kCGLineJoinMiter, lineCap:kCGLineCapButt, miterLimit:10.0, globalAlpha:1.0,
115  blendMode:kCGBlendModeNormal,
116  shadowOffset:CGSizeMakeZero(), shadowBlur:0.0, shadowColor:NULL, CTM:CGAffineTransformMakeIdentity() };
117 }
118 
124 function CGGStateCreateCopy(aGState)
125 {
126  return { alpha:aGState.alpha, strokeStyle:aGState.strokeStyle, fillStyle:aGState.fillStyle, lineWidth:aGState.lineWidth,
127  lineJoin:aGState.lineJoin, lineCap:aGState.lineCap, miterLimit:aGState.miterLimit, globalAlpha:aGState.globalAlpha,
128  blendMode:aGState.blendMode,
129  shadowOffset:CGSizeMakeCopy(aGState.shadowOffset), shadowBlur:aGState.shadowBlur, shadowColor:aGState.shadowColor, CTM:CGAffineTransformMakeCopy(aGState.CTM) };
130 }
131 
137 {
138  return { DOMElement:document.createElement("div"), path:NULL, gState:CGGStateCreate(), gStateStack:[] };
139 }
140 
146 function CGContextSaveGState(aContext)
147 {
148  aContext.gStateStack.push(CGGStateCreateCopy(aContext.gState));
149 }
150 
156 function CGContextRestoreGState(aContext)
157 {
158  aContext.gState = aContext.gStateStack.pop();
159 }
160 
161 function CGContextSetLineCap(aContext, aLineCap)
162 {
163  aContext.gState.lineCap = aLineCap;
164 }
165 
166 function CGContextSetLineDash(aContext, aPhase, someDashes)
167 {
168  aContext.gState.lineDashes = someDashes;
169  aContext.gState.lineDashesPhase = aPhase;
170 }
171 
172 function CGContextSetLineJoin(aContext, aLineJoin)
173 {
174  aContext.gState.lineJoin = aLineJoin;
175 }
176 
177 function CGContextSetLineWidth(aContext, aLineWidth)
178 {
179  aContext.gState.lineWidth = aLineWidth;
180 }
181 
182 function CGContextSetMiterLimit(aContext, aMiterLimit)
183 {
184  aContext.gState.miterLimit = aMiterLimit;
185 }
186 
187 function CGContextSetBlendMode(aContext, aBlendMode)
188 {
189  aContext.gState.blendMode = aBlendMode;
190 }
191 
192 function CGContextAddArc(aContext, x, y, radius, startAngle, endAngle, clockwise)
193 {
194  CGPathAddArc(aContext.path, aContext.gState.CTM, x, y, radius, startAngle, endAngle, clockwise);
195 }
196 
207 function CGContextAddArcToPoint(aContext, x1, y1, x2, y2, radius)
208 {
209  CGPathAddArcToPoint(aContext.path, aContext.gState.CTM, x1, y1, x2, y2, radius);
210 }
211 
223 function CGContextAddCurveToPoint(aContext, cp1x, cp1y, cp2x, cp2y, x, y)
224 {
225  CGPathAddCurveToPoint(aContext.path, aContext.gState.CTM, cp1x, cp1y, cp2x, cp2y, x, y);
226 }
227 
235 function CGContextAddLines(aContext, points, count)
236 {
237  CGPathAddLines(aContext.path, aContext.gState.CTM, points, count);
238 }
239 
247 function CGContextAddLineToPoint(aContext, x, y)
248 {
249  CGPathAddLineToPoint(aContext.path, aContext.gState.CTM, x, y);
250 }
251 
258 function CGContextAddPath(aContext, aPath)
259 {
260  if (!aContext || CGPathIsEmpty(aPath))
261  return;
262 
263  if (!aContext.path)
264  aContext.path = CGPathCreateMutable();
265 
266  CGPathAddPath(aContext.path, aContext.gState.CTM, aPath);
267 }
268 
278 function CGContextAddQuadCurveToPoint(aContext, cpx, cpy, x, y)
279 {
280  CGPathAddQuadCurveToPoint(aContext.path, aContext.gState.CTM, cpx, cpy, x, y);
281 }
282 
289 function CGContextAddRect(aContext, aRect)
290 {
291  CGPathAddRect(aContext.path, aContext.gState.CTM, aRect);
292 }
293 
301 function CGContextAddRects(aContext, rects, count)
302 {
303  CGPathAddRects(aContext.path, aContext.gState.CTM, rects, count);
304 }
305 
311 function CGContextBeginPath(aContext)
312 {
313  // This clears any previous path.
314  aContext.path = CGPathCreateMutable();
315 }
316 
322 function CGContextClosePath(aContext)
323 {
324  CGPathCloseSubpath(aContext.path);
325 }
326 
332 function CGContextIsPathEmpty(aContext)
333 {
334  return (!aContext.path || CGPathIsEmpty(aContext.path));
335 }
336 
344 function CGContextMoveToPoint(aContext, x, y)
345 {
346  if (!aContext.path)
347  aContext.path = CGPathCreateMutable();
348 
349  CGPathMoveToPoint(aContext.path, aContext.gState.CTM, x, y);
350 }
351 
358 function CGContextFillRect(aContext, aRect)
359 {
360  CGContextFillRects(aContext, [aRect], 1);
361 }
362 
370 function CGContextFillRects(aContext, rects, count)
371 {
372  if (arguments[2] === undefined)
373  var count = rects.length;
374 
375  CGContextBeginPath(aContext);
376  CGContextAddRects(aContext, rects, count);
377  CGContextClosePath(aContext);
378 
379  CGContextDrawPath(aContext, kCGPathFill);
380 }
381 
388 function CGContextStrokeRect(aContext, aRect)
389 {
390  CGContextBeginPath(aContext);
391  CGContextAddRect(aContext, aRect);
392  CGContextClosePath(aContext);
393 
394  CGContextDrawPath(aContext, kCGPathStroke);
395 }
396 
404 function CGContextStrokeRectWithWidth(aContext, aRect, aWidth)
405 {
406  CGContextSaveGState(aContext);
407 
408  CGContextSetLineWidth(aContext, aWidth);
409  CGContextStrokeRect(aContext, aRect);
410 
411  CGContextRestoreGState(aContext);
412 }
413 
420 function CGContextConcatCTM(aContext, aTransform)
421 {
422  var CTM = aContext.gState.CTM;
423 
424  CGAffineTransformConcatTo(CTM, aTransform, CTM);
425 }
426 
432 function CGContextGetCTM(aContext)
433 {
434  return aContext.gState.CTM;
435 }
436 
444 function CGContextRotateCTM(aContext, anAngle)
445 {
446  var gState = aContext.gState;
447 
448  gState.CTM = CGAffineTransformRotate(gState.CTM, anAngle);
449 }
450 
458 function CGContextScaleCTM(aContext, sx, sy)
459 {
460  var gState = aContext.gState;
461 
462  gState.CTM = CGAffineTransformScale(gState.CTM, sx, sy);
463 }
464 
472 function CGContextTranslateCTM(aContext, tx, ty)
473 {
474  var gState = aContext.gState;
475 
476  gState.CTM = CGAffineTransformTranslate(gState.CTM, tx, ty);
477 }
478 
487 function CGContextSetShadow(aContext, aSize, aBlur)
488 {
489  var gState = aContext.gState;
490 
491  gState.shadowOffset = CGSizeMakeCopy(aSize);
492  gState.shadowBlur = aBlur;
493  gState.shadowColor = [CPColor shadowColor];
494 }
495 
504 function CGContextSetShadowWithColor(aContext, aSize, aBlur, aColor)
505 {
506  var gState = aContext.gState;
507 
508  gState.shadowOffset = CGSizeMakeCopy(aSize);
509  gState.shadowBlur = aBlur;
510  gState.shadowColor = aColor;
511 }
512 
519 function CGContextSetAlpha(aContext, anAlpha)
520 {
521  aContext.gState.alpha = MAX(MIN(anAlpha, 1.0), 0.0);
522 }
523 
527 } // END CANVAS IF
532 // GOOD.
538 function CGContextEOFillPath(aContext)
539 {
540  CGContextDrawPath(aContext, kCGPathEOFill);
541 }
542 
548 function CGContextFillPath(aContext)
549 {
550  CGContextDrawPath(aContext, kCGPathFill);
551  CGContextClosePath(aContext);
552 }
553 
561 function CGContextStrokeRectWithWidth(aContext, aRect, aWidth)
562 {
563  CGContextSaveGState(aContext);
564 
565  CGContextSetLineWidth(aContext, aWidth);
566  CGContextStrokeRect(aContext, aRect);
567 
568  CGContextRestoreGState(aContext);
569 }
570 
571 var KAPPA = 4.0 * ((SQRT2 - 1.0) / 3.0);
572 
579 function CGContextAddEllipseInRect(aContext, aRect)
580 {
581  CGContextBeginPath(aContext);
582  CGContextAddPath(aContext, CGPathWithEllipseInRect(aRect));
583  CGContextClosePath(aContext);
584 }
585 
592 function CGContextFillEllipseInRect(aContext, aRect)
593 {
594  CGContextBeginPath(aContext);
595  CGContextAddEllipseInRect(aContext, aRect);
596  CGContextClosePath(aContext);
597  CGContextFillPath(aContext);
598 }
599 
606 function CGContextStrokeEllipseInRect(aContext, aRect)
607 {
608  CGContextBeginPath(aContext);
609  CGContextAddEllipseInRect(aContext, aRect);
610  CGContextClosePath(aContext);
611  CGContextStrokePath(aContext);
612 }
613 
619 function CGContextStrokePath(aContext)
620 {
621  CGContextDrawPath(aContext, kCGPathStroke);
622  CGContextClosePath(aContext);
623 }
624 
635 function CGContextStrokeLineSegments(aContext, points, count)
636 {
637  var i = 0;
638 
639  if (count === NULL)
640  var count = points.length;
641 
642  CGContextBeginPath(aContext);
643 
644  for (; i < count; i += 2)
645  {
646  CGContextMoveToPoint(aContext, points[i].x, points[i].y);
647  CGContextAddLineToPoint(aContext, points[i + 1].x, points[i + 1].y);
648  }
649 
650  CGContextStrokePath(aContext);
651 }
652 
653 
654 //FIXME: THIS IS WRONG!!!
655 
663 function CGContextSetFillColor(aContext, aColor)
664 {
665  if (aColor)
666  aContext.gState.fillStyle = [aColor cssString];
667 }
668 
675 function CGContextSetStrokeColor(aContext, aColor)
676 {
677  if (aColor)
678  aContext.gState.strokeStyle = [aColor cssString];
679 }
680 
692 function CGContextFillRoundedRectangleInRect(aContext, aRect, aRadius, ne, se, sw, nw)
693 {
694  CGContextBeginPath(aContext);
695  CGContextAddPath(aContext, CGPathWithRoundedRectangleInRect(aRect, aRadius, aRadius, ne, se, sw, nw));
696  CGContextClosePath(aContext);
697  CGContextFillPath(aContext);
698 }
699 
711 function CGContextStrokeRoundedRectangleInRect(aContext, aRect, aRadius, ne, se, sw, nw)
712 {
713  CGContextBeginPath(aContext);
714  CGContextAddPath(aContext, CGPathWithRoundedRectangleInRect(aRect, aRadius, aRadius, ne, se, sw, nw));
715  CGContextClosePath(aContext);
716  CGContextStrokePath(aContext);
717 }
718 
727 {
728 #include "CGContextCanvas.j"
729 }
731 {
732 #include "CGContextVML.j"
733 }
734 else
735 {
736  // I have declared these functions here to make it compile without warnings with the new compiler under rhino.
737  CGContextClearRect = CGContextDrawLinearGradient = CGContextClip = CGContextClipToRect = CGContextDrawImage = function() {throw new Error("function is not declared in this environment")}
738 }
function CGContextSetBlendMode(aContext, aBlendMode)
Definition: CGContext.j:187
kCGBlendModeColorBurn
Definition: CGContext.j:51
function CGContextTranslateCTM(aContext, tx, ty)
Definition: CGContext.j:472
function CGContextSetShadowWithColor(aContext, aSize, aBlur, aColor)
Definition: CGContext.j:504
function CGContextStrokeEllipseInRect(aContext, aRect)
Definition: CGContext.j:606
function CGGStateCreate()
Definition: CGContext.j:112
function CGPathWithRoundedRectangleInRect(aRect, xRadius, yRadius, ne, se, sw, nw)
Definition: CGPath.j:355
kCGBlendModeLighten
Definition: CGContext.j:49
function CGContextDrawImage(aContext, aRect, anImage)
function CGContextAddRects(aContext, rects, count)
Definition: CGContext.j:301
function CGAffineTransformMakeIdentity()
function CGAffineTransformRotate(aTransform, anAngle)
function CGContextAddArcToPoint(aContext, x1, y1, x2, y2, radius)
Definition: CGContext.j:207
function CGContextFillEllipseInRect(aContext, aRect)
Definition: CGContext.j:592
function CGPathCloseSubpath(aPath)
Definition: CGPath.j:402
kCGBlendModePlusLighter
Definition: CGContext.j:71
function CGContextDrawLinearGradient(aContext, aGradient, aStartPoint, anEndPoint, options)
kCGPathEOFill
Definition: CGContext.j:35
function CGPathAddRects(aPath, aTransform, rects, count)
Definition: CGPath.j:284
function CGContextSetStrokeColor(aContext, aColor)
Definition: CGContext.j:675
function CGContextSetMiterLimit(aContext, aMiterLimit)
Definition: CGContext.j:182
function CGContextSetLineJoin(aContext, aLineJoin)
Definition: CGContext.j:172
kCGBlendModeHue
Definition: CGContext.j:56
function CGContextScaleCTM(aContext, sx, sy)
Definition: CGContext.j:458
function CGContextRestoreGState(aContext)
Definition: CGContext.j:156
function CGAffineTransformMakeCopy(anAffineTransform)
function CGContextSetShadow(aContext, aSize, aBlur)
Definition: CGContext.j:487
CPColor shadowColor()
Definition: CPColor.j:438
kCGBlendModeExclusion
Definition: CGContext.j:55
function CGContextSetLineCap(aContext, aLineCap)
Definition: CGContext.j:161
CGContext kCGLineCapButt
Definition: CGContext.j:26
function CGContextStrokeLineSegments(aContext, points, count)
Definition: CGContext.j:635
function CGContextDrawPath(aContext, aMode)
Definition: CGContextVML.j:119
kCGBlendModeDestinationAtop
Definition: CGContext.j:68
kCGBlendModeLuminosity
Definition: CGContext.j:59
function CGContextAddLineToPoint(aContext, x, y)
Definition: CGContext.j:247
function CGContextAddArc(aContext, x, y, radius, startAngle, endAngle, clockwise)
Definition: CGContext.j:192
function CGContextStrokePath(aContext)
Definition: CGContext.j:619
function CGContextAddEllipseInRect(aContext, aRect)
Definition: CGContext.j:579
function CGContextSetLineWidth(aContext, aLineWidth)
Definition: CGContext.j:177
function CGContextClosePath(aContext)
Definition: CGContext.j:322
kCGPathFillStroke
Definition: CGContext.j:37
function CGPathMoveToPoint(aPath, aTransform, x, y)
Definition: CGPath.j:304
kCGLineJoinMiter
Definition: CGContext.j:30
kCGLineJoinRound
Definition: CGContext.j:31
kCGBlendModeDifference
Definition: CGContext.j:54
function CGContextFillRects(aContext, rects, count)
Definition: CGContext.j:370
function CGPathAddLines(aPath, aTransform, points, count)
Definition: CGPath.j:190
function CGContextSetLineDash(aContext, aPhase, someDashes)
Definition: CGContext.j:166
kCGPathEOFillStroke
Definition: CGContext.j:38
kCGBlendModeSoftLight
Definition: CGContext.j:52
function CGPathAddCurveToPoint(aPath, aTransform, cp1x, cp1y, cp2x, cp2y, x, y)
Definition: CGPath.j:173
function CGContextRelease()
Definition: CGContext.j:83
function CGContextStrokeRectWithWidth(aContext, aRect, aWidth)
Definition: CGContext.j:404
kCGBlendModeNormal
Definition: CGContext.j:44
function CGContextAddPath(aContext, aPath)
Definition: CGContext.j:258
function CGAffineTransformScale(aTransform, sx, sy)
function CGContextSetAlpha(aContext, anAlpha)
Definition: CGContext.j:519
function CPFeatureIsCompatible(aFeature)
function CGPathWithEllipseInRect(aRect)
Definition: CGPath.j:331
kCGBlendModeDestinationIn
Definition: CGContext.j:66
function CGPathIsEmpty(aPath)
Definition: CGPath.j:505
var KAPPA
Definition: CGContext.j:571
function CGContextSetFillColor(aContext, aColor)
Definition: CGContext.j:663
function CGPathAddArc(aPath, aTransform, x, y, aRadius, aStartAngle, anEndAngle, isClockwise)
Definition: CGPath.j:79
function CGContextRotateCTM(aContext, anAngle)
Definition: CGContext.j:444
kCGBlendModePlusDarker
Definition: CGContext.j:70
kCGBlendModeXOR
Definition: CGContext.j:69
kCGPathStroke
Definition: CGContext.j:36
function CGContextStrokeRoundedRectangleInRect(aContext, aRect, aRadius, ne, se, sw, nw)
Definition: CGContext.j:711
function CGContextBeginPath(aContext)
Definition: CGContext.j:311
function CGPathCreateMutable()
Definition: CGPath.j:43
function CGContextClearRect(aContext, aRect)
Definition: CGContextVML.j:51
kCGBlendModeColor
Definition: CGContext.j:58
CPHTMLCanvasFeature
function CGContextRetain(aContext)
Definition: CGContext.j:93
function CGAffineTransformConcatTo(lhs, rhs, to)
function CGGStateCreateCopy(aGState)
Definition: CGContext.j:124
function CGPathAddRect(aPath, aTransform, aRect)
Definition: CGPath.j:279
kCGBlendModeOverlay
Definition: CGContext.j:47
kCGBlendModeClear
Definition: CGContext.j:60
kCGBlendModeDestinationOut
Definition: CGContext.j:67
function CGContextIsPathEmpty(aContext)
Definition: CGContext.j:332
function CGContextAddCurveToPoint(aContext, cp1x, cp1y, cp2x, cp2y, x, y)
Definition: CGContext.j:223
function CGContextStrokeRect(aContext, aRect)
Definition: CGContext.j:388
function CGContextSaveGState(aContext)
Definition: CGContext.j:146
function CGContextEOFillPath(aContext)
Definition: CGContext.j:538
CPVMLFeature
kCGLineJoinBevel
Definition: CGContext.j:32
kCGBlendModeSourceIn
Definition: CGContext.j:62
kCGBlendModeHardLight
Definition: CGContext.j:53
function CGContextFillRoundedRectangleInRect(aContext, aRect, aRadius, ne, se, sw, nw)
Definition: CGContext.j:692
kCGBlendModeScreen
Definition: CGContext.j:46
function CGContextFillRect(aContext, aRect)
Definition: CGContext.j:358
function CGPathAddLineToPoint(aPath, aTransform, x, y)
Definition: CGPath.j:204
function CGContextConcatCTM(aContext, aTransform)
Definition: CGContext.j:420
kCGBlendModeCopy
Definition: CGContext.j:61
kCGLineCapRound
Definition: CGContext.j:27
kCGBlendModeSourceOut
Definition: CGContext.j:63
kCGBlendModeDarken
Definition: CGContext.j:48
kCGBlendModeColorDodge
Definition: CGContext.j:50
function CGContextFillPath(aContext)
Definition: CGContext.j:548
function CGBitmapGraphicsContextCreate()
Definition: CGContext.j:136
kCGBlendModeMultiply
Definition: CGContext.j:45
function CGContextMoveToPoint(aContext, x, y)
Definition: CGContext.j:344
function CGPathAddPath(aPath, aTransform, anotherPath)
Definition: CGPath.j:215
kCGBlendModeDestinationOver
Definition: CGContext.j:65
kCGPathFill
Definition: CGContext.j:34
function CGPathAddArcToPoint(aPath, aTransform, x1, y1, x2, y2, aRadius)
Definition: CGPath.j:143
kCGLineCapSquare
Definition: CGContext.j:28
kCGBlendModeSourceAtop
Definition: CGContext.j:64
function CGContextAddRect(aContext, aRect)
Definition: CGContext.j:289
function CGContextAddLines(aContext, points, count)
Definition: CGContext.j:235
function CGPathAddQuadCurveToPoint(aPath, aTransform, cpx, cpy, x, y)
Definition: CGPath.j:264
function CGContextGetCTM(aContext)
Definition: CGContext.j:432
function CGContextAddQuadCurveToPoint(aContext, cpx, cpy, x, y)
Definition: CGContext.j:278
function CGAffineTransformTranslate(aTransform, tx, ty)
kCGBlendModeSaturation
Definition: CGContext.j:57