ci[bot]
@@ -0,0 +1,487 @@
|
||||
# Builtin - 图形 / 图形对象
|
||||
|
||||
## `graphGroup(graph1, graph_n, prop_m, value_m)`
|
||||
|
||||
用于生成图形组合，可以指定任意多个单个图形作为参数生成一个图形组合，在其后面还可以指定图形组合的共有属性。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| --------- | ------ | ------------------------------------ |
|
||||
| `graph1` | tgraph | TGraph 图形1 |
|
||||
| `graph_n` | tgraph | TGraph 图形N |
|
||||
| `prop_m` | string | string 可选参数，TGraphGroup属性名称 |
|
||||
| `value_m` | | any 可选参数，TGraphGroup属性值 |
|
||||
|
||||
返回：tgraphgroup
|
||||
|
||||
### 示例
|
||||
|
||||
```tsl
|
||||
vol_data := nDay2(gfVol() , vol() , gfColor() , ifThen ( close()> open() , clRed() , clGreen() ) );
|
||||
mavol := nDay2('MA5', ma ( vol() , 5 ) );
|
||||
vol_graph := graph(gtBar(), 'VOLGraph', vol_data);
|
||||
mavol_graph := graph(gtLine(), 'MA5Graph', mavol, gfColor(), clBlue());
|
||||
return graphGroup(vol_graph, mavol_graph, gfMinValue(), 0);
|
||||
// 输出：
|
||||
// Execute script error at Line:3
|
||||
// function:__main__:line 3:instruction:usercall: 执行函数 graph 出错。
|
||||
// function:__main__:line 3:instruction:usercall: function execute error
|
||||
// 输出：说明：GraphGroup包含了两个TGraph图形，一个是VOLGraph成交量图形，另一个是MAVOLGraph成交量的5日均线的折线图形。这两个图形具有的共有属性是gfMinValue()，就是最小值为0。gfColor在VolData中作为了数据字段，用来指示每一个数据点的颜色。因此柱子会根据开盘和收盘的差异来决定色彩的显示。而在MAVOLGraph又作为了图形的属性，因此MAVOLGraph在显示的时候会呈现出蓝色。gfMinValue在返回的图形组合里作为了图形组合的属性，因此决定了图形会用0来作为最小的值来显示，而不会用区间内的最小成交量作为最小值显示。
|
||||
// 另外，我们可以注意到，作为gtLine类型的MAVOLGraph并不含有特殊的值来指定折线的点的位置，在没有特定的数据字段的时候，系统会使用第一个存在的数据字段当成默认的gfValue来显示。
|
||||
gfMinValue()：设定最小值。一般的，图形会用查找视图内最小最小值用于显示，同时，为了特殊显示，也可以指定其显示的最大最小值，通常成交量的图是用0作为最小值的。
|
||||
```
|
||||
|
||||
## `encodeGraph(_type, name, data, prop)`
|
||||
|
||||
返回根据指定的类型、名称、数据以及属性数组生成的图形。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ------- | ------- | ---- |
|
||||
| `_type` | integer | |
|
||||
| `name` | string | |
|
||||
| `data` | array | |
|
||||
| `prop` | array | |
|
||||
|
||||
返回：tgraph
|
||||
|
||||
### 示例
|
||||
|
||||
```tsl
|
||||
setSysParam(pn_stock(), 'SZ000002');
|
||||
setSysParam(pn_date(), intToDate(20140117));
|
||||
setSysParam(pn_nday(), 250);
|
||||
t1 := nDay2(gfOpen(), open() ,
|
||||
gfClose(), close(),
|
||||
gfHigh(), high(),
|
||||
gfLow(), low(),
|
||||
gfTime(), dateTimeToStr(sp_time()),
|
||||
// KLine颜色
|
||||
gfColor(), ifThen3(close(), open(),
|
||||
clRed() , // 涨颜色
|
||||
clYellow() , // 平颜色
|
||||
clBlue() // 跌颜色
|
||||
),
|
||||
gfFill(), ifThen3(close(), open(), flClear(), flSolid(), flSolid())
|
||||
);
|
||||
return encodeGraph(gtKLine(), 'KLine', t1, array());
|
||||
// 输出：
|
||||
// Execute script error at Line:17
|
||||
// function:__main__:line 17:instruction:array: 执行函数 encodeGraph 出错。
|
||||
// function:__main__:line 17:instruction:array: function execute error
|
||||
```
|
||||
|
||||
## `gfColor()`
|
||||
|
||||
颜色（数据字段或TGraph的属性），可以修饰单个数据点或者整个图形的颜色。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfFill()`
|
||||
|
||||
填充状况(数据字段)，用于设定柱线、K线、圆圈图等填充情况。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfFlag()`
|
||||
|
||||
标示(数据字段)，标示内容见图形标示函数
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfZero()`
|
||||
|
||||
零轴(TGraphgroup的属性字段)，TGraphGroup的属性，用于标示中间值，特别用于MACD类的图形
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfMaxValue()`
|
||||
|
||||
设定显示的最大值(TGraphGroup的属性字段)，TGraphGroup的属性。一般的，图形会用查找视图内最小最小值用于显示，同时，为了特殊显示，也可以指定其显示的最大最小值，例如成交量的图是用0作为最小值的。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfMinValue()`
|
||||
|
||||
设定显示的最小值(TGraphGroup的属性字段)，TGraphGroup的属性。一般的，图形会用查找视图内最小最小值用于显示，同时，为了特殊显示，也可以指定其显示的最大最小值，例如成交量的图是用0作为最小值的。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfLtp()`
|
||||
|
||||
流通盘(TGraphGroup的属性字段)，TGraphGroup的属性，用于换手率的计算，暂时未使用，将来扩展用。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfTitleCaption()`
|
||||
|
||||
图形的标题文字，TGraphGroup的属性。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfLeftTitleCaption()`
|
||||
|
||||
图形辅助标题文字。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfCoordinate()`
|
||||
|
||||
图形的坐标系模式。设置为0为普通坐标，1为对数坐标，2为百分比坐标。
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfValue()`
|
||||
|
||||
值（数据字段），可指定折线，柱线，细柱线，圆圈图的值
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfClose()`
|
||||
|
||||
收盘（数据字段），一般用于K线，美国线，宝塔线
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfOpen()`
|
||||
|
||||
开盘（数据字段），用于K线，宝塔线，美国线
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfHigh()`
|
||||
|
||||
最高（数据字段），用于K线，宝塔线，美国线
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfLow()`
|
||||
|
||||
最低（数据字段），用于K线，宝塔线，美国线
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfTowerLow()`
|
||||
|
||||
宝塔线中的低值（数据字段），宝塔线也可以不需要使用此三个字段，该三个字段的内容可以被自动根据gfClose,gfOpen,gfHigh,gfLow计算出来
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfTowerHigh()`
|
||||
|
||||
宝塔线中的高值（数据字段），宝塔线也可以不需要使用此三个字段，该三个字段的内容可以被自动根据gfClose,gfOpen,gfHigh,gfLow计算出来
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfTowerMid()`
|
||||
|
||||
宝塔线中的中值（数据字段），宝塔线也可以不需要使用此三个字段，该三个字段的内容可以被自动根据gfClose,gfOpen,gfHigh,gfLow计算出来
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfVol()`
|
||||
|
||||
成交量(数据字段)，也可用于指定柱线，细柱线的值
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfAmount()`
|
||||
|
||||
成交金额(数据字段)，也可用于指定柱线，细柱线的值
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfTime()`
|
||||
|
||||
时间坐标(数据字段)，用于X坐标轴的显示
|
||||
|
||||
返回：string
|
||||
|
||||
## `gfRateFlag()`
|
||||
|
||||
除权标示(数据字段)，指示是否为除权日
|
||||
|
||||
返回：string
|
||||
|
||||
## `flSolid()`
|
||||
|
||||
实心填充。
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flClear()`
|
||||
|
||||
空心体。
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flHorizontal()`
|
||||
|
||||
横线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flVertical()`
|
||||
|
||||
竖线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flFDiagonal()`
|
||||
|
||||
正斜线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flBDiagonal()`
|
||||
|
||||
反斜线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flCross()`
|
||||
|
||||
交叉线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `flDiagCross()`
|
||||
|
||||
交叉斜线填充
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtLine()`
|
||||
|
||||
折线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtKLine()`
|
||||
|
||||
K线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtTower()`
|
||||
|
||||
宝塔线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtAmerican()`
|
||||
|
||||
美国线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtBar()`
|
||||
|
||||
柱线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtSingleBar()`
|
||||
|
||||
细柱线类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `gtCircle()`
|
||||
|
||||
圆圈图类型
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgNone()`
|
||||
|
||||
无标识
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgUp()`
|
||||
|
||||
上
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgDown()`
|
||||
|
||||
下
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgLeft()`
|
||||
|
||||
左
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgRight()`
|
||||
|
||||
右
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgLeftUp()`
|
||||
|
||||
左上
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgLeftDown()`
|
||||
|
||||
左下
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgRightUp()`
|
||||
|
||||
右上
|
||||
|
||||
返回：integer
|
||||
|
||||
## `fgRightDown()`
|
||||
|
||||
右下
|
||||
|
||||
返回：integer
|
||||
|
||||
## `graph(_type, graph_name, data, prop1, prop1_value, prop2, prop2_value, ..., prop_n, prop_n_value)`
|
||||
|
||||
用于生成单个图形。单个图形的含义是一条折线、K线或成交量柱壮图。函数的具体的功能是：用指定的数据Data生成一个类型为Type的图形，并且用后面指定的属性参数PropN和PropNValue为图形指定修饰属性。注意，如果横坐标要显示出数据，需要把横坐标设置列名为'time'
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| -------------- | ---------- | ---- |
|
||||
| `_type` | integer | |
|
||||
| `graph_name` | string | |
|
||||
| `data` | tablearray | |
|
||||
| `prop1` | string | |
|
||||
| `prop1_value` | any | |
|
||||
| `prop2` | string | |
|
||||
| `prop2_value` | any | |
|
||||
| `...` | | |
|
||||
| `prop_n` | string | |
|
||||
| `prop_n_value` | any | |
|
||||
|
||||
返回：tgraph
|
||||
|
||||
### 示例
|
||||
|
||||
范例一：
|
||||
|
||||
```tsl
|
||||
// K线图
|
||||
setSysParam(pn_stock(), 'SZ000002');
|
||||
setSysParam(pn_date(), intToDate(20140117));
|
||||
setSysParam(pn_nday(), 250);
|
||||
t1 := nDay2(gfOpen(), open() ,
|
||||
gfClose(), close(),
|
||||
gfHigh(), high(),
|
||||
gfLow(), low(),
|
||||
gfTime(), dateTimeToStr(sp_time()),
|
||||
// KLine颜色
|
||||
gfColor(), ifThen3(close(), open(),
|
||||
clRed() , // 涨颜色
|
||||
clYellow() , // 平颜色
|
||||
clLime() // 跌颜色
|
||||
),
|
||||
gfFill(), ifThen3(close(), open(), flClear(), flSolid(), flSolid())
|
||||
);
|
||||
t2 := nDay2('MA10', ma(close(), 10));
|
||||
g1 := graph(gtKLine(), 'KLine', t1);
|
||||
g2 := graph(gtLine(), 'MA10', t2);
|
||||
return graphGroup(g1, g2);
|
||||
// 输出：
|
||||
// Execute script error at Line:19
|
||||
// function:__main__:line 19:instruction:usercall: 执行函数 graph 出错。
|
||||
// function:__main__:line 19:instruction:usercall: function execute error
|
||||
```
|
||||
|
||||
范例二：
|
||||
|
||||
```tsl
|
||||
// 折线图
|
||||
setSysParam(pn_stock(), 'SZ000002');
|
||||
setSysParam(pn_date(), intToDate(20140117));
|
||||
setSysParam(pn_nday(), 250);
|
||||
g_data1 := nDay2(gfClose(), close());
|
||||
g_data2 := nDay2('MA5', ma(close(), 5));
|
||||
g_data3 := nDay2('MA20', ma(close(), 20));
|
||||
g1 := graph( gtLine(), gfClose(), gdata1, gfColor() , clBlue());
|
||||
g2 := graph( gtLine(), "MA5", gdata2, gfColor() , clGreen());
|
||||
g3 := graph( gtLine(), "MA20", gdata3, gfColor() , clRed());
|
||||
return graphGroup(g1, g2, g3);
|
||||
// 输出：
|
||||
// Execute script error at Line:8
|
||||
// function:__main__:line 8:instruction:usercall: 执行函数 graph 出错。
|
||||
// function:__main__:line 8:instruction:usercall: function execute error
|
||||
```
|
||||
|
||||
## `gfBias_Eval(l1)`
|
||||
|
||||
乘离率绘图教学函数。返回指定股票在截止日N(默认180)个序列的L1乘离率图形，与系统参数(股票，周期，时间，复权相关)
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| `l1` | any | 整数 |
|
||||
|
||||
返回：any
|
||||
|
||||
## `mergeGraph(g1, g2, g3, gn)`
|
||||
|
||||
将运行结果为图像的多个参数图像叠加，返回叠加后的图形组合。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ---- | ----- | ---------------------------------- |
|
||||
| `g1` | graph | 图形1，一般是由graph函数返回的图形 |
|
||||
| `g2` | graph | 图形2，一般是由graph函数返回的图形 |
|
||||
| `g3` | graph | 图形3，一般是由graph函数返回的图形 |
|
||||
| `gn` | graph | 图形n，一般是由graph函数返回的图形 |
|
||||
|
||||
返回：graph
|
||||
|
||||
### 示例
|
||||
|
||||
```tsl
|
||||
setSysParam(pn_stock(), 'SZ000063');
|
||||
setSysParam(pn_date(), 20190301T);
|
||||
setSysParam(pn_nday(), 100);
|
||||
t1 := nDay2(gfOpen(), open() ,
|
||||
gfClose(), close(),
|
||||
gfHigh(), high(),
|
||||
gfLow(), low(),
|
||||
gfTime(), dateTimeToStr(sp_time()),
|
||||
// KLine颜色
|
||||
gfColor(), ifThen3(close(), open(),
|
||||
clRed() , // 涨颜色
|
||||
clYellow() , // 平颜色
|
||||
clLime() // 跌颜色
|
||||
),
|
||||
gfFill(), ifThen3(close(), open(), flClear(), flSolid(), flSolid())
|
||||
);
|
||||
t2 := nDay2('MA5', ma(close(), 5)); // 5日均线
|
||||
t3 := nDay2('MA10', ma(close(), 10)); // 10日均线
|
||||
t4 := nDay2('MA20', ma(close(), 20)); // 20日均线
|
||||
g1 := graph(gtKLine(), 'KLine', t1);
|
||||
g2 := graph(gtLine(), 'MA5', t2);
|
||||
g3 := graph(gtLine(), 'MA10', t3);
|
||||
g4 := graph(gtLine(), 'MA20', t4);
|
||||
return mergeGraph(g1, g2, g3, g4);
|
||||
// 返回:
|
||||
```
|
||||
|
||||
## `getColorByIndex(index)`
|
||||
|
||||
依据Index值，获得颜色数组内的指定颜色整数代号。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ------- | ------- | ---------------- |
|
||||
| `index` | integer | 整数，颜色索引号 |
|
||||
|
||||
返回：integer
|
||||
|
||||
### 示例
|
||||
|
||||
```tsl
|
||||
return getColorByIndex(1);
|
||||
// 返回：16711680
|
||||
```
|
||||
Reference in New Issue
Block a user