<!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN">
<article>
<!--
WORD : valuator	バリュエータ
-->
<!-- made up title -->
<!-- <title> Information about the XInput extension in XFree86&tm; -->
<title> XFree86&tm; における XInput 拡張に関する情報
<author> Fr&eacute;d&eacute;ric Lepied
<date> 2 November 1998
<trans> The X Japanese Documentation Project
<tdate> 2 August 1999
<toc>

<!-- <sect> Introduction <p> -->
<sect> はじめに <p>

<!-- This document provides  some information  about  the XInput  extension
implemented in XFree86&tm;. -->
この文書では XFree86&tm; に実装されている XInput 拡張に関する情報をい
くつか説明します。

<!-- If  you have any suggestions,  comments, fixes  or ideas regarding the
XInput extension in XFree86&tm; or about this document, send e-mail to -->
XFree86&tm の XInput 拡張や本文書についての提案、ご意見、訂正、アイディ
アがあれば、
<htmlurl url="mailto:lepied@XFree86.Org" 
    name="lepied@XFree86.Org"><p>
まで連絡してください。
<!-- Bug Reports should be sent to<p>
<em>XFree86@XFree86.Org</em><p> -->
ただし、バグ報告は<em>XFree86@XFree86.Org</em>の方に送ってください。<p>
<!-- Questions or anything else should be posted to the NewsGroup<p>
<em>comp.windows.x.i386unix</em><p> -->
また、疑問点等は<em>comp.windows.x.i386unix</em>に投稿してください。<p>

<!-- <sect> Description <p> -->
<sect> 説明 <p> -->

<!-- The XInput extension is a standard X Consortium extension. The goal of
this extension is to allow additional input  devices management to the
X Window System. The documentation could  be found in the X Consortium
distribution under <em>xc/doc/hardcopy/Xi</em>. -->
XInput 拡張は X コンソーシアム標準の機能拡張です。XInput 拡張の目的は、
追加の入力デバイスを X ウィンドウシステムで管理できるようにすることで
す。ドキュメンテーションは X コンソーシアムの配布物の 
<em>xc/doc/hardcopy/Xi</em> ディレクトリ以下にあります。

<!-- <sect> XFree86 implementation <p> -->
<sect> XFree86 での実装 <p>

<!-- The XFree86 implementation contains 2 parts : the server part and two
clients (<em>xsetpointer</em> and <em>xsetmode</em>). -->
XFree86 での実装は2つの部分からなります。すなわち、サーバ部分とクライ
アント部分(クライアントは <em>xsetpointer</em> と <em>xsetmode</em>の2
つ)です。

<!-- <sect1> Server side <p> -->
<sect1> サーバ部分 <p>

<!-- The server supports the following extended devices : -->
サーバは以下の拡張デバイスをサポートしています:
<itemize>
<!--
	<item>Joystick (only on  supported systems ie. Linux, FreeBSD
	and NetBSD). Features :
	<itemize>
		<item>Relative mode.
		<item>2 valuators (x and y axis).
		<item>2 buttons.
	</itemize>
-->
	<item>ジョイスティック (ただし、ジョイスティックをサポートして
	いるシステム(Linux, FreeBSD, NetBSD)だけでしか扱えません)。
	機能を以下に示す(以降の項目でも同じ) :
	<itemize>
		<item>相対モード
		<item>バリュエータ 2 つ(x 軸と y 軸)
		<item>ボタン 2 つ
	</itemize>

<!--
	<item>Elographics touchscreen. Features :
	<itemize>
		<item>Absolute mode.
		<item>2 valuators (x and y axis).
		<item>1 button.
	</itemize>
-->
	<item>Elographics 製タッチスクリーン:
	<itemize>
		<item>絶対モード
		<item>バリュエータ 2 つ (x 軸と y 軸)
		<item>ボタン 1 つ
	</itemize>

<!--
	<item>Stylus on MicroTouch touchscreen. Features :
	<itemize>
		<item>Absolute mode.
		<item>2 valuators (x and y axis).
		<item>1 button.
	</itemize>
-->
	<item>MicroTouch 製タッチスクリーン(スタイラスペンで操作):
	<itemize>
		<item>絶対モード
		<item>バリュエータ 2 つ (x 軸と y 軸)
		<item>ボタン 1 つ
	</itemize>

