使用指南
资产 / 图像 / ImageAsset节点
资产 / 图像 / ImageAsset 节点手册，包含 6 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：6
- 分类路径：资产 / 图像 / ImageAsset
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取所有属性 | imageAssetGetProperties | 1 / 5 | 立即继续 |
| 获取图片尺寸 | imageAssetGetSize | 1 / 1 | 立即继续 |
| 获取图片高度 | imageAssetGetHeight | 1 / 1 | 立即继续 |
| 获取图片宽度 | imageAssetGetWidth | 1 / 1 | 立即继续 |
| 获取像素格式 | imageAssetGetFormat | 1 / 1 | 立即继续 |
| 是否压缩图片 | imageAssetGetIsCompressed | 1 / 1 | 立即继续 |
获取所有属性
一次性读出图像资产的全部常用属性：像素宽高、尺寸、像素格式编号、是否为压缩纹理。等同于连接多个 获取类节点，但只用一个节点即可。适合序列化、调试、批量比较等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetProperties |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
width | 宽度 | 数据 | number | 宽度 图片水平方向的像素数（整数）。 | - | 可选 |
height | 高度 | 数据 | number | 高度 图片垂直方向的像素数（整数）。 | - | 可选 |
size | 尺寸 | 数据 | size | 尺寸 由宽度和高度组成的 Size 值，便利输出。 | - | 可选 |
format | 格式编号 | 数据 | number | 格式编号 一个整数，代表图片在内存里采用的存储格式（例如 RGBA8888、RGB_ETC2 等）。 | - | 可选 |
isCompressed | 是否压缩 | 数据 | boolean | 是否压缩 true：图片使用了压缩格式（ETC / PVR / ASTC 等）；false：未压缩（如 RGBA8888）。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取图片尺寸
获取图片尺寸：把图片的“宽度”和“高度”打包成一个尺寸输出。 例如一张 512×256 的图片，这里会输出 宽 512、高 256 的尺寸值，可直接连接到任何需要“尺寸”的端口（例如设置 UI 大小时）。 这是一个便利节点——效果和“获取图片宽度 + 获取图片高度 + 合成尺寸”相同，但只要一个节点即可。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetSize |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 尺寸 | 数据 | size | 尺寸 由图片宽度和高度组成的值（宽：像素数，高：像素数），可直接连到任何需要“尺寸”的端口。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取图片高度
获取图片高度：读出传入图片的高度，单位是像素（px）。 例如一张 512×256 的图片，这里会输出 256。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetHeight |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
height | 高度 | 数据 | number | 高度 图片垂直方向的像素数，是一个整数。例如 256 表示图片纵向有 256 个像素。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取图片宽度
获取图片宽度：读出传入图片的宽度，单位是像素（px）。 例如一张 512×256 的图片，这里会输出 512。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetWidth |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
width | 宽度 | 数据 | number | 宽度 图片水平方向的像素数，是一个整数。例如 512 表示图片横向有 512 个像素。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取像素格式
获取像素格式：读出图片的“像素格式”——说明每个像素在内存里是怎么存储的。 通俗解释：
- 常见的未压缩格式，比如每个像素用 红/绿/蓝（RGB）或 红/绿/蓝/透明度（RGBA）三~四个字节存储；
- 移动平台上常见的压缩格式，比如 ETC、PVR、ASTC，用更少的空间存储同一张图，代价是画质略有损失。 输出是一个整数编号，每个编号代表一种具体格式（比如 RGBA8888、RGB_ETC2 等）。多数情况下只需把它与事先约定的编号做比较（是否等于某个值），通常不需要直接看这个数字本身的大小。 例如：你想判断“这张图有没有透明通道”，可以判断该编号是否属于“带 Alpha 的未压缩格式”之一。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetFormat |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
format | 格式编号 | 数据 | number | 格式编号 一个整数，代表图片在内存里采用的存储格式（例如 RGBA8888、RGB_ETC2 等）。 只在和“已知格式编号”比较时使用，不要把它当普通数字参与运算。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
是否压缩图片
是否压缩图片：判断这张图是否使用了压缩格式。 通俗解释：
- 未压缩（结果为 false）：直接用颜色值存储每个像素，画质最好，但占用显存多。
- 已压缩（结果为 true）：使用 ETC / PVR / ASTC 等压缩格式存储，节省显存和带宽，画质会有少量损失，在移动设备上常见。 可以用它来做性能检查，或者针对不同图片走不同处理分支。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | imageAssetGetIsCompressed |
| 分类 | 资产 |
| 二级分类 | 图像 |
| 分组 | ImageAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
imageAsset | 图像资产 | 数据 | cc.Asset / ImageAsset | 图像资产 这里需要连接一张已经加载好的图片。 这个端口没有“选择图片”按钮，请先使用下面任一节点把图片读进内存，再把它的输出连接到这里： - 加载资产：从资产包按路径异步加载一张图。 - 获取资产：取出资产包里已经加载过的图。 - 远程加载：从网络 URL 加载一张图。 使用上述节点时，请把“类型”选项选为 IMAGE_ASSET（图像资产）。 本节点只负责读取图片信息，不会加载图片，也不会修改图片内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isCompressed | 是否压缩 | 数据 | boolean | 是否压缩 true：图片使用了 ETC / PVR / ASTC 等压缩格式；false：图片按未压缩方式存储（如 RGBA8888）。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。