Julius Windows コンソール版

Visual C++ でのコンパイルの手引き

							2004/03/09
========================================================================

本文書は，Julius-3.4.2 Windows コンソール版を
Microsoft Visual C++ でコンパイルする方法について解説します．

なお，テストしたコンパイル環境は以下の通りです．

	Microsoft Windows XP Professional SP1 日本語版
	Microsoft Visual C++ 6.0

//////////////////////////////////////////////////////////////////////

□１．準備

Julius/Julian をソースからコンパイルするには，win32用の zlibライブラリが必要
です．以下を入手して，そのなかのヘッダファイルと zlibstat.lib を
適当なディレクトリに置いておいてください．
	
	http://www.gzip.org/zlib/contrib/zlib113-win32.zip

また，文法コンパイラ mkfa を作るために，Win32 用の flex ライブラリが
必要です．Win32用flexライブラリの作成方法は下記を参考にしてください．

	http://www.geocities.com/ymotiwala/flex.html

ライブラリの準備が出来たら，julius/julian のソースを展開してください．

	% tar xzvf julius-3.4.2-win32.tar.gz


//////////////////////////////////////////////////////////////////////

□２．ワークスペースの作成

  Visual C++ を起動し，新規ワークスペースを作成します．
  「ファイル」→「新規作成」→「ワークスペース」
  ワークスペース名は "Julius"，ディレクトリは適当な場所を指定してください．


//////////////////////////////////////////////////////////////////////

□３．juliuslibのコンパイル

3.1  新規プロジェクトを作成する
=================================

  画面左のペインの「ワークスペース Julius:」を右クリックして，
  「ワークスペースへ新規プロジェクトを追加」します．
  タイプは「Win32 static library」を選択し，プロジェクト名を juliuslib
  にします．ディレクトリはデフォルトのままでよいでしょう．
  「…以下の機能を使用しますか？」のダイアログが出る場合は，どちらも使
  用しませんのでチェックをすべて外して「終了」を押してください．


