This is an automated email from the ASF dual-hosted git repository.
wangdd pushed a commit to branch gl-en
in repository https://gitbox.apache.org/repos/asf/incubator-echarts-doc.git
The following commit(s) were added to refs/heads/gl-en by this push:
new a68dd79 doc: fix gl cn ( part of cn/option-gl/...)
a68dd79 is described below
commit a68dd791e02194174a393fac692964c71847459e
Author: Wdingding <[email protected]>
AuthorDate: Mon Sep 23 13:37:03 2019 +0800
doc: fix gl cn ( part of cn/option-gl/...)
---
cn/option-gl/component/axis3D-axis-common.md | 8 +--
cn/option-gl/component/axis3D-common.md | 4 +-
cn/option-gl/component/globe.md | 2 +-
cn/option-gl/component/grid3D.md | 2 +-
cn/option-gl/component/mapbox3D.md | 2 +-
cn/option-gl/partial/formatter.md | 78 +++++++++++++++++++++++++
cn/option-gl/partial/label.md | 15 ++---
cn/option-gl/partial/post-effect.md | 16 ++---
cn/option-gl/partial/series-name.md | 2 +-
cn/option-gl/partial/shading.md | 4 +-
cn/option-gl/partial/temporal-super-sampling.md | 2 +-
cn/option-gl/partial/view-control.md | 6 +-
cn/option-gl/partial/zlevel.md | 2 +-
cn/option-gl/series/bar3D.md | 2 +-
cn/option-gl/series/flowGL.md | 10 ++--
cn/option-gl/series/graphGL.md | 6 +-
cn/option-gl/series/lines3D.md | 2 +-
cn/option-gl/series/polygons3D.md | 4 +-
cn/option-gl/series/series.md | 2 +-
cn/option-gl/series/surface.md | 9 +--
20 files changed, 129 insertions(+), 49 deletions(-)
diff --git a/cn/option-gl/component/axis3D-axis-common.md
b/cn/option-gl/component/axis3D-axis-common.md
index 0e2160f..e17830c 100644
--- a/cn/option-gl/component/axis3D-axis-common.md
+++ b/cn/option-gl/component/axis3D-axis-common.md
@@ -6,7 +6,7 @@
## nameTextStyle(Object)
-坐标轴名称的显示样式。
+坐标轴名称的文字样式。
{{ use: partial-text-style(
prefix='##',
@@ -32,10 +32,10 @@
类目轴，适用于离散的类目数据，为该类型时必须通过 [data](~${componentType}.data) 设置类目数据。
+ `'time'`
-
时间轴，适用于连续的时序数据，与数值轴相比时间轴带有时间的格式化，在刻度计算上也有所不同，例如会根据跨度的范围来决定使用月，星期，日还是小时范围的刻度。
+ 时间轴，适用于连续的时序数据，与数值轴相比时间轴带有时间的格式化，在刻度计算上也有所不同，例如会根据跨度的范围来决定使用月、星期、日、小时范围的刻度。
+ `'log'`
- 对数轴。适用于对数数据。
+ 对数轴，适用于对数数据。
## min(number|string) = null
@@ -53,7 +53,7 @@
可以设置成特殊值 `'dataMax'`，此时取数据在该轴上的最大值作为最大刻度。
-不设置时会自动计算最大值保证坐标轴刻度的均匀分布。
+如果不设置，则会自动计算最大值来保证坐标轴刻度的均匀分布。
在类目轴中，也可以设置为类目的序数（如类目轴 `data: ['类A', '类B', '类C']` 中，序数 `2` 表示
`'类C'`。也可以设置为负数，如 `-3`）。
diff --git a/cn/option-gl/component/axis3D-common.md
b/cn/option-gl/component/axis3D-common.md
index 77c6a71..01da740 100644
--- a/cn/option-gl/component/axis3D-common.md
+++ b/cn/option-gl/component/axis3D-common.md
@@ -163,7 +163,7 @@ textStyle: {
#${prefix|default('#')} splitArea(Object)
坐标轴在 [grid3D](~grid3D) 的平面上的分隔区域。
-##${prefix|default('#')} show(boolean) = ${defaultShow|default(true)}
+##${prefix|default('#')} show(boolean) = ${defaultShow|default(false)}
是否显示分隔区域。
{{ if: ${hasLabelInterval|default(true)} }}
@@ -206,7 +206,7 @@ textStyle: {
###${prefix|default('#')} formatter(Function)
-标签格式器，函数第一个参数是当前坐标轴的数值，第二个参数是所有坐标轴的数值数组
+标签格式器，函数第一个参数是当前坐标轴的数值，第二个参数是所有坐标轴的数值数组。
```js
(value: number, valueAll: Array) => string
diff --git a/cn/option-gl/component/globe.md b/cn/option-gl/component/globe.md
index 6029edc..8827106 100644
--- a/cn/option-gl/component/globe.md
+++ b/cn/option-gl/component/globe.md
@@ -13,7 +13,7 @@
地球的半径。单位相对于三维空间，跟 [viewControl.distance](~globe.viewControl.distance) 相关。
## globeOuterRadius(number) = 150
-地球的外半径。`globeRadius` 到 `globeOuterRadius` 之间这篇区域会被用于展示三维柱状图，散点图等。
+地球的外半径。`globeRadius` 到 `globeOuterRadius` 之间这片区域会被用于展示三维柱状图，散点图等。
{{ use: partial-environment(
componentType="globe",
diff --git a/cn/option-gl/component/grid3D.md b/cn/option-gl/component/grid3D.md
index 3682020..ab90598 100644
--- a/cn/option-gl/component/grid3D.md
+++ b/cn/option-gl/component/grid3D.md
@@ -14,7 +14,7 @@
---
-> **注意：** [xAxis3D](~xAxis3D)，[yAxis3D](~yAxis3D)，[zAxis3D](~zAxis3D)
上单独设置的`axisLine`, `axisTick`, `axisLabel`, `splitLine`, `splitArea`,
`axisPointer`会覆盖`grid3D`下的相应配置项。
+> **注意：** [xAxis3D](~xAxis3D)，[yAxis3D](~yAxis3D)，[zAxis3D](~zAxis3D) 上单独设置的
[axisLine](~xAxis3D.axisLine), [axisTick](~xAxis3D.axisTick),
[axisLabel](~xAxis3D.axisLabel), [splitLine](~xAxis3D.splitLine),
[splitArea](~xAxis3D.splitArea), [axisPointer](~xAxis3D.axisPointer)`
会覆盖[grid3D](~grid3D) 下的相应配置项。
diff --git a/cn/option-gl/component/mapbox3D.md
b/cn/option-gl/component/mapbox3D.md
index e68109d..1c44ac4 100644
--- a/cn/option-gl/component/mapbox3D.md
+++ b/cn/option-gl/component/mapbox3D.md
@@ -55,7 +55,7 @@ Mapbox 地图的旋转角度。见 [https://www.mapbox.com/mapbox-gl-js/style-sp
## pitch(number) = 0
-视角俯视的倾斜角度。默认为`0`，也就是正对着地图。最大`60`。见
[https://www.mapbox.com/mapbox-gl-js/style-spec/#root-pitch](https://www.mapbox.com/mapbox-gl-js/style-spec/#root-pitch)
+视角俯视的倾斜角度。默认为`0`，也就是垂直于地图表面。最大的值是`60`。见
[https://www.mapbox.com/mapbox-gl-js/style-spec/#root-pitch](https://www.mapbox.com/mapbox-gl-js/style-spec/#root-pitch)
## altitudeScale(number) = 1
diff --git a/cn/option-gl/partial/formatter.md
b/cn/option-gl/partial/formatter.md
new file mode 100644
index 0000000..e60ef0a
--- /dev/null
+++ b/cn/option-gl/partial/formatter.md
@@ -0,0 +1,78 @@
+{{ target: partial-formatter-params-structure }}
+
+```js
+{
+ componentType: 'series',
+ // 系列类型
+ seriesType: string,
+ // 系列在传入的 option.series 中的 index
+ seriesIndex: number,
+ // 系列名称
+ seriesName: string,
+ // 数据名，类目名
+ name: string,
+ // 数据在传入的 data 数组中的 index
+ dataIndex: number,
+ // 传入的原始数据项
+ data: Object,
+ // 传入的数据值。在多数系列下它和 data 相同。在一些系列下是 data 中的分量（如 map、radar 中）
+ value: number|Array|Object,
+ // 坐标轴 encode 映射信息，
+ // key 为坐标轴（如 'x' 'y' 'radius' 'angle' 等）
+ // value 必然为数组，不会为 null/undefied，表示 dimension index 。
+ // 其内容如：
+ // {
+ // x: [2] // dimension index 为 2 的数据映射到 x 轴
+ // y: [0] // dimension index 为 0 的数据映射到 y 轴
+ // }
+ encode: Object,
+ // 维度名列表
+ dimensionNames: Array<String>,
+ // 数据的维度 index，如 0 或 1 或 2 ...
+ // 仅在雷达图中使用。
+ dimensionIndex: number,
+ // 数据图形的颜色
+ color: string,
+{{ for: ${extra} as ${obj}, ${name} }}{{ if: ${extra}.hasOwnProperty(${name})
}}
+ // ${obj.desc}
+ ${name}: ${obj.type},
+{{ /if }}{{ /for }}
+}
+```
+
+注：encode 和 dimensionNames 的使用方式，例如：
+
+如果数据为：
+```js
+dataset: {
+ source: [
+ ['Matcha Latte', 43.3, 85.8, 93.7],
+ ['Milk Tea', 83.1, 73.4, 55.1],
+ ['Cheese Cocoa', 86.4, 65.2, 82.5],
+ ['Walnut Brownie', 72.4, 53.9, 39.1]
+ ]
+}
+```
+则可这样得到 y 轴对应的 value：
+```js
+params.value[params.encode.y[0]]
+```
+
+如果数据为：
+```js
+dataset: {
+ dimensions: ['product', '2015', '2016', '2017'],
+ source: [
+ {product: 'Matcha Latte', '2015': 43.3, '2016': 85.8, '2017': 93.7},
+ {product: 'Milk Tea', '2015': 83.1, '2016': 73.4, '2017': 55.1},
+ {product: 'Cheese Cocoa', '2015': 86.4, '2016': 65.2, '2017': 82.5},
+ {product: 'Walnut Brownie', '2015': 72.4, '2016': 53.9, '2017': 39.1}
+ ]
+}
+```
+则可这样得到 y 轴对应的 value：
+```js
+params.value[params.dimensionNames[params.encode.y[0]]]
+```
+
+{{ /target }}
\ No newline at end of file
diff --git a/cn/option-gl/partial/label.md b/cn/option-gl/partial/label.md
index 97b9a71..87b3341 100644
--- a/cn/option-gl/partial/label.md
+++ b/cn/option-gl/partial/label.md
@@ -26,7 +26,7 @@ ${name}文字的字体大小。
${name}文字字体的粗细。
-可选：
+**可选：**
+ `'normal'`
+ `'bold'`
+ `'bolder'`
@@ -34,9 +34,6 @@ ${name}文字字体的粗细。
+ 100 | 200 | 300 | 400...
-
-
-
{{ target: partial-label }}
#${prefix|default('##')} show(boolean) = ${defaultShow|default(false)}
@@ -65,15 +62,19 @@ ${name}文字字体的粗细。
标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用 `\n` 换行。
-**字符串模板**
-模板变量有 `{a}`、`{b}`、`{c}`，分别表示系列名，数据名，数据值。
+**字符串模板**
+
+模板变量有：
++ `{a}`：系列名。
++ `{b}`：数据名。
++ `{c}`：数据值。
**示例：**
```js
formatter: '{b}: {c}'
```
-**回调函数**
+**回调函数**
回调函数格式：
```js
diff --git a/cn/option-gl/partial/post-effect.md
b/cn/option-gl/partial/post-effect.md
index 82b35bd..086d5ab 100644
--- a/cn/option-gl/partial/post-effect.md
+++ b/cn/option-gl/partial/post-effect.md
@@ -2,7 +2,7 @@
#${prefix|default('#')} postEffect(Object)
-后处理特效的相关配置，后处理特效可以为画面添加高光、景深、环境光遮蔽（SSAO）、调色等效果。可以让整个画面更富有质感。
+后处理特效的相关配置。后处理特效可以为画面添加高光、景深、环境光遮蔽（SSAO）、调色等效果。可以让整个画面更富有质感。
下面分别是关闭和开启 `postEffect` 的区别。
@@ -16,7 +16,7 @@
##${prefix|default('#')} enable(boolean) = false
-是否开启后处理特效，默认关闭。
+是否开启后处理特效。默认关闭。
##${prefix|default('#')} bloom(Object)
@@ -34,9 +34,9 @@
##${prefix|default('#')} depthOfField(Object)
-景深效果。景深效果是模拟摄像机的光学成像效果，在对焦的区域相对清晰，原理对焦的区域则会逐渐模糊。
+景深效果。景深效果是模拟摄像机的光学成像效果，在对焦的区域相对清晰，离对焦的区域越远则会逐渐模糊。
-景深效果可以让观察者几种注意力到对焦的区域，而且让画面的镜头感更强，大景深还能塑造出微距的模型效果。
+景深效果可以让观察者集中注意力到对焦的区域，而且让画面的镜头感更强，大景深还能塑造出微距的模型效果。
下面分别是关闭和开启景深的区别。
@@ -47,7 +47,7 @@
###${prefix|default('#')} enable(boolean) = false
-是否开启景深
+是否开启景深。
###${prefix|default('#')} focalDistance(boolean) = 50
@@ -142,7 +142,7 @@
然后那这张纹理图片就作为该配置项的值，就可以得到相同的在 Photoshop 里调整好的效果了。
-当然如果你只是想得到一张截图，完全可以不这样操作，但是如果你想在可实时交互的作品中能方便的调整到理想的色调，这个就非常有用了。
+当然如果你只是想得到一张截图，完全可以不这样操作，但是如果你想在可以实时交互的作品中能方便的调整到理想的色调，这个就非常有用了。
###${prefix|default('#')} exposure(number) = 0
@@ -164,7 +164,7 @@
##${prefix|default('#')} FXAA(Object)
-在开启 [postEffect](~${componentType}.postEffect) 后，WebGL 默认的 MSAA 会无法使用。这时候通过
FXAA 可以廉价方便的解决抗锯齿的问题，FXAA 会对一些场景的边缘部分进行模糊从而解决锯齿的问题，这在一些场景上效果还不错，但是在 echarts-gl
中，需要保证很多文字和线条边缘的锐利清晰，因此 FXAA 并不是那么适用。这时候我们可以通过如下设置更高的`devicePixelRatio`来使用超采样
+在开启 [postEffect](~${componentType}.postEffect) 后，WebGL 默认的 MSAA (Multi
Sampling Anti Aliasing) 会无法使用。这时候通过 FXAA (Fast Approximate Anti-Aliasing)
可以廉价方便的解决抗锯齿的问题，FXAA 会对一些场景的边缘部分进行模糊从而解决锯齿的问题，这在一些场景上效果还不错，但是在 echarts-gl
中，需要保证很多文字和线条边缘的锐利清晰，因此 FXAA
并不是那么适用。这时候我们可以通过设置更高的`devicePixelRatio`来使用超采样，如下所示：
```js
var chart = echarts.init(dom, null, {
@@ -172,7 +172,7 @@ var chart = echarts.init(dom, null, {
})
```
-但是这种方法对电脑性能有很高的要求，所以更多时候我们建议使用 echarts-gl 中的
[temporalSuperSampling](~${componentType}.temporalSuperSampling)，在画面静止后会持续分帧对一个像素多次抖动采样，从而达到超采样抗锯齿的效果。
+但是设置更高的`devicePixelRatio` 对电脑性能有很高的要求，所以更多时候我们建议使用 echarts-gl 中的
[temporalSuperSampling](~${componentType}.temporalSuperSampling)，在画面静止后会持续分帧对一个像素多次抖动采样，从而达到超采样抗锯齿的效果。
###${prefix|default('#')} enable(boolean) = false
diff --git a/cn/option-gl/partial/series-name.md
b/cn/option-gl/partial/series-name.md
index 0878caa..d7ae692 100644
--- a/cn/option-gl/partial/series-name.md
+++ b/cn/option-gl/partial/series-name.md
@@ -1,3 +1,3 @@
{{ target: partial-series-name }}
## name(string)
-系列名称，用于[tooltip](http://echarts.baidu.com/option.html#tooltip)的显示，[legend](http://echarts.baidu.com/option.html#legend)
的图例筛选，在 `setOption` 更新数据和配置项时用于指定对应的系列。
+系列名称，用于 [tooltip](https://echarts.apache.org/zh/option.html#tooltip)
的显示，[legend](https://echarts.apache.org/zh/option.html#legend) 的图例筛选，在
`setOption` 更新数据和配置项时用于指定对应的系列。
diff --git a/cn/option-gl/partial/shading.md b/cn/option-gl/partial/shading.md
index df250ea..6c6ee6f 100644
--- a/cn/option-gl/partial/shading.md
+++ b/cn/option-gl/partial/shading.md
@@ -6,9 +6,9 @@
#${prefix|default("##")} textureTiling(number) = 1
-材质细节纹理的平铺。默认为`1`，也就是拉伸填满，大于 `1` 的时候数字表示纹理平铺重复的次数。
+材质细节纹理的平铺。默认为`1`，也就是拉伸填满。大于 `1` 的时候，数字表示纹理平铺重复的次数。
-**注：**使用平铺需要 `detailTexture` 的高宽是 2 的 n 次方。例如 512x512，如果是 200x200 的纹理无法使用平铺。
+**注：** 使用平铺需要 `detailTexture` 的高宽是 2 的 n 次方。例如 512x512，如果是 200x200 的纹理无法使用平铺。
#${prefix|default("##")} textureOffset(number) = 0
diff --git a/cn/option-gl/partial/temporal-super-sampling.md
b/cn/option-gl/partial/temporal-super-sampling.md
index aec194a..6178e94 100644
--- a/cn/option-gl/partial/temporal-super-sampling.md
+++ b/cn/option-gl/partial/temporal-super-sampling.md
@@ -4,7 +4,7 @@
分帧超采样。在开启 [postEffect](~${componentType}.postEffect) 后，WebGL 默认的 MSAA
会无法使用，所以我们需要自己解决锯齿的问题。
-分帧超采样就是用来解决锯齿的问题，它在画面静止后会持续分帧对一个像素多次抖动采样，从而达到抗锯齿的效果。而且在这个分帧采样的过程中，echarts-gl
也会对 [postEffect](~${componentType}.postEffect) 中一些需要采样保证效果的特效，例如
[SSAO](~${componentType}.postEffect.SSAO),
[景深](~${componentType}.postEffect.depthOfField)，以及阴影进行渐进增强。
+分帧超采样是用来解决锯齿问题的方法，它在画面静止后会持续分帧对一个像素多次抖动采样，从而达到抗锯齿的效果。而且在这个分帧采样的过程中，echarts-gl
也会对 [postEffect](~${componentType}.postEffect) 中一些需要采样保证效果的特效，例如
[SSAO](~${componentType}.postEffect.SSAO),
[景深](~${componentType}.postEffect.depthOfField)，以及阴影进行渐进增强。
下面是未开启和开启`temporalSuperSampling`的区别。
diff --git a/cn/option-gl/partial/view-control.md
b/cn/option-gl/partial/view-control.md
index 45d635b..eec274d 100644
--- a/cn/option-gl/partial/view-control.md
+++ b/cn/option-gl/partial/view-control.md
@@ -34,7 +34,7 @@
旋转操作的灵敏度，值越大越灵敏。支持使用数组分别设置横向和纵向的旋转灵敏度。
-默认为`${defaultRotateSensitivitydefault(1)}`
+默认为`${defaultRotateSensitivity | default(1)}`。
设置为`0`后无法旋转。
@@ -49,7 +49,7 @@ rotateSensitivity: [0, 1]
##${prefix|default('#')} zoomSensitivity(number) =
${defaultZoomSensitivity|default(1)}
-缩放操作的灵敏度，值越大越灵敏。默认为`${defaultRotateSensitivitydefault(1)}`
+缩放操作的灵敏度，值越大越灵敏。默认为`${defaultRotateSensitivity | default(1)}`。
设置为`0`后无法缩放。
@@ -57,7 +57,7 @@ rotateSensitivity: [0, 1]
平移操作的灵敏度，值越大越灵敏。支持使用数组分别设置横向和纵向的平移灵敏度
-默认为`${defaultRotateSensitivitydefault(1)}`
+默认为`${defaultRotateSensitivity | default(1)}`。
设置为`0`后无法平移。
diff --git a/cn/option-gl/partial/zlevel.md b/cn/option-gl/partial/zlevel.md
index de76f55..8bd7db0 100644
--- a/cn/option-gl/partial/zlevel.md
+++ b/cn/option-gl/partial/zlevel.md
@@ -8,4 +8,4 @@
`zlevel` 大的 Canvas 会放在 `zlevel` 小的 Canvas 的上面。
-**注:** echarts-gl 中组件的层需要跟 echarts 中组件的层分开。同一个 zlevel 不能同时用于 WebGL 和 Canvas
的绘制。
\ No newline at end of file
+**注:** echarts-gl 中组件的层需要跟 echarts 中组件的层分开。同一个 `zlevel` 不能同时用于 WebGL 和 Canvas
的绘制。
\ No newline at end of file
diff --git a/cn/option-gl/series/bar3D.md b/cn/option-gl/series/bar3D.md
index 8f2a425..2215193 100644
--- a/cn/option-gl/series/bar3D.md
+++ b/cn/option-gl/series/bar3D.md
@@ -91,7 +91,7 @@ data: [
对于数组中的每一项：
1. 在 [grid3D](~grid3D) 中，每一项的前三个值分别是`x`, `y`, `z`。
-2. 在 [geo3D](~geo3D) 以及 [globe](globe) 中，每一项的前两个值分别是经纬度 `lng`,
`lat`，第三个值表示数值大小，例如人口的大小。这个值会被映射到 [minHeight](~series-bar3D.minHeight) ~
[maxHeight](~series-bar3D.maxHeight) 的范围。
+2. 在 [geo3D](~geo3D) 以及 [globe](~globe) 中，每一项的前两个值分别是经纬度 `lng`,
`lat`，第三个值表示数值大小，例如人口的多少。这个值会被映射到 [minHeight](~series-bar3D.minHeight) ~
[maxHeight](~series-bar3D.maxHeight) 的范围。
除了默认给坐标系使用的三个值，每一项还可以加入任意多个值，用于给 [visualMap](~visualMap) 组件映射到颜色等其它图形属性。
diff --git a/cn/option-gl/series/flowGL.md b/cn/option-gl/series/flowGL.md
index 605d764..474e343 100644
--- a/cn/option-gl/series/flowGL.md
+++ b/cn/option-gl/series/flowGL.md
@@ -12,11 +12,11 @@
## particleDensity(number) = 128
-粒子的密度，实际的粒子数量是设置数目的平方。粒子密度越大迹线效果越好，但是性能开销也会越大。除了该属性，将
[particleType](~series-flowGL.particleType) 也可以得到更加清晰连贯的迹线。
+粒子的密度，实际的粒子数量是设置数目的平方。粒子密度越大迹线效果越好，但是性能开销也会越大。除了该属性，使用
[particleType](~series-flowGL.particleType) 也可以得到更加清晰连贯的迹线。
## particleType(string) = 'point'
-粒子的类型，默认为点 `'point'`，可以设置成线 `'line'`，线类型的粒子会用一条线连接上个运动位置和当前运动位置。会让这个轨迹更加连贯。
+粒子的类型，默认为点 `'point'`，可以设置成线 `'line'`。线类型的粒子会用一条线连接上个运动的位置和当前运动的位置，这会让这个轨迹更加连贯。
下面是类型分别是`'point'`和`'line'`的区别。
@@ -50,7 +50,7 @@
## gridWidth(number|string) = 'auto'
-传入的网格数据的网格宽度数量，`flowGL` 会根据这个值和 [gridHeight](~series-flowGL.gridHeight)
创建存储向量场的浮点纹理，用于粒子的轨迹计算。
+传入的网格数据的网格宽度数量。`flowGL` 会根据这个值和 [gridHeight](~series-flowGL.gridHeight)
创建存储向量场的浮点纹理，用于粒子的轨迹计算。
## gridHeight(number|string) = 'auto'
@@ -64,8 +64,8 @@
```js
data: [
- // 每个数据项包含四个值，表示位置的 lng, lat 以及相应维度上的速度 sLng, sLat.
- // 如果是直角坐标系上的话则是表示位置的 x, y 以及相应维度上的速度 sx, sy
+ // 每个数据项包含四个值，表示位置的 lng、lat 以及相应维度上的速度 sLng、 sLat.
+ // 如果是直角坐标系上的话则是表示位置的 x、y 以及相应维度上的速度 sx、sy
[0, 0, 1, 1], [1, 0, 1, 1],
[0, 1, 1, 1], [1, 1, 1, 1]
];
diff --git a/cn/option-gl/series/graphGL.md b/cn/option-gl/series/graphGL.md
index 6ae7553..b75ad88 100644
--- a/cn/option-gl/series/graphGL.md
+++ b/cn/option-gl/series/graphGL.md
@@ -22,7 +22,7 @@
CPU 实现的优势是兼容性好，而 GPU 实现在高端显卡中有着数十倍甚至上百倍的性能优势。
-下面是在 GTX1070 和 i7 4GHz 的电脑中对一个 2w 个节点，近 5w 条边的关系图一次布局的迭代的性能对比。
+下面是在 GTX1070 和 i7 4GHz 的电脑中对一个 2w 个节点(近 5w 条边)的关系图一次布局的迭代的性能对比。
@@ -124,7 +124,7 @@ CPU 实现的优势是兼容性好，而 GPU 实现在高端显卡中有着数
### value(number|Array)
-数据项值
+数据项值。
### itemStyle(Object)
@@ -138,7 +138,7 @@ CPU 实现的优势是兼容性好，而 GPU 实现在高端显卡中有着数
## nodes(Array)
-同 [graphGL.data](~series-graphGL.data)
+同 [graphGL.data](~series-graphGL.data)。
## links(Array)
diff --git a/cn/option-gl/series/lines3D.md b/cn/option-gl/series/lines3D.md
index cfeb3bb..3d338cd 100644
--- a/cn/option-gl/series/lines3D.md
+++ b/cn/option-gl/series/lines3D.md
@@ -2,7 +2,7 @@
# series.lines3D(Object)
-三维的飞线图。跟二维的[飞线图](http://echarts.baidu.com/option.html#series-line)一样用于表现起点终点的线数据。更多用在地理可视化上。
+三维的飞线图。跟二维的[飞线图](https://echarts.apache.org/zh/option.html#series-line)一样用于表现起点终点的线数据。更多用在地理可视化上。
下图是使用 [lines3D](~series-lines3D) 在 [globe](~globe) 上可视化飞机航班的一个例子。
diff --git a/cn/option-gl/series/polygons3D.md
b/cn/option-gl/series/polygons3D.md
index c44c5e1..b6ac760 100644
--- a/cn/option-gl/series/polygons3D.md
+++ b/cn/option-gl/series/polygons3D.md
@@ -14,7 +14,7 @@
## itemStyle(Object)
-图形样式，包括颜色，透明度，描边等。
+图形样式，包括颜色、透明度、描边等。
{{ use: partial-item-style(
prefix="##",
@@ -24,7 +24,7 @@
## emphasis(Object)
-鼠标 hover 高亮时图形和标签的样式
+鼠标 hover 高亮时图形和标签的样式。
### itemStyle(Object)
diff --git a/cn/option-gl/series/series.md b/cn/option-gl/series/series.md
index a769c11..380771d 100644
--- a/cn/option-gl/series/series.md
+++ b/cn/option-gl/series/series.md
@@ -3,4 +3,4 @@
echarts-gl 加入了丰富的三维可视化类型，包括 [三维柱状图 bar3D](~series.bar3D)，[三维散点图
scatter3D](~series.scatter3D)，[三维飞线 lines3D](~series.lines3D)，[曲面图
surface](~series.surface)，大部分可视化类型都能在多种坐标系组件中使用。而且与 echarts 原先的图例，tooltip
等交互组件有良好的集成。
-同时对原先二维的图表也有功能上的增强，对于大量数据的散点图和关系图，你可以使用 echarts-gl 中提供的
[scatterGL](~series.scatterGL)，[graphGL](~series.graphGL) 加速绘制和运算。
+同时,对原先的二维图表也进行了更多功能上的增强。例如，对于大量数据的散点图和关系图，你可以使用 echarts-gl 中提供的
[scatterGL](~series.scatterGL)，[graphGL](~series.graphGL) 加速绘制和运算。
diff --git a/cn/option-gl/series/surface.md b/cn/option-gl/series/surface.md
index 8309d38..df08750 100644
--- a/cn/option-gl/series/surface.md
+++ b/cn/option-gl/series/surface.md
@@ -96,10 +96,11 @@ z 为关于 [x](~series-surface.equation.x),
[y](~series-surface.equation.y) 的
## parametricEquation(Object)
-曲面的[参数方程](https://zh.wikipedia.org/wiki/%E5%8F%83%E6%95%B8%E6%96%B9%E7%A8%8B)。在不设置
[data](~series-surface.data)，可以通过
[parametricEquation](~series-surface.equation) 去声明参数参数方程。在
[parametric](~series-surface) 为`true`时有效。
+曲面的[参数方程](https://zh.wikipedia.org/wiki/%E5%8F%83%E6%95%B8%E6%96%B9%E7%A8%8B)。在[data](~series-surface.data)没被设置的时候，可以通过
[parametricEquation](~series-surface.equation) 去声明参数参数方程。在
[parametric](~series-surface) 为`true`时有效。
-参数方程是 [x](~series-surface.parametricEquation.x),
[y](~series-surface.parametricEquation.y),
[z](~series-surface.parametricEquation.z) 关于参数
[u](~series-surface.parametricEquation.u)，[v](~series-surface.parametricEquation.v)
的方程。
-下面的参数方程就是绘制前面图中类似一个金属零件的参数曲面的。
+参数方程是
[x](~series-surface.parametricEquation.x)、[y](~series-surface.parametricEquation.y)、
[z](~series-surface.parametricEquation.z) 关于参数
[u](~series-surface.parametricEquation.u)、[v](~series-surface.parametricEquation.v)
的方程。
+
+下面的参数方程就是绘制前面图中类似一个金属零件的参数曲面的：
```js
var aa = 0.4;
@@ -183,7 +184,7 @@ x 为关于 [u](~series-surface.equation.u),
[v](~series-surface.equation.v) 的
## itemStyle(Object)
-曲面的颜色和不透明度等样式。
+曲面的颜色、不透明度等样式。
{{ use: partial-item-style(
componentType='series-surface',
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
