首页 > 代码库 > osgearth earth文件规范-符号参考

osgearth earth文件规范-符号参考

osgearth earth文件规范-符号参考

osgEarth用样式表渲染要素和注记。

本文档列出了可在样式表中使用的所有符号属性。不是每个符号是适用于每种情况;这只是一个主列表。

 

跳转到符号:

 

  •Geometry

 •Altitude

 •Extrusion

 •Icon

 •Model

 •Render

 •Skin

 •Text

 

开发人员注意:

 

 

在SDK 中,符号在osgEarth::Symbology命名空间中,每个符号类是以类似AltitudeSymbol这样的形式。下面的属性就是他们出现在earth文件中;在 SDK中,可以以LineSymbol::strokeWidth()等形式通过存取器获得属性。

 

值类型

 

这些是基本值类型。在此页的符号表中,各个属性包括其说明后的括号中的值类型。

float:浮点数

带单位的float:带单位指示符的浮点数,例如 20px 的浮点数 (20 像素) 或 10 米 (10 米)

HTML_Color:十六进制格式的颜色字符串,如HTML所使用的方式如。像#RRGGBB或 #RRGGBBAA 的格式。(示例: #FFCC007F)

integer:整形数据

numeric_expr:可解析为一个数的表达式 (简单或JavaScript)

string:简单的文本字符串

string_expr:可解析为一个文本字符串的表达式 (简单或JacaScript)

uri_string:

