一、技术原理

CityMaker中图层（featurelayer）标注指的通过属性字段设置图层的标注样式，具体分类详见如图：

CityMaker几何体——标注 - 图1

图层标注有两种方法：
·创建图层的时候设置textrender；
·通过setTextRender设置textrender

文字渲染器ITextRender分为简易文字渲染对象ISimpleTextRender、多专题的文字渲染器IValueMapTextRender、配置显示提示信息IToolTipTextRender

简易文字渲染对象一般是通过设置属性字段文字的样式来设置
多专题的文字渲染主要是用渲染方案来设置渲染的效果，渲染方案有两个渲染的规则，一个是范围规则，也就是可以设置在规定范围中显示某种渲染效果，另一个是唯一值渲染规则，也就是可以根据某一类型来实现渲染的效果

二、图层标注

1. .NET

  1. public void textRender() {
  2.       //文字渲染风格
  3.      ISimpleTextRender textRender = new SimpleTextRender();
  4.      textRender.Expression = "''..$(oid)";
  5.      ITextSymbol textSymbol = new TextSymbol();
  6.      TextAttribute textAttribute = new TextAttribute();
  7.      textAttribute.TextColor = 0xff0000ff;
  8.      textSymbol.TextAttribute = textAttribute;
  9.      textSymbol.PivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  10.      textSymbol.VerticalOffset = 10;
  11.      // 注意：必须设置symbol，默认文字不显示
  12.      textRender.Symbol  = textSymbol; 
  15.      //创建图层
  16.      IFeatureLayer featureLayer = rendercontrol.ObjectManager.CreateFeatureLayer(
  17.      fc, geoName, textRender, null, __rootId);
  18. }
  21. //1、简易文字渲染，通过设置颜色，来渲染模型
  22. public void SimpleSymbol() {
  23.      // 文字渲染风格
  24.      ISimpleTextRender textRender = new SimpleTextRender();
  25.      textRender.Expression = "''..$(oid)";
  26.      ITextSymbol textSymbol = new TextSymbol();
  27.      TextAttribute textAttribute = new TextAttribute();
  28.      textAttribute.TextColor = 0xffCCCCCC;
  29.      textSymbol.TextAttribute = textAttribute;
  30.      textSymbol.PivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  31.      textSymbol.VerticalOffset = 10;
  32.      textRender.Symbol = textSymbol;
  33.      BuildingFl.SetTextRender(textRender) ;
  34. }
  37. //2、多专题的文字渲染器,通过设置范围来渲染不同范围的模型
  38. public void ValueSymbol() {
  39.      //定义文字渲染风格
  40.      IValueMapTextRender textRender = new ValueMapTextRender();
  41.      textRender.Expression = "''..$(oid)";
  44.      //文字属性
  45.      TextAttribute textAttribute = new TextAttribute();
  46.      textAttribute.TextColor = 0xffff0000;
  47.      textAttribute.Font = "黑体";
  48.      textAttribute.TextSize = 50;
  51.      //文字样式 
  52.      ITextSymbol textSymbol = new TextSymbol();
  53.      textSymbol.TextAttribute = textAttribute;
  54.      textSymbol.PivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  57.      //渲染规则 
  58.      IUniqueValuesRenderRule uniqValRule = new UniqueValuesRenderRule();
  59.      uniqValRule.LookUpField = "oid";
  60.      uniqValRule.AddValue("1073");
  63.      //渲染方案
  64.      ITextRenderScheme textScheme = new TextRenderScheme();
  65.      textScheme.Symbol = textSymbol;
  66.      textScheme.AddRule(uniqValRule);
  67.      textRender.AddScheme(textScheme);
  68.      BuildingFl.SetTextRender(textRender);
  69. }

2. JavaScript

  1. //创建图层
  2. function createFeaturelayer(){
  3.      //初始化一个简易文字渲染
  4.      var textRender= __g.new_SimpleTextRender;//文字渲染器
  5.      //此处用的是模型图层为例，其他数据类型类似，只是渲染的文字风格不同
  6.      textRender.expression = "''..$(oid)";
  7.      var textSymbol = __g.new_TextSymbol;//文字样式
  8.      var textAttribute = __g.new_TextAttribute;//文字属性
  9.      textAttribute.textColor =0x64FFFFFF;
  10.      textSymbol.textAttribute=textAttribute;
  11.      textSymbol.pivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  12.      textSymbol.verticalOffset = 10;
  13.      textRender.symbol=textSymbol;
  16.      var fl = __g.objectManager.createFeatureLayer(fc, geoName, textRender, null, __rootId);
  17. }
  20. //1、简易文字渲染
  21. function changeSimpleSymbol(){
  22.      var textRender= __g.new_SimpleTextRender;//文字渲染器
  23.      textRender.expression = "''..$(oid)";
  24.      var textSymbol = __g.new_TextSymbol;//文字样式
  25.      var textAttribute = __g.new_TextAttribute;//文字属性
  26.      textAttribute.textColor =0xff097CEA;
  27.      textSymbol.textAttribute=textAttribute;
  28.      textSymbol.pivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  29.      textSymbol.verticalOffset = 10;
  30.      textRender.symbol=textSymbol;
  31.      buildingFl.setTextRender(textRender);
  32. }
  35. //2、多专题的文字渲染器,通过设置范围来渲染不同范围的模型
  36. function changeValueSymbol(){
  37.      //文字渲染风格
  38.      var textRender = __g.new_ValueMapTextRender;
  39.      textRender.expression = "''..$(oid)";
  42.      //文字属性
  43.      var textAttribute = __g.new_TextAttribute;
  44.      textAttribute.textColor = 0xff097CEA;
  45.      textAttribute.font = "黑体";
  46.      textAttribute.textSize = 50;
  49.      //文字样式  
  50.      var textSymbol = __g.new_TextSymbol;
  51.      textSymbol.textAttribute = textAttribute;
  52.      textSymbol.pivotAlignment = gviPivotAlignment.gviPivotAlignBottomCenter;
  55.      //渲染规则                    
  56.      var uniqValRule = __g.new_UniqueValuesRenderRule;
  57.      uniqValRule.lookUpField = "oid";
  58.      uniqValRule.addValue("1073");
  61.      //渲染方案
  62.      var textScheme = __g.new_TextRenderScheme;
  63.      textScheme.symbol = textSymbol;
  64.      textScheme.addRule(uniqValRule);
  65.      textRender.addScheme(textScheme);
  66.      buildingFl.setTextRender(textRender);
  67. }

3. 注意

  1. 文字渲染 必须设置symbol，默认文字不显示
  2. 简易文字渲染包含各种数据类型的图层设置，不仅是模型图层，也可以是点线面图层
  3. 专题渲染可以同时添加多个渲染规则