MSTAR工具之SkinTool使用说明V1.0
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
Gwin，或者是添加新的 Gwin（注意：如果在合程序、换屏参等涉及到 UI 部分转移的情 况，不能直接复制.xml 文件，要使用 Export、Import，这样方便快捷，可以保持 UI 框 架的阶级不变）。 7: GWIN 列表，所有 UI 显示部分都可以从这个列表中调出。 8：上移、下移、删除，记得移动时候要选中要移动的部分，删除时候不要一下删除过多的 选项，否则会出现假删除，即显示删除了，保存后，关闭在打开，看到删除项还在，没 有删掉。属性，GWIN 中每一个都有与之相对应的 Properties，显示其位置，大小以及其 他属性。 9：属性，即显示当前选中的 Gwin 的位置，长宽，以及其他的字符或图片等属性 10: 这三个按键是操作 GWIN 列表较为常用的键，因为 SkinTool 工具在打开任一类 GWIN List 时都会默认全部显示全部展开，用这三个键就可以方便的显示或者隐藏、展开或者合拢。
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
（2）编译说明： 1．Build->Project Properties Dialog 选项： 用于选择 Color 类型，我们现在使用的主要有 ARGB1555 和 RGB565。 2. Build->Build Table Option 选项 此对话框是用来设置编译文 件的类型和输出位置。三个 勾选处一定要选中，否则会 造成图片，文字等未调用或 者是调用错误；编译文件的 输出也要放在相应的网络盘 文件夹中，否则修改的 tool 编译会发现根本没有作用。
该 GWIN 的属性是 EN_ZUI_AUTOCLOSE_WINPROC,表示可以自动隐藏，时间就是后面 的“AUDIO_VOLUME_TIME_OUT_MS”的时间
显示音量的字符的属性要是动态的属性，因为其是 0-100 的变化的，不是某一个值，如果 你编译后调解音量有变化，但是数值没有变化，第一个就想到的是该 GWIN 的属性不对，
徐落意 xuly@siviton.com
2、 实际操作 (1) 修改篇
深圳市视纬通科技有限公司
以 Balance 为例，上图选中的是 MENU_SOUND_BALANCE 这一项，即 1 所指，这项是代 表 Balance 项光标，2、3 分别是代表 Balance 项的字符和数值。下图是 Balance 项光标的 Properties 选项；
4.字库修改编辑说明 MSTAR 给出的字库文件是.est 后缀的，这样添加字库，繁琐，而且不方便终端用户提供
翻译，这样操作工作量太大，所以我们使用.txt 的文档用 EXCEL 打开来编辑。 1. 用上图 3 中的导出当前 skintool 文件当前的 TXT 格式字库，然后右击字库选择打开方 式用 EXCEL 打开，打开后首先按照上面步骤 3 所说，将比例模式的修改为文本格式， 之后在修改为对应的比例模式。然后即可在对应的字库文件.txt 文档中添加修改字库 翻译等。记住第一次 TXT 字库文件导出的时候，有些会将 UP,DOWN 等图标也导出 到字库中，你修改完毕后，再次将.TXT 文件导入，这时候就会报错，你找到报错的 字符，然后将该行删除即可。
ZUI_AUDIO_VOLUME_styletables_c.inl：该文件主要是反映与 paint 相关的属性，指出 了 该 Gwin 下 所 有 部 件 的 DRAWCOMPONENT ， CP_BITMAP 、 CP_RECT 还 是 CP_FILL_RECT； ZUI_AUDIO_VOLUME_postables_c.inl：该文件反映了该 Gwin 下所有部件的从属关系以及 位置大小； ZUI_AUDIO_VOLUME_alphatable_c.inl：该文件反映了该 Gwin 下所有重叠界面间在 normal、 focused、disable、Alow src alpha overwrite dst alpha 这四种种情况下透明程度的数据。
1：选择 Button 项或 Rnd Gradient Btn 项，前者设置一块 control type 为 Static 区域，后者设 置一块 control type 为 Round Gradient Button 的区域，两者的区别在于 Advanced Settings 的 异同； 2：在需要的区域任意选择一块面积， 3：在 Gwin List 中就会有相应的 Item 。然后进入相应的 Properties，可以进行修改名称、位 置长宽、背景色等等。调整位置的时候可以设置为 Frame 架构，方便查看其上下左右长宽 的位置，有没有和前面的或者是后面的 Gwin 对齐 （3）删除 GWIN
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
1：背景色的选择。 2：以 Bitmap 作为背景，正常显示时候的 背景，选中时候的背景，以及无作用时候 的背景，根据图中可知，选中的时候是 MAINPAGE_IMG_FOCUS 图片为背景， 进图片中可以找到，该图片是淡绿色的， 即选中的时候是淡绿的背景，同理克隆它 的结构的也是这种方式。 3：Gradient 表示选择渐变色和渐变色的 方向等，在 Gwin 属性是 Round Gradient Button 时起作用 4：3D 效果的选择，在 Gwin 属性是 Round Gradient Button 时起作用 （2）增加 GWIN
3.Build->Build Confirm 选项 编译确认，选用默认设置即可
（3）图片导入，字库导入设置 Library->Image Library 、String Table Manager 选项
1：Add, Remove 用于添加新的图片和删除没用到的图片 Relink 和 Reflash 是用于导入 Bitmap 和刷新修改后的 Bitmap。
选中对应的 GWIN，然后选择 Delete 即可，注意删除的时候级别不要相差 3 级，否则 会出现假删除。
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
2：由于 Mstar 将图片的透明色定为（255，0，255），所以在要设置图片、图标透明度的时 候在勾选 Enable Color Key 选项，并将颜色改为上述值透明度值。 3.选择 ARGB1555 方式的有以下风格，ZERO 格式的，表示该图片有透明度，若是 ONE 就 没有透明度，即主菜单的透明度控制不到该图标的透明度属性
1、 简介 （1）主界面
深圳市视纬通科技有限公司
SkinTool 使用说明 V1.0
Байду номын сангаас
1: 设定适用的屏分辨率。 2: 放大或者缩小 GWIN 的图案，只是方便观看，无实际效果。 3：查看 UI 方式，即采用框架方式查看还是，带图片颜色等方式查看，方便添加 UI 以及查 看添加的 UI 是否对齐等。 4：显示方式，即显示的是正常的 Normal 时的，还是选中 Focus 时的，以及 Disable 时候的。 5：这个一个比较有用的按键，用于增加新的 ITEM，例如一个图案或者文字。 6：Export 将当前 Gwin 导出为.wls 文件，Import 将之前导出的.wls 文件导入，以替换当前
来不协调。
在 EXCEL 打开之后， 字符的 ID 号都是不带 en_str 的，而编译生成 到软件中的字库都是 带 en_str 的，从上图的 2 可以看到有在 skintool 工具中已经默 认加了前缀，所以添加 字库的时候不要再次 添加了前缀 en_str_以 免编译之后生成了多 余的前缀，使软件看起
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
要去看下，是否改为了动态属性“EN_ZUI_DYNAMICTEXT” 其他的一些属性列举 MAIN_MENU 的例子如下：
_MENU_SOUND_PAGE_DATA 表示 SOUND 页的 LIST 每页可以显示的首末字符， 下面的_MENU_SOUND_SNDMODE_Navigation，表示其的上下左右是什么 GWIN, _MENU_SOUND_MODE_KEY 表示当 FOUCS 在此 GWIN 时候可以操作哪些，分别有什 么作用
2. 如何提供字库给客户翻译 如一个新客户出口俄罗斯或者是阿拉伯等地区，虽然我们字库中都有默认的翻译，但
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
是不同的客户，要求的翻译会有差异，所以我们可以提供相应的 EXCEL 字库文件给 客户翻译，之后直接合进我们用的 EXCEL 即可，例如给客户翻译俄语字库具体做法 如下：公版字库复制粘贴备份一份，用复制的那份保留第一列字符 ID 名称，第四列 英文翻译，以及对应的俄语那列的翻译，其他的都删除，保存后发给客户，要客户根 据英文翻译，只核对翻译俄语那一列，中文部分不用翻译。客户核对翻译提供给我们 之后，我们就可以把客户翻译的俄语那列直接拷贝到公版中，用 Skintool 导入编译即 可，省时省力，减少很多工作量。 （4）Tool 选项（主要用于修改不同分辨率的 UI，非常有用）
Stretch System Panel：根据主界面中设置的屏分辨率自动调整各个 UI 的大小。 Stretch Gwin Windows：可以设置被选中的 Gwin 大小，Skintool 会自动调整此 Gwin 下的所 有窗口大小（注意：如果界面中有球状图片，建议不使用此功能，Stretch 会导致球的锯齿 加重）； Gwin Shift：可以调整被选中的 Gwin 的原点位置，Skintool 会自动调整此 Gwin 下的所有窗 口原点位置；
（5）Skintool 生成文件简介 对于任何一个 Gwin Skintool 在编译后都会生成几个文件，下面以 AUDIO_VOLUME 为例做 简单介绍 ZUI_AUDIO_VOLUME_tables_c.inl：该文件是 Skintool 针对 Audio Volume 生成的最主要文 件，它里面拥有了 Keymap_Table、Dynamic list、Navigation Table、Window List， Keymap_Table 区域设定了某个按键和相关动作（在 ZUI_exefunc.h 中）的链接； Dynamic list 区域是设定改 Gwin 中 Item 的首尾选项； Navigation Table 区域反映了该 Gwin 在 Skintool 中方位的导航； Window list 区域是该 Gwin 下所有部件的属性，包括控制属性、Item 范围属性、边框属性、 导航属性、按键属性等；
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
3.在修改或增减字符后需要将改动过的文件导入 SkinTool，这时就要选中图中红圈 1 的选项， 然后将.txt 文件导入即可。注意.txt 字库文件用 EXCEL 打开编译之前要将 4:3,16:9 以及 14:9 的字符要设置单元格格式为文本格式，否则编译后会错误的显示成 04:03,16:09 等错误的格 式。
1：Item Name 2：上一级菜单和控制方式（static or round gradient button 表示 为 Advanced Setting 的不同）。 3：坐标位置和高度宽度值 4：默认的状态，可选择可视、选 中、未激活以及透明度覆盖这三个 状态，旁边的 Frame 选项可以进一 步选择，处于这三种状态时的颜色 和边距。 5：此项 ITEM 的顺序位置。 6：是指两个重叠界面的透明度， 例 如 Menu 里 面 又 跳 出 一 个 Message Box，Alpha 为这二者之 间的透明程度，255 为不透明，0 为全透。 7：高级选项；图中 Clone（克隆） 是指保持和 menu_channel_autotune 的风格一 致。下图为 menu_channel_autotune 的 Advanced Settings
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
（2）编译说明： 1．Build->Project Properties Dialog 选项： 用于选择 Color 类型，我们现在使用的主要有 ARGB1555 和 RGB565。 2. Build->Build Table Option 选项 此对话框是用来设置编译文 件的类型和输出位置。三个 勾选处一定要选中，否则会 造成图片，文字等未调用或 者是调用错误；编译文件的 输出也要放在相应的网络盘 文件夹中，否则修改的 tool 编译会发现根本没有作用。
该 GWIN 的属性是 EN_ZUI_AUTOCLOSE_WINPROC,表示可以自动隐藏，时间就是后面 的“AUDIO_VOLUME_TIME_OUT_MS”的时间
显示音量的字符的属性要是动态的属性，因为其是 0-100 的变化的，不是某一个值，如果 你编译后调解音量有变化，但是数值没有变化，第一个就想到的是该 GWIN 的属性不对，
徐落意 xuly@siviton.com
2、 实际操作 (1) 修改篇
深圳市视纬通科技有限公司
以 Balance 为例，上图选中的是 MENU_SOUND_BALANCE 这一项，即 1 所指，这项是代 表 Balance 项光标，2、3 分别是代表 Balance 项的字符和数值。下图是 Balance 项光标的 Properties 选项；
4.字库修改编辑说明 MSTAR 给出的字库文件是.est 后缀的，这样添加字库，繁琐，而且不方便终端用户提供
翻译，这样操作工作量太大，所以我们使用.txt 的文档用 EXCEL 打开来编辑。 1. 用上图 3 中的导出当前 skintool 文件当前的 TXT 格式字库，然后右击字库选择打开方 式用 EXCEL 打开，打开后首先按照上面步骤 3 所说，将比例模式的修改为文本格式， 之后在修改为对应的比例模式。然后即可在对应的字库文件.txt 文档中添加修改字库 翻译等。记住第一次 TXT 字库文件导出的时候，有些会将 UP,DOWN 等图标也导出 到字库中，你修改完毕后，再次将.TXT 文件导入，这时候就会报错，你找到报错的 字符，然后将该行删除即可。
ZUI_AUDIO_VOLUME_styletables_c.inl：该文件主要是反映与 paint 相关的属性，指出 了 该 Gwin 下 所 有 部 件 的 DRAWCOMPONENT ， CP_BITMAP 、 CP_RECT 还 是 CP_FILL_RECT； ZUI_AUDIO_VOLUME_postables_c.inl：该文件反映了该 Gwin 下所有部件的从属关系以及 位置大小； ZUI_AUDIO_VOLUME_alphatable_c.inl：该文件反映了该 Gwin 下所有重叠界面间在 normal、 focused、disable、Alow src alpha overwrite dst alpha 这四种种情况下透明程度的数据。
1：选择 Button 项或 Rnd Gradient Btn 项，前者设置一块 control type 为 Static 区域，后者设 置一块 control type 为 Round Gradient Button 的区域，两者的区别在于 Advanced Settings 的 异同； 2：在需要的区域任意选择一块面积， 3：在 Gwin List 中就会有相应的 Item 。然后进入相应的 Properties，可以进行修改名称、位 置长宽、背景色等等。调整位置的时候可以设置为 Frame 架构，方便查看其上下左右长宽 的位置，有没有和前面的或者是后面的 Gwin 对齐 （3）删除 GWIN
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
1：背景色的选择。 2：以 Bitmap 作为背景，正常显示时候的 背景，选中时候的背景，以及无作用时候 的背景，根据图中可知，选中的时候是 MAINPAGE_IMG_FOCUS 图片为背景， 进图片中可以找到，该图片是淡绿色的， 即选中的时候是淡绿的背景，同理克隆它 的结构的也是这种方式。 3：Gradient 表示选择渐变色和渐变色的 方向等，在 Gwin 属性是 Round Gradient Button 时起作用 4：3D 效果的选择，在 Gwin 属性是 Round Gradient Button 时起作用 （2）增加 GWIN
3.Build->Build Confirm 选项 编译确认，选用默认设置即可
（3）图片导入，字库导入设置 Library->Image Library 、String Table Manager 选项
1：Add, Remove 用于添加新的图片和删除没用到的图片 Relink 和 Reflash 是用于导入 Bitmap 和刷新修改后的 Bitmap。
选中对应的 GWIN，然后选择 Delete 即可，注意删除的时候级别不要相差 3 级，否则 会出现假删除。
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
2：由于 Mstar 将图片的透明色定为（255，0，255），所以在要设置图片、图标透明度的时 候在勾选 Enable Color Key 选项，并将颜色改为上述值透明度值。 3.选择 ARGB1555 方式的有以下风格，ZERO 格式的，表示该图片有透明度，若是 ONE 就 没有透明度，即主菜单的透明度控制不到该图标的透明度属性
1、 简介 （1）主界面
深圳市视纬通科技有限公司
SkinTool 使用说明 V1.0
Байду номын сангаас
1: 设定适用的屏分辨率。 2: 放大或者缩小 GWIN 的图案，只是方便观看，无实际效果。 3：查看 UI 方式，即采用框架方式查看还是，带图片颜色等方式查看，方便添加 UI 以及查 看添加的 UI 是否对齐等。 4：显示方式，即显示的是正常的 Normal 时的，还是选中 Focus 时的，以及 Disable 时候的。 5：这个一个比较有用的按键，用于增加新的 ITEM，例如一个图案或者文字。 6：Export 将当前 Gwin 导出为.wls 文件，Import 将之前导出的.wls 文件导入，以替换当前
来不协调。
在 EXCEL 打开之后， 字符的 ID 号都是不带 en_str 的，而编译生成 到软件中的字库都是 带 en_str 的，从上图的 2 可以看到有在 skintool 工具中已经默 认加了前缀，所以添加 字库的时候不要再次 添加了前缀 en_str_以 免编译之后生成了多 余的前缀，使软件看起
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
要去看下，是否改为了动态属性“EN_ZUI_DYNAMICTEXT” 其他的一些属性列举 MAIN_MENU 的例子如下：
_MENU_SOUND_PAGE_DATA 表示 SOUND 页的 LIST 每页可以显示的首末字符， 下面的_MENU_SOUND_SNDMODE_Navigation，表示其的上下左右是什么 GWIN, _MENU_SOUND_MODE_KEY 表示当 FOUCS 在此 GWIN 时候可以操作哪些，分别有什 么作用
2. 如何提供字库给客户翻译 如一个新客户出口俄罗斯或者是阿拉伯等地区，虽然我们字库中都有默认的翻译，但
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
是不同的客户，要求的翻译会有差异，所以我们可以提供相应的 EXCEL 字库文件给 客户翻译，之后直接合进我们用的 EXCEL 即可，例如给客户翻译俄语字库具体做法 如下：公版字库复制粘贴备份一份，用复制的那份保留第一列字符 ID 名称，第四列 英文翻译，以及对应的俄语那列的翻译，其他的都删除，保存后发给客户，要客户根 据英文翻译，只核对翻译俄语那一列，中文部分不用翻译。客户核对翻译提供给我们 之后，我们就可以把客户翻译的俄语那列直接拷贝到公版中，用 Skintool 导入编译即 可，省时省力，减少很多工作量。 （4）Tool 选项（主要用于修改不同分辨率的 UI，非常有用）
Stretch System Panel：根据主界面中设置的屏分辨率自动调整各个 UI 的大小。 Stretch Gwin Windows：可以设置被选中的 Gwin 大小，Skintool 会自动调整此 Gwin 下的所 有窗口大小（注意：如果界面中有球状图片，建议不使用此功能，Stretch 会导致球的锯齿 加重）； Gwin Shift：可以调整被选中的 Gwin 的原点位置，Skintool 会自动调整此 Gwin 下的所有窗 口原点位置；
（5）Skintool 生成文件简介 对于任何一个 Gwin Skintool 在编译后都会生成几个文件，下面以 AUDIO_VOLUME 为例做 简单介绍 ZUI_AUDIO_VOLUME_tables_c.inl：该文件是 Skintool 针对 Audio Volume 生成的最主要文 件，它里面拥有了 Keymap_Table、Dynamic list、Navigation Table、Window List， Keymap_Table 区域设定了某个按键和相关动作（在 ZUI_exefunc.h 中）的链接； Dynamic list 区域是设定改 Gwin 中 Item 的首尾选项； Navigation Table 区域反映了该 Gwin 在 Skintool 中方位的导航； Window list 区域是该 Gwin 下所有部件的属性，包括控制属性、Item 范围属性、边框属性、 导航属性、按键属性等；
徐落意 xuly@siviton.com
深圳市视纬通科技有限公司
3.在修改或增减字符后需要将改动过的文件导入 SkinTool，这时就要选中图中红圈 1 的选项， 然后将.txt 文件导入即可。注意.txt 字库文件用 EXCEL 打开编译之前要将 4:3,16:9 以及 14:9 的字符要设置单元格格式为文本格式，否则编译后会错误的显示成 04:03,16:09 等错误的格 式。
1：Item Name 2：上一级菜单和控制方式（static or round gradient button 表示 为 Advanced Setting 的不同）。 3：坐标位置和高度宽度值 4：默认的状态，可选择可视、选 中、未激活以及透明度覆盖这三个 状态，旁边的 Frame 选项可以进一 步选择，处于这三种状态时的颜色 和边距。 5：此项 ITEM 的顺序位置。 6：是指两个重叠界面的透明度， 例 如 Menu 里 面 又 跳 出 一 个 Message Box，Alpha 为这二者之 间的透明程度，255 为不透明，0 为全透。 7：高级选项；图中 Clone（克隆） 是指保持和 menu_channel_autotune 的风格一 致。下图为 menu_channel_autotune 的 Advanced Settings