1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
// Copyright 2007 The Closure Library Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS-IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
/**
* @fileoverview Graphics utility functions and factory methods.
* @author arv@google.com (Erik Arvidsson)
* @see ../demos/graphics/advancedcoordinates.html
* @see ../demos/graphics/advancedcoordinates2.html
* @see ../demos/graphics/basicelements.html
* @see ../demos/graphics/events.html
* @see ../demos/graphics/modifyelements.html
* @see ../demos/graphics/tiger.html
*/
goog.provide('goog.graphics');
goog.require('goog.dom');
goog.require('goog.graphics.CanvasGraphics');
goog.require('goog.graphics.SvgGraphics');
goog.require('goog.graphics.VmlGraphics');
goog.require('goog.userAgent');
/**
* Returns an instance of goog.graphics.AbstractGraphics that knows how to draw
* for the current platform (A factory for the proper Graphics implementation)
* @param {string|number} width The width in pixels. Strings
* expressing percentages of parent with (e.g. '80%') are also accepted.
* @param {string|number} height The height in pixels. Strings
* expressing percentages of parent with (e.g. '80%') are also accepted.
* @param {?number=} opt_coordWidth The optional coordinate width - if
* omitted or null, defaults to same as width.
* @param {?number=} opt_coordHeight The optional coordinate height - if
* omitted or null, defaults to same as height.
* @param {goog.dom.DomHelper=} opt_domHelper The DOM helper object for the
* document we want to render in.
* @return {!goog.graphics.AbstractGraphics} The created instance.
* @deprecated goog.graphics is deprecated. It existed to abstract over browser
* differences before the canvas tag was widely supported. See
* http://en.wikipedia.org/wiki/Canvas_element for details.
*/
goog.graphics.createGraphics = function(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper) {
var graphics;
// On IE9 and above, SVG is available, except in compatibility mode.
// We check createElementNS on document object that is not exist in
// compatibility mode.
if (goog.userAgent.IE && (!goog.userAgent.isVersionOrHigher('9') ||
!(opt_domHelper || goog.dom.getDomHelper())
.getDocument()
.createElementNS)) {
graphics = new goog.graphics.VmlGraphics(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper);
} else if (
goog.userAgent.WEBKIT &&
(!goog.userAgent.isVersionOrHigher('420') || goog.userAgent.MOBILE)) {
graphics = new goog.graphics.CanvasGraphics(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper);
} else {
graphics = new goog.graphics.SvgGraphics(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper);
}
// Create the dom now, because all drawing methods require that the
// main dom element (the canvas) has been already created.
graphics.createDom();
return graphics;
};
/**
* Returns an instance of goog.graphics.AbstractGraphics that knows how to draw
* for the current platform (A factory for the proper Graphics implementation)
* @param {string|number} width The width in pixels. Strings
* expressing percentages of parent with (e.g. '80%') are also accepted.
* @param {string|number} height The height in pixels. Strings
* expressing percentages of parent with (e.g. '80%') are also accepted.
* @param {?number=} opt_coordWidth The optional coordinate width, defaults to
* same as width.
* @param {?number=} opt_coordHeight The optional coordinate height, defaults to
* same as height.
* @param {goog.dom.DomHelper=} opt_domHelper The DOM helper object for the
* document we want to render in.
* @return {!goog.graphics.AbstractGraphics} The created instance.
* @deprecated goog.graphics is deprecated. It existed to abstract over browser
* differences before the canvas tag was widely supported. See
* http://en.wikipedia.org/wiki/Canvas_element for details.
*/
goog.graphics.createSimpleGraphics = function(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper) {
if (goog.userAgent.MAC && goog.userAgent.GECKO &&
!goog.userAgent.isVersionOrHigher('1.9a')) {
// Canvas is 6x faster than SVG on Mac FF 2.0
var graphics = new goog.graphics.CanvasGraphics(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper);
graphics.createDom();
return graphics;
}
// Otherwise, defer to normal graphics object creation.
return goog.graphics.createGraphics(
width, height, opt_coordWidth, opt_coordHeight, opt_domHelper);
};
/**
* Static function to check if the current browser has Graphics support.
* @return {boolean} True if the current browser has Graphics support.
* @deprecated goog.graphics is deprecated. It existed to abstract over browser
* differences before the canvas tag was widely supported. See
* http://en.wikipedia.org/wiki/Canvas_element for details.
*/
goog.graphics.isBrowserSupported = function() {
if (goog.userAgent.IE) {
return goog.userAgent.isVersionOrHigher('5.5');
}
if (goog.userAgent.GECKO) {
return goog.userAgent.isVersionOrHigher('1.8');
}
if (goog.userAgent.OPERA) {
return goog.userAgent.isVersionOrHigher('9.0');
}
if (goog.userAgent.WEBKIT) {
return goog.userAgent.isVersionOrHigher('412');
}
return false;
};
|