用于表示资源位置 (如 URL 或文件路径)的字符串,Uri可以是绝对或相对 ;相对 Uri 始终是所处位置的引用,即,请求该资源的实体。(例如,earth文件内的相对URI 将是earth文件本身的所处位置。

 

几何图形

 

基本几何符号(SDK:LineSymbol, PolygonSymbol, PointSymbol) 控制矢量数据的颜色和样式。

 

 

属性

说明

  值

fill

为多边形填充颜色。 

HTML 颜色

stroke

线颜色 (或多边形的轮廓颜色,如果存在fill参数)

HTML 颜色

stroke-width

线宽

 带单位的float

stroke-min-pixel

最低渲染宽度 ;防止线变薄比以像素为单位 的该值更小                                   仅适用于当stroke-width不是以像素为单位时

 float(像素)

strok-tessellation

细分线的次数

 integer

stroke-linejoin

加入 polygonized 线样式。仅适用与stroke-width是在世界单位 (而不是以像素为单位)

miter,round

stroke-linecap

  Polygonized 线帽样式。仅适用与stroke-width是在世界单位 (而不是以像素为单位)

square,flat,round

stroke-rounding-ratio

用于联接和caps为round,也是圆角上分辨率。值是到角线段长度线宽度的比例。

float(0.4)

stroke-stipple-pattern

  点模式下的位掩码。每个设置的位模式中表示像"On"。

  integer(65535)

stroke-stipple-factor

点画像素宽度的线的因素。数重复描模式中的每一位

 integer(1)

point-fill 

填充颜色的点。 

  HTML 颜色

point-size

GL 几何图形上点的尺寸  

 float(1.0)

 


 

海拔高度

 

海拔高度符号(SDK:AltitudeSymbol) 控制与它的位置根据地形功能交互。

 

属性

说明

altitude-clamping

控制地形跟随行为。

 

        none:不使用夹持

 

        terrain:  夹持地形并减去Z值

 

        relative:夹持地形并减去Z值

 

        absolute:要素的Z 包含其Z值的绝对值.

 

altitude-technique

当altitude-clamping 设置为terrain时,请选择一个贴合地形技术:

         map:几何图形紧贴到地图上的高程数据

 

         drape:用投影纹理紧贴几何图形地图上的高程数据

 

         gpu:在GPU上把几何图形紧贴到地形上

 

         scene:重新夹紧几何图形到新分页的图块上 (仅适用于注记)

altitude-binding

当altitude-technique为map时在Granularity上采样:

 

        vertex:夹紧每个顶点

 

        centroid:只夹每个功能的质心

altitude-resolution

高程数据分辨率时,要抽样的地形高度海拔高度技术是映射(float)

altitude-offset

要应用于几何图形 Z 的垂直偏移量

altitude-scale

比例因子要应用于几何图形 Z

 

 

提示: 您可以也使用快捷方式激活表面附着或 GPU 夹紧 ;设置altitude-clamping为terrain-drape或terrain-gpu。

 

挤出

 

挤压符号(SDK:ExtrusionSymbol) 指示 osgEarth 源矢量数据 ; 从创建拉伸几何挤出一个 2D 向量变成 3D形状。注:挤压属性的简单的存在将使挤压。

 

属性

说明

extrusion-height

拉伸矢量数据到多远(numeric-expr)

extrusion-flatten

是否强制所有挤压到相同的 Z 值 (bool) 顶点。例如,如果您挤压的多边形,使 3D 建筑物,将此设置为true将强制屋顶是平的即使基础地形不是。(布尔值)

extrusion-wall-gradient

因子相乘的挤压几何在基地的 3D 形状的填充颜色。这将导致在被暗底部比顶部,效果好的 3D 形状。(浮 [0..1] ; 尝试 0.75)

extrusion-wall-style

名称相同的样式表中的另一种风格的那 osgEarth 应适用于墙壁延伸形状。(字符串)

extrusion-roof-style

名称相同的样式表中的另一种风格的那 osgEarth 应适用于屋顶延伸形状。(字符串)

 

皮肤

 

皮肤符号(SDK:SkinSymbol) 适用于几何图形,适用时的纹理映射。(此刻这仅适用于挤压几何)。

 

属性

说明

skin-library

包含 skin(s) 的资源库的名称

skin-tags

集的字符串 (以空格包含一个或多个资源标记分隔。在选择时要应用的纹理外观,osgEarth 将限制选择到皮肤与这些标记之一。如果您省略此属性,则认为所有皮肤。例如,如果你挤压的建筑物,你可能只想要考虑纹理与建筑标记。(字符串)

skin-tiled

当设置为true,osgEarth 才会考虑选择的外观,有其平铺属性设置为true。平铺属性指示皮肤可能用作重复纹理。(布尔值)

skin-object-height

数值表达式解析为该功能的实际高度 (以米为单位)。osgEarth 将使用此值来缩小到皮肤那样的高度适当选择 (即,为其值落在皮肤的最小/最大对象高度范围之间的外观。(数字-expr)

skin-min-object-height

告诉 osgEarth,只考虑最小对象高度不大于或等于此值的外观。(数字-expr)

skin-max-object-height

告诉 osgEarth,只考虑其最大对象高度是小于或等于此值的外观。(数字-expr)

skin-random-seed

筛选操作完成后 (osgEarth 根据以上的属性,将确定适当皮肤要从中选择的最小集和随机选择其中之一。通过设置此种子值,您可以确保相同的"随机"选项发生每次您运行应用。(整数)

 

 图标

 

图标符号(SDK:IconSymbol) 描述 2D 图标的外观。图标用于不同的东西,最常见的是:

 

  •指向模型替换-几何替换图标

 •地方批注

属性

说明

icon

图标图像的 URI。(uri-字符串)

icon-library

包含图标 (可选)资源库的名称

icon-placement

用于模型替换,描述osgEarth 应如何用图标替换几何形状:

         vertex:用图标替换几何图形上的每一个顶点

 

         interval:沿着几何图形按照icon-density属性有规律间隔地放置图标

 

          random: 将随机内几何,图标放置根据图标密度属性。将随机内几何,图标放置根据图标密度属性。

 

           centroid:将单个图标放置在几何的质心。

 

icon-density

图标位置的时间间隔或随机的此属性的设置是多少实例 osgEarth 提示应放置。单位是大约"单位每公里"(为线性数据) 或者"单位每平方米公里"多边形数据。() float

icon-scale

通过这一数值缩放图标 (float)

icon-heading

沿其轴线 (float、度) 旋转图标

icon-declutter

激活此图标为decluttering 。osgEarth 将尝试自动显示或隐藏的东西,所以他们不会重叠在屏幕上。(布尔值)

icon-align

  设置icon与锚点相对的位置,合法的值是具有“水平-竖直”格式的,如下所示:

  •left-top

 •left-center

 •left-bottom

 •center-top

 •center-center

 •center-bottom

 •right-top

 •right-center

 •right-bottom

icon-random-seed

对于随机放置操作,设置此种子以便随机化是可重复的每次您运行应用程序 (整数)

icon-occlusion-cull

是否剔除遮挡的文本,所以它们不显示时的视线受阻的地形

icon-occlusion-cull-altitude

查看器高度 (MSL) 开始扑杀时视线受阻的地形闭塞

 

模型

 

模型符号(SDK:ModelSymbol) 描述了外部的 3D 模型。像图标,模型,通常用于:

 

 

  •指向模型替换-替换的 3D 模型的几何形状

 •模型注释

 

属性

说明

model

3D 模型 (uri-字符串) 的 URI。此或模型库属性,但不是能同时使用。

model-library

资源库包含模型的名称。模型属性,但不是能同时使用此或。

model-placement

为模型代替,描述如何 osgEarth 应替换几何模型:

 

            vertex:替换模型在几何中的每个顶点。

 

            interval:将模型放在沿几何,定期根据模型密度属性。

 

            random:根据模型密度属性发生随机内的几何模型。

 

            centroid:一个单一的模型几何的质心在的地方。

 

model-density

对于模型放置的时间间隔或随机的此属性的设置是多少实例 osgEarth 提示应放置。单位是大约"单位每公里"(为线性数据) 或者"单位每平方米公里"多边形数据。() float

model-scale

这一数额沿所有轴 (float) 模型缩放

model-heading

旋转有关其 + Z 轴 (浮法、 度)

icon-random-seed

对于随机放置操作,设置此种子以便随机化是可重复的每次您运行应用程序 (整数)

 

 

渲染器

 

渲染器的符号(SDK: RenderSymbol) 适用于一般的 OpenGL 渲染设置,以及一些osgEarth 特定的设置,并不特定于任何其他符号类型。

 

属性

说明

render-depth-test

启用或禁用 GL 的深度测试。(布尔值)

render-lighting

启用或禁用 GL 照明。(布尔值)

render-depth-offset

启用或禁用深度消法。深度偏移是修改一个片段的深度值,模拟该对象近或离查看器中的呈现,比实际的 GPU 技术。它是为减轻 z 战斗的机制。(布尔值)

render-depth-offset-min-bias

设置最小偏见 (距离到查看器偏移量) 的深度偏移。如果是通常不足以设置此属性 ;所有其他人都将被自动设置。(浮法、 米)

render-depth-offset-max-bias

置最小偏见 (距离到查看器偏移量) 的深度偏移。

render-depth-offset-min-range

设置范围 (从查看器的距离) 在其应用抵消偏见的最小深度。偏见毕业生之间的最小和最大值在指定范围内。

render-depth-offset-max-range

设置范围 (从查看器的距离) 在其应用抵消偏见的最大深度。偏见毕业生之间的最小和最大值在指定范围内。

 

文本

 

文本符号(SDK:TextSymbol) 控制的存在性和外观的文本标签。

 

属性

说明

text-fill

前景颜色的文本 (HTML 颜色)

text-size

(浮法、 像素为单位) 的文本大小

text-font

要使用 (依赖于系统) 的字体的名称。例如,使用"arialbd"上 Windows 为 Arial 粗体显示。

text-halo

轮廓颜色的文本 ;省略此产权一共为没有轮廓。(HTML 颜色)

text-halo-offset

概述厚度 (浮法、 像素为单位)

text-align

相对于其锚点的文本字符串的对齐方式:

 

•left-top

 •left-center

 •left-bottom

 •left-base-line

 •left-bottom-base-line

 •center-top

 •center-center

 •center-bottom

 •center-base-line

 •center-bottom-base-line

 •right-top

 •right-center

 •right-bottom

 •right-base-line

 •right-bottom-base-line

 •base-line

text-layout

文本的布局:

  •ltr

 •rtl

 •vertical

 

 

text-content

要显示 (字符串-expr) 的实际文本字符串

text-encoding

字符编码的文本内容:

 

•utf-8

 •utf-16

 •utf-32

 •ascii

text-declutter

激活此图标为decluttering 。osgEarth 将尝试自动显示或隐藏的东西,所以他们不会重叠在屏幕上。(布尔值)

text-occlusion-cull

是否对遮挡剔除的文本,所以它们不显示时的视线受阻的地形

text-occlusion-cull-altitude

查看器高度 (MSL) 开始扑杀时视线受阻的地形闭塞

osgearth earth文件规范-符号参考