管理メニュー

プログラミングに関する私的メモ

TiltTestC

最終更新：

匿名ユーザー

- view
だれでも歓迎！ 編集

TiltTest.c

Windowsプログラミングにはなじみが無いので、関数がどこから来たものか調べながら読み下してみる。 
#include <windows.h>   // ... Microsoft SDKs/Windows/v7.0/include/windows.h
#include <math.h>      // ... Microsoft Visual Studio 10.0/VC/include/math.h
#include <string.h>    // ... 上に同じ
#include "wintab.h"    // NOTE: get from wactab header package (TiltTest.zipに同梱)
#define PACKETDATA     (PK_X | PK_Y | PK_BUTTONS | PK_NORMAL_PRESSURE | \
                        PK_ORIENTATION | PK_CURSOR)
                       // PK_xxはwintab.h内で定義
#define PACKETMODE     0
#include "pktdef.h"    // NOTE: get from wactab header package (TiltTest.zipに同梱)
#include "msgpack.h"   // (TiltTest.zipに同梱)
#include "Utils.h"     // (TiltTest.zipに同梱)
#include "tilttest.h"  // (TiltTest.zipに同梱)

/* converts FIX32 to double */
#define FIX_DOUBLE(x)   ((double)(INT(x))+((double)FRAC(x)/65536))
#define pi 3.14159265359
ここまでは特に難しいことはない。 

#ifdef WIN32                                
#define MoveTo(h,x,y)   MoveToEx(h,x,y,NULL)
#endif
MoveToEx は Microsoft SDKs/Windows/v7.0A/Include/WinGDI.h の4520行にプロトタイプ宣言？がある。 

char*	gpszProgramName = "TiltTest";

HANDLE          hInst;               /* Handle for instance */
HCTX            hTab = NULL;         /* Handle for Tablet Context */
POINT           ptNew;               /* XY value storage */
UINT            prsNew;              /* Pressure value storage */
UINT            curNew;              /* Cursor number storage */
ORIENTATION     ortNew;              /* Tilt value storage */
RECT            rcClient;            /* Size of current Client */
RECT            rcInfoTilt;          /* Size of tilt info box */
RECT            rcInfoName;          /* Size of cursor name box */
RECT            rcInfoGen;           /* Size of testing box */
RECT            rcDraw;              /* Size of draw area */
double          aziFactor = 1;       /* Azimuth factor */
double          altFactor = 1;       /* Altitude factor */
double          altAdjust = 1;       /* Altitude zero adjust */
BOOL            tilt_support = TRUE; /* Is tilt supported */
以上はグローバル変数の定義。
ptNew以後は、タブレットから来たデータを保持する構造体を指すポインタらしい。
上から順に、XY座標、筆圧、カーソル番号(ペン先か消しゴムかひょっとするとサイドスイッチの状態も)、ペンの傾き角度、の様子。
rcClient以後は、情報をウインドウ上に表示するエリアのための構造体らしい。
aziFactor ... 方位角についての何らかの係数
altFactor ... 加速度についての何らかの係数
altAdjust ... 加速度についての何らかの係数
最後に、ペンの傾きをサポートしてないタブレットではflaseになるBOOL型変数か。

  • ここでカーソル番号curNewの内容として、ペンのペン先か消しゴム側かの情報に加えて、サイドスイッチの情報や、モノによってはタブレットに仕込まれたスイッチの情報を返しているかもしれないことに注意しておく。
  • また、タブレットが複数接続されている場合には hInst や hTab の内容が変わっているかもしれない。

続いてプログラム本体部分が来る。 
int PASCAL WinMain(hInstance, hPrevInstance, lpCmdLine, nCmdShow)
HINSTANCE  hInstance;
HINSTANCE  hPrevInstance;
LPSTR   lpCmdLine;
int     nCmdShow;
この構文だとVC++2010のデフォルトでは、インテリセンス機能による警告が出る。警告の出ない構文に書き直すと、例えば次のようになる。 
int PASCAL WinMain(
	HINSTANCE	hInstance,
	HINSTANCE	hPrevInstance,
	LPSTR		lpCmdLine, 
	int		nCmdShow)
