You need to enable JavaScript to run this app.
导航
素材包结构说明(v4.2.1及以上)
最近更新时间:2025.03.31 20:19:45首次发布时间:2022.02.25 17:16:51
我的收藏
有用
有用
无用
无用
素材包结构说明(421及以上)
前言

此文档适用于SDK v4.2.1及以上的版本。
如果使用的CV SDK版本在4.7.1及以上,美颜和微整形的素材详解 可移步至:美颜&微整形素材详解(v4.7.1及以上) , 其他模块的素材路径可继续查看该文档。

ModelResource.bundle

此bundle内包含不同算法相关模型文件,应用相应算法时需要有对应算法模型文件

StickerResource.bundle

此bundle内包含已授权的贴纸素材

LicenseBag.bundle

此bundle内包含授权license文件

ComposeMakeup.bundle

大部分的特效素材都在 ComposeMakeup.bundle 中,包括美颜、微整形、美体、美妆。 其中美颜、微整形、美体是一个素材支持多种类型的,开放的功能可以到各自的文件夹下找到 .config_file,解析出支持的内容。

性能消耗建议:

  • 若同一素材包,包含多个小项功能,只开启一个小项与开启全部小项的性能消耗是一样的。

举例: beauty_Android_lite(包含美白、磨皮、锐化、清晰),4项全开和1项全开性能消耗是一样的,其余如reshape_lite(微整形若干项)同理。 特别注意部分素材包下存在两个子素材包,例如beauty_4Item(法令纹、亮眼、黑眼圈、白牙)中白牙和(法令纹、亮眼、黑眼圈)分属两个子素材包,开关白牙对整体性能有影响,而法令纹、亮眼、黑眼圈 3个全开和只开1个是一样的性能消耗。

  • 加载素材包后,将素材强度置为0,与强度非0为一样的性能消耗,不加载素材包时才不存在对应性能消耗。

  • 整体而言,pro素材的性能消耗大于lite素材。

结构说明

└── ComposeMakeup 
   ├── beauty_4Items                           // 包含白牙、亮眼、法令纹、黑眼圈四项 
   ├── beauty_Android_lite                     // lite 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_Android_standard                 // standard 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_IOS_lite                         // lite 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_IOS_standard                     // standard特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_Android_lengbai_lite             // lite 冷白,4.5.0后新增素材 
   ├── beauty_IOS_lengbai_lite                 // lite 冷白,4.5.0后新增素材 
   ├── beauty_Android_fenbai_lite              // lite 粉白,4.5.2后新增素材 
   ├── beauty_iOS_fenbai_lite                  // lite 粉白,4.5.2后新增素材 
   ├── beauty_Android_rosy_lite                // lite 美白-红润,4.7.0新增素材
   ├── beauty_IOS_rosy_lite                    // lite 美白-红润,4.7.0新增素材
   ├── beauty_Android_fenbai_standard          // standard 粉白,4.5.2后新增素材 
   ├── beauty_iOS_fenbai_standard              // standard 粉白,4.5.2后新增素材 
   ├── reshape_lite                            // lite 特效微整形,包括面部、眼睛、鼻子、嘴巴等若干项 
   ├── reshape_standard                        // standard 特效微整形,包括面部、眼睛、鼻子、眉毛、嘴巴等若干项;4.7.0版本微整形pro里的瘦脸-瘦脸、小脸、窄脸、小头、v脸、发际线单独有子文件夹。
   ├── reshape_boy                             // lite 瘦脸-男神瘦脸,4.4.3版本新增 
   ├── reshape_girl                            // lite 瘦脸-女神瘦脸,4.4.3版本新增 
   ├── reshape_nature                          // lite 瘦脸-自然脸,4.4.3版本新增 
   ├── reshape_lite_eye_size                   // lite 大眼,4.5.0新增素材 
   ├── reshape_standard_girl                   // standard 瘦脸-女神瘦脸,4.5.0版本新增 
   ├── reshape_standard_boy                    // standard 瘦脸-男神瘦脸,4.5.2版本新增 
   ├── reshape_standard_nature                 // standard 瘦脸-自然脸,4.5.2版本新增 
   ├── reshape_v8                              // 包含微整形pro里的瘦脸-瘦脸、小脸、窄脸、小头、v脸,4.7.0版本新增
   ├── reshape_forehead                        // 微整形pro里的发际线,4.7.0版本新增
   ├── body 
   │   └── allslimqy                           // 美体,含长腿、瘦身 
   │   └── allslim                             // 美体,含长腿、瘦身、小头、瘦腿、瘦腰、丰胸、美胯、天鹅颈、瘦手臂(3931后美体更新至此子文件夹,但在390及以上版本可使用)。4.5.0版本后丰胸美胯单独有子文件夹。4.7.0版本瘦腿单独有子文件夹。   
   │   └── allslim_breast                      // 4.5.0版本后美颜美型pro的丰胸和美胯两个小项 
   │   └── allslim_prev                        // 4.7.0版本新增,只包含瘦腿
   ├── blush                                    // 腮红 
   │   └── lite                                // lite 腮红 
   │   └── standard                            // standard 腮红,可调节颜色 
   ├── eyebrow                                  // 眉毛 
   │   └── lite                                // lite 眉毛 
   │   └── standard                            // standard 眉毛,可调节颜色 
   ├── eyelashes                                // 睫毛,可调节颜色 
   ├── eyeshadow                                // 眼影 
   ├── eyelight                                 // 眼神光 
   ├── double_eye_lid                           // 双眼皮 
   ├── wocan/double_eye_lid                     // 卧蚕/双眼皮 
   ├── facial                                   // 修容 
   │   └── jingzhi                             // lite 修容-精致
   │   └── ziran                               // pro 修容-自然
   │   └── xiaov                               // pro 修容-小v脸
   │   └── fajixian                            // pro 修容-发际线
   │   └── gaoguang                            // pro 修容-高光
   │   └── shensui                             // lite 修容-深邃,4.7.0版本新增
   │   └── yingjun                             // pro 修容-英俊,4.7.0版本新增
   ├── hair                                     // 染发 
   ├── hack                                     // 祛斑祛痘 
   ├── lip                                      // 口红 
   │   └── lite                                // lite 口红 
   │   └── standard                            // standard 口红,可调节颜色 
   ├── pupil                                    // 美瞳 
   ├── palette                                          // 画质 
   ├── hack/yunfu_fengying_liuchanglian_standard        //原肤(匀肤)、面部填充(丰盈)、轮廓平滑(流畅脸)  
   ├── hack/acne_removal_lite                           //祛斑祛痘 
   ├── style_makeup                                     // 风格妆,包含滤镜、妆容                                                  
                               └── qise                                                                                                                                  
                               └── xxxx