<!--
	<item>Finger on MicroTouch touchscreen. Features :
	<itemize>
		<item>Absolute mode.
		<item>2 valuators (x and y axis).
		<item>1 button.
	</itemize>
-->
	<item>MicroTouch 製タッチスクリーン(指で操作):
	<itemize>
		<item>絶対モード
		<item>バリュエータ 2 つ (x 軸と y 軸)
		<item>ボタン 1 つ
	</itemize>

<!--
	<item>Mouse. Features :
	<itemize>
		<item>Relative mode.
		<item>2 valuators (x and y axis).
		<item>up to 4 buttons.
	</itemize>
-->
	<item>マウス:
	<itemize>
		<item>相対モード
		<item>バリュエータ 2 つ (x 軸と y 軸)
		<item>ボタン 4 つまで
	</itemize>

<!--
	<item>Wacom stylus. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>6 valuators :
		<enum>
			<item>X axis.
			<item>Y axis.
			<item>pressure.
			<item>X tilt.
			<item>Y tilt.
			<item>wheel.
		</enum>
		<item>3 buttons.
		<item>Proximity report.
		<item>Motion history capability.
		<item>Macro/function buttons are reported as keys.
	</itemize>
-->
	<item>Wacom 製スタイラスペン:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ y つ:
		<enum>
			<item>X 軸
			<item>Y 軸
			<item>圧力
			<item>X チルト
			<item>Y チルト
			<item>ホイール
		</enum>
		<item>ボタン 3 つ
		<item>近接通知機能
		<item>移動履歴機能
		<item>マクロボタン/機能ボタンをキーとして通知
	</itemize>

<!--
	<item>Wacom eraser. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>6 valuators :
		<enum>
			<item>X axis.
			<item>Y axis.
			<item>pressure.
			<item>X tilt.
			<item>Y tilt.
			<item>wheel.
		</enum>
		<item>1 button.
		<item>Proximity report.
		<item>Motion history capability.
		<item>Macro/function buttons are reported as keys.
	</itemize>
-->
	<item>Wacom 製イレーザ:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 6 つ:
		<enum>
			<item>X 軸
			<item>Y 軸
			<item>圧力
			<item>X チルト
			<item>Y チルト
			<item>ホイール
		</enum>
		<item>ボタン 1 つ
		<item>近接通知機能
		<item>移動履歴機能
		<item>マクロボタン/機能ボタンをキーとして通知
	</itemize>

<!--
	<item>Wacom cursor. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>6 valuators :
		<enum>
			<item>X axis.
			<item>Y axis.
			<item>pressure.
			<item>X tilt.
			<item>Y tilt.
			<item>wheel.
		</enum>
		<item>16 buttons.
		<item>Proximity report.
		<item>Motion history capability.
		<item>Macro/function buttons are reported as keys.
	</itemize>
-->
	<item>Wacom 製カーソル:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 6 つ:
		<enum>
			<item>X 軸
			<item>Y 軸
			<item>圧力
			<item>X チルト
			<item>Y チルト
			<item>ホイール
		</enum>
		<item>ボタン 16 個
		<item>近接通知機能
		<item>移動履歴機能
		<item>マクロボタン/機能ボタンをキーとして通知
	</itemize>

<!--
	<item>SummaSketch tablet. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>2 valuators (x and y axis).
		<item>2 buttons stylus or 4 buttons puck.
		<item>Proximity report.
		<item>Motion history capability.
	</itemize>
-->
	<item>SummaSketch 製タブレット:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 2 つ(x 軸と y 軸)
		<item>2 ボタンのスタイラスペン、4ボタンのパック
		<item>近接通知機能
		<item>移動履歴機能
	</itemize>

<!--
	<item>AceCad tablet. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>2 valuators (x and y axis).
		<item>2 buttons stylus or 4 buttons puck.
		<item>Proximity report.
		<item>Motion history capability.
	</itemize>
-->
	<item>AceCad 製タブレット:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 2 つ(x 軸と y 軸)
		<item>2 ボタンのスタイラスペン、4ボタンのパック
		<item>近接通知機能
		<item>移動履歴機能
	</itemize>

<!--
	<item>Calcomp DrawingBoard tablet. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>2 valuators (x and y axis).
		<item>4 buttons stylus or 16 buttons puck.
		<item>Proximity report.
		<item>Motion history capability.
	</itemize>
