# 画像

> 画像のライブラリ。PNG と JPG のファイルの取り込みと拒否されるもの、カードの並びとその検査、参照ごと画像の名前を変えること、削除、画像の使われ先、そしてレポートの既定のロゴの出どころ。

**Images** は、Assets の最上位の下の 1 つ目の分類です。このステーションが持つ絵で、選んだファイルから取り込んだものに、製品が最初から入れる 4 つの画像（Ganter Lab の印とロゴを、明るい地と暗い地それぞれに）を足したものです。パネルの見出しは「画像」で、「ダッシュボードの画像コンポーネントとレポート様式のために取り込んだ画像です。」の行と、件数のピル（「画像 4 件」）が付きます。読むには **Logic の表示**が、取り込み、名前の変更、削除には **Logic の構成**が必要です。

## 画像を取り込む… {#import-image}

Images の行の上の動詞は、ファイルの選択（画像を取り込む…）です。ブラウザー自身のファイルのダイアログを開き、ステーションのウィンドウからでも、離れたブラウザーからでも同じように働き、その場のファイルを読みます。ライブラリが受け付けるものは次のとおりです。

| 規則 | 拒否されるもの |
| --- | --- |
| 拡張子が `.png`、`.jpg`、`.jpeg` | それ以外のすべて。「「.gif」は対応していない画像の形式です。PNG か JPG を使ってください。」 |
| 中身が丸ごと 1 つの PNG か、丸ごと 1 つの JPEG であること | 名前だけ変えた HEIC、PDF、Web ページ、あるいは写している途中で切れたファイル。同じメッセージで拒否されます |
| 最大 16 MB | 「この画像は、上限の 16 MB を超えています。」ブラウザーが述べる大きさで、バイトが渡る前に拒否されます |

バイトは、アプリ自身の素材のフォルダーに、内容を表さないファイル名で写されるので、元のファイルが動いても消えても、その絵は残ります。ライブラリでの名前は、そのファイルの名前から拡張子を取ったもので、ほかのどの画像も使っていない区切りに変換されなければなりません。うまくいくと、新しいカードが選ばれ、その検査が開き、ツリーの件数が増え、操作ログ帯が「画像を取り込みました。」と伝えます。拒否のときは「取り込みに失敗しました：…」です。

## カタログ {#the-catalog}

カードは、縮小の絵、名前、出どころ（製品の画像は**システム**、取り込んだものは**自分のもの**）を見せます。絞り込みは**出どころ**と**1 ページの件数**です。空のライブラリは「画像はまだありません。コマンドバーの「画像を取り込む…」から追加してください。」と述べ、絞り込みの結果が空のときは「この絞り込みに合う画像はありません。」と**絞り込みを解除**が出ます。並びとページ送りのほかの振る舞いは、[どのライブラリ](logic-assets#the-shape-every-library-shares)とも同じです。

## 検査 {#the-inspector}

カードを選ぶと、その絵が大きく、名前とともに出て、次の行が並びます。

| 行 | 見せるもの |
| --- | --- |
| アドレス | `Assets.Images.<segment>`。出力が画像の変数が、この絵について返すアドレスです |
| 出どころ | 製品のライブラリ、または自分のライブラリ |
| 種類 | ファイルの拡張子から見た PNG か JPG |
| 寸法 | その絵のピクセルの大きさで、表示したときに測ります（「1280 × 720 ピクセル」）。それまでは横線です |
| ファイルサイズ | ディスク上の大きさ（B、KB、MB）。ファイルがないときは横線です |

システムの画像は「システムの画像は読み取り専用です。」と出します。自分のものの画像は、Logic の構成を持つロールに**編集**と**削除**を差し出します。この 2 つは、ステーションがロックされている間や、ライブラリの操作が走っている間は灰色になります。

## 編集 {#edit}

編集は、並びの代わりに「`<name>` を編集」を開きます（「変わらない画像の素材の名前を変え、必要ならその参照も更新します。」）。その絵と、[変数の名前](logic-variables#name-and-address)と同じ名前の変更の入力欄である**名前**の項目が出ます。入力している間、1 行が影響を予告します（「名前を変えると、このアドレスを読んでいる 2 か所が更新されます。」、「現在のアドレスを使っている参照はありません。」、あるいは新しい名前が同じ区切りに変換されるときは「実効アドレスは変わらないため、更新が必要な参照はありません。」）。Enter を押すか、入力欄から離れると確定します（「正しい名前は、Enter を押すか、入力欄から離れたときに保存されます。」）。画像はその id とそのファイルを保ち、古いアドレスへの最上位を根とする参照はすべて書き換えられ、操作ログ帯が「画像の名前を変え、参照 N 件を更新しました。」と伝えます。すでに使われている名前は、その入力欄の下でその場で拒否されます。**戻る**でカタログに戻ります。画像の名前の変更は、アイコンや色の名前の変更と同じ参照の書き換えを通ります。

## レポートのロゴ {#the-report-logo}

[レポート様式](process-reports)は、名指ししたこのライブラリの画像をロゴとして描きます。何も名指ししていない様式は、ステーションの[ブランド](settings-branding)のロゴを描きます。それはこのライブラリの画像ではないので、ライブラリには選ぶべき自分のロゴがありません。1 つの画像を組織のロゴとして印していた版から更新したステーションでは、画像を名指ししていなかったすべての様式がその画像を名指しするように設定されたので、どのレポートも前と同じロゴを印刷し、その画像はここに残ります。

## 削除 {#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 は受け付けません。画像をフォルダーで整理しません。そして、画像のバイトをその場で入れ替えることもしません。新しいファイルを取り込み、古いものを使っていたところを向け直してください。