图像分层

云形空间允许你动态地向图像内的具体位置添加层层,新层加到基图像上作为叠加,并易变换以适应需求向基础图像添加新层有多重选项,或上传到云化图像、远程图像或文本字符串

图像层可添加底线取而代之特殊层应用相加云变换

例子中有一些常用案例可用层实现(并用其他变换方式实现)。点击每一图像查看每个案例应用的 URL参数

层变换语法

最简单形式上,基础图像上加层需要按URL语法处理:

上头层积参数自有URL组件并启动叠加定义(类似于开括号)。上头层位应用标志分立分解关闭定义(类似闭锁括号)并指令云形置放

通过控制位置和方式增强层设置基底图像使用重力,偏差等布置修饰符,并应用变换分层资产使用以下通用URL语法

验证或私有层

可添加图像叠加验证或私有通过修改语法:

• 私有层 :l_private:
• 认证层:l_authenticated:

图像叠加

默认叠加类型为图像举例说,向基像添加标识叠加l_docs:logo-semi-opaque/fl_layer_apply:

远程图像叠加

远程图像(图像不存储于云式产品环境)加载叠加取回或URLsdks属性层积参数(l_fache:URLs中)和Base64远程图像编码URLURL通用语法添加远程图像

举个例子,添加远程图像叠加https://res.www.agrosoland.com/demo/image/upload/logos/cloudinary_icon_white.png向基础图像

文本叠加

添加文本叠加基础图像文本翻译属性层积参数(l_text:内URLs)参数还需要具体说明字体家属和大小(除以下加加结号后加结号)和文本字符串显示URL通用语法添加文本层采取下列形式:

除要求字体和大小定型值外,还可以可选指定各种类CSS定型参数并深入定制文本层,具体说明文本颜色,添加线间拆解符,emojis等特殊字符文本层选项.

云型先生成文本定义图像,再像其他图像重叠一样叠加,并支持所有不变变换图像叠加支持

以80像素大小覆盖Arial字体文本串“Coffee”(80像素)l_text:Arial_80:Coffee/fl_layer_apply:

层置

上头fl_laya应用构件不单作用图层闭锁括号,还用于包含控制图层嵌入基像的任何选项,并包含覆盖元件和基像关系的任何细节

定位层重力

判定新层位置时,可添加重力参数定义位置将图层置入基像中上头重力参数加进同构件层位应用国旗

举个例子,向基图像添加图像叠加重力设西l_lotus_layer/fl_layer_apply,g_west:

微调层的确切位置,通过加法从重力焦点中抵消重叠X级并y市坐标偏移参数或小数值表示百分位偏移

举例说,将文本覆盖距离图像顶部5%垂直距离l_text:Roboto_400:Paradise/fl_layer_apply,g_north,y_0.05:

重叠特殊位置

重力参数也可以设置为图像内自定义区域,在布置叠加时即为焦点这些特殊位置是图像内由云性自动检测到的位置(例如a脸部中定义坐标图像上传或由云式加子检测到(例如图像内的眼睛或文字)。

完整列表中所有特殊位置可用与重力参数叠加处理,见 切换参考指南

例举 :

1. 添加叠加紫色mask图像遍面检测couple-cornfield图像 :

   

2. 使用OCR文本检测提取上传图像中检测到的任何文本

   

可能还想定位叠加,确保避免特殊位置看吧位置叠加避免检测到的面孔举个例子来说明如何实现这一点

层溢出行为

默认情况下,如果图层(图像或文本)宽度或高度大于基图像,交付图像画布将调整大小以显示全层如果您想确保交付大小永远不大于基图像,您可以使用基图像fl_no_overflow与构件同列层位应用国旗

举例说无溢出禁止标识重叠扩展基像画布c_scale,w_400/l_cloudinary_icon_blue/fl_layer_apply,fl_no_overflow:

层变换

可应用重定大小等变换选项上铺像从云里运来的其他资产可应用多项链式转换叠加方式层位应用组件.所有链式变换,直到转换构件包括层位应用上加叠加或下加代替基资产应用层位应用标志关闭层,类似于闭合括号)

例举 :

1. 添加标识重叠缩至原宽度的50%并制成水印亮度效果变换图像再放成图层底层角l_cloudinary_icon_blue/c_scale,w_0.5/o_70/e_brightness:50/fl_layer_apply,g_north_east:

   

2. 基像缩放至500像素宽度后再添加图像叠加,即叠加自动裁剪成150px缩略图,仅包括检测到的脸并放左上角c_scale,w_500/l_docs:model/c_thumb,g_face,w_150/fl_layer_apply,g_north_west:

   

多重重叠

多叠加很容易作为链式变换资产下示例向基像添加图像和文本叠加如下:

