# 图像

> 图像素材库：导入 PNG 和 JPG 文件、什么会被拒绝、卡片网格和它的检视面板、连同引用一起重命名一张图像、删除、一张图像用在哪里，以及报告的默认徽标从哪里来。

**Images** 是 Assets 根下面的第一个类别：工作站自己拥有的那些图片，从你挑的文件导入进来，再加上产品自带的四张图像（Ganter Lab 的标记和徽标，浅色深色各一张）。面板标题是“图像”，配一行“供仪表画面图像组件和报告版式使用的导入图片。”，还有一枚数量胶囊（“4 张图像”）。读它需要**查看 Logic**；导入、重命名和删除需要**配置 Logic**。

## 导入图像… {#import-image}

Images 那一行上的命令是一个文件选择器（导入图像…）：它打开浏览器自己的文件对话框，在工作站窗口里和在远程浏览器里同样管用，并且在你所在的那台机器上读取文件。素材库接受：

| 规则 | 什么会被拒绝 |
| --- | --- |
| 扩展名是 `.png`、`.jpg` 或 `.jpeg` | 其余一律不收：“‘.gif’不是支持的图像类型。请使用 PNG 或 JPG。” |
| 内容是一整个 PNG 或者一整个 JPEG | 改了名的 HEIC、PDF 或网页，以及复制到一半被截断的文件，都用同一句话拒绝 |
| 最大 16 MB | “该图像超过了 16 MB 的上限。”，按浏览器报出的大小拒绝，字节还没开始传就被挡下 |

字节被复制进应用自己的素材文件夹，用一个不透明的文件名存下，所以源文件被移走或者删掉，这张图片照样在。素材库里的名称是文件去掉扩展名之后的名字；它规整出来的那一段不能和别的图像撞上。成功之后新卡片被选中，它的检视面板打开，树上的数量增加，操作记录条说“图像已导入。”；被拒绝时说“导入失败：…”。

## 目录 {#the-catalog}

卡片显示缩略图、名称和来源（产品图像是**系统**，导入的是**我的**）。筛选项：**来源**和**每页**；素材库为空时说“还没有图像。请用任务栏上的‘导入图像…’添加一张。”，筛选之后为空时说“没有图像符合这个筛选条件。”，并给出**清除筛选**。网格和翻页的其余行为，和每一个[素材库](logic-assets#the-shape-every-library-shares)一样。

## 检视面板 {#the-inspector}

选中一张卡片会把图片放大显示，加上它的名称，以及：

| 行 | 它显示什么 |
| --- | --- |
| 地址 | `Assets.Images.<segment>`：一个输出为图片的变量为这张图片返回的那个地址 |
| 来源 | 产品素材库，或者我的素材库 |
| 类型 | PNG 或 JPG，取自文件的扩展名 |
| 尺寸 | 图片的像素大小，在它显示出来的时候测得（“1280 × 720 像素”），在那之前是一条短横线 |
| 文件大小 | 磁盘上的大小（B、KB 或 MB），文件不在时是一条短横线 |

系统图像显示“系统图像是只读的。”。一张“我的”图像会为拥有“配置 Logic”的角色提供**编辑**和**删除**；工作站被锁住或者有一条素材库命令在跑的时候，这两个都置灰。

## 编辑 {#edit}

**编辑**会在网格的位置上打开“编辑 `<name>`”（“重命名这个稳定的图像素材，并可选择一并更新它的引用。”）：图片，加一个**名称**字段，它是一个和[变量](logic-variables#name-and-address)一样的重命名字段。你打字的时候有一行预览影响范围（“重命名会更新读取这个地址的 2 处位置。”“没有任何引用使用当前地址。”，或者新名称规整之后还是同一段时的“有效地址不会改变，没有引用需要更新。”）。按回车，或者离开这个字段，就提交（“有效的重命名在按回车或焦点离开该字段时保存。”）：图像保留它的 id 和它的文件，指向旧地址的每一处带根引用都被改写，操作记录条说“图像已重命名，更新了 N 处引用。”。已经被占用的名称就地在字段下面被拒绝。**返回**回到目录。给图像重命名走的是和给图标或颜色重命名一样的引用改写。

## 报告的徽标 {#the-report-logo}

一份[报告版式](process-reports)画的徽标，是它点名的这个素材库里的图像。没有点名任何图像的版式，画的是工作站[品牌](settings-branding)里的徽标，它不是这个素材库里的图像：素材库没有自己的徽标可选。从曾把一张图像标为组织徽标的版本升级上来的工作站上，每份没有点名图像的版式都改成了点名那张图像，所以每份报告印的徽标和以前一样，那张图像也仍留在这里。

## 删除 {#delete}

**删除**会问“要删除‘X’吗？指向它的引用会退化成占位图形。此操作无法撤销。”，然后把这一行和这个文件一起移走；点名它的仪表画面图像组件或者报告，在它的位置上什么都不画。操作记录条说“图像已删除。”。系统图像不能删除。

## 一张图像用在哪里 {#where-an-image-is-used}

仪表画面上的[图片](component-image)组件画的就是这个素材库里的一张图像，要么是它自己点名的那张，要么是一个输出为图片的[变量](logic-variables#output-types)返回的那张（`Assets.Images.<name>` 解析成素材 id）；一份报告版式把它点名的图像画成徽标。别的东西都不读这个文件夹：图像不是图标，不能当图元绑定，也不会提供给外部的 OPC UA 客户端。

## 这个素材库不做的事 {#what-the-library-does-not-do}

它不缩放、不裁剪、不转换图片，不接受 SVG、GIF、BMP 或 WebP，不把图像分文件夹整理，也不就地替换一张图像的字节：请导入新文件，再把用过旧图的地方重新指过去。