WinMain()の中身はいたってシンプル。 
{
	MSG msg;

	if (!hPrevInstance)
		if (!InitApplication(hInstance))
			return (FALSE);

	/* Perform initializations that apply to a specific instance */
	if (!InitInstance(hInstance, nCmdShow))
		return (FALSE);

	/* Acquire and dispatch messages until a WM_QUIT message is received. */
	while (GetMessage(&msg, NULL, 0, 0)) 
	{
		TranslateMessage(&msg);
		DispatchMessage(&msg);
	}

	// Return Wintab resources.
	Cleanup();

	return (msg.wParam);
}
WinMain() は Windows でのウインドウアプリケーションの主要関数で、C言語の main() に相当するものとのこと。Web を調べると、どのサンプルコードでもこの部分はほとんど違いがない。この関数が実行されたら、あとはマウスやキーボードや、TiltTest の場合はタブレットのイベント割り込みを待つことになる。
その割り込み処理をフックして、アプリケーションのコードを記述することになる。

InitApplication()

BOOL InitApplication(HINSTANCE  hInstance)
// BOOL InitApplication(hInstance)
// HANDLE  hInstance;  // 呼び出し側が HINSTANCE でありこの文おそらく間違いなので変更する。TILTTEST.Hも。
{
	WNDCLASS wc;
	/* Fill in window class structure with parameters that describe the */
	/* main window. */
	wc.style = 0;
	wc.lpfnWndProc = MainWndProc;
	wc.cbClsExtra = 0;
	wc.cbWndExtra = 0;
	wc.hInstance = hInstance;
	wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);
	wc.hCursor = LoadCursor(NULL, IDC_ARROW);
	wc.hbrBackground = (HBRUSH)(COLOR_APPWORKSPACE + 1);
	wc.lpszMenuName =  "TiltTestMenu";
	wc.lpszClassName = "TiltTestWClass";

	/* Register the window class and return success/failure code. */
	return (RegisterClass(&wc));
}
WNDCLASS は Microsoft SDKs/Windows/v7.0A/Include/WinUser.h で 構造体 tagWNDCLASSA で定義されている。アプリケーションウインドウの雛形が作成されているのかな。

InitInstance()