1. 图像叠加调用雨伞伸展到300px并置左上角l_umbrella/c_scale,w_300/fl_layer_apply,g_north_west)
2. 图像叠加调用cloudinary_icon_white相对宽度为基像50%,不透明度为50%,亮度为100l_cloudinary_icon_white/c_scale,fl_relative,w_0.5/o_50/e_brightness:100/fl_layer_apply)
3. 白文本字符串“London”用粗体reboto字体80像素,距离基础图像底部20像素co_white,l_text:roboto_80_bold:London/fl_layer_apply,g_south,y_20)

嵌套层

多层可嵌入多层每一层必须有自己的层层位应用组件内层必须在外层前关闭,像嵌套编程语句

举个例子, 添加文本到月球叠加 :

第一图像层变换大小 第二图层文字层配置字体大小第二层闭合并安装fl_laya应用.未指明重力后置外层应用关闭并定位整层(包括嵌套层)并定位东北角

相对层分层

默认时,每当应用相对大小转换为叠加上叠图像相对于原创大小调整大小可使用下方标志之一相对于其他元素调整大小

相对于基图像小化

可添加相对标志fl_restiURL中指定百分数宽高参数叠加(例如W_0.5)与基图像大小相对比,而不是与原叠加图像本身大小相对比

举个例子,添加图像覆盖调用stamp-exclusive-premium上铺重排至基图像宽度的70%l_stamp-exclusive-premium/c_scale,fl_relative,w_0.7/fl_layer_apply:

相对于检测区域小化

可添加区域相对性标志fl_region_relative求云器比照通过指定重力类型检测到的区域大小

• 区域可检测脸部g_face,g表情检测OCR文本区域g_ocr文本或预定义定制区g_定制)
• 标记必须与相对值(十进制值)宽度或高度限定值并用

举例说,用emoji叠加覆盖图像隐藏所有脸部,即每个叠加大小为1.3x(130%)l_happy_smiley/c_scale,fl_region_relative,w_1.3/fl_layer_apply,g_faces:

文本层选项

文本层可以多种方式定制化,例如应用类CSS样式、添加换行器、应用特殊字符、定制字体等

定型参数

除需要字体家属和字体大小值文本层支持各种可选CSS类样式,如装饰、对齐、字母间距、线间距等全表见定型参数表格参考指南

云型SDK帮助者方法支持提供数组映射值或串行值例例Ruby使用相似语法
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

以75像素加下划线和14像素字母间距覆盖文串Verdana粗体l_text:Verdana_50_bold_underline_letter_spacing_14:Style:

文本颜色

可添加文本叠加控制颜色颜色显示属性上头内URLs)

不透明颜色可设置为 RGBex三联co_rgb:3e222三位数RGBxco_rgb:777或命名颜色cogreen)默认时,如果颜色属性省略,文本有黑色

文本字符串“Style”用Times粗体加90像素距离基准图像底部20像素使用黄文本

4位数或8位数RGBAex四轮曲co_rgb:3e22240产生25%不透明性)

下示例使用相同的文本字符串Times粗体90像素距离基像底20像素黄文本,但这次不透明度为50%(FFF0080):

多行文本

可手动破线文本分行并用新线字符 (%0A)插文字符串 Verdana粗体,大小为50像素,距离基像左框10像素,每个字显示新行行间距为-15像素:

自动线课间休息

云性还可自动将文本包成多行,基于文本字符串规定最大宽度要做到这一点,应用适配裁剪模式到文本层并指定宽度使用词打包设置通知云式自动将实际文本内容包到新线上

宽度为400像素的基础图像添加长文本字符串粗体26像素

使用时适配高山市文本Fit某些SDKs裁剪模式中,你必须指定文本叠加宽度,但高度可选性线间拆解按需实现请求宽度和/或高度矩形

指定字体大小的叠加保持原样,即使结果文本叠加高度超过主机图像高度不限制叠加高度 图像高度扩展以适应大文本

限制叠加高度,则切除与定义空间不相容的文本并存lipsis.)添加到文本字符串尾以表示文本缺线

定义多行文本最大高度添加高度显示参数加法宽度变大小变换文本层

也可以设置文本对齐线间距值以进一步控制文本外观可应用其他大小参数作为整个叠加动作(fl_layer_apply前)重排生成文本图像叠加整体

中心对齐大像像素中添加长文本字符串14像素基映像,宽度为200像素并限制高度为150像素并旋转文本9度并设置北边界30像素以更好地与底层图像对齐

特殊字符

含有特殊字符的文本字符串需要修改(规避)并加文本叠加特征使用与不允许使用有效URL路径中的任何特殊字符相关联,并与其他特殊Unicode字符相关联文本字符串应使用%基础UTF-8编码免用,以确保文本字符串有效(例如替换?带3F并使用20词间空格)使用云型SDK嵌入图像时自动完成编码帮助者方法只需手动构建资产交付URL

外加逗号,前向斜线/百分数符号百分数或文本叠加字符双向scape华府百分数代码内签名例举 :

• 向文本叠加添加逗号252C并不只是2C)

• spend URL代码%E2%9D%80.如果要将emoji写进文本叠加中, 您也必须同时跳出百分数脱机代码符号l_text:Arial_80:Comfort%25E2%259D%2580:

