MS RFC 26:版本5术语清理¶
- 日期
2007／04／21
- 作者
史蒂夫·莱姆，哈瓦德·特维特
- 联系方式
史蒂夫·莱姆（Steve.Lime）在北卡罗来纳州北卡罗来纳州，哈瓦德·特韦特（Havard.Tveite）在北卡罗来纳州北部
- 状态
实施
- 版本
MAPServer 5
MapServer术语基本上是好的和一致的，但也有一些例外。产生最混乱和透明度的两个参数（layerobj）和各种比例引用参数（例如minscale）。
另一个改变是将symbolobj样式参数改为pattern。这只是为了避免与ClassObj风格混淆。
此建议的目的是使MapServer更易于使用，消除术语不一致时可能出现的混淆。
TRANSPARENCY¶
概述
透明度在mapserver mapfile layer对象中用于实际不透明度（如当前文档中所指出的）。
2）为了获得更一致的术语，应完成以下工作：
将关键字透明度更改为不透明度
旧的mapfile层关键字“transparency”将被弃用，但在未来版本的mapserver中将支持它作为不透明度的别名。
新的mapfile layer关键字opacity应替换透明度。不会改变类型或语义，只会改变关键字名称。
layerObj中的内部结构成员名称将从透明度更改为不透明度。
Mapfile 含义
解析器必须同时支持不透明度和透明性（为了向后兼容）。类型将不会更改。
在调试级别1，将发出警告，建议不要使用transparency参数，而应使用opacity。
MapScript含义
由于layerObj将不再包含透明成员，这将破坏旧脚本。解决办法很明显。
文件的含义
应该更新文档，引入不透明度作为新的图层关键字，文档类似于当前的透明度。图层关键字透明度应记录为已弃用。所有引用透明度的其他文档都必须更新（简单搜索替换为手动检查所有出现的单词透明度？）
SCALE¶
概述
scale和maxscale/minscale是MapServer术语与主流地图术语不一致的情况。
在适当的用法中，比例是一个有代表性的分数。比例尺1:50000告诉我们地图上的一米相当于“地形”中的50000米。1:1000（0.001）的比例大于1:50000（0.00002）。因此，目前对maxscale和minscale的使用与正确的术语不一致。
技术细节
为了实现更一致的术语，可以在有限的后果下完成以下工作：
将关键字中所有出现的“scale”都更改为“scaledenom”。
最小10000最大1000000
将成为：
Minscaledenom 10000 Maxscaledenom 1000000
这将适用于以下在mapserver关键字中出现的比例：
- 地图对象：
比例->比例
- Web对象：
最大刻度/最小刻度
- 层对象：
最大刻度/minscale labelmaxscale/labelminscale symbolscale
- 类对象：
最大刻度/最小刻度
Mapfile 含义
解析器必须接受新的关键字。旧关键字将是新关键字的唯一前缀，解析器可以接受它（在过渡期或永恒期）。
在调试级别1，将发出一条警告，指出…scale参数已被弃用，应改为使用…scaledenom。
4）mapscript对所有比例变量的影响，应将比例更改为scaledenom（出于一致性原因）。类型（double）不会更改。像上面的不透明度一样，这会破坏旧脚本。
模板含义
应弃用[scale]替换（但仍受支持），并添加[scaledenom]。
CGI图像
将继续支持scale cgi参数（例如，用户通常使用中心点和比例值定义地图范围）。也支持scaledenom。
文件的含义
文档中出现的所有比例关键字都必须更改以反映新名称。可以包含旧样式的关键字，但应标记为已弃用。
PATTERN¶
概述
目前symbolobj和classobj都包含样式参数。符号obj样式存储用于线符号的短划线图案。该名称源自gd术语。为避免与ClassObj样式混淆，应将符号obj样式重命名为更简洁地反映其用途。
技术细节
在symbolobj结构定义中，成员样式将被重命名为pattern。代码中对样式的所有引用也将更新。
Mapfile /符号文件含义
解析器必须接受新的关键字。旧关键字将是新关键字的唯一前缀，解析器可以接受它（在过渡期或永恒期）。
在调试级别1，将发出警告，说明样式参数已被弃用，应改为使用模式。
MapScript含义
如上所述，符号obj结构将被更改，因此以编程方式设置符号样式的mapscript脚本将中断。他们需要引用patter参数。
模板含义
没有
CGI含义
没有
文件的含义
符号对象参考指南需要更新以反映名称更改。