1.1 2D 资源铭文 2D Res Inscriptions

这个chapter是Metaverse Resources Inscriptions专门针对所有2D资源所定义的创始资源铭刻规范。虽然是实验性的，并且不一定完善。但是已经基本满足大部分2D资源的关键属性要求，以满足大部分应用和引擎调用。

本2D 资源铭刻规范仍处于测试阶段，不代表其最终完成程度。

这章节主要说明2D Res Inscriptions的 metaverse的属性块相关基础属性，关于metaversepreview请见chapter1.1.1的详细说明

单一图片资源 Single Image Resource

这是当资源为单张2D图片资源时所需填写的相关铭刻属性关键字。我们以一个漂亮像素图片椅子为例

web preview display

<metaverse
	name="chair"
	description="This is a pixel chair, you can use it anywhere"
	src="/content/2a42c7779edi04591981ec0c1253cdd68de55205bb7e9f04ffacc0756921efc0c7"
	srctype="PNG"
>
</metaverse>

<metaversepreview
	backgroundcolor="0b9db7"
	>
	<previewimg 
		src="/content/2a42c7779edi04591981ec0c1253cdd68de55205bb7e9f04ffacc0756921efc0c7"
	/>
	<previewimg 
		src="/content/6f7c28ce0f87f498ab4be1dc4e498c206b85a2646285609fd4392i0178090cf70d"
	/>
	<previewimg 
		src="/content/2c777cc0756d5bb198153cdde9f00c779edi0ef0594ffa692ec18c4e5522a40c12"
		size="[1,1]"
		position="[0.5,0.8]"
	/>
</metaversepreview>
<script  src="/content/5d1bc794cc8a7e2c0c1b104f5c10f5319b68796ac57eba02fe39b10761334192i0"></script>

单张图片形式的资源铭刻很简单，没有什么复杂的属性设置，相关的属性完整对照表如下。请仔细阅读。

本属性仅以单张图片为资源的key的参考和描述，一些非必要填写的属性这里就没有对齐进行设置，其非必要相关属性参考详情请见metaverse属性key列表

No Required 的属性虽然可以不设置，但是不设置这些属性将会影响到引用其相关属性的游戏和应用，不同的游戏和应用可能需要设置自己的默认加载属性来给这些属性动态赋值。而设置这些属性，便于统一生态属性。也便于不同应用之间的统一规范。

key	Required?	Description
name	Yes	资源名称，用作资源的标识符。
description	No	资源描述
src	Yes	铭刻依赖相关资源的链上id地址，例如2D资源的图片或3D资源的模型。
srctype	Yes	资源格式，例如图片资源为PNG、JPEG，模型资源为OBJ、FBX、GLB。
any key you want	No	可以自行添加自定的key 当然，您可以添加任何您喜欢的自定义属性。推荐的密钥格式为“custom_yourtypename”。不带“custom”关键字的属性要么是协议的创世属性，要么是与后续社区投票相关的属性。

图集资源 Atlas Image Resource

当资源为一个图集，并且资源只引用图集中某一位置的相关图片时。其资源的相关属性。我们以这个圣诞树为例的一个铭刻参考为例：

web preview display

atlas range area

<metaverse
	name="christmas tree"
	description="This is a christmas tree"
	src = "/content/085a2646285118ce090cf70d6f7c2bf87f498ab4be788c4392i02dc4e406609fd9"
	srctype="PNG"
	isatlas="true"
	atlasrange="[0,96,32,48]"
>
</metaverse>

<metaversepreview
	backgroundcolor="0b9db7"
	>
	<previewimg 
		src="/content/085a2646285118ce090cf70d6f7c2bf87f498ab4be788c4392i02dc4e406609fd9"
		isatlas="true"
		atlasrange="[0,96,32,48]"
	/>
	<previewimg 
		src="/content/6f7c28ce0f87f498ab4be1dc4e498c206b85a2646285609fd4392i0178090cf70d"
	/>
	<previewimg 
		src="/content/1d98ab4bc17826462e8786f7c28806b5609fd4392i0090cf70df45ace0f4e498c2"
		size="[0.4,0.4]"
		position="[0.8,0.25]"
		rotation="30"
	/>