开放功能说明

.config_file 示例:

[

    "whiten",

    "sharp",

    "smooth"

]

文件内容为一个 json 列表,每一项对应一个功能的 key。

滤镜序号对应

每一个滤镜都对应一个序号,可通过滤镜素材名查找,如 Filter_01_38 对应为序号为 1 的滤镜,下面为查询表,前面为滤镜在 sample 中的名称拼音,后面为对应的滤镜序号。

{
 "roubai": 1,    
"baixi": 1,    
"naiyou": 2,    
"yangqi": 3,    
"jiegeng": 4,    
"luolita": 5,   
 "mitao": 6,   
 "makalong": 7,   
 "paomo": 8,   
 "yinghua": 9,   
 "qiannuan": 10,   
 "wuyu": 11,   
 "beihaidao": 12,    
"riza": 13,    
"xiyatu": 14,    
"jingmi": 15,    
"jiaopian": 16,    
"nuanyang": 17,    
"jiuri": 18,    
"hongchun": 19,    
"julandiao": 20,    
"tuise": 21,    
"heibai": 22,    
"wenrou": 23,    
"lianaichaotian": 24,    
"chujian": 25,    
"andiao": 26,    
"naicha": 27,    
"soft": 28,    
"xiyang": 29,    
"lengyang": 30,    
"haibianrenxiang": 31,   
 "gaojihui": 32,   
 "haidao": 33,    
"qianxia": 34,    
"yese": 35,    
"hongzong": 36,    
"qingtou": 37,    
"ziran2": 38,    
"suda": 39,    
"jiazhou": 40,    
"shise": 41,    
"chuanwei": 42,    
"meishijiaopian": 43,    
"hongsefugu": 44,    
"lvtu": 45,    
"nuanhuang": 46,   
"landiaojiaopian": 47,
 "lengbaipi": 48,
"touliang": 49,
"liangju": 50,
"hutaomu": 51,
"shenhe": 52,
"degula": 53,
"lise": 54,
"yelin": 55,
"nuanshi": 56,
"qipaoshui": 57,
"liaoli": 58,
"tanshao": 59,
"jingdu": 60,
"haian": 61,
"lvyan": 62,
"wanying": 63,
"qingcheng": 64,
"aizhicheng": 65,
"CT": 66,
"EK": 67,
"FJ": 68,
"heijin": 69
"heben": 70
}

demo中tab和滤镜以及序号的对应关系

demo中的tabdemo中的名称(中文)demo中的名称(英文)序号

Portrait 人像

柔白

snow white

1

自然natural38
初见first sight25
清透clear37
温柔gentle23
恋爱超甜sweet love24
softsoft28
冷白皮Pale48
透亮Lucency49
亮橘Bright Orange50
高级灰advanced grey32
海边人像beach portrait31
冷氧cool oxygen30
红棕red brown36
奶茶bubble tea27
暗调dark26
浅暖mousse10
胡桃木Walnut51
深褐Dark Brown52
德古拉Dracula53
奶油creamy2
马卡龙macaron7
氧气oxygen3
物语story11
洛丽塔doll5
桔梗grandiflorum4
栗色Maroon54
椰林Coconut Forest55
Food 美食食色yummy41
川味spicy42
苏打soda39
暖食Warm Food56
气泡水Sparkling Water57
料理Cuisine58
炭烧Grill59

Landscape 风景

樱花

sakura

9

加州california40
蜜桃peach6
浅夏early summer34
海岛island33
北海道hokkaido12
夕阳sunset29
夜色night35
京都Kyoto60
海岸Coast61
绿妍Green62
晚樱Evening Sakura63
青橙Green Orange64
爱之城Love of City65
Retro 复古美式胶片movie43
红色复古vintage red44
旅途journey45
暖黄warm yellow46
蓝调胶片blue film47
日杂japan magazine13
CTCT66
EKEK67
FJFJ68
Stylization 风格化红唇red lips19
橘蓝调orange blue20
褪色color fading21
黑白black and white22
黑金Black Gold69
赫本Hepburn70
Un-grouped 未分组 (4.4.0 later version will not show these filters in demo)(4.4.0后下架滤镜)泡沫foam8
西雅图seattle14
静谧quite15
胶片film16
暖阳sun17
旧日old days18