v1.1.0

アニメーションのクリップを切り替えられるように

• アニメーションが複数入っているファイル (glTF / FBX) で、再生するクリップを選べるように
  なりました。ツールバーの選択ボックス、または [ / ] キーで切り替えます。
  クリップが 1 つ以下のファイルでは、選択ボックスは出ません。
• 左上のモデル情報のアニメ時間も、選んだクリップの長さになります。
• 操作説明 (H) に、クリップが複数あるときだけ「[ / ] : クリップ切替」を表示します。

---

English

Switch between animation clips

• For files that contain several animations (glTF / FBX), you can now choose which clip
  to play. Use the selector in the toolbar, or the [ / ] keys. The selector is hidden
  for files with one clip or fewer.
• The animation length in the model info at the top left now follows the selected clip.
• The help panel (H) shows "[ / ] : clip switch" only when the file has several clips.

v1.0.1

同じ名前のボーンとメッシュを持つ FBX で、アニメ時に体が崩れる不具合を修正

• FBX にボーンとメッシュのノードが同じ名前 (例: Body) で入っていると、アニメーションの
  再生時に股のあたりが前に垂れ下がるように崩れることがありました。ボーンとして正しい
  ノードを使うようにして、glTF と同じ見た目になります。
• (補足) OBJ / FBX / glTF で面が角ばって (フラットシェードで) 見えるのは、ファイルに
  記録された法線のとおりの表示です。.blend はこの情報を読み込めないため、なめらかに
  表示されます。

---

English

Fix a collapsed body during animation in FBX files with a bone and a mesh of the same name

• When an FBX contained a bone node and a mesh node with the same name (for example
  Body), the area around the hips could sag forward while the animation played. The
  correct node is now used for the bone, and the result matches the glTF version.
• Note: Models that look faceted (flat-shaded) in OBJ / FBX / glTF are displayed as the
  normals stored in the file specify. A .blend cannot provide this information when
  loaded, so it is shown smooth.

3D model viewer plugin v1.0.0

FBX に加えて、OBJ / glTF / glb / Blender の 3D モデルを表示できるように

• 対応する拡張子が、.fbx に加えて .obj / .gltf / .glb / .blend になりました。
  farman のファイル一覧からこれらを開くと、3D モデルビュアーが起動します。
• glTF / glb: FBX と同じく、テクスチャ (.glb の埋め込みと、.gltf の外部ファイルの
  両方)・骨格・スキニング・アニメーション・ノード階層を表示します。
• OBJ: メッシュ・マテリアル (.mtl)・テクスチャを表示します。
• Blender (.blend): メッシュとマテリアルを表示します。Blender は Z が上の座標系なので、
  読み込み時に立たせて表示します。骨格とアニメーションは読み込めません。また、新しい
  Blender で保存した .blend (圧縮形式など) は読めないことがあり、その場合は FBX や
  glTF への書き出しをお試しください。
• アニメーションが複数入っているファイルは、先頭のクリップを再生します。
• 0.4.x で追加した「ノード情報パネル」(i キー)、アニメの無いモデルの現在姿勢での表示、
  アニメ付きモデルでボーンに付けた小物の追従などは、すべての形式で使えます。

---

English

Display OBJ, glTF, glb and Blender 3D models, in addition to FBX

• The supported extensions are now .obj, .gltf, .glb and .blend, in addition to
  .fbx. Opening any of them from farman's file list starts the 3D model viewer.
• glTF / glb: As with FBX, textures (embedded in .glb, or external files for
  .gltf), skeletons, skinning, animation and the node hierarchy are displayed.
• OBJ: Meshes, materials (.mtl) and textures are displayed.
• Blender (.blend): Meshes and materials are displayed. Blender uses a Z-up
  coordinate system, so the model is stood upright when loaded. Skeletons and animation
  cannot be read. Also, a .blend saved with a recent Blender (a compressed file, for
  example) may not load; in that case, please try exporting it to FBX or glTF.
• For files that contain several animations, the first clip is played.
• The node info panel (i key) added in 0.4.x, the display of models without animation in
  their stored pose, and accessories attached to bones following the animation all work
  with every format.

3D model viewer plugin v0.4.0

ノード情報パネルを追加 (i キー)