</metaversepreview>
<script  src="/content/5d1bc794cc8a7e2c0c1b104f5c10f5319b68796ac57eba02fe39b10761334192i0"></script>

这里只对其特有属性key进行说明，其余属性请出参考2D单张图片资源key描述

key	Required?	Description
isatlas	Yes	如果引用资源是图集中的一张图，那么此属性为必须填写的属性。设置isatlas为true，即为标记为图集
atlasrange	Yes	此属性为标注图集中的一个区域，[x,y,z,w] x,y: 为划分图引用区域起始的像素坐标 z,w：为改区域的长宽值。 具体见 图 Atlas Range Area

Animation Sheet Resource

当资源为一个2D动画序列帧时，其资源的相关属性设置，这里我们以一只可爱的小狗为例进行说明：

<metaverse
	name="CuteDoge"
	description="This is a cute dog with animation, you can use it anywhere"
	src = "/content/4acc4304ab4b62855ad8540c4effd6f70410ce3gg50e7886109ad985dc2ba2642"
	srctype="PNG"
	issheetanimate="true"
	sheetlayout="[8,5]"
>
	<animate name="idle-down" range="[0, 0]" duration="0.9" />
    	<animate name="idle-up" range="[1, 1]" duration="0.9" />
    	<animate name="idle-right" range="[2, 2]" duration="0.9" />
	<animate name="idle-left" range="[3, 3]" duration="0.9" />
	<animate name="move-right" range="[8, 15]" duration="0.9" />
    	<animate name="move-up" range="[16, 23]" duration="0.9" />
    	<animate name="move-down" range="[24, 31]" duration="0.9" />
	<animate name="move-left" range="[32, 39]" duration="0.9" />
</metaverse>

<metaversepreview
	backgroundcolor="0b9db7"
	>
	<previewimg 
		src="/content/4acc4304ab4b62855ad8540c4effd6f70410ce3gg50e7886109ad985dc2ba2642"
		issheetanimate="true"
		sheetlayout="[8,5]"
		sheetindex="14"
	/>
	<previewimg 
		src="/content/6f7c28ce0f87f498ab4be1dc4e498c206b85a2646285609fd4392i0178090cf70d"
	/>
	<previewimg 
		src="/content/2c777cc0756d5bb198153cdde9f00c779edi0ef0594ffa692ec18c4e5522a40c12"
		size="[1,1]"
		position="[0.5,0.25]"
	/>
	<previewimg 
		src="/content/1d98ab4bc17826462e8786f7c28806b5609fd4392i0090cf70df45ace0f4e498c2"
		size="[0.4,0.4]"
		position="[0.8,0.8]"
		rotation="-30"
	/>
</metaversepreview>
<script  src="/content/5d1bc794cc8a7e2c0c1b104f5c10f5319b68796ac57eba02fe39b10761334192i0"></script>

这里只对其特有属性key进行说明，其余属性请出参考2D单张图片资源key描述

单项基础属性：

key	Required?	Description
issheetanimate	Yes	如果引用资源是一个动画序列帧，那么此属性为必须填写的属性。设置issheetanimate为true，即为标记2D sheet 动画资源
sheetlayout	Yes	动画序列帧的横竖tiling 划分[x,y] x : 横向数量 y : 纵向数量

动画相关属性(多项)：

属性块以<animate ... />为划分。其中子属性如下表：

key	Required?	Description
name	Yes	动画名称
range	Yes	动画起始帧以及结束帧[x,y] 起始帧结束帧即sheet图片中划分的格子编号，由左至右，由上至下，左上角为0，右下角为最后编号 x : 起始编号 y : 结束编号
duration	Yes	播放速度,(整个动画的播放总时间，以秒s为单位)
loop	No	是否循环