3D マウスのソースを表示

[[Category:マウス]]
[[en:3D Mouse]]
超音波によって機能する 3D マウスはバットや空飛ぶマウス、あるいは杖とも呼ばれ、三次元的に自在に操作することができます。最もよく知られた製品として1990年代初頭に登場した 3DConnexion/Logitech の SpaceMouse などがあります。

詳しくは https://www.3dconnexion.com/products/spacemouse.html#panel-whatis を見てください。
{{Note|以下の設定は一番ベーシックなモデル (Space Navigator) で動作することを確認しています。}}

== プロプライエタリドライバー ==

3D マウスを USB 端子に接続してください。認識されているかどうか {{ic|lsusb}} を使ってチェックします:
{{hc|$ lsusb|Bus 003 Device 002: ID 046d:c626 Logitech, Inc. 3Dconnexion Space Navigator 3D Mouse}}

{{Pkg|openmotif}} をインストールしてください。

{{ic|libXm.so.4}} から {{ic|libXm.so.3}} にシンボリックリンクを張ります:
{{bc|1=# ln -s /usr/lib/libXm.so.4 /usr/lib/libXm.so.3}}

ドライバーには {{ic|/var/run/utmp}} からユーザー名を取得できず "failed to get user" エラーを出力するという問題があります。

以下のプログラムをコンパイルしてください。ドライバーが読み込める方法で {{ic|/var/run/utmp}} にユーザー名を追加します。
{{hc|3dmouse.c|2=<nowiki>
/* source: https://forums.gentoo.org/viewtopic-t-609224.html
 *         http://www.3dconnexion.com/forum/viewtopic.php?t=1039
 */
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <utmpx.h>

int main(int argc, char ** argv) {
  if (argc != 2) {
    fprintf(stderr, "Need a name to put in the structure\n");
    exit(1);
  }
  struct utmpx u;
  memset(&u, 0, sizeof(u));
  u.ut_type = USER_PROCESS;
  u.ut_pid = getpid();
  strcpy(u.ut_id, ":0");
  strcpy(u.ut_line, ":0");
  strcpy(u.ut_user, argv[1]);
  setutxent();
  pututxline(&u);
  endutxent();
} 
</nowiki>}}
{{bc|1=$ gcc 3dmouse.c -o 3dmouse
# ./3dmouse root}}

次の URL から Linux ドライバーを {{ic|/tmp}} にダウンロードしてください: https://www.3dconnexion.com/service/drivers.html

インストールスクリプトを展開して実行してください:
{{bc|1=$ tar xfz 3dxware-linux-v1-5-2.i386.tar.gz install-3dxunix.sh
# ./install-3dxunix.sh
Password:

<nowiki>
This installs 3DxWareUnix V1.5.2 on this machine. Continue? (y/n) [y]
y

 Choose one of the following platforms:

  1.  HP-UX
  2.  Solaris
  3.  AIX 5
  4.  Linux
  5.  Exit

Please enter your choice (1-5)[4]:
4

Installing files for 3DxWare for Unix / linux......

Uninstalling a running driver. Please wait ...
Done.

Converting default configs V5.x to V5.3.
(User configs will be converted when used)
Please wait a moment...
Converting configs... found 27 configurations
Configuration file             Configuration name       Version Status
/etc/3DxWare/UGSNX2_01.scg     ("UGS NX 2 config 01      ") 5.3 Ok.
/etc/3DxWare/4DNav.scg         ("4D Navigator            ") 5.3 Ok.
/etc/3DxWare/UGSNX5_02.scg     ("UGS NX 5 config 02      ") 5.3 Ok.
/etc/3DxWare/CatiaV5_02.scg    ("CATIA V5 config 02      ") 5.3 Ok.
/etc/3DxWare/Maya2011.scg      ("Maya 2011               ") 5.3 Ok.
/etc/3DxWare/CatiaV4_01.scg    ("CATIA V4                ") 5.3 Ok.
/etc/3DxWare/Patran_01.scg     ("Patran                  ") 5.3 Ok.
/etc/3DxWare/UGSNX4_01.scg     ("UGS NX 4 config 01      ") 5.3 Ok.
/etc/3DxWare/Pr(...)ire_02.scg ("ProE Wildfire config 02 ") 5.3 Ok.
/etc/3DxWare/Pr(...)ire_01.scg ("ProE Wildfire config 01 ") 5.3 Ok.
/etc/3DxWare/UGSNX2_02.scg     ("UGS NX 2 config 02      ") 5.3 Ok.
/etc/3DxWare/CatiaV5_03.scg    ("CATIA V5 config 03      ") 5.3 Ok.
/etc/3DxWare/UGSNX3_02.scg     ("UGS NX 3 config 02      ") 5.3 Ok.
/etc/3DxWare/default_10.scg    ("Driver Protocol 1.0     ") 5.3 Ok.
/etc/3DxWare/CADDS_R14.scg     ("CADDS5 R14 +            ") 5.3 Ok.
/etc/3DxWare/CatiaV5_01.scg    ("CATIA V5 config 01      ") 5.3 Ok.
/etc/3DxWare/DMUNav.scg        ("DMU Navigator           ") 5.3 Ok.
/etc/3DxWare/UGSNX4_02.scg     ("UGS NX 4 config 02      ") 5.3 Ok.
/etc/3DxWare/Enovia_VPM.scg    ("Enovia VPM              ") 5.3 Ok.
/etc/3DxWare/UGSNX5_01.scg     ("UGS NX 5 config 01      ") 5.3 Ok.
/etc/3DxWare/ICEM_MED.scg      ("ICEM MED                ") 5.3 Ok.
/etc/3DxWare/CADDS_R13.scg     ("CADDS5 -R13             ") 5.3 Ok.
/etc/3DxWare/DVise.scg         ("DVise                   ") 5.3 Ok.
/etc/3DxWare/Op(...)alizer.scg ("Optegra Visualizer      ") 5.3 Ok.
/etc/3DxWare/UGSNX3_01.scg     ("UGS NX 3 config 01      ") 5.3 Ok.
/etc/3DxWare/IDEAS_01.scg      ("IDEAS                   ") 5.3 Ok.
/etc/3DxWare/default.scg       ("Any Application         ") 5.3 Ok.

Done.

Do you want 3DxWareUnix being started with every login (from the /etc/inittab)? (y/n) [y]
n

Please start the driver manually. [/etc/3DxWare/daemon/3dxsrv -d <port>]

****************************************************************
    For testing purposes you can find the demos
                      xcube and xvalues at /tmp
****************************************************************
</nowiki>}}

以下のコマンドを実行することでドライバーを手動で起動できます (USB 版):
{{bc|1=# /etc/3DxWare/daemon/3dxsrv -d USB}}

これで Arch Linux で 3D マウスが動作するはずです。ドライバーのアーカイブからデモを解凍してテストできます:
{{bc|1=$ tar xfz 3dxware-linux-v1-5-2.i386.tar.gz xcube
$ ./xcube}}

== オープンソースドライバー ==
spacenav プロジェクトによってメンテナンスされている 3Dconnexion デバイスのオープンソースドライバーも存在します。残念ながら対応しているアプリケーションはごく限られています。spacenav ドライバーをサポートしている著明なソフトウェアとしては 3D 作成スイートの Blender が唯一です。オープンソースドライバーを使用するには以下の条件を満たす必要があります:
# デバイスがカーネルによって入力デバイスとして認識されていること。
# spacenavd デーモンを動作させること。
# spacenav のサポートを有効にしてアプリケーションをコンパイルすること (公式リポジトリの {{Pkg|blender}} はサポートが有効になっていません)。

最初の要件はデバイスを接続すれば自動的にクリアです。{{ic|/proc/bus/input/devices}} 内のデバイスを見ることで確認できます:
{{bc|1=$ grep 3Dconnexion /proc/bus/input/devices
N: Name="3Dconnexion SpaceNavigator"}}

2番目の要件を満たすには AUR から {{Pkg|libspnav}} と {{AUR|spacenavd}} をインストールしてください。テストとしてフォアグラウンドモードでデーモンを起動してみると良いでしょう。以下のように出力されるはずです:
{{bc|1=# spacenavd -v -d
Spacenav daemon 0.5
Device detection, parsing /proc/bus/input/devices
using device: /dev/input/event21
device name: 3Dconnexion SpaceNavigator
trying to open X11 display ":0"
   XAUTHORITY=/home/user/.Xauthority
}}
CTRL-C を押すことでデーモンを終了できます。バックグラウンドでは systemd で {{ic|spacenavd.service}} を使うことで起動できます。

後は対応アプリケーションさえあれば 3D マウスを使うことができます。

=== spacenav のサポートが有効な Blender ===
公式リポジトリの {{Pkg|blender}} パッケージは spacenav のサポートがデフォルトで有効になっています。

手動でビルドするときに spacenav のサポートを有効にしたい場合、{{pkg|libspnav}} をインストールしてから [[ABS]] から Blender をビルドすることで NDOF(=spacenav) のサポートが自動的に有効になってビルドが行われます。

ビルドした Blender をインストールしたら 3D マウスを試してみてください:
{{bc|1=$ blender
ndof: using SpaceNavigator}}

== 参照 ==
* [https://www.3dconnexion.com/forum/viewforum.php?f=22 3dconnexion linux フォーラム]
* [https://www.3dconnexion.com/forum/viewtopic.php?t=1039 Source of C program used]
* [https://www.3dconnexion.com/forum/viewtopic.php?t=1757 Information about libXm.so.4 and libXm.so.3]
* [http://spacenav.sourceforge.net/ オープンソースドライバー spacenav のウェブサイト]
* [https://spacemice.wikidot.com/ Community Wiki about Spacemice]