javax.sound.midi
클래스 MidiFileFormat

java.lang.Object 
  javax.sound.midi.MidiFileFormat

public class MidiFileFormat
extends Object 

MidiFileFormat객체는 MIDI 파일의 형태를 길이 및 타이밍 정보와 함께 캡슐화합니다.

MidiFileFormat 객체에는 일식의 프로퍼티를 짜넣을 수가 있습니다. 프로퍼티는 String 형의 키와 임의의 객체를 값으로 해서 지정하는 프로퍼티치의 페어로 구성됩니다. 프로퍼티에는 작성자나 저작권 등, 부가적인 정보의 메타데이타를 지정합니다. 프로퍼티는 옵션 정보이므로 파일 리더 및 파일 리더의 구현으로 프로퍼티를 제공하거나 인식하거나 하는 것은 필수가 아닙니다.

다음의 겉(표)에 구현으로 사용되는 일반적인 프로퍼티의 예를 나타냅니다.

프로퍼티의 키	치의 형태	설명
「author」	String	이 파일의 작성자의 이름
「title」	String	이 파일의 타이틀
「copyright」	String	저작권 메세지
「date」	Date	녹음 또는 릴리스의 날짜와 시간
「comment」	String	임의의 텍스트

관련 항목:

MidiSystem.getMidiFileFormat(java.io.File), Sequencer.setSequence(java.io.InputStream stream)

필드 개요

protected int	byteLength MIDI 파일의 길이를 바이트로 표시한 것입니다.
protected float	divisionType MIDI 파일의 분할 형식입니다.
protected long	microsecondLength MIDI 파일의 듀레이션을 마이크로 세컨드로 표시한 것입니다.
protected int	resolution MIDI 파일의 타이밍 해상도입니다.
protected int	type MIDI 파일의 형태입니다.
static int	UNKNOWN_LENGTH 길이가 미지인 것을 나타냅니다.

생성자 개요

MidiFileFormat (int type, float divisionType, int resolution, int bytes, long microseconds)
MidiFileFormat를 구축합니다.

MidiFileFormat (int type, float divisionType, int resolution, int bytes, long microseconds, Map <String, Object > properties)
MidiFileFormat를, 일식의 프로퍼티를 짜넣어 구축합니다.

메서드 개요

int	getByteLength () MIDI 파일의 길이를 8 비트 바이트 단위로 취득합니다.
float	getDivisionType () MIDI 파일의 타이밍 분할 형식을 취득합니다.
long	getMicrosecondLength () MIDI 파일의 길이를 마이크로 세컨드 단위로 취득합니다.
Object	getProperty (String key) 지정한 키의 프로퍼티치를 취득합니다.
int	getResolution () MIDI 파일의 타이밍 해상도를 취득합니다.
int	getType () MIDI 파일형을 취득합니다.
Map <String, Object >	properties () 프로퍼티의 맵 (변경 불가)을 취득합니다.

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

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

필드의 상세

UNKNOWN_LENGTH

public static final int UNKNOWN_LENGTH

길이가 미지인 것을 나타냅니다.

관련 항목:

getByteLength(), getMicrosecondLength(), 정수 필드값

type

protected int type

MIDI 파일의 형태입니다.

divisionType

protected float divisionType

MIDI 파일의 분할 형식입니다.

관련 항목:

Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

resolution

protected int resolution

MIDI 파일의 타이밍 해상도입니다.

byteLength

protected int byteLength

MIDI 파일의 길이를 바이트로 표시한 것입니다.

microsecondLength

protected long microsecondLength

MIDI 파일의 듀레이션을 마이크로 세컨드로 표시한 것입니다.

생성자 상세

MidiFileFormat

public MidiFileFormat(int type,
                      float divisionType,
                      int resolution,
                      int bytes,
                      long microseconds)

MidiFileFormat를 구축합니다.

파라미터:

type - MIDI 파일의 형태 (0, 1, 또는 2)

divisionType - 타이밍 분할 형식 (PPQ, 또는 SMPTE 형식의 1개)

