Skip to content

3D model viewer plugin v0.1.0

Choose a tag to compare

@github-actions github-actions released this 15 Sep 01:10
· 16 commits to main since this release

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