Repository navigation
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)
- テクスチャ表示 ON/OFF(
- アニメーション再生:再生 / 停止(
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)
- Toggle textures (
- 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/Enterto 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