ノード一覧に戻る

画像読込

image_load

ファイルから画像を読み込みます(PNG, JPEG等に対応)

確認済み
解説あり

出力ポート

名前説明
画像
output
Image
読み込まれた画像

パラメータ

名前既定値範囲説明・選択肢
ファイルパス
path
FilePath

画像ファイルのパス

概要

外部の画像ファイル(PNG/JPEG/BMP/GIF/WebP)をグラフに取り込む入口です。 手描きのドット絵に加工を足す、参考画像から色を拾う、写真をドット絵化する—— 「既にある画像から始める」ワークフローはすべてここから始まります。

使い方のポイント

  • 素材はプロジェクトフォルダに取り込むのが基本。「設定 > 一般 > ポータブル保存」の 「外部参照ファイルをプロジェクトへコピー」をONにしておくと、選んだ画像が projects/<プロジェクト>/assets/images/ にコピーされ相対パスで参照される。 プロジェクトフォルダごと移動・共有しても画像が読める
  • 読み込んだ画像のサイズはそのまま。キャンバスに合わせたい場合は後段に canvas_resize / fit_to_canvas / crop をつなぐ
  • 写真やフルカラー画像をドット絵にする定番: image_load → pixel_scale(縮小) → palette_quantize(減色) → dither

よくある失敗

  • プロジェクトを移動したら画像が消えた: 絶対パスで外部参照している。上記の 素材コピー設定をONにして選び直すのが確実(未保存プロジェクトではコピーできないので 先に保存する)
  • Asepriteファイルが読めない: .ase/.aseprite はこのノードではなく aseprite_load (レイヤー・フレーム単位で取り込める)
  • GIFがアニメとして読まれない: 読み込まれるのは静止画像。アニメとして扱う場合は フレームを分解した素材を使う

使用例

  1. image_load → hsv_adjust → 書き出し : 既存素材の色調整
  2. image_load → height_from_image → surface系 : 手描き絵に立体感のある陰影を付ける
  3. image_load(参考画像) → palette_extract : 画像からパレットを抽出して配色に流用

関連ノード

  • aseprite_load — Asepriteファイル(.ase/.aseprite)のレイヤー・フレーム読込
  • palette_load — 画像ではなくパレットファイルの読込
  • canvas_resize / crop — 読み込み後のサイズ合わせ
  • palette_quantize — フルカラー画像の減色
ノード一覧に戻る
画像読込 — PixPipeline ノード解説