画像

これらのノードは、インターフェース用の画像ウィジェット nl.image を操作します——タイトル画面の絵、セーブスロットのサムネイル、装飾フレームなどです。ステージ画像やキャラクターの立ち絵、プレイ中にストーリーが表示するものとは一切関係ありません。それらはストーリーアセットであり、UI ウィジェットではありません。

規約

• Self ノードのみです。 ここには Element 入力を取るノードはありません。対象は常に、そのブループリントを所有する nl.image です。接続されたエレメントに対して働くバージョンは Element の blueprint.element.image.* で、それぞれ element:nl.image 入力を持ち、グラフにすでに互換性のあるバインディングがある場合にのみ現れます。
• 取得系ノードは pure、書き込み系ノードは latent です。 Blueprint Value のオーナーは widgetValue であり、取得系ノードは提供されません。Blueprint Value から画像を読み取るには、Element のバージョンを Element リテラルとともに使用してください。書き込み系ノードは、書き込みが完了するまでグラフを一時停止させます。
• ImageAsset は構造化された値です（{ kind: "imageAsset", assetId }）。単なる id 文字列ではありません。null 許容形の ImageAsset|null は、null を画像なしとして受け付けます。これらのピンに渡された素の string も、依然としてアセット id として読み取られます。これにより、この型が存在する前に保存されたグラフも動作し続けます。
• 書き込みはウィジェットの imageFill（mode、assetId、cropPlacement）または imageFlipX / imageFlipY を書き換え、その後エレメントの flush をキューに入れます。書き込む値がすでにある値と一致する場合は、何も起きません——パッチも flush も発生しません。
• 利用できない入力は現在の値にフォールバックします。 認識できない、または空のフィットモード、数値でない切り抜きパーセンテージ、未接続の真偽値は、いずれもそのプロパティをリセットせず、そのままにします。
• ジオメトリ、不透明度、バリアントはここにはありません。 位置、サイズ、回転、不透明度は Displayable に属します。また、Default 以外の外観バリアントが Default のフィルモードや切り抜きを上書きすることは決してありません——そのため、半透明のバリアントに切り替えても画像が crop のまま固まることはありません。
• 一部のノードは同じ種類のノードとしてまとめられます。 パレットを一覧するとき、Get Image Fit Mode、Get Image Crop Rect、Get Image Flip X、Get Image Flip Y は Get Image Framing（画像の表示方法を取得）、対応する設定ノードは Set Image Framing（画像の表示方法を設定）、Get Visible と Get Enabled は Get Visible or Enabled（表示・有効状態を取得）、Set Visible と Set Enabled は Set Visible or Enabled（表示・有効状態を設定）として、それぞれ 1 行で表示されます。検索すると各ノードが自分の名前で表示されます。配置したカードは、タイトルの横の ▾ で同じ種類の別のノードに切り替えられます。同じ種類のノードを参照してください。

Image Asset

blueprint.image.assetLiteral · Pure

アセットリテラルです。カードには現在のサムネイル、アセット名、または未設定の状態が表示されます。クリックすると画像アセットピッカーが開きます。

画像が選ばれていない場合、このノードは何も出力しません。これは ImageAsset|null 入力にとってはクリアするという意味になります。

Get Image Asset

blueprint.image.getImageAsset · Pure

Set Image Asset

blueprint.image.setImageAsset · Latent

ウィジェットが指す画像を切り替えて flush します。フィルモードと切り抜き矩形はそのままです。

未接続のままにすると、このピンはカード上で画像ピッカーとして展開されます。画像を選ぶとノードのパラメータに書き込まれ、クリアすると null が書き込まれます。接続すると、接続された値が優先されます。

Clear Image Asset

blueprint.image.clearImageAsset · Latent

ウィジェットの画像を取り除きます——Set Image Asset を null で呼ぶのと同じことを、ピンなしで行います。

Get Image Fit Mode

blueprint.image.getFitMode · Pure

モード

Set Image Fit Mode

blueprint.image.setFitMode · Latent

現在のアセットと切り抜き矩形を保ったまま、画像がボックスを満たす方法を変更します。

Get Image Crop Rect

blueprint.image.getCropRect · Pure

切り抜き矩形を読み取ります。4 つの数値は、元画像に対してではなくウィジェット自身のボックスに対するパーセンテージです：leftPct / topPct は画像の左上隅をボックス内のどこに置くかを、widthPct / heightPct は描画されるサイズを表します。したがって 0, 0, 100, 100——何も切り抜いていないときに得られる値——はボックスをちょうど満たすことを意味し、100 を超える値や 0 未満の値は、ボックスより大きい画像を表現する手段になります。

Set Image Crop Rect

blueprint.image.setCropRect · Latent

Get Image Flip X

blueprint.image.getFlipX · Pure

Set Image Flip X

blueprint.image.setFlipX · Latent

画像を中心を軸に左右反転します。反転するのは画像コンテンツのレイヤーだけです——ウィジェットのボックス、枠線、子要素には影響しません。

Get Image Flip Y

blueprint.image.getFlipY · Pure

Set Image Flip Y

blueprint.image.setFlipY · Latent

画像を中心を軸に上下反転します。

Get Visible

blueprint.image.getVisible · Pure

これは Displayable が visible プロパティキーとして公開しているのと同じ可視性です——1 つの値を、2 通りの方法で読んでいます。ウィジェットをレンダーツリーから取り除かずに非表示にしたい場合は、代わりに Displayable の Set Display を使ってください。

Set Visible

blueprint.image.setVisible · Latent

Get Enabled

blueprint.image.getEnabled · Pure

Set Enabled

blueprint.image.setEnabled · Latent

ウィジェットのインタラクションのオン・オフを切り替えます。これは内部の無効化機構にマッピングされます。作者向けに公開された interactionDisabled プロパティはありません。