javax.sound.midi
클래스 MidiFileFormat

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

public class MidiFileFormat
extends Object 

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

MidiFileFormat 객체에는, 일식의 프로퍼티을 짜넣을 수가 있습니다. 1 개의 프로퍼티은, 열쇠와 값의 페어로부터 완성됩니다. 열쇠는 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 개나 인식되지 않는 경우는, 빈 상태(empty)의 맵이 반환되는

도입된 버젼:

1.5

관련 항목:

getProperty(String)

getProperty

public Object  getProperty(String  key)

키에 의해 지정된 프로퍼티치를 가져옵니다. 프로퍼티의 개념에 대해 자세하게는,클래스의 설명 중(안)에서 해설합니다.

지정한 프로퍼티이 특정의 파일 형식에서 정의되어 있지 않은 경우, 이 메소드는 null 를 돌려줍니다.

파라미터:

key - 취득하고 싶은 프로퍼티의 키

반환값:

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

도입된 버젼:

1.5

관련 항목:

properties