• 画面右側に「ノード情報パネル」を表示できるようになりました。i キー、または
  ツールバー右端の「i」ボタンで表示 / 非表示を切り替えます (初期は非表示)。
• FBX 内部のノード階層を、接続線つきのツリーで表示します。各ノードは開閉でき、
  「すべて展開」「すべて閉じる」ボタンも使えます。ボーンには [bone]、メッシュを
  持つノードにはメッシュ名が付きます。
• ノードを選ぶと、ツリーの下に詳細を表示します (種別・親子・位置/回転/スケール・
  メッシュの頂点数 / 三角形数 / マテリアル・ボーンが影響する頂点数・配下のメッシュ合計)。
• 選んだノードは 3D ビューでも強調されます。メッシュやグループは色付けされ、ボーンは
  影響する範囲が色付けされて、関節にリングと名前が表示されます。
• モデル全体の情報 (ファイル名・メッシュ数・頂点数・テクスチャなど) は、左上の
  操作説明パネルの上に表示するようになりました。

アニメーションの無いモデルが、Unity Editor と同じ姿勢で表示されるように

• ボーンを持ち、アニメーションを含まない FBX が、T ポーズではなく、ファイルに
  記録された関節の現在姿勢 (腕を下げた姿勢など) で表示されます。剣などボーンに
  取り付けられたパーツも、手の動きに追従して正しい位置に表示されます。
• メッシュごとにボーンの基準が異なる FBX (パーツが多く、ボーンが 100 本を超える
  キャラクターなど) で、表示が崩れる問題を修正しました。

アニメ付きモデルで、ボーンに付けた小物がアニメに追従するように

• 手に持たせた剣や杖など、ボーンの子ノードにした「スキンなしのメッシュ」が、アニメに
  追従せず、最初の位置に固定されていた問題を修正しました。

その他

• モデル全体の情報パネルとツールバーのテクスチャ表示は、フルパスではなくファイル名だけを
  表示するようにしました (フルパスはツールバーのツールチップに表示されます)。パスが長いと
  パネルがモデルに重なったり、ツールバーの「i」ボタンが隠れたりしていました。

---

English

Added a node info panel (press i)

• A node info panel can now be shown on the right side of the view. Toggle it with
  the i key or the "i" button at the right end of the toolbar (hidden by default).
• It shows the node hierarchy inside the FBX as a tree with connecting lines. Each
  node can be expanded or collapsed, and there are "Expand all" / "Collapse all"
  buttons. Bones are marked [bone], and nodes that hold meshes show the mesh names.
• Selecting a node shows its details below the tree: type, parent and children,
  position / rotation / scale, mesh vertex and triangle counts and material, the
  number of vertices a bone affects, and the total of the meshes under the node.
• The selected node is also highlighted in the 3D view. Meshes and groups are tinted,
  and for a bone the area it influences is tinted, with a ring and its name drawn on
  the joint.
• Information about the whole model (file name, mesh count, vertex count, textures,
  and so on) now appears above the controls panel in the top-left corner.

Models without animation now appear in the same pose as in Unity Editor

• FBX files that have a skeleton but no animation are now shown in the joint pose
  stored in the file (for example, arms lowered) instead of the T-pose. Parts attached
  to a bone, such as a sword, follow the hand and appear in the correct place.
• Fixed a rendering problem with FBX files where each mesh has a different bone
  reference (characters with many parts and more than 100 bones, for example).

Accessories attached to bones now follow the animation

• Fixed an issue where meshes without skinning that are children of a bone (such as a
  sword or staff held in a hand) did not follow the animation and stayed fixed at their
  starting position.

Other

• The information about the whole model and the toolbar now show only the texture file
  name instead of the full path (the full path is in the toolbar tooltip). A long path
  used to make the panel overlap the model and push the "i" button out of the toolbar.

3D model viewer plugin v0.3.1

アニメーションの無いモデルで、顔など一部のパーツが床面に表示される問題を修正

• ボーン (スケルトン) を持つが、アニメーションを含まない FBX で、頭ローカル座標で
  作られた顔などのパーツだけが床面に表示されてしまう問題を修正しました。
  Unity Editor と同じ位置に表示されます。
• 同じ名前のボーンでも、メッシュごとに異なる基準位置 (逆バインド行列) を
  持つ FBX で、パーツの位置がずれる可能性があった問題も修正しました。
