JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.