長いので調査結果や変更点はソースコードにコメントの形で埋め込んだ。 
BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
// 第一引数の型は呼び出し側が HINSTANCE なのでそれにあわせた。TILTTEST.H も書き直した。
// HANDLE  hInstance;
// int     nCmdShow;
{
	HWND            hWnd;             /* Handle for window */
	HDC             hDC;              /* Handle for Device Context */
	TEXTMETRIC      textmetric;       /* Structure for font info */
	int             nLineH;           /* Holds the text height */
	int             Xinch, Yinch;     /* Holds the number of pixels per inch */
	int             Hres, Vres;       /* Holds the screen resolution */
	char            WName[50];        /* String to hold window name */
	struct          tagAXIS TpOri[3]; /* The capabilities of tilt */
	double          tpvar;            /* A temp for converting fix to double */

/* Save the instance handle in static variable, which will be used in  */
/* many subsequence calls from this application to Windows.            */
hInst = hInstance;
hInst はこのソースのはじめで定義したグローバル変数。 


if ( !LoadWintab( ) )
{
	ShowError( "Wintab not available" );
	return FALSE;
}
LoadWintab()の戻り値でタブレットサービスの有無がわかるようだ。 

/* check if WinTab available. */
if (!gpWTInfoA(0, 0, NULL)) {
	MessageBox(NULL, "WinTab Services Not Available.", gpszProgramName, 
		   MB_OK | MB_ICONHAND);
	return FALSE;
}
gpWTInfoA()の引数でタブレットに関するいろいろな情報が得られる模様。
http://www.wacomeng.com/windows/docs/Wintab_v140.htm の WTInfo を参照すると、引数は
  • カテゴリー: 情報のカテゴリ(種類)を整数で指定
  • インデックス: カテゴリ内のどの情報かを整数で指定
  • 戻り値を入れるバッファへのポインタ
となっている。(0,0,NULL)の指定だと、必要なバッファサイズ(一番大きな情報を返すカテゴリのために必要なバッファのサイズ)を返す。
タブレットが接続されていないなど利用できない状態の場合は0を返す。上記のコードは0かどうかを見ている。 

	/* check if WACOM available. */
    gpWTInfoA(WTI_DEVICES, DVC_NAME, WName);
    if (strncmp(WName,"WACOM",5)) {
		MessageBox(NULL, "Wacom Tablet Not Installed.", gpszProgramName, 
		    	   MB_OK | MB_ICONHAND);
//      return FALSE;
    }
上記のコードは、ワコム社のタブレットが接続されているかどうかを、帰ってきた値の中にWACOMの文字列があるかどうかでチェックしている。
WTI_DEVICES と DVC_NAME は .h の中で定義されているのだろう。この組み合わせでデバイスの名前を返す模様。
組み合わせる値と返る情報の表の翻訳版があったのでありがたく参照させていただく(外部参照)。 

	/* get info about tilt */
	tilt_support = gpWTInfoA(WTI_DEVICES,DVC_ORIENTATION,&TpOri);
	if (tilt_support) {
		/* does the tablet support azimuth and altitude */
		if (TpOri[0].axResolution && TpOri[1].axResolution) {

			/* convert azimuth resulution to double */
			tpvar = FIX_DOUBLE(TpOri[0].axResolution);
			/* convert from resolution to radians */
			aziFactor = tpvar/(2*pi);  
			
			/* convert altitude resolution to double */
			tpvar = FIX_DOUBLE(TpOri[1].axResolution);
			/* scale to arbitrary value to get decent line length */ 
			altFactor = tpvar/1000; 
			 /* adjust for maximum value at vertical */
			altAdjust = (double)TpOri[1].axMax/altFactor;
		}
		else {  /* no so dont do tilt stuff */
			tilt_support = FALSE;
		}
	}
上記はペンの傾き情報が利用できるかどうかをチェックしている模様。 

	/* Create a main window for this application instance.  */
	wsprintf(WName, "TiltTest:%x", hInst);
	hWnd = CreateWindow(
		"TiltTestWClass",
		WName,
		WS_OVERLAPPEDWINDOW,
		0,
		0,
		CW_USEDEFAULT,
		CW_USEDEFAULT,
		NULL,
		NULL,
		hInstance,
		NULL
	);

	/* If window could not be created, return "failure" */
	if (!hWnd)
		return (FALSE);
上記はアプリケーションウインドウを表示する部分らしい。 

   /* Get Device Context and setup a rects  to write packet info */
   hDC = GetDC(hWnd);
   if (!hDC)
		return FALSE;
	// 以下のブロックは
	// ウインドウにテキストを書くための、フォントのサイズなどのパラメータを取得している。
   GetTextMetrics(hDC, &textmetric);
   nLineH = textmetric.tmExternalLeading + textmetric.tmHeight;
   Xinch = GetDeviceCaps(hDC, LOGPIXELSX);
   Yinch = GetDeviceCaps(hDC, LOGPIXELSY);
   Hres = GetDeviceCaps(hDC, HORZRES);
   Vres = GetDeviceCaps(hDC, VERTRES);
   ReleaseDC(hWnd, hDC);


GetClientRect(hWnd, &rcClient);
rcInfoTilt = rcClient;
   rcInfoTilt.left   = Xinch / 8;
   rcInfoTilt.top    = Yinch / 8;
   rcInfoTilt.bottom = rcInfoTilt.top + nLineH;
   rcInfoName = rcInfoTilt;
   rcInfoName.top    += nLineH;
   rcInfoName.bottom += nLineH;
   rcInfoGen = rcInfoName;
   rcInfoGen.top    += nLineH;
   rcInfoGen.bottom += nLineH;
   rcDraw = rcInfoGen;
   rcDraw.left   = 0;
   rcDraw.top   += nLineH;
   rcDraw.bottom = rcClient.bottom;

以下、書きかけ。 

/* Make the window visible; update its client area; and return "success" */
ShowWindow(hWnd, nCmdShow);
UpdateWindow(hWnd);
return (TRUE);


   }


これを実行するとウインドウが表示され、ペンのタブレット上の位置が十字カーソルで表示され、十字カーソルを中心にして筆圧に従った大きさの円が描画される。カーソルの座標はタブレット面の座標に対応しており、タブレットドライバによるマルチモニタの割付などは無視している。
またウインドウがアクティブの間、マウスカーソルとタブレットの十字カーソルは別物として動作する。つまりマウスカーソルはマウスで、十字カーソルはタブレットペンで動く。
さらにタブ1=画面1、タブ2=画面2と割り付けてあったとき、ウインドウをどちらの画面に表示させてもタブ面の絶対座標が画面上の絶対座標に対応するかのように十字カーソルは動く。

タグ：

Tablet TiltTest.c C++
+ タグ編集
  • タグ：
  • Tablet
  • TiltTest.c
  • C++
タグの更新に失敗しました
エラーが発生しました。ページを更新してください。
ページを更新
「TiltTestC」をウィキ内検索
「Tablet」関連ページ
人気タグ「NetBeans」関連ページ
もっと見る
人気記事ランキング
  1. Googleスプレッドシートによる複式簿記の作成
  2. ワコムタブレット
  3. MSGS
もっと見る
最近更新されたページ
もっと見る
ウィキ募集バナー