resolution - 타이밍 해상도

bytes - MIDI 파일의 길이 (바이트 단위)인가 길이가 미지의 경우는 UNKNOWN_LENGTH

microseconds - MIDI 파일의 듀레이션 (마이크로 세컨드 단위)인가 길이가 미지의 경우는 UNKNOWN_LENGTH

관련 항목:

UNKNOWN_LENGTH, Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

MidiFileFormat

public MidiFileFormat(int type,
                      float divisionType,
                      int resolution,
                      int bytes,
                      long microseconds,
                      Map <String,
Object > properties)

MidiFileFormat를, 일식의 프로퍼티를 짜넣어 구축합니다.

파라미터:

type - MIDI 파일의 형태 (0, 1, 또는 2)

divisionType - 타이밍 분할 형식 (PPQ, 또는 SMPTE 형식의 1개)

resolution - 타이밍 해상도

bytes - MIDI 파일의 길이 (바이트 단위)인가 길이가 미지의 경우는 UNKNOWN_LENGTH

microseconds - MIDI 파일의 듀레이션 (마이크로 세컨드 단위)인가 길이가 미지의 경우는 UNKNOWN_LENGTH

properties - 프로퍼티를 지정한 Map<String, Object> 객체

도입된 버전 :

1.5

관련 항목:

UNKNOWN_LENGTH, Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

메서드의 상세

getType

public int getType()

MIDI 파일형을 취득합니다.

반환값:

파일의 형태 (0, 1, 또는 2)

getDivisionType

public float getDivisionType()

MIDI 파일의 타이밍 분할 형식을 취득합니다.

반환값:

분할 형식 (PPQ, 또는 SMPTE 형식의 1개)

관련 항목:

Sequence.Sequence(float, int), Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30, Sequence.getDivisionType()

getResolution

public int getResolution()

MIDI 파일의 타이밍 해상도를 취득합니다. 분할 형식이 PPQ인 경우, 해상도는 1 비트 당의 틱으로 지정됩니다. SMTPE 타이밍의 경우, 해상도는 1 프레임 당의 틱으로 지정됩니다.

반환값:

1 비트 당 (PPQ) 또는 1 프레임 당 (SMPTE)의 틱수

관련 항목:

getDivisionType(), Sequence.getResolution()

getByteLength

public int getByteLength()

MIDI 파일의 길이를 8 비트 바이트 단위로 취득합니다.

반환값:

파일에 포함되는 바이트수인가 바이트수가 미지의 경우는 UNKNOWN_LENGTH

관련 항목:

UNKNOWN_LENGTH

getMicrosecondLength

public long getMicrosecondLength()

MIDI 파일의 길이를 마이크로 세컨드 단위로 취득합니다.

반환값:

파일의 듀레이션 (마이크로 세컨드 단위)인가 길이가 미지의 경우는 UNKNOWN_LENGTH

관련 항목:

Sequence.getMicrosecondLength(), getByteLength(), UNKNOWN_LENGTH

properties

public Map <String,
Object > properties()

프로퍼티의 맵 (변경 불가)을 취득합니다. 프로퍼티의 개념에 대해 자세하게는 클래스의 설명 안에서 해설합니다.

반환값:

모든 프로퍼티를 포함한 Map<String, Object> 객체. 프로퍼티가 1개 나 인식되지 않는 경우는 비어있는 맵이 리턴된

도입된 버전 :

1.5

관련 항목:

getProperty(String)

getProperty

public Object  getProperty(String  key)

지정한 키의 프로퍼티치를 취득합니다. 프로퍼티의 개념에 대해 자세하게는 클래스의 설명 안에서 해설합니다.

지정한 프로퍼티가 특정의 파일 형식에서 정의되어 있지 않은 경우, 이 메서드는 null을 리턴합니다.

파라미터:

key - 바람직한 프로퍼티의 키

반환값:

지정된 키를 가지는 프로퍼티의 값. 그 프로퍼티가 존재하지 않는 경우는 null

도입된 버전 :

1.5

관련 항목:

properties