TwinVQ問い合わせ関数のマニュアル

(C)Copyright 2000 NTT Cyber Space Laboratories

# TwinVQ問い合わせ関数

更新：2000年10月12日

名前
  `TvqEncCheckVersion(), TvqEncGetSamplingRate(), TvqEncGetBitRate(), TvqEncGetFrameSize(), TvqEncGetNumChannels, TvqGetNumFixedBitsPerFrame(), TvqEncGetSetupInfo(), TvqEncGetConfInfo(), TvqEncGetNumPreCand(), TvqGetVersionID()` TvqGetModuleVersion( )- TwinVQ モジュールへの問い合わせ関数
形式
  `#include "twinvq.h"
  #include "tvqenc.h"
  int TvqEncCheckVersion(char *strTvqID);
  float TvqEncGetSamplingRate();
  int TvqEncGetBitRate();
  int TvqEncGetFrameSize();
  int TvqEncGetNumChannels();
  int TvqEncGetNumFixedBitsPerFrame();
  void TvqEncGetSetupInfo(headerInfo *sinfo);
  void TvqEncGetConfInfo(tvqConfInfo *cf);
  int TvqGetVersionID(int versionNum, char *versionID);`
  `int TvqEncGetModuleVersion( char *versionName );`
  `
  `
機能説明
  `TvqEncCheckVersion()` は、バージョン ID 文字列をチェックし、対応するバージョン番号を戻します。バージョン番号と ID 文字列の対応は以下の通りです。

  文字列 | バージョン番号 | バージョン名
  "TWIN97012000" | V2 (= 0) | バージョン２
  上記の２つ以外 | TVQ_UNKNOWN_VERSION (= -1) | サポート外バージョン

  `TvqGetVersionID()` は、バージョン ID 番号を入力し、バージョン ID 文字列を取得します。versionID に13文字以上の文字配列を渡すと、versionNumに対応したバージョンIDをコピーします。バージョン番号と ID 文字列の対応は上の表の通りですが、サポート外のバージョン ID 番号を入力すると、バージョンIDのコピーは行われず関数の戻り値として 1 を返します。バージョンIDのコピーが行われた場合には0が戻ります。
  `TvqEncGetSamplingRate()` は、サンプリング周波数を返します。単位は Hz で、戻り値の型は float です。
  `TvqEncGetBitRate()` は、固定部分のビットレートを返します（全チャネルトータル）。単位は kbit/s で、戻り値の型は int です。
  `TvqEncGetFrameSize()` は、フレームサイズを返します。
  `TvqEncGetNumChannels()` は、チャネル数を返します。
  `TvqEncGetSeupInfo` は、TwinVQ モジュールのセットアップ情報を獲得し、内容を `sinfo` に格納します。
  `TvqEncGetConfInfo()` は、TwinVQモジュールの設定の情報を獲得し、内容を `cf` に格納します。
  `TvqEncGetModuleVersion()` は、モジュールのバージョンを取得します。versionID に 256 文字以上の文字配列を渡すと、モジュールのバージョン名をコピーします。
  `
  sinfo` は、初期化パラメータを格納する`headerInfo` 構造体を示すポインタです。
  `cf` は `tvqConfInfo` 構造体を示すポインタです。