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