1.1.2 位图浏览器 Bitmap Explorer

Bitmap Explorer相关资源铭文除了metaverse相关属性设置外，还有自定义应用的属性设置，其位于<bitmap-explorer>相关属性块中。

位图浏览器协议仍在不断发展和更新。以下示例并不代表最终协议。

范例 Example:

我们将前两章中的可爱的小狗，赋予Bitmap Explorer特有属性，使其支持Bitmap Explorer的应用支持。

理论上应用或者游戏(appdata)针对通用资源应该是有默认加载设置的，因为基础属性已经完全够应用和游戏去引用。只是某些属性并不是通用属性，应用想要支持更多的相关资源，应该对其默认加载设置进行通用化处理，给与一些属性以默认值。当资源没有设置这些属性时，应用方以默认方式方式加载。

<metaverse
	...
>
	...
</metaverse>

<bitmap-explorer
	category="owner"
	type="pet"
	usable="1"
	shape="rect"
	shaperange="[0.1, 0.1]"
	pivot="[0.5, 1.0]"
	size="[0.1, 0.1]"
	height="0.06"
	speed="1.5"
>
	<animation name="idle-down" srcname="idle1" perframespeed="0.1" loop="true"/>
	<animation name="idle-up" srcname="idle2" perframespeed="0.1" loop="true"/>
	<animation name="idle-right" srcname="idle3" perframespeed="0.1" loop="true"/>
	<animation name="idle-left" srcname="idle4" perframespeed="0.1" loop="true"/>
	<animation name="move-right" srcname="move1" perframespeed="0.1" loop="true"/>
	<animation name="move-up" srcname="move2" perframespeed="0.1" loop="true"/>
	<animation name="move-down" srcname="move3" perframespeed="0.1" loop="true"/>
	<animation name="move-left" srcname="move4" perframespeed="0.1" loop="true"/>
</bitmap-explorer>

<metaversepreview
	...>
	...
</metaversepreview>
<script  src="/content/5d1bc794cc8a7e2c0c1b104f5c10f5319b68796ac57eba02fe39b10761334192i0"></script>

基础 base

存在于<bitmap-explorer>属性块中的相关属性便是Bitmap Explorer所特有的相关属性。

Metaverse Resources Inscription中关于 appdata 这以一块的属性自定义添加规则，属性名称为自定义，我们建议不要与html协议中相关属性块名称冲突。以避免web端加载时产生错误。比如这里我们使用"bitmap-explorer"为 appdata 的属性块名称。

Bitmap Explorer中地块的大小是严格定义的，我们将此大小定义为单位 1 。默认为10米。如果你的资源设定为 1米 x 1米。那么你就得将碰撞shaperange或者图形显示大小size设置为 0.1 的参考大小,此设置和原始图片资源大小无关，可以理解为：在设定的0.1x0.1的大小面积里拉伸填充了你的原始资源图片，所以size的长宽比尤其重要。设置不正确或者和你的原始资源大小长宽比不一样，那么你得到的显示效果将会被拉伸而得不到想要的显示效果。

Key	Required?	Description
category	No	资源相关使用状态: 默认为static 为BitmapExplorer中的使用状态，可为static或者owner static : 在BitmapExplorer中为静态物件，可用于固定放置 owner : 为个人资产，可以被使用或者动态设置的资产
type	No	资源所属类别: 默认为item 此类别会携带相关特殊属性，BitmapExplorer中有如下几种类别，他们分别携带了自己的功能属性 ground : 地板类别 flat：地板与物件的中间层(新增，实验得出) item : 物件类别 avatar : 角色类别 pet：宠物
construction	No	“它是一个布尔变量，不填写时默认为 false。设置为 true 时，该资源将被定义为可编辑单元，就像建造房屋的每一块砖一样。您可以在 Bitmap Explorer 中编辑它们，例如移动或者翻转，这样你就可以利用这个资源来构建你自己的元宇宙空间。
tag	No	分配给资源的标签，一个资源可以包含多个标签，这些标签将反映在位图资源管理器中的资源索引中。
useable	No	复用次数： 默认为1 此为当拥有该资源时在BitmapExplorer中可重复引用次数的设置，其参数为 可以设置为-1，0，以及其他正整数 -1 : 无限次 0 : 无法被引用 ≥1 的正整数 : 可被重复引用次用 (某些特殊的type会有默认的useable设置，当没有设置该属性时，会使用相关type的默认引用次数设置，比如当type设置为ground时，默认useable为-1.即可以无限次重复引用。 Tips:这个决定了你持有1个该420资源是可以在同一场景下使用的次数)
shape	No	碰撞体形状： rect ： 矩形 circle ：圆形
shaperange	No	碰撞范围参数 x,y x ：横向长度 y ：纵向长度
pivot	No	图片的参照点，以整个碰撞范围为参照，无论你的图片长宽是多少。 example：有一张图片为50x50。 如果设置pivot为[0.5，0.5]，即为将图片中心放置于上两个参数决定的 碰撞范围 的中心。 pivot为[0，0] 是整个碰撞范围的左下点 pivot为[1，1] 是整个碰撞范围的右上点 此值可以设置为小于0与大于1。这样设置会使图片中心偏移出碰撞范围以外，有些特殊情况你可能会用到
size	No	图片在场景中的显示大小。参考比例还是以整个BitmapExplorer的一个区块大小1为单位。 如果设置为[0.1，0.1]即将图片显示在0.1x0.1的区域中。 如果你没有设置这个参数，可能会得到一个大小错误的展示效果，所以我们强烈建议你设置这个参数。并且合理的计算长宽比来匹配图片的长宽比。
height	No	资源在BitmapExplorer中的高度，有些功能可能会用到 0.1即为高度为1米
speed	No	资源速度： 此资源在场景中的默认移动速度，一般是针对类别为avatar的相关属性设置参数。

动画 animation

animation为BitmapExplorer中的动画配置信息。旨在对BitmapExplorer中的动画进行匹配。当从metaverse中拿到相关的动画资源信息后，我们需要将该动画匹配到相关的动画中

由于动画为多项属性，所以放在多项属性块<animation ... />中填写，相关关键字为如下

key	Required?	Description
name	Yes	匹配动画的关键字(功能性关键字 important) 比如idle代表待机动画。这些关键字带有特定功能，详情请见动画配置表
srcname	Yes	此属性是从ordi中拿到的动画名称。如果资源中没有找到该名称，则不会加载，并且动画配置无效
perframespeed	No	重新定义动画每帧所需要的时间。单位为秒s 如果不填写则按照ordiverse中的配置来
loop	No	动画是否循环，默认为false。 当填写并且为true时，动画会一直循环播放

附录

对于移动的动画，进行了优化处理，支持单一动画，2方向动画，4方向动画，以及8方向动画，如果你的原始资源仅含有很少的动画，比如含有一个idle以及一个向左移动的动画，那么你只要将其匹配至idle和move-left上即可，其他各个方向上的会自动进行相关的匹配。需要注意的是，你的动画的方向性适配不要出现错误，如果你将一个向右的动画匹配到向左的动画关键字上，你便会得到一个倒着走的显示效果。

animation功能关键字表：

key	Description
idle	待机动画，也为默认动画。角色或者静态物件在场景中的默认播放动画
move	移动动画，当可移动物体配置该动画后，移动时便会播放该动画
idle-down	面向下边时的待机动画
idle-up	面向上边时的待机动画
idle-right	面向右边时的待机动画
idle-left	面向左边时的待机动画
move-right	向右移动的动画
move-up	向上移动的动画
move-down	向下移动的动画
move-left	向左移动的动画