MS RFC 26:版本5术语清理

日期

2007/04/21

作者

史蒂夫·莱姆,哈瓦德·特维特

联系

史蒂夫·莱姆(Steve.Lime)在北卡罗来纳州北卡罗来纳州,哈瓦德·特韦特(Havard.Tveite)在北卡罗来纳州北部。

状态

实施

版本

MAPServer 5

MapServer术语基本上是好的和一致的,但也有一些例外。产生最混乱和透明度的两个参数(layerobj)和各种比例引用参数(例如minscale)。

另一个改变是将symbolobj样式参数改为pattern。这只是为了避免与ClassObj风格混淆。

此建议的目的是使MapServer更易于使用,消除术语不一致时可能出现的混淆。

TRANSPARENCY

  1. 概述

透明度在mapserver mapfile layer对象中用于实际不透明度(如当前文档中所指出的)。

2)为了获得更一致的术语,应完成以下工作:

将关键字透明度更改为不透明度

旧的mapfile层关键字“transparency”将被弃用,但在未来版本的mapserver中将支持它作为不透明度的别名。

新的mapfile layer关键字opacity应替换透明度。不会改变类型或语义,只会改变关键字名称。

layerObj中的内部结构成员名称将从透明度更改为不透明度。

  1. 映射文件含义

解析器必须同时支持不透明度和透明性(为了向后兼容)。类型将不会更改。

在调试级别1,将发出警告,建议不要使用transparency参数,而应使用opacity。

  1. MapScript含义

由于layerObj将不再包含透明成员,这将破坏旧脚本。解决办法很明显。

  1. 文件的含义

应该更新文档,引入不透明度作为新的图层关键字,文档类似于当前的透明度。图层关键字透明度应记录为已弃用。所有引用透明度的其他文档都必须更新(简单搜索替换为手动检查所有出现的单词透明度?)

SCALE

  1. 概述

scale和maxscale/minscale是MapServer术语与主流地图术语不一致的情况。

在适当的用法中,比例是一个有代表性的分数。比例尺1:50000告诉我们地图上的一米相当于“地形”中的50000米。1:1000(0.001)的比例大于1:50000(0.00002)。因此,目前对maxscale和minscale的使用与正确的术语不一致。

  1. 技术细节

为了实现更一致的术语,可以在有限的后果下完成以下工作:

将关键字中所有出现的“scale”都更改为“scaledenom”。

最小10000最大1000000

将成为:

Minscaledenom 10000 Maxscaledenom 1000000

这将适用于以下在mapserver关键字中出现的比例:

地图对象:

比例->比例

Web对象:

最大刻度/最小刻度

层对象:

最大刻度/minscale labelmaxscale/labelminscale symbolscale

类对象:

最大刻度/最小刻度

  1. 映射文件含义

解析器必须接受新的关键字。旧关键字将是新关键字的唯一前缀,解析器可以接受它(在过渡期或永恒期)。

在调试级别1,将发出一条警告,指出…scale参数已被弃用,应改为使用…scaledenom。

4)mapscript对所有比例变量的影响,应将比例更改为scaledenom(出于一致性原因)。类型(double)不会更改。像上面的不透明度一样,这会破坏旧脚本。

  1. 模板含义

应弃用[scale]替换(但仍受支持),并添加[scaledenom]。

  1. CGI图像

将继续支持scale cgi参数(例如,用户通常使用中心点和比例值定义地图范围)。也支持scaledenom。

  1. 文件的含义

文档中出现的所有比例关键字都必须更改以反映新名称。可以包含旧样式的关键字,但应标记为已弃用。

PATTERN

  1. 概述

目前symbolobj和classobj都包含样式参数。符号obj样式存储用于线符号的短划线图案。该名称源自gd术语。为避免与ClassObj样式混淆,应将符号obj样式重命名为更简洁地反映其用途。

  1. 技术细节

在symbolobj结构定义中,成员样式将被重命名为pattern。代码中对样式的所有引用也将更新。

  1. 映射文件/符号文件含义

解析器必须接受新的关键字。旧关键字将是新关键字的唯一前缀,解析器可以接受它(在过渡期或永恒期)。

在调试级别1,将发出警告,说明样式参数已被弃用,应改为使用模式。

  1. MapScript含义

如上所述,符号obj结构将被更改,因此以编程方式设置符号样式的mapscript脚本将中断。他们需要引用patter参数。

  1. 模板含义

没有

  1. CGI含义

没有

  1. 文件的含义

符号对象参考指南需要更新以反映名称更改。