Class SongUnit

ソングUnit管理用クラス

Inheritance
object
UnitBase
SongUnit
Inherited Members
Namespace: LibSasara.Model
Assembly: LibSasara.dll
Syntax
public class SongUnit : UnitBase
Remarks

Unit要素（SongUnitの場合はソングトラックの楽譜・調整データ全て、TalkUnitの場合はセリフ単位）を管理します。 シリアライズしたクラスではありません。

RawRootをはじめとした Raw～ で始まるプロパティは元のxmlのXElementへのアクセスを提供します。XML要素を直接いじる際に使用します。

Constructors

SongUnit(XElement, CeVIOFileBase)

Unit管理用クラス コンストラクタ

Declaration
public SongUnit(XElement elem, CeVIOFileBase root)
Parameters
Type Name Description
XElement elem
CeVIOFileBase root

Unit所属ファイルの管理クラス
See Also
IUnitBuilder<TUnit, TBuilder>

Properties

Alpha

トラック全体の声質バー / Global Alpha(ALP)

Declaration
public decimal Alpha { get; set; }
Property Value
Type Description
decimal
Remarks

エディタ上で設定する数値と異なる内部的な数値で管理される。

Beat

曲の拍子変更リスト

Declaration
public SortedDictionary<int, (int Beats, int BeatType)> Beat { get; }
Property Value
Type Description
SortedDictionary<int, (int Beats, int BeatType)>

CastId

キャスト（ボイス）の内部ID

Declaration
public string CastId { get; set; }
Property Value
Type Description
string

Category

Unit category

Declaration
public override Category Category { get; }
Property Value
Type Description
Category
Overrides
See Also

CommonKeys

調号を全トラック共通で処理するかどうか

Declaration
public bool CommonKeys { get; set; }
Property Value
Type Description
bool
Remarks

CeVIO AI ver. 8.5以降のみ。 SongVersionが 1.08 以上で存在。

See Also

Husky

トラック全体のハスキーパラメータ / Global Huskiness(HUS)

Declaration
public decimal Husky { get; set; }
Property Value
Type Description
decimal
  • VoiSona: max: 10.0, min: -10.0, default: 0.0
  • CeVIO AI: max: 1.0, min: -1.0, default: 0.0
Remarks

トラック全体のかすれ具合のパラメータ。 VoiSona v1.0、CeVIO AI v8.5以降 SongVersion >= 1.8

Language

Unitの言語

Declaration
public string Language { get; set; }
Property Value
Type Description
string
Remarks

"Japanese", "English"

Notes

音符データのリスト

Declaration
public List<Note> Notes { get; }
Property Value
Type Description
List<Note>

PitchShift

トラック全体の基準ピッチ / Tuning pitch

Declaration
public decimal PitchShift { get; set; }
Property Value
Type Description
decimal

Hz. default: 440.0, max: 450.0, min: 430.0
Remarks

トラック全体の基準となるピッチの周波数の値。 指定がない場合は 440.0 が返ります。 VoiSona v1.0、CeVIO AI v8.5以降 SongVersion >= 1.8

PitchTune

トラック全体のTUNEパラメータ / Global TUNE

Declaration
public decimal PitchTune { get; set; }
Property Value
Type Description
decimal

default: 0.0, max: 1.0, min: -1.0
Remarks

ピッチの音符の音程への忠実度合いを調整する。 VoiSona v1.2、CeVIO AI v8.5以降 SongVersion >= 1.8

RawAlpha

生のAlpha(ALP)要素

Declaration
public XElement RawAlpha { get; set; }
Property Value
Type Description
XElement

RawHuskiness

生のHuskiness(HUS)要素（Husky)

Declaration
public XElement RawHuskiness { get; set; }
Property Value
Type Description
XElement

RawParameter

生のParameter要素

Declaration
public XElement? RawParameter { get; set; }
Property Value
Type Description
XElement