3.2  ソースファイルをプロジェクトに追加する
============================================

  julius-3.4.2-win32/libsent/src 以下にあるソースファイルを追加します．
  左のペインの下の「FileView」を選択し，「juliuslib ファイル」を
  右クリックして「フォルダの新規作成」を選び，以下のフォルダを新規作成します．

	adin
	anlz
	dfa
	hmminfo
	libjcode
	net
	ngram
	phmm
	util
	voca
	wav2mfcc
	
  次に，それぞれのフォルダを右クリックして「ファイルをフォルダへ追加」
  を選び，libsent/src 内の対応するフォルダ内のソースを入れていきます．

    ○adin については，以下のファイルのみを追加してください．
	adin.c
	adin_file.c
	adin_portaudio.c
	adin_tcpip.c
	adin-cut.c
	zc-e.c
	zmean.c
	pa/* (pa_unix_oss以外)
    ○libjcode については，以下のファイルのみを追加してください．
	libjcode.c
	detect.c

  それ以外のディレクトリは，全ての .c, .h ファイルを追加します．


3.3  プロジェクトを設定する
============================

 プロジェクトのコンパイルの設定を行います．「プロジェクト」→「設定...」
 で，「C/C++」タブの「カテゴリ(Y)」を「プリプロセッサ」にして，
 「インクルードファイルのパス」として，

	julius-3.4.2-win32\libsent/include
	zlibのヘッダファイルへのパス
  
 の２つを，コンマで区切って指定してください．
 例えば，julius-3.4.2-win32 が C:\temp に展開されていて，zlib が
 C:\temp\zlib に展開されている場合，以下のように指定します．

         "C:\temp\julius-3.4.2-win32\libsent\include,c:\temp\zlib"


 設定が終わったら，メニューの「ビルド」→「アクティブな構成の設定...」
 から，Win32 Release ビルドを選択しておいてください．


3.4  ビルド実行
================

  「ビルド」→「ビルド」を実行してください．
   2.1で指定したディレクトリのReleaseの下に，juliuslib.lib が作成されます．


//////////////////////////////////////////////////////////////////////

□４．julian のコンパイル

4.1  新規プロジェクトを作成する
================================

  画面左のペインにある「ワークスペース Julius:」を右クリックし，
  メニューから「ワークスペースへ新規プロジェクトを追加」します．
  タイプは「Win32 console application」を選択し，
  プロジェクト名を julian にします．
  続くダイアログでは「空のプロジェクト」を指定してください．


4.2  ソースファイルをプロジェクトに追加する
=============================================

  julius-3.4.2-win32/julius 以下にあるソースファイルとヘッダを
  追加します．

  左の pane の下の「FileView」を選び，「julian ファイル」を右クリック
  して「ファイルをフォルダへ追加」から，
  julius-3.4.2-win32/julius/ 以下の .c と .h ファイルを指定します．
  ただし，以下は省いてください．

	acconfig.h
	
  次に julius.h を編集します．さきほどの「Source Files」にある
  "julius.h" をダブルクリックして開き， 21行目に

----------------------------------------------------------------------
	# include <config-win-julian.h>
----------------------------------------------------------------------

  があることを確認してください．もし違っていれば，上記のように
  書き換えてください．


4.3 プロジェクトを設定する
===========================

  ・2.3 と同様にインクルードファイルのパスを設定します．今度は，
    julius のソースディレクトリもパスに指定します．すなわち，
    「プリプロセッサ」の「インクルードファイルのパス」として，

	julius-3.4.2-win32\julius
        julius-3.4.2-win32\libsent\include
	zlibのヘッダファイルへのパス

    の３つを，上記の順でコンマで区切って指定してください．


  ・2 章でコンパイルした juliuslib.lib と zlibstat.lib が存在する場所
    をそれぞれライブラリのパスに追加してください．
    「リンク」→「カテゴリ(Y)：インプット」→「追加ライブラリのパス」

    例："C:\temp\Julius\juliuslib\Release, C:\temp\zlib, C:\temp\flexlib"


  ・リンクするライブラリとして，以下の４つを追加します．

	juliuslib.lib zlibstat.lib winmm.lib wsock32.lib

    「リンク」タブの「カテゴリ(Y)」を「一般」にして，
     「オブジェクト/ライブラリ モジュール」欄の末尾に上記を追加してく
     ださい．


 上記が終了したら，メニューの「ビルド」→「アクティブな構成の設定...」
 を選び，「julian - Win32 Release」を選択してください．


4.4 ビルド実行
==============

  プロジェクトを作成したディレクトリの Release/ 以下に
  julian.exe が作成されます．


----------------------------------------------------------------------
□５．julius のコンパイル


Julius の作成も，前節の Julian と同様に新規プロジェクトを追加して行います．
ただし，julius.h の21行目を

----------------------------------------------------------------------
	# include <config-win-julius.h>
----------------------------------------------------------------------
に書き換えてください．

□６．その他のツールのコンパイル

Julius/Julian のときと同様に，Win32 console application のプロジェクト
を新規作成してソースを加え，設定を行いビルドしてください．

以下はツール名と，それに対応するソースファイルの置き場所です．

    adinrec	    julius-3.4.2-win32/adinrec/
    adintool	    julius-3.4.2-win32/adintool/
    jcontrol	    julius-3.4.2-win32/jcontrol/
    mkbingram	    julius-3.4.2-win32/mkbingram/
    mkbinhmm	    julius-3.4.2-win32/mkbinhmm/
    mkss	    julius-3.4.2-win32/mkss/
    mkfa	    julius-3.4.2-win32/gramtools/mkdfa/mkfa-1.44-flex
    generate	    julius-3.4.2-win32/gramtools/generate/
    accept_check    julius-3.4.2-win32/gramtools/accept_check/

以下は，各ツールごとの留意点です．

  ○jcontrol
    リンクのオブジェクトには wsock32.lib のみでよい

  ○mkfa
  ・flex ライブラリをコンパイルして flexlib.lib を作る必要がある．以下を参照．
	http://www.geocities.com/ymotiwala/flex.html
  ・lex.yy.c 以外のファイルをプロジェクトに追加
  ・ライブラリには flexlib.lib のみを追加

----------------------------------------------------------------------
以上．
