com.jblend.media.karaoke
クラス ReferenceScore

java.lang.Object
  |
  +--com.jblend.media.karaoke.ReferenceScore

public class ReferenceScore
extends java.lang.Object

採点基準情報を管理するためのクラスです。

KaraokePlayerオブジェクトは再生速度とキーを変更することができますが、 その変更は、ReferenceScoreクラスのインスタンスには反映されません。

ReferenceScoreクラスのインスタンスは、KaraokeData オブジェクトに関連しています。 関連している KaraokeDataオブジェクトに対して KaraokeDatasetData() メソッドによってメディアデータが変更された場合、 ReferenceScoreクラスのメソッドによって取得する値も変わります。

 例
   ReferenceScore A = KaraokeData.getReferenceScore();
   KaraokeData.setData( ChangeData );
   ReferenceScore B = KaraokeData.getReferenceScore();
   
A、Bから得られる情報は、どちらも ChangeData に対する情報です。

導入されたバージョン:
JSCL 1.3.2

メソッドの概要
 byte[] getOptionalData(int size)
          採点用付加情報を取得する。
 int getReferenceEventCh()
          採点基準情報のチャンネル番号を取得します。
 ReferenceEvent getReferenceEvents(int ch, int size)
          採点基準情報を取得します。
 int getTagEnd(int tag)
          SMAFデータ中に設定されている採点用タグの終了時間を取得します。
 int getTagStart(int tag)
          SMAFデータ中に設定されている採点用タグの開始時間を取得します。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getReferenceEventCh

public int getReferenceEventCh()
採点基準情報のチャンネル番号を取得します。

SMAFデータ中の採点基準情報に指定されているチャンネル番号を取得します。 チャンネル番号はビットマップ値で表します。 指定されているチャンネル番号に対応するビットの値が 1 となります。 チャンネル番号 0 〜 15 で最下位ビット(ビット0)がチャンネル番号0、 ビット1がチャンネル番号1・・・ビット15がチャンネル番号15となります。

戻り値:
チャンネル番号に対応するビットマップ値
例外:
java.lang.RuntimeException - 取得エラーが発生した場合に発生する

getReferenceEvents

public ReferenceEvent getReferenceEvents(int ch,
                                         int size)
採点基準情報を取得します。

指定されたチャンネルから採点基準情報を取得します。 採点基準情報が含まれるチャンネルはgetReferenceEventCh()によって取得します。 取得する要素数は、指定されたチャンネルの採点基準情報に依存します。 最大で引数sizeに指定した数を取得します。 取得した採点基準情報は、積算時間の小さい順に配列になっています。

パラメータ:
ch - 取得する採点基準情報のチャンネル番号(0 〜 15)
size - 採点基準情報から取得する要素数
戻り値:
採点の基準となる旋律情報を表す ReferenceEvent
例外:
java.lang.IllegalArgumentException - 採点基準情報以外のチャンネル番号を指定した、またはサイズが不正な場合に発生する
java.lang.RuntimeException - 取得エラーが発生した場合に発生する

getOptionalData

public byte[] getOptionalData(int size)
採点用付加情報を取得する。

SMAFデータ中に含まれるオプション情報を取得します。 最大で引数sizeに指定されたサイズの情報を取得します。 SMAFデータ中にオプション情報が含まれていない場合は null が返ります。

パラメータ:
size - 取得するオプション情報のサイズ
戻り値:
採点用付加情報
例外:
java.lang.IllegalArgumentException - sizeが負の場合に発生する
java.lang.RuntimeException - 取得エラーが発生した場合に発生する

getTagStart

public int getTagStart(int tag)
SMAFデータ中に設定されている採点用タグの開始時間を取得します。
パラメータ:
tag - 採点用タグ。0 〜 15 の16段階で指定する。
戻り値:
開始位置の時間(単位はミリ秒)。曲の先頭からの経過時間を返す。 タグが存在しない場合は負の値を返す。
例外:
java.lang.IllegalArgumentException - 採点用タグが不正の場合に発生する

getTagEnd

public int getTagEnd(int tag)
SMAFデータ中に設定されている採点用タグの終了時間を取得します。
パラメータ:
tag - 採点用タグ。0 〜 15 の16段階指定で指定する。
戻り値:
終了位置の時間(単位はミリ秒)。曲の先頭からの経過時間を返す。 タグが存在しない場合は負の値を返す。
例外:
java.lang.IllegalArgumentException - 採点用タグが不正の場合に発生する