javax.sound.midi
클래스 Track

java.lang.Object 
  javax.sound.midi.Track

public class Track
extends Object 

MIDI 트럭은 표준의 MIDI 파일에 다른 트럭과 함께 보존할 수 있는 MIDI 이벤트 (시각표시가 붙은 MIDI 데이터)의 독립한 스트림입니다. MIDI 사양으로 허용 되는 MIDI 데이터는 16 채널 뿐입니다만, 트럭을 사용하는 것으로 이 제한을 회피할 수 있습니다. 1개의 MIDI 파일에는 16 채널까지의 MIDI 데이터의 독자적인 스트림을 포함한 트럭을 임의의 수만큼 포함할 수 있습니다.

Track는 Sequencer 로 연주되는 데이터의 계층에서 중간의 위치를 차지합니다. 즉, 시퀀서가 연주하는 순서에는 트럭이 포함되어 트럭에는 MIDI 이벤트가 포함되어 있습니다. 시퀀서에서는 개개의 트럭을 제어해 뮤트 하거나 솔로로 하거나 할 수 있는 경우도 있습니다.

트럭의 타이밍 정보나 해상도는 그 트럭을 포함하고 있는 순서에 의해 제어 및 보존됩니다. 특정의 Track는 그 타이밍을 유지하고 있는 특정 Sequence 에 속하는 것이라고 보여집니다. 그 때문에 새로운 (비어있는) 트럭을 작성하려면, Track 생성자를 직접 호출하는 것이 아니라, Sequence.createTrack() 메서드를 호출합니다.

Track 클래스에서는 MidiEvent 객체를 추가 또는 삭제하는 것으로 트럭을 편집하는 메서드가 제공됩니다. 이러한 조작을 행해도, 이벤트 리스트의 시간순서는 올바르게 유지됩니다. 또, 트럭의 사이즈를 그 트럭에 포함되는 이벤트수, 또는 틱 단위에서의 듀레이션으로 얻는 메서드도 포함되어 있습니다.

관련 항목:

Sequencer.setTrackMute(int, boolean), Sequencer.setTrackSolo(int, boolean)

메서드 개요

boolean	add (MidiEvent event) 트럭에 새로운 이벤트를 추가합니다.
MidiEvent	get (int index) 지정한 인덱스의 이벤트를 취득합니다.
boolean	remove (MidiEvent event) 지정한 이벤트를 트럭으로부터 삭제합니다.
int	size () 이 트럭에 포함되는 이벤트의 수를 취득합니다.
long	ticks () 트럭의 길이를 MIDI 틱 단위로 취득합니다 (1 틱의 초단위에서의 듀레이션은 이 트럭을 포함하고 있는 Sequence 타이밍 해상도와 시퀀서로 설정한 음악의 템포에 의해 정해진다).

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

메서드의 상세

add

public boolean add(MidiEvent  event)

트럭에 새로운 이벤트를 추가합니다. 다만, 그 이벤트가 이미 그 트럭에 포함되어 있는 경우는 다시 추가할 수 없습니다. 이벤트의 리스트는 시간순서에 유지되기 때문에 이벤트는 리스트의 반드시 최후가 아니고, 적절한 장소에 삽입됩니다.

파라미터:

event - 추가하는 이벤트

반환값:

그 이벤트가 그 트럭에 포함되지 않고, 한편 추가되었을 경우는 true, 그렇지 않은 경우는 false

remove

public boolean remove(MidiEvent  event)

지정한 이벤트를 트럭으로부터 삭제합니다.

파라미터:

event - 삭제하는 이벤트

반환값:

그 이벤트가 그 트럭에 존재해, 한편 삭제되었을 경우는 true, 그렇지 않은 경우는 false

get

public MidiEvent  get(int index)
              throws ArrayIndexOutOfBoundsException 

지정한 인덱스의 이벤트를 취득합니다.

파라미터:

index - 얻는 이벤트의 이벤트 벡터에 한 위치

예외:

ArrayIndexOutOfBoundsException - 지정한 인덱스가 부, 또는 이 트럭의 현재의 사이즈 이상인 경우

ArrayIndexOutOfBoundsException

관련 항목:

size()

size

public int size()

이 트럭에 포함되는 이벤트의 수를 취득합니다.

반환값:

이 트럭의 이벤트 벡터의 사이즈

ticks

public long ticks()

트럭의 길이를 MIDI 틱 단위로 취득합니다 (1 틱의 초단위에서의 듀레이션은 이 트럭을 포함하고 있는 Sequence 타이밍 해상도와 시퀀서로 설정한 음악의 템포에 의해 정해진다).

반환값:

틱 단위에서의 듀레이션

관련 항목:

Sequence.Sequence(float, int), Sequencer.setTempoInBPM(float), Sequencer.getTickPosition()