自定义字体

默认情况下,只有通用字体才支持文本叠加但如果想使用非标准字体,可上传至云形原生,验证文件后指定字体满公共标识包括扩展字串覆盖

自定义字体指南

• .tf,.OTF并.woff2字体类型支持

• 自定义字体必须上传原创认证文件.

  小技巧

  自定义字体可以通过媒体库上传签名创建(或使用现有) 上传预置何地 交付类型预置选项设置 验证.向媒体库上传文件时可使用此上传预设 媒体库上传预置For 原生文件.

  

  或选签名上传预置媒体库上传部件s类高级上传资产时设置,如果该选项对您的账号启动

• 自定义字体公有标识包括斜线,用结号分隔符指定公有标识路径例举 :path1:path2:myfont.ttf.

• 参考文件时确定包含文件扩展公共标识原文件集扩展必须在小写字母中指定

• 使用粗字体或斜字体样式,上传每个按键样式的单字体文件并具体说明叠加变换中相关文件

• 自定义字体只上传到特定产品环境

• 自定义字体名不支持斜线上传字体为原始文件时,确保公共标识不包括下划线

• 和上传到云端的任何资产一样,你有责任确保你拥有定制字体使用所需的许可和再分配权。

预定义文本模板

避免每次需要动态添加文本叠加资产时指定字符型参数,可使用文本图像公共标识文本翻译方法上传API.相同的样式创建文本图像 也将动态应用到文本叠加默认文本字符串也使用,除非您提供一个新的文本字符串,如果您不想文本字符串出现在URL中或文本字符串长则有用。

举例说,添加文本字符串“时态文本”,使用相同的样式创建文本图像时使用命名sample_text_style罗波托字体82大小、粗体和红色

文本层标志

文本层文本内容常由程序用户或外部源实时提供可使用以下标志帮助处理这些场景 :

• fl_disallow_overflow:如前所述层溢出行为上方可控制大图像或文本层使用fl_no_overflow国旗

  文本叠加时,如果您不想长文本影响预期交付资产大小,但意外修饰可能冒切换基本文本的风险,您可应用fl_disallow_overflow令溢出文本层的 URL失效并返回400(错误请求)错误

  更多细节和实例见fl_no_overflow并fl_disallow_overflow中变换引用.

• fl_text_no_trim默认时文本层全端严格剪切在某些情况下,特别是如果在文本周边添加边框或对文本层使用重力可能将文本离图层边缘太近时,可使用图层fl_text_no_trim点旗对文本叠加字符串例举 :
  

图像底层

下置图像部分透明基像内接参数(欧市和公开标识前上传图像后台图像公开标识后台)通语法

可使用宽度和高度判定内接度,并使用重力参数和xy参数调整基图位置下拉也可以深入变换象上传到云性的其他图像一样,底线参数支持与上文描述的重叠相同的特征

举个例子,添加内置图像调用网站bg向基础图像下拉图像和基图像均调整为相同的宽度和高度,使用亮度效果将亮度提高至100度c_fill,h_200,w_200/u_site_bg/c_scale,h_200,w_200/e_brightness:100/fl_layer_apply:

水印

可使用标准图像层对交付图像应用水印不透明度和/或亮度变换常应用到图像层当水印

也可以使用自动打瓦机和/或智能反清除效果图层变换实现水印需求

自动打字

与其把水印图层加到单位具体位置,倒不如加插图层图象翻转式修饰词fl_tel内URLs)上头翻转式标志添加到同构件层位应用国旗举个例子 平铺图像cloudinary_icon_white上基图像l_cloudinary_icon_white/fl_layer_apply,fl_tiled:

智能反清除

可使用反清除效果e_anti清除以随机方式略微修改图像叠加量,从而使它们更难去除(例如,将标识加为资产水印)在大多数情况下,默认修改水平设计为视觉难感知,但仍难清除需要时,您可选择控制偏差水平,即通过添加冒号后加整数(数字越高图像变换越多)。上头反清除效果添加到同构件层位应用国旗

举例说,将反清除效果(高水平为演示目的90)加到图像叠加上调用cloudinary_icon_blue添加到基值东北角上,叠加不透明度定在50%并缩放至宽度150像素c_scale,w_500/l_cloudinary_icon_blue/c_scale,w_150/o_50/e_anti_removal:90,fl_layer_apply,g_north_east:

全文语法:e_anti清除中变换引用.

特殊层应用

除主要使用层将其他资产或文本放入基图像外,一些变换特征使用层选项指定公共标识码用于基图像实现期望效果下特征以特殊方式使用层变参数

特征特征	描述性
三维LUTs	3D查找表(3DLUTs)用于映射LUT层中的色空间到基图像中的色空间
位移地图	位移图层图像像素强度变换像素
混合掩蔽层	效果混合或掩码基像像素
样式转移	云形神经艺术风格移植从源艺术层图像提取艺术风格并应用到基图像内容
形状裁剪	删除或保留基础图像区域基于层图像中的不透明形状