• アニメーション付きモデルの表示は変わりません。

---

English

Fixed some parts (such as the face) appearing at floor level in models without animation

• Fixed an issue where, in FBX files that have a skeleton but no animation,
  parts authored in head-local coordinates (such as a character's face) were
  drawn at floor level. They now appear in the same position as in Unity Editor.
• Also fixed a possible misplacement of parts in FBX files where bones with the
  same name have a different bind-pose (inverse bind) matrix per mesh.
• Models with animation render the same as before.

3D model viewer plugin v0.3.0

複数パーツで構成された FBX が正しく組み上がるようになりました

• FBX のノード階層が持つ位置・回転・拡大縮小をメッシュに適用するようになりました。
  同じ形状を複数のノードから参照して配置しているモデル (床・壁などのパーツを
  並べたダンジョン背景など) で、これまではすべてのパーツが原点に重なって
  表示されていましたが、Unity Editor や DCC ツールと同じ配置で表示されます。
• 鏡像 (反転) 配置されたパーツも、面の表裏が正しく保たれます。
• スケルタルアニメーション付きのモデルの表示は変わりません。

裏面カリングを追加

• ポリゴンの裏面を描画しない「裏面カリング」を追加しました。Unity などの
  ゲームエンジンと同じ片面表示になるため、エンジンでの見え方を確認しやすく
  なります。既定でオンです。
• ツールバーのボタン、または C キーで切り替えられます。両面を確認したい
  ときはオフにしてください。キーは farman の設定 → キーバインドから変更
  できます。
• ワイヤーフレーム表示中は、構造を把握しやすいよう常に両面を描画します。

その他

• 動作確認用ビルド (build.yml) の macOS 成果物にも Developer ID 署名を
  付けるようにしました。配布物 (このリリース) はこれまでどおり署名 + 公証済みです。

---

English

Multi-part FBX models are now assembled correctly

• The position, rotation and scale stored in the FBX node hierarchy are now
  applied to each mesh. Models that place the same shape from several nodes
  (for example dungeon backgrounds built from floor and wall parts) used to
  render with every part stacked at the origin. They now appear laid out the
  same way as in Unity Editor or your DCC tool.
• Mirrored (flipped) parts keep the correct face orientation.
• Models with skeletal animation render the same as before.

Back-face culling

• Added back-face culling, which skips drawing the back side of polygons. This
  matches the single-sided rendering of game engines such as Unity, so the
  viewer now gives a closer preview of how a model will look in-engine. It is on
  by default.
• Toggle it with the toolbar button or the C key. Turn it off when you want to
  see both sides. The key can be changed in farman's Settings → Key Bindings.
• Wireframe mode always draws both sides so the structure stays visible.

Other

• The macOS build produced by the CI workflow (build.yml) is now signed with
  the Developer ID as well. Release binaries (this release) are signed and
  notarized as before.

Full Changelog: v0.2.0...v0.3.0

3D model viewer plugin v0.2.0

操作キーを farman の設定から変更できるようになりました

• 3D ビュアーの操作キーを、farman の設定 → キーバインドで自由に割り当て直せる
  ようになりました。本体のビュアーと同じ画面で、他のビュアーと並べて編集できます。
• 変更できる操作は次のとおりです (括弧内は既定のキー)。
  • 回転: 左 / 右 / 上 / 下 (矢印キー)
  • パン: 上 / 下 / 左 / 右 (W / S / A / D)
  • 拡大 / 縮小 (U / J)
  • 視点をリセット (R)、情報を表示 (I)
  • テクスチャ / グリッド / ワイヤーフレーム / ボーン / ヘルプ表示の切り替え
    (T / G / F / B / H)
  • アニメーション再生 / 一時停止 (Space)
• 既定のキーはこれまでと同じなので、変更しなければ操作感は変わりません。
• キーバインドの集約に対応していない farman で使った場合も、既定のキーで
  そのまま操作できます。

farman 0.9.9 への対応

• farman 0.9.9 で更新されたビュアープラグインのインターフェース (5.0) に
  合わせました。0.9.9 以降の farman で読み込まれるのはこの版からです。
  以前の版は 0.9.9 では読み込まれません (本体が安全に無視します)。

---

English

Shortcut keys are now configurable in farman

• The 3D viewer's shortcut keys can now be reassigned in farman's Settings → Key
  Bindings, on the same page as the built-in viewers.
• The configurable actions are (default keys in parentheses):
  • Rotate left / right / up / down (arrow keys)
  • Pan up / down / left / right (W / S / A / D)
  • Zoom in / out (U / J)
  • Reset view (R), show model info (I)
  • Toggle textures / grid / wireframe / bones / help overlay
    (T / G / F / B / H)
  • Play / pause animation (Space)
• The defaults are unchanged, so nothing feels different unless you change them.
• On a farman build that does not collect plugin key bindings, the viewer still
  responds to its default keys.

farman 0.9.9 support

• Updated to the viewer plugin interface (5.0) introduced in farman 0.9.9. This
  is the first version that loads on farman 0.9.9 and later; earlier versions
  are ignored by the host on 0.9.9.

Full Changelog: v0.1.0...v0.2.0

3D model viewer plugin v0.1.0

farman 用の 3D モデルビュアープラグイン、最初の公開版です。farman のファイルリストから .fbx を選ぶと、アプリ内でモデルを表示・回転・アニメーション再生できます。

新機能

• FBX 3D モデルの表示（assimp によるロード。テクスチャ／マテリアルにも対応）
• カメラ操作：矢印キー = 回転、WASD = 平行移動、U / J = 拡大 / 縮小、R = 視点リセット
• 表示モードの切り替え
  • テクスチャ表示 ON/OFF（T）
  • グリッド表示 ON/OFF（G）
  • ワイヤーフレーム表示（シェーディング無し, F）
  • ボーン（スケルトン）表示（B）
• アニメーション再生：再生 / 停止（Space）
• 操作方法オーバーレイ：ビュアー左端に操作一覧を表示（H でトグル）／モデル情報（i）
• キーボード操作中心の UI（本体ビュアーと同じ操作感・ツールバー体裁）
• 独立ウィンドウ／インライン両対応（Esc・Enter で閉じる）

動作要件

• farman 0.9.9 以降（プラグインの MinHostVersion により、古い本体では自動的にスキップされます）

プラットフォーム / 配布物

• macOS (arm64) … Developer ID 署名 + Apple 公証済み
• Windows (x64)
• Linux (x86_64)
• assimp は静的リンク済み（別途インストール不要）

インストール

ダウンロードしたファイルを、farman のプラグインディレクトリ配下 plugins/viewers/ に配置します（拡張子は各 OS のもの）。

• macOS: ~/Library/Application Support/Farman/farman/plugins/viewers/ModelViewerPlugin.dylib
• Windows: %APPDATA%\Farman\farman\plugins\viewers\ModelViewerPlugin.dll
• Linux: ~/.local/share/Farman/farman/plugins/viewers/ModelViewerPlugin.so

---

English

The 3D model viewer plugin for farman — first public release. Select an .fbx file in farman's file list to view, rotate, and play back model animations inside the app.

New features

• FBX 3D model display (loaded via assimp, with texture/material support)
• Camera controls: arrow keys = rotate, WASD = pan, U / J = zoom in / out, R = reset view
• Display modes
  • Toggle textures (T)
  • Toggle grid (G)
  • Wireframe (no shading, F)
  • Bone / skeleton overlay (B)
• Animation playback: play / stop (Space)
• Controls overlay: operation list along the left edge (toggle with H); model info (i)
• Keyboard-driven UI matching farman's built-in viewers (toolbar & look)
• Works both as a standalone window and inline (Esc / Enter to close)

Requirements

• farman 0.9.9 or later (enforced via the plugin's MinHostVersion; older hosts skip it automatically)

Platforms / artifacts

• macOS (arm64) … Developer ID signed + Apple notarized
• Windows (x64)
• Linux (x86_64)
• assimp is statically linked (no separate install required)

Installation

Place the downloaded file under farman's plugin directory in plugins/viewers/ (use the extension for your OS).

• macOS: ~/Library/Application Support/Farman/farman/plugins/viewers/ModelViewerPlugin.dylib
• Windows: %APPDATA%\Farman\farman\plugins\viewers\ModelViewerPlugin.dll
• Linux: ~/.local/share/Farman/farman/plugins/viewers/ModelViewerPlugin.so

Full Changelog: https://github.com/mashsoft-jp/farman-plugin-3d/commits/v0.1.0