RawParameterChildren

生のParameter要素の子要素一覧

Declaration
public List<XElement> RawParameterChildren { get; set; }
Property Value
Type Description
List<XElement>
See Also

RawParameters

生のParameter要素の子要素一覧

Declaration
[Obsolete("Use RawParameterChildren")]
public List<XElement> RawParameters { get; set; }
Property Value
Type Description
List<XElement>
See Also

RawPitch

生のPitch(PIT)要素（LogF0)

Declaration
public XElement RawPitch { get; set; }
Property Value
Type Description
XElement

RawScore

生のScore要素

Declaration
public XElement RawScore { get; set; }
Property Value
Type Description
XElement
See Also

RawScores

生のScore要素の子要素一覧

Declaration
public IList<XElement> RawScores { get; set; }
Property Value
Type Description
IList<XElement>
Remarks

Score要素の子要素のみのリスト(List<T>)です。Score要素そのものは RawScore を使用して下さい。

See Also

RawSong

Songの生要素

Declaration
public XElement RawSong { get; set; }
Property Value
Type Description
XElement

RawTiming

生のTiming(TMG)要素

Declaration
public XElement RawTiming { get; set; }
Property Value
Type Description
XElement

RawVibratoAmp

生のVIA要素（VibAmp）

Declaration
public XElement RawVibratoAmp { get; set; }
Property Value
Type Description
XElement

RawVibratoFrq

生のVIF要素（VibFrq）

Declaration
public XElement RawVibratoFrq { get; set; }
Property Value
Type Description
XElement

RawVolume

生のVolume(VOL)要素（C0）

Declaration
public XElement RawVolume { get; set; }
Property Value
Type Description
XElement

SongVersion

ソングフォーマットのバージョン

Declaration
public Version SongVersion { get; }
Property Value
Type Description
Version
Remarks

ソングエンジンやボイスのバージョンとは異なります。

  • VoiSonaVoiSonaの場合は取得できません

Tempo

曲のテンポ変更リスト

Declaration
[Obsolete("Use Tempos")]
public SortedDictionary<int, int> Tempo { get; }
Property Value
Type Description
SortedDictionary<int, int>
Remarks
  • Clock: テンポ変更開始時のtick
  • Tempo : テンポ
See Also

Tempos

曲のテンポ変更リスト

Declaration
public SortedDictionary<int, decimal> Tempos { get; }
Property Value
Type Description
SortedDictionary<int, decimal>
Remarks
  • Clock : テンポ変更開始時のtick
  • Tempo : テンポ

Volume

VOLの調声パラメータ

Declaration
public Parameters Volume { get; set; }
Property Value
Type Description
Parameters
Remarks
  • Length : パラメータ総数（0.005間隔）
See Also

Methods

CreateSongUnitRaw(TimeSpan, TimeSpan, string, Guid?, string?, string, SortedDictionary<int, int>?, SortedDictionary<int, (int Beats, int BeatType)>?)

SongのUnit要素生成

Declaration
public static XElement CreateSongUnitRaw(TimeSpan StartTime, TimeSpan Duration, string CastId, Guid? Group = null, string? Language = "Japanese", string songVersion = "1.07", SortedDictionary<int, int>? tempo = null, SortedDictionary<int, (int Beats, int BeatType)>? beat = null)
Parameters
Type Name Description
TimeSpan StartTime
TimeSpan Duration
string CastId
Guid? Group
string Language
string songVersion

Song要素のversion。CS7,AI 8.4までは 1.07。AI 8.5以降は 1.08
see: SongVersion
SortedDictionary<int, int> tempo
SortedDictionary<int, (int Beats, int BeatType)> beat
Returns
Type Description
XElement

SongのUnit要素のXElement
Remarks

SongのUnit要素のXElementを生成します。

生成するだけでCeVIOFileBaseには紐付けません。 SongUnitBuilderも活用してください。

See Also

See Also