-->
	<item>Calcomp 製 DrawingBoard タブレット:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 2 つ(x 軸と y 軸)
		<item>4 ボタンのスタイラスペン、16 ボタンのパック
		<item>近接通知機能
		<item>移動履歴機能
	</itemize>

<!--
	<item>SWITCH virtual device. Features :
	<itemize>
		<item>Absolute mode.
		<item>1 valuator (device id) which reports the id of the device controlling
		the core pointer (works with the AlwaysCore feature see bellow).
	</itemize>
-->
	<item>SWITCH 仮想デバイス:
	<itemize>
		<item>絶対モード
		<item>バリュエータ 1 つ(デバイス ID)。これはコアポイン
		タを制御するデバイスの ID を通知します(AlwaysCore 機能
		を使って動作します。以下を参照してください)。
	</itemize>

<!--
	<item>SGI button box. Features :
	<itemize>
		<item>Absolute or relative modes.
		<item>8 valuators.
		<item>32 buttons.
		<item>Motion history capability.
	</itemize>
-->
	<item>SGI 製ボタンボックス:
	<itemize>
		<item>絶対モード、相対モード
		<item>バリュエータ 8 個
		<item>ボタン 32 個
		<item>移動履歴機能
	</itemize>

</itemize>

<!-- To  enable  an   extended  device, you  must   add   en  entry  in the
<em>XF86Config</em> file.   Consult   to  the <em>XF86Config</em>  man
pages to see the details. <p> -->
拡張デバイスを有効にするには、<em>XF86Config</em> にエントリーを追加し
なければなりません。詳しくはオンラインマニュアルの <em>XF86Config</em> 
を調べてください。<p>

<!-- The  XFree86 implementation supports  a  non  standard feature  called
<em>AlwaysCore</em> which enables an  XInput device to send both  core
and extended events at the same time. To enable it you have to add the
<em>AlwaysCore</em> keyword to the  subsection describing your  device
in the <em>XF86Config</em>  file.  The  <em>SWITCH</em> virtual device
reports a Motion event when another  device takes over the control of
the core pointer. The id of the new device is reported in the first
valuator of the event. -->
XFree86 の実装では、<em>AlwaysCore</em> という X コンソーシアム非標準
の機能をサポートしています。この機能を使うと、XInput デバイスはコアイ
ベントと拡張イベントを同時に送ることができます。<em>AlwaysCore</em> 機
能を有効にするには、<em>XF86Config</em> ファイル中のデバイスを記述して
いるサブセクションに <em>AlwaysCore</em> キーワードを追加してください。
他のデバイスがコアポインタの制御を引き継いだときには、<em>SWITCH</em> 
仮想デバイスが Motion イベントを通知します。新しいデバイスの ID は、こ
の Motion イベント中の最初のバリュエータが保持しています。

<!-- <sect1> Clients <p> -->
<sect1> クライアント <p>

<!-- <em>xsetpointer</em> is used to  change the device controlling the core
pointer and to list available extended devices. <p> -->
<em>xsetpointer</em> を使うと、コアポインタを制御するデバイスを変更す
ることができます。また、利用可能な拡張デバイスのリストを表示することが
できます。<p>

<!-- <em>xsetmode</em> is used to change the mode (absolute or relative) of
an extended device. The device  has to  support relative and  absolute
modes and the device must not control the core pointer. <p> -->
<em>xsetmode</em> を使うと、拡張デバイスのモード(絶対モードか相対モー
ド)を変更することができます。このデバイスは絶対モードと相対モードをサ
ポートしていなければならず、コアポインタを制御してはいけません。

<!-- Consult the man pages for details. -->

詳しくはオンラインマニュアルで調べてください。

<verb>
$XFree86: xc/programs/Xserver/hw/xfree86/doc/Japanese/sgml/xinput.sgml,v 1.1.2.2 1999/11/26 15:24:01 hohndel Exp $





$XConsortium: xinput.sgml /main/3 1996/10/27 11:06:13 kaleb $
</verb>

<sect>日本語訳について<p>
日本語訳は X Japanese Documentation Project の藤原輝嘉 <url
url="mailto:fujiwara@linux.or.jp"
name="&lt;fujiwara@linux.or.jp&gt;"> が行いました。問題点の指摘やご意
見は藤原まで御連絡ください。
原文の著作権は XFree86 プロジェクト社にあり、日本語訳の著作権は
X Japanese Documentation Project にあります。
</article>
