mapnik的TextSymbolizer类属性说明及使用预研情况

本文来自李明子csdn博客（http://blog.csdn.net/free1985），商业转载请联系博主获得授权，非商业转载请注明出处！

本文编写于2010年9月，记述了mapnik的TextSymbolizer类的各属性说明及使用预研情况。
TextSymbolizer共有25个在XML中可用的属性。现已将其分别试用总结。

名称	值	意义	试用结果	默认值
avoid_edges	Bool，true/false	是否避免文字出现在地图边缘	可用	true
allow_overlap	Bool,true/false	是否允许文字重叠	可用	false
character_spacing	Int(非负整形数字)	两个字符间的距离，默认0	可用但无明显效果	0
dx	Int（整形数字）	字符的水平位移，以像素为单位	可用	0
dy	Int（整形数字）	字符的垂直位移，以像素为单位	可用	0
face_name	Cstring（字符串）	字体名称，环境中已注册的字体。不能与fontset_name 同时使用	可用	宋体
fontset_name	Cstring（字符串）	自注册字体名称，需要与FontSet结合使用，不能与face_name同时使用	可用
fill	RGB（颜色值）	文字填充颜色	可用	黑色
halo_fill	RGB（颜色值）	文字光晕（描边）颜色	可用	黄色
halo_radius	Int（非负整形数字）	文字光晕（描边）宽度，以像素为单位	可用	0
horizontal_alignment	Enum(枚举),left/middle/right	水平校正方式，对准基准点的文字位置	可用
justify_alignment	Enum(枚举),left/middle/right	对齐方式（多行文字时有效果）	可用，但缺乏多行文字数据无法测试效果
line_spacing	Int（非负整形数字）	行间距	可用，但缺乏多行文字数据无法测试效果
max_char_angle_delta	Int（整形数字）	最大字符角度值	可用，但无明显效果
min_distance	Int（非负整形数字）	字符串（标签）间的最小距离	可用	0
name	Cstring（字符串）	域名称，来源于数据库。SymbolizerText使用的一种方式，参考青岛数据，建议不使用	缺乏合适的DATASOURCE，未作测试
opacity	Float 0.0-1.0，软件中映射为0-100的整数	文字的透明度	可用	不透明
placement	Enum(枚举),point/line	文字放置方式，point为放置在点的位置上；line为根据线形渲染文字	可用，但可能与线形文件有关，测试时当选用line时文字消失	中心
size	Int（非负整形数字）	文字大小	可用	9
spacing	Int（非负整形数字）	一条线中重复文字间的空格，以像素为单位	可用，但可能与线形文件有关，测试时未见效果	256
text_convert	Enum(枚举),none/toupper/tolower	字符转换。三个选项分别为“不转换”，“转为大写字符”，“转为小写字符”	可用，但可能与字符集有关，测试时未见效果
vertical_alignment	Enum(枚举),top/middle/bottom	垂直校正方式，对准基准点的文字位置	可用

wrap_before，wrap_character和wrap_width三个属性为一组，从介绍来看是设置环绕字符的。即以某个字符为中心，环绕渲染某个字符串。经过测试这个属性是可用的。但是，测试结果没有规律可循，效果不是介绍中的样式，并且字符串被渲染后的位置会有很大的改变，建议谨慎使用。