2010년 5월 9일 일요일

MPMediaPropertyPredicate Class Reference

MPMediaPropertyPredicate Class Reference
상속 : MPMediaPredicate:NSObject
프로토콜 : NSCoding (MPMediaPredicate) / NSObject (NSObject)
프레임워크 : /System/Library/Frameworks/MediaPlayer.framework
사용가능 버전 : iPhone OS 3.0 이상
관련 가이드 : iPod Library Access Programming Guide
선언 : MPMediaQuery.h

개요
iPod 라이브러리에서 미디어 아이템의 서브셋을 얻는 미디어 쿼리내의 필터를 정의하는 하나 이상의 MPMediaPropertyPredicate 오브젝트 또는 미디어 프로퍼티 프리디케이트들을 사용한다.  이 컨텍스트의 프리디케이트(predicate)는 각 미디어 아이템에 대해 테스트 하기 원하는 논리 상태의 명령문이다.  이 아이템들은 쿼리 결과에서 얻어지는 상태를 만족시킨다.

당신은 MPMediaQuery 클래스 레퍼런스에서 설명된 MPMediaQuery 클래스를 사용해서 iPod 라이브러리 쿼리들을 정의하고 쿼리 결과들을 얻는다. 미디어 아이템들과 미디어 아이템 컬렉션들은 MPMediaItemCollection 클래스 레퍼런스MPMediaItem 클래스 레퍼런스에서 설명된 쿼리를 사용해서 얻는다.

태스크
미디어 프로퍼티 프리디케이트 생성
+ predicateWithValue:forProperty:
+ predicateWithValue:forProperty:comparisonType:

미디어 프로퍼티 프리디케이트 검사
property property
value property
comparisonType property

속성
comparisonType
당신이 쿼리를 호출할 때 비교할 미디어 프로퍼티 프리디케이트 수행 형태.
@property (nonatomic, readonly) MPMediaPredicateComparison comparisonType;

토론
비교 타입은 "Media Property Predicate Comparison Types." 를 보도록 하자.

iPhone OS 3.0 이상에서 사용가능하고 MPMediaQuery.h 에 선언되어 있다.

property
당신이 쿼리를 호출할 때 사용하는 미디어프로퍼티 프리디케이트 속성
@property (nonatomic, readonly, copy) NSString *property
iPhone OS 3.0 이상에서 사용가능하고 MPMediaQuery.h 에 선언되어 있다.

value
당신이 쿼리를 호출할 때 검색할 미디어 프로퍼티 프리디케이트 값.
@property (nonatomic, readonly) id value
iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.
iPhone OS 3.0 이상에서 사용가능하고 MPMediaQuery.h 에 선언되어 있다.


클래스 메서드
predicateWithValue:forProperty:
기본 비교 타입으로 미디어 프로퍼티 프리디케이트를 생성.
+ (MPMediaPropertyPredicate *)predicateWithValue:(id)value 
                                     forProperty:(NSString *)property
인자
predicateWithValue:
    iPod 라이브러리에 질의할 때 일치하길 바라는 속성 값.
    예를 들어, forProperty 인자에 MPMediaItemPropertyArtist 상수를 넣었다면,
    이 인자에서 당신은 아티스트명을 포함하는문자열을 제공하도록한다.
forProperty:
    미디어 프로퍼티 프리디케이트를 만드는데 사용할 수 있는 호출된 필터가능한 속성.
    MPMediaItem 클래스 레퍼런스의 일반적인 미디어 아이템 속성 키와
    팟캐스트 아이템 속성 키들을 참고하자.

리턴값
하나의 미디어 프로퍼티 프리디케이트

토론
이것은 편리한 메서드이다. 
이것은 기본 논리 비교 타입으로 MPMediaPredicateComparisonEqualTo를 사용한다.

iPhone OS 3.0 이상에서 사용가능하고, MPMediaQuery.h 에 선언되어 있다.
+ predicateWithValue:forProperty:comparisonType: 도 함께 보도록 하자.

predicateWithValue:forProperty:comparisonType:
특정 비교 타입으로 미디어 프로퍼티 프리디케이트를 생성한다.
+ (MPMediaPropertyPredicate *)predicateWithValue:(id)value 
                                     forProperty:(NSString *)property
                       comparisonType:(MPMediaPredicateComparison)comparisonType
인자
prediateWithValue:
    iPod 라이브러리에 질의할 때 일치하기를 바라는 속성 값.
    예를 들어, forProperty 속성에 MPMediaItemPropertyArtist 상수를 넣었다면,
    이 인자에서는 아티스트 명을 포함하는 문자열을 제공해야 한다.
forProperty:
    미디어 프로퍼티 프리디케이트를 만드는데 사용할 수 있는 호출된 필터가능한 속성.
    MPMediaItem 클래스 레퍼런스의 일반적인 미디어 아이템 속성 키와
    팟캐스트 아이템 속성 키들을 참고하자.
comparisonType:
    프리디케이트를 위한 논리적인 비교 형태.
    "미디어 프로퍼티 프리디케이트 비교 타입"을 참고하자.

리턴값
하나의 미디어 프로퍼티 프리디케이트

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h 에 선언되어 있다.
+ predicateWithValue:forProperty: 도 함께 보도록 하자.

상수
미디어 프로퍼티 프리디케이트 비교 타입
미디어 쿼리들을 위한 논리적 비교 형태
다음의 상수들은 iPhone OS 3.0 이상에서 사용가능하며, MPMediaQuery.h에 선언되어 있다.
enum {
    MPMediaPredicateComparisonEqualTo,
    MPMediaPredicateComparisonContains
};
typedef NSInteger MPMediaPredicateComparison;

상수
MPMediaPredicateComparisonEqualTo
    미디어 프로퍼티 프리디케이트의 값과 미디어 아이템의 주어진 속성값이 같을 때.
MPMediaPredicateComparisonContains
    미디어 프로퍼티 프리디케이트의 값에 미디어 아이템의 주어진 속성값이 포함될 때.
원문

MPMediaQuery Class Reference

MPMediaQuery Class Reference
상속 : NSObject
프로토콜 : NSCoding / NSCopying / NSObject(NSObject)
프레임워크 : /System/Library/Frameworks/MediaPlayer.framework
사용가능한 버전 : iPhone OS 3.0 이상
관련된 가이드 : iPod Library Access Programming Guide
정의 : MPMediaQuery.h


개요
MPMediaQuery 오브젝트, 또는 미디어 쿼리는 필터나 그룹핑 타입의 방법으로 iPod 라이브러리로부터 미디어 아이템의 셋을 열거한다.  두 방법 모두 옵션이다; 무제한 쿼리는 전체 라이브러리에 매치 한다.
쿼리는 많아야 하나의 그루핑 타입을 가진다.  쿼리의 필터는 몇개의 미디어 프로퍼티 프리디케이트들로 구성될 수 있다.  당신은 MPMediaItem 클래스 레퍼런스에서 설명하는 프로퍼티 키들을 사용하여 MPMediaPropertyPredicate 클래스 레퍼런스에서 설명하는 메서드들을 사용하여 필터들을 만든다.

쿼리를 생성 및 구성한 후에, 당신은 이것을 미디어 아이템 또는 미디어 아이템 컬렉션들을 컴색하는데 사용한다.  컬렉션들은 MPMediaCollection 클래스 레퍼런스에 설명되어 있다.

이 클래스는 각 그루핑 타입에 사용하며, 대부분의 경우에 iPod 라이브러리의 서브셋에 해당하는 다수의 편리한 생성자들을 포함한다.  [표 1] 은 이 생성자들의 기능을 요약한다. 필터 열에 들어가는 자세한 설명은 MPMediaItem 클래스 레퍼런스를 보도록 하자.  그루핑 타입 열에 들어가는 설명은 "Media Item Collection Grouping Keys"를 보도록 하자.

[표 1] MPMediaQuery 클래스의 편리한 생성자들


태스크
미디어 쿼리 생성
여기에서 볼 수 있는 클래스 매서드들은 "미디어 쿼리 구성"에서 설명되는 바와 같이 직접 사용하거나 수정할 수 있는 쿼리를 생성한다.  각 클래스 메서드는, 쿼리의 groupingType 속성을 자동으로 메서드의 이름으로 설정한다.  예를 들어, albumsQuery 메서드는 MPMediaGroupingAlbum의 그루핑 타입을 할당한다.  그루핑 타입은 쿼리로부터 얻을 수 있는 미디어 아이템 컬렉션의 성질을 열거한다.  각 메서드의 토론 섹션에서 설명된 바와 같이 몇몇의 클래스 메서드들은 모든 iPod 라이브러리와 같으며, 다른 것들은 서브셋과 같다.

+ albumsQuery
+ artistsQuery
+ songsQuery
+ playlistsQuery
+ podcastsQuery
+ audiobooksQuery
+ compilationsQuery
+ composersQuery
+ genresQuery
- init
- initWithFilterPredicates:

미디어 쿼리 구성
  filterPredicates property
  groupingType property
- addFilterPredicate:
- removeFilterPredicate:


미디어 쿼리 수행
당신은 아이팟 라이브러리로부터 미디어 아이템들이나 미디어 아이템 컬렉션들을 items나 collections 접근 메서드들을 호출함으로써 특정 배열을 얻는다.
items property
collections property


속성
Objective-C 속성에 대한 자세한 내용은 The Objective-C Programming Language 의 "Properties"를 보도록 하자.

collections
미디어 아이템 컬렉션들의 배열은 쿼리의 미디어 프로퍼티 프리디케이트와 매치하는 아이템들을 담고 있다.
@property (nonatomic, readonly) NSArray *collections;

토론
리턴되는 컬렉션의 배열은 미디어 쿼리의 groupingType에 의해 그룹화되고 정렬된다.  다음의 코드 스니펫은 이 속성을 어떻게 사용하는지를 나타낸다:

//미디어 쿼리 열거; 이것은 iPod 라이브러리와 매치한다. 
//왜냐하면 이것은 미디어 프로퍼티 프리디케이트를 포함하고 있지 않기 때문이다.
MPMediaQuery *everything = [[MPMediaQuery alloc] init];

//미디어 아이템을 이용해서 그룹짓는 미디어 쿼리를 구성;
//여기에서는 아티스트로 그룹화 한다.
[everything setGroupingType:MPMediaGroupingArtist];

//쿼리로 부터 미디어 아이템 컬렉션들을 얻는다
NSArray *collections = [everything collections];

각 collections 배열의 요소는 이제 미디어 아이템 컬렉션을 포함하고 있다. 각 컬렉션은 개별 아티스트로 나눠진 아이팟 라이브러리의 미디어 아이템들을 포함한다.  이 배열의요소들은 아티스트 이름으로 정렬되어 있다.

그룹핑 타입으로 가능한 것들은 "Media Item Collection Grouping Keys"를 참조하도록 하자.
이것은 iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h 에 선언되어 있다.


filterPredicates
미디어 쿼리의 미디어 프로퍼티 프리디케이트.
@property (nonatomic, retain) NSSet *filterPredicates;

토론
MPMediaItem Class일반적인 미디어 아이템 속성 키들팟캐스트 아이템 프로퍼티 키들의 목록에 프리디케이트를 구성하는데 사용할 수 있는 키들이 포함되어 있다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


groupingType
미디어 쿼리에서 얻어지는 콜렉션들을 위한 그룹핑
@property (nonatomic) MPMediaGrouping groupingType;

토론
기본 그룹핑 타입은 MPMediaGroupingTitle 이다. 사용가능한 그룹핑 타입의 목록은 "Media Item Collection Grouping Keys"를 보도록 하자.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


items
미디어 쿼리의 프리디케이트에 대입되는 미디어 아이템들의 배열
@property (nonatomic, readonly) NSArray *items;

토론
프리디케이트에 매치되는 아이템이 없다면, 이 메서드는 빈 배열을 리턴한다. 에러가 날 때는 nil을 리턴한다.

iPhone OS 3.0 이상에서 사용가능하며  MPMediaQuery.h에 선언되어 있다.



클래스 메서드
albumsQuery
뮤직 아이템들과 매치하고, 컬렉션을 앨범이름으로 그룹 및 정렬하는 미디어 쿼리를 생성.
+ (MPMediaQuery *)albumQuery

리턴값
MPMediaTypeMusic 타입의 미디어 아이템들과 매치하며 MPMediaGroupingAlbum의 그룹핑 타입을 가지는 미디어 쿼리.

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 들어, 하나의 아이템은 "music"과 "podcast"형태가 될 수 있다. 하나의 albumsQuery 쿼리는 그들이 또한 다른 미디어 타입이든 아니든 간에, 모든 MPMediaTypeMusic 아이템들과 매치한다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.

artistsQuery
아티스트 이름으로 그룹화 되고 정렬된 뮤직 아이템들을 얻는 미디어 쿼리를 생성한다.
+ (MPMediaQuery *)artiestsQuery

리턴값
MPMediaGroupingArtiest 의 그룹핑 타입을 가지는 MPMediaTypeMusic 타입의 미디어 아이템을 얻는 미디어 쿼리.

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 들어, 하나의 아이템은 "music"과 "podcast"형태가 될 수 있다. 하나의 artistsQuery 쿼리는 그들이 또한 다른 미디어 타입이든 아니든 간에, 모든 MPMediaTypeMusic 아이템들과 매치한다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


audiobooksQuery
오디오 북 이름에 의해 오디오 북 아이템들을 얻고, 콜렉션들을 그룹 및 정렬하는 미디어 쿼리를 생성.
+ (MPMediaQuery *)audiobooksQuery

리턴값
MPMediaTypeAudioBook 형태의 미디어 아이템을 얻는 미디어 쿼리. 그리고 이것은 MPMediaGroupingTitle을 기본 그룹 형태로 사용한다.

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 들어, 하나의 아이템은 "music"과 "podcast"형태가 될 수 있다. 하나의 audiobooksQuery 쿼리는 이것이 또 다른 미디어 타입이든 아니든 간에 모든 MPMediaTypeAudioBook 아이템들과 매치한다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


compilationsQuery
앨범 이름으로 그룹 및 정렬한 컬렉션들과 컴필레이션 아이템들을 얻는 미디어 쿼리를 생성
+ (MPMediaQuery *)compilationsQuery

리턴값
MPMediaItemPropertyIsCompilation 속성을 가지는 미디어 아이템을 얻는 미디어 쿼리. 리턴되는 쿼리는 MPMediaGroupingAlbum의 그룹핑 형태를 가진다.

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 들어, 하나의 아이템이 "music"과 "podcast"타입이 될 수 있다. compilationsQuery 쿼리는 그들의 미디어 타입에 상관없이, MPMediaItemPropertyIscompilation 속성을 가지는 모든 미디어 아이템들을 검색한다.

iPhone OS 3.0 이상에서 사용가능하고 MPMediaQuery.h 에 선언되어 있다.


composersQuery
작곡가 이름에 의해 그룹 및 정렬되는 컬렉션들과 모든 미디어 아이템들을 검색하는 미디어 쿼리를 생성.
+ (MPMediaQuery *)composersQuery

리턴값
MPMediaGroupingComposer의 그룹핑 타입을 가지는 모든 미디어 아이템들을 검색하는 미디어 쿼리.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h 에 선언되어 있다.


genresQuery
장르명에 의해 그룹 및 정렬되는 컬렉션들의 모든 미디어 아이템들을 검색하는 미디어 쿼리를 생성
+ (MPMediaQuery *)genresQuery

리턴값
MPMediaGroupingGenre의 그룹핑 타입을 가지는 모든 미디어 아이템들을 검색하는 미디어 쿼리.

iPhone OS 3.0 이상에서 사용가능하며  MPMediaQuery.h에 선언되어 있다.


playlistsQuery
재생목록 이름에 의해 컬렉션을 그룹및 정렬하는 모든 iPod 라이브러리를 검색하는 미디어 쿼리를 생성
+ (MPMediaQuery *)playlistsQuery

리턴값
MPMediaGroupingPlaylist의 그룹핑 타입을 가지는 모든 미디어 아이템들을 검색하는 미디어 쿼리.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


podcastsQuery
팟캐스트 이름으로 컬렉션을 그룹 및 정렬하는 팟캐스트 아이템들을 정렬하는 미디어 쿼리를 생성
+ (MPMediaQuery *)podcastsQuery

리턴값
MPMediaGroupingPodcastTitle의 그룹핑 타입을 가지는 MPMediaTypePodCast 타입의 미디어 아이템을 검색하는 미디어 쿼리.

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 들어, 하나의아이템은 "music"과 "podcast"형태가 될 수 있다. 하나의 podcastsQuery 쿼리는 이것이 다른 미디어 타입이던 아니던 간에 모든 MPMediaTypePodcast를 검색한다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


songsQuery
노래 제목에 의해 컬렉션들을 그룹 및 정력하는 뮤직 아이템들을 검색하는 미디어 쿼리를 생성
+ (MPMediaQuery *)songsQuery

리턴값
MPMediaGroupingTitle 의 그룹핑 타입을 가지는  MPMediaTypeMusic 형태의 미디어 아이템을 검색하는 미디어 쿼리

토론
하나의 미디어 아이템은 하나이상의 미디어 타입을 가질 수 있다. 예를 달어 하나의 아이템은 "music"과 "podcast" 형태가 될 수 있다.  songsQuery쿼리는 검색하고자 하는것들이 다른 미디어 타입이든 아니든 상관없이 모든 MPMediaTypeMusic 아이템들을 검색한다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h 에 선언되어 있다.


인스턴스 메서드
addFilterPredicate:
쿼리에 미디어 프로퍼티 프리디케이트 추가
-(void)addFilterPredicate:(MPMediaPredicate *)predicate
인자
predicate
    쿼리의 프리디케이트 셋에 추가할 미디어 프리디케이트

iPhone OS 3.0 이상에서 사용가능하고 MPMediaQuery.h 에 선언되어 있다. 


init
일반적인 미디어 쿼리 초기화
-(id)init
토론
일반적인 미디어 쿼리는 필터 프리디케이트들과 그룹핑 구성이 없다.  이것은 iPod 라이브러리의 모든것을 검색하며 그룹핑이나 정렬은 제공하지 않는다.

iPhone OS 3.0 이상에서 사용가능하며  MPMediaQuery.h 에 선언되어 있다.


initWithFilterPredicates:
미디어 프로퍼티 프리디케이트들의 셋으로 미디어 쿼리 초기화
- (id)initWithFilterPredicates:(NSSet *)filterPredicates

인자
filterPredicates
    iPod 라이브러리에서 필터로 사용할 미디어 프로퍼티 프리디케이트들의 셋

리턴값
초기화된 미디어 쿼리

토론
MPMediaPropertyPredicate 클래스 레퍼런스는 미디어 프로퍼티 프리디케이트들을 생성하는 방법을 설명한다.  MPMediaItem 클래스 레퍼런스의 일반적인 미디어 아이템 프로퍼티 키들과 팟캐스트 아이템 프로퍼티 키들의 목록은 프리디케이트들을 구성하는데 사용할 수 있는 키들을 포함하고 있다.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.


removeFilterPredicate:
쿼리에서 필터 프리디케이트를 삭제한다.
- (void)removeFilterPredicate:(MPMediaPredicate *)predicate
인자
predicate
    쿼리의 프리디케이트 셋에서 지울 미디어 프리디케이트.

iPhone OS 3.0 이상에서 사용가능하며 MPMediaQuery.h에 선언되어 있다.

상수
키들을 그룹핑하는 미디어 아이템 컬렉션
하나의 미디어 쿼리를 구성하는 groupingType 속성으로 사용되는 키들.
다음의 상수들은 모두 iPhone OS 3.0 이상에서 사용가능하며, MPMediaQuery.h에 선언되어 있다.
enum {
    MPMediaGroupingTitle,
    MPMediaGroupingAlbum,
    MPMediaGroupingArtist,
    MPMediaGroupingAlbumArtist,
    MPMediaGroupingComposer,
    MPMediaGroupingGenre,
    MPMediaGroupingPlaylist,
    MPMediaGroupingPodcastTitle,
    MPMediaGroupingSeriesName
};
typedef NSInteger MPMediaGrouping;

상수
MPMediaGroupingTitle
    제목으로 미디어 아이템 컬렉션들을 그룹 및 정렬한다. 
    노래를 예를 들면  title 은 노래 제목이다. 
    이것은 키를 그룹화하는 기본값이다.
MPMediaGroupingAlbum
    앨범으로 미디어 아이템 컬렉션들을 그룹 및 정렬하고,
    앨범 안에서는 트랙 순서로 노래들을 정렬한다.
MPMediaGroupingArtist
    연주자(가수이름)로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.
MPMediaGroupingAlbumArtiest
    앨범 전체에서 앨범의 대표 연주자로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.
MPMediaGroupingComposer
    작곡가로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.
MPMediaGroupingGenre
    음악이나 영화 장르를 통해서 미디어 아이템 컬렉션들을 그룹 및 정렬 한다.
MPMediaGroupingPlaylist
    재생목록으로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.
MPMediaGroupingPodcastTitle
    팟캐스트 제목으로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.
MPMediaGroupingSeriesName
    시리즈로 미디어 아이템 컬렉션들을 그룹 및 정렬한다.

토론
다음의 코드 스니펫은 키를 그룹핑하는 방법에 대해 보여준다:
MPMediaQuery *everything = [[MPMediaQuery alloc] init];
[everything setGroupingType:MPMediaGroupingAlbum];
NSArray *collections = [everything collections];

이 코드 라인들을 실행한 후에, collections 배열은 앨범 이름에 따라 그룹 및 정렬된 미디어 아이템들을 포함하고 있다.
정렬된 노래 목록을 얻으려면, MPMediaGroupingTitle 키로 미디어 쿼리를 구성하거나 미디어 쿼리를 위해 기본으로 되어 있는 타이틀 키의 이점을 활용한다.  이 두 가지 모두, 자신의 컬렉션을 효과적으로 얻는다.
컬렉션들은 데스크탑의 iTunes 에서 사용하는 것과 같은 방법으로 정렬한다.  이것은 사용자가 선택한 기본 시스템 언어를 포함한다.  기사를 읽을 때, 영어를 사용할 때는  "A," "An," 그리고 "The"가, 프랑스어를 사용할 때는 "L'," "La," "Le"가 정렬되는 동안은 무시된다.  만약에 정확한 정렬이 필요하다면 이것을 당신의 어플리케이션에 구현하라.


원문

MPMediaItem Class Reference

MPMediaItem Class Reference
상속 : NSObject
프로토콜 : NSCoding, NSObject(NSObject)
프레임워크 : /System/Library/Frameworks/MediaPlayer.framework
이용가능 버전 : iPhone OS 3.0 이상
관련 가이드 : iPod Library Access Programming Guide
선언 : MPMediaItem.h
관련 샘플 코드 : AddMusic

개요
MPMediaItem 오브젝트, 또는 미디어 아이템은 iPod 라이브러리에서 미디어의 한조각을 표현한다.  하나의 미디어 아이템은 하나의 유일한 식별자를 가지는데, 이것은 MPMediaItemPropertyPersistentID 속성 키를 사용하여 접근된다.  이 식별자는 어플리케이션 런치들을 유지한다.

하나의 미디어 아이템은 이것과 관련된 넓은 범위의 메타 데이터를 가질 수 있다.  당신은 이 문서에서 설명되는 속성 키들과 같이 valueForProperty: 메서드를 사용하여 이 메타데이터에 접근한다.

당신은 iPod 라이브러리를 검색하기 위한 미디어 쿼리들을 만드는데에 미디어 아이템의 속성들을 사용한다. 이 속성들은 "Media Item Type Flages," "General Media Item Property Keys" 그리고 "Podcast Item Property Keys."에 설명되어 있고, 미디어 쿼리들은 MPMediaQuery 클래스 레퍼런스에 설명되어 있다.

태스크
미디어 아이템 속성들 사용하기
+ canFilterByProperty:
- valueForProperty:

클래스 메서드
canFilterByProperty:
미디어 아이템 속성 키가 미디어 속성을 결정짓도록 구성하는데 사용될수 있는지를 나타냄

+ (BOOL)canFilterByProperty:(NSString *)property

인자
property
    검사하길 원하는 속성을 위한 키

리턴 값
속성키로 YES를 리턴하는 것은 MPMediaPropertyPredicate 오브젝트들을 구성하는데 사용될 수 있다는 것이다.

[iPhone OS 3.0 이상에서 사용가능하며, MPMediaItem.h 에 정의되어 있음.]


인스턴스 메서드
valueForProperty:
특정 미디어 아이템 프로퍼티 키의 값

- (id)valueForProperty:(NSString *)property

인자
property
    값을 얻기를 원하는 속성

리턴 값
미디어 아이템 프로퍼티 키를 위한 값을 리턴

토론
이 프로퍼티와 같이 사용할 수 있는 메타데이터 키들의 목록은 "일반적인 미디어 아이템 프로퍼티 키, " "팟캐스트 아이템 프로퍼티 키, " 그리고 "사용자 정의 프로퍼티 키." 에 있다.

[iPhone OS 3.0 이상에서 사용가능하며, MPMediaItem.h 에 정의되어 있음. 관련 샘플 코드는 AddMusic]


상수

미디어 아이템 타입 플래그들
MPMediaItemPropertyMediaType 속성을 위한 값으로 사용할 수 있는 미디어 아이템 타입들.  하나의 미디어 아이템은 하나 이상의 미디어 아이템 타입을 가질 수 있다.
enum {
    // audio media types
    MPMediaTypeMusic       = 1 << 0,
    MPMediaTypePodcast     = 1 << 1,
    MPMediaTypeAudioBook   = 1 << 2,
    MPMediaTypeAnyAudia    = 0x00ff,

    // generic media type
    MPMediaTypeAny         = ~0
};
typedef NSInteger MPMediaType;

상수
MPMediaTypeMusic
음악을 포함하는 미디어 아이템으로 설정된 경우.
iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의 되어 있다.

MPMediaTypePodcase
하나의 podcast를 포함하는 미디어 아이템을 설정한 경우.
iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaTypeAudioBook
오디오북을 포함하는 미디어 아이템을 설정한 경우.
iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaTypeAnyAudio
불특정 형태의 오디오 컨텐츠를 포함하는 미디어 아이템을 설정한 경우.
iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaTypeAny
불특정 형태의 오디오를 포함하는 미디어 아이템을 설정한 경우.
iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.


일반적인 미디어 아이템 프로퍼티 키들
당신은 이 프로퍼티 키들을 사용해서 valueForProperty 메소드를 호출하여 미디어 아이템을 위한 메타데이터를 얻는다.  몇몇의 프로퍼티들은 MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이, 미디어 프로퍼티 프리디케이트들을 만드는데에도 사용 될 수 있다.  표시된 속성들은 필터 가능하다.

NSString *const MPMediaItemPropertyPersistentID;      //filterable(필터 가능)
NSString *const MPMediaItemPropertyMediaType;         //filterable
NSString *const MPMediaItemPropertyTitle;             //filterable
NSString *const MPMediaItemPropertyAlbumTitle;        //filterable
NSString *const MPMediaItemPropertyArtist;            //filterable
NSString *const MPMediaItemPropertyAlbumArtist;       //filterable
NSString *const MPMediaItemPropertyGenre;             //filterable
NSString *const MPMediaItemPropertyComposer;          //filterable
NSString *const MPMediaItemPropertyPlaybackDuration;
NSString *const MPMediaItemPropertyAlbumTrackNumber;
NSString *const MPMediaItemPropertyAlbumTrackCount;
NSString *const MPMediaItemPropertyDiscNumber;
NSString *const MPMediaItemPropertyDiscCount;
NSString *const MPMediaItemPropertyArtwork;
NSString *const MPMediaItemPropertyLyrics;
NSString *const MPMediaItemPropertyIsCompilation;    //filterable

상수
MPMediaItemPropertyPersistentID
미디어 아이템을 위한 지속성 있는 식별자.  uint64_t(unsigned long long)을 담고 있는 NSNumber 값이다.  MPMediaItemPropertyPersistentID 식별자의 값은 어플리케이션의 실행과 미디어 아이템의 변하지 않는 싱크 상태를 유지한다.  이 값은 sync/unsync/sync 사이클을 유지할때 이점이 없다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyMediaType
미디어 아이템의 미디어 타입. NSInteger 데이터형을 나타내는 NSNumber 오브젝트 값이다.  NSInteger 값은 "미디어 아이템 타입 플래그들" 에서 비트 필드 플래그나 플래그 셋을 나타낸다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyTitle
미디어 아이템의 제목(또는 이름). 이 속성은 MPMediaItemPropertyAlbumTitle 속성과 관계 없다.  NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.


MPMediaItemPropertyAlbumTitle
"Live On Mars"와 같은 앨범의 제목.
앨범에서 각각의 곡의 제목에 나란히 들어갈, (MPMediaItemPropertyTitle 속성을 사용하여 열거하는) "Crater Dance (radio edit)"와 같은 것.  NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyArtist
미디어 아이템의 아티스트. NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyAlbumArtist
앨범 전체에 걸친 아티스트. NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyGenre
미디어 아이템의 장르. NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyComposer
미디어 아이템 작곡가. NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyPlaybackDuration
미디어 아이템의 재생시간. NSTimeInterval의 초로 표현되는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyAlbumTrackNumber
미디어 아이템이 앨범에서 몇번째에 해당하는지를 나타내는 트랙넘버.  NSUInteger 데이터 형을 나타내는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyAlbumTrackCount
앨범이 포함하고 있는 미디어 아이템의 수. NSUInteger 데이터형을 나타내는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyDiscNumber
여러개의 디스크를 가지는 앨범에서 이 미디어 아이템의 디스크 넘버. NSUInteger 데이터 형을 나타내는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyDiscCount
이 미디어 아이템을 가지고 있는 앨범의 디스크 수. NSUInteger 데이터 형을 나타내는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyArtwork
미디어 아이템의 아트웍 이미지.  미디어 아이템 이미지 값은, MPMediaItemArtwork 클래스 레퍼런스 에 설명되어 있다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyLyrics
미디어 아이템의 가사. NSString 오브젝트 값이다.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyIsCompilation
이 미디어 아이템이 편집의 일부인지(YES) 아닌지(NO)를 나타내는 Boolean 값.  BOOL 데이터 타입을 나타내는 NSNumber 오브젝트 값.
iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.


팟캐스트 아이템 프로퍼티 키들
당신은 이 속성 키들을 사용해서  valueForProperty: 메서드를 호출하여 팟캐스트 미디어 아이템을 위한 메타데이터를 얻는다.  필터 가능한 속성들은 미디어 프로퍼티 프리디케이트들을 만드는데 사용될 수 있다.
NSString *const MPMediaItemPropertyPodcastTitle;   //filterable

상수
MPMediaItemPropertyPodcastTitle
팟캐스트의 개별 에피소드의 제목과 함께 나올 팟캐스트의 제목.
NSString 오브젝트 값이다.
MPMediaPropertyPredicate 클래스 레퍼런스에서 설명되는 바와 같이 미디어 프로퍼티 프리디케이트를 만드는데 사용될 수 있다. iPhone OS 3.0이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

사용자 정의 프로퍼티 키들
당신은 이 프로퍼티 키들을 사용해서 valueForProperty: 메서드를 호출하여 미디어 아이템을 위한 사용자 정의 메타데이터를 얻는다.  사용자 정의 속성들은 미디어 프로퍼티 프리디케이트들을 만드는데 사용될 수 없다.

NSString *const MPMediaItemPropertyPlayCount;
NSString *const MPMediaItemPropertySkipCount;
NSString *const MPMediaItemPropertyRating;
NSString *const MPMediaItemPropertyLastPlayedDate;

상수
MPMediaItemPropertyPlayCount
사용자가 미디어 아이템을 재생한 횟수. NSUInteger 데이터형을 나타내는 NSNumber 오브젝트 값.  iPhone OS 3.0 이상에서 사용가능하고, MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertySkipCount
사용자가 아이템 재생을 스킵한 횟수. NSUInteger 데이터형을 나타내는 NSNumber 오브젝트 값. iPhone OS 3.0 이상에서 사용가능하고, MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyRating
사용자가 미디어 아이템에 준 등급. 0~5의 범위를 가지며 NSUInteger 데이터형을 나타내는 NSNumber 오브젝트 값이다.  iPhone OS 3.0 이상에서 사용가능하며 MPMediaItem.h에 정의되어 있다.

MPMediaItemPropertyLastPlayedDate
미디어 아이템을 플레이 했던 가장 최근 날짜. NSDate 오브젝트 값이다.
iPhone OS 3.0 이상에서 사용가능하고 MPMediaItem.h에 정의되어 있다.

원문

2010년 5월 4일 화요일

Determining OpenGL ES Capabilities

OpenGL ES 능력 결정하기

iPhone OS의 OpenGL ES 는 고정 함수 그래픽스 파이프라인을 수행하는 OpenGL ES 1.1 과 쉐이더 파이프라인을 수행하는 OpenGL ES 2.0 을 모두 지원한다. OpenGL ES 2.0 은 OpenGL ES 1.1 의 슈퍼셋이 아니다; OpenGL ES 의 고정함수 능력들은 그래픽스 하드웨어의 최신 인터페이스의 지원에서 제거 되었다.

OpenGL ES 1.1과 OpenGL ES 2.0 모두 반드시 지원해야 하는 모든 임플리먼테이션에 해당하는 최소한의 능력을 정의한다. 하지만, OpenGL ES 명세서는 능력들에 관해서는 하드웨어 임플리먼테이션에 제한을 하지 않는다. OpenGL ES 임플리먼테이션은 최소한의 능력(예를들어, 텍스쳐의 최대 사이즈 증가라던가..)이나 OpenGL ES 확장 메커니즘으로 인한 OpenGL ES의 확장된 능력들도 확장할 수 있다. 애플은 다른 iPhone 모델들 상에서 다양한 능력들을 제공하는데에 두 메커니즘들을 사용한다. 다음 장인, "Platform Notes," 에서 이 능력들에 대해 자세히 알아보도록 한다. 하지만, 애플에서 OpenGL ES 의 다른 버전을 제공하여 같은 버전에서도 다른 능력들을 보이기 때문에, 당신의 어플리케이션은 반드시 이 능력에 맞는 동작을 하도록 디바이스의 능력을 테스트 하고 조절해야 한다. 만약에 당신의 어플리케이션이 런타임에 OpenGL ES 의 능력 테스트에 실패한다면, 실행할때 충돌 또는 실패할 것이며, 사용자에게 좋지 못한 경험을 제공하는 것이 된다.


어떤 버전을 타겟으로 삼아야 할까?
OpenGL ES 어플리케이션을 설계할 때, 당신이 반드시 대답해야 할 첫번째 질문은 당신의 어플리케이션이 OpenGL ES 1.1 과 2.0을 모두 지원해야 하는가 이다.

OpenGL ES 1.1 의 고정함수 파이프라인은 3D 그래픽스 파이프라인을 위한 동작에 버텍스 변형 및 라이팅 부터 프레임 버퍼와 함께 마지막 픽셀들을 블렌딩 하는 것 까지 좋은 기준치를 제공한다. 만약 당신이 OpenGL Es 2.0 애플리케이션을 구현하는 것을 선택한다면, 이런 기능을 중복할 필요가 있다. OpenGL ES 2.0은 OpenGL ES 1.1 보다 좀더 융통성 있다. OpenGL ES 2.0 쉐이더에서 쉽게 구현할 수 있는 커스텀 버텍스와 프래그먼트 연산들도 OpenGL ES 1.1 을 사용하려면 어렵거나 불가능하다. OpenGL ES 1.1 어플리케이션에서의 커스텀 연산의 구현은 종종 다중 렌더링 과정이나 OpenGL ES 상태에 복잡한 변경을 요구하는데, 이것은 코드에 의존적이며, 이해하기 어렵다.  당신의 알고리즘이 복잡해질수록, 쉐이더는 이 연산들을 보다 명료하고 간결하게 그리고 보다 나은 퍼포먼스로 전달한다.

OpenGL ES 렌더링 컨텍스트 생성
iPhone OS 에서 당신의 애플리케이션은 EAGLContext 오브젝트로 알려져 있는 OpenGL ES 렌더링 컨텍스트를 초기화 할 때, 어떤 버전의 OpenGL ES 를 사용할 것인지 결정한다.  당신의 어플리케이션은 각 컨텍스트가 사용하는 OpenGL ES의 버전을 결정한다.  예를 들어, OpenGL ES 1.1 을 사용하는 컨텍스트를 생성하려면, 당신의 애플리케이션은 다음과 같이 초기화 한다.
 EAGLContext* myContext = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1];

만약 OpenGL ES 2.0을 사용하길 원한다면, 다음과 같이 초기화 한다.
EAGLContext* myContext = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES2];

만약 각 OpenGL ES 의 구현이 가능하지 않다면, initWithAPI:는 nil을 리턴한다.  당신의 어플리케이션은 반드시 사용하기 전에 컨텍스트가 성공적으로 초기화 되었는지 테스트 해 보아야 한다.

OpenGL ES 2.0과 OpenGL ES 1.1 이 같은 어플리케이션에서 모두 지원되도록 하려면, 코드 2-1에 보여지는 바와 같이 당신의 어플리케이션에서는 첫번째로 OpenGL ES 2.0 렌더링 컨텍스트를 생성하는것을 시도해야 한다. 만약 이것이 실패한다면, 대신에 OpenGL ES 1.1 컨텍스트를 생성하는것을 시도한다.

[코드 2-1] 같은 어플리케이션에서 OpenGL ES 1.1 과 OpenGL 2.0 지원하기
EAGLContext* CreateBestEAGLContext(){
    EAGLContext *context = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES2];
    if(context == nil)
    {
         context = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1];
    }
    return context;
}

당신의 어플리케이션이 컨텍스트를 초기화했을 때, 이것은 OpenGL ES 의 어떤 버전을 지원할지 결정하는 컨텍스트의 API 속성을 읽을 수 있다.  예를 들어, 당신의 어플리케이션이 고정함수 렌더러와 쉐이더 렌더러를 클래스에서 구현하여, 일반적인 기본 클래스와 공유한다고 하면, 당신의 어플리케이션은 런타임에 적절한 렌더러를 사용할 것이다.

중요 : OpenGL ES 2.0 은 OpenGL ES 1.1 에 있는 많은 함수들을 제거 하였고 OpenGL ES 1.1 에서 사용할 수 없는 함수들을 추가하였다.  만약 당신의 어플리케이션이 OpenGL ES 1.1 컨텍스트에서 OpenGL ES 2.0 함수의 호출을 시도한다면(또는 반대로), 결과는 undefined 가 될 것이다.  두개의 렌더링 패스간에 약간의 코드 콩유가 가능한 동안은, 당신은 OpenGL ES 의 두 버전을 식별하는 작업을 호출하는데 공유를 제한해야 한다.


OpenGL ES 의 각 버전으로 당신의 어플리케이션을 제한하기





원문

PBXProjectWizard 에러처리

링크 참조

딱히 뭣땀시 나는 에러인지는 잘 모르겠습니다만..
저의 경우엔 Window-based Application 템플릿으로 프로젝트 생성할때 갑자기 에러가 나더군요.. SDK를 이거깔았다 저거 깔았다 했더니만..;;

뭐.. 암튼..


일본어로 된 사이트 입니다.
구글자동 번역 이용하시믄 대충이해할 정도는 번역 해 주네요.

인제 별게 다 에러를 내는구만!!  >ㅅ<;

Developer 안에 있는 어플리케이션들은 Xcode 설치하면 자동으로 설치 되는군요..
이것도 모르고 어디서 찾아야 하는지 해메다니..ㅡ..ㅡ;;

2010년 5월 3일 월요일

Working with OpenGL ES Contexts and Framebuffers

원문

EAGL Context 생성
당신의 애플리케이션에서 OpenGL ES 명령을 실행하기 전에, 첫번째로 EAGL 컨텍스트를 반드시 생성 및 초기화 하고 현재 컨텍스트로 만들어야 한다.

EAGLContext* myContext = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1];
[EAGLContext setCurrentContext:myContext];

당신의 애플리케이션이 컨텍스트를 초기화 했을 때, 이것은 이 컨텍스트를 위해 어떤 버전의 OpenGL ES 를 사용할 것인지를 선택한다.  사용할 OpenGL ES 버전을 선택하는 것에 대한 더 자세한 정보는 "어떤 버전을 타겟으로 해야 하는가?" 를 보도록 하자.

당신의 애플리케이션의 각각의 스레드는 현재 렌더링 하고 있는 컨텍스트를 가리키는 포인터를 유지하고 있다.  당신의 어플리케이션이 현재 컨텍스트를 만들면, EAGL은 이전의 컨텍스트를 릴리즈 하고, 컨텍스트 오브젝트를 유지하고 앞으로 수행할 OpenGL ES 렌더링 명령을 위한 타겟으로 설정한다. 주의할 것은 많은 경우에, 다중 렌더링 컨텍스트들을 생성하는 것은 불필요할 것이라는 것이다. 당신은 종종 단일 렌더링 컨텍스트와 당신이 렌더링 할 각각의 이미지를 위한 하나의 프레임버퍼 오브젝트를 사용하는 같은 결과를 얻을 수 있다.

Framebuffer 오브젝트 생성
EAGL 컨텍스트가 명령들을 받기는 하지만, 이것이 그 명령들의 최종 타겟은 아니다.  당신의 어플리케이션은 픽셀들에 렌더링 할 목적지를 제공한다.iPhone OS 에서는, 모든 이미지들이 프레임 버퍼 오브젝트들로 렌더링 된다.  프레임 버퍼 오브젝트들은 모든 OpenGL ES 2.0 임플리먼테이션들에 의해 제공된다.  그리고, 애플은 또한 OpenGL ES 1.1 에서도 GL_OES_framebuffer_object 확장을 통해 모든 임플리먼테이션들을 제공한다.  프레임 버퍼 오브젝트들은 어플리케이션에서 색상, 깊이, 스텐실 타겟들의 생성을 정밀하게 제어할 수 있도록 한다.  게다가, 색상 타겟은 또한 텍스쳐의 포인터로도 사용될 수 있다.

프레임 버퍼를 생성하는 절차는 다음과 같다:
1. 프레임 버퍼 오브젝트 생성
2. 하나이상의 타겟 생성(렌더버퍼 또는 텍스쳐)하고, 메모리 할당, 그리고 프레임버퍼 오브젝트로 바인딩
3. 제대로 되었는지 프레임 버퍼 테스트
다음장에서는 이 개념을 더 자세히 확장하도록 한다.

오프스크린 프레임버퍼 오브젝트
오프스크린 프레임 버퍼는 렌더링된 이미지를 담아두는데 OpenGL ES 렌더버퍼를 사용한다.  다음의 코드는 OpenGL ES 1.1 에서 완전한 오프스크린 프레임 버퍼 오브젝트를 할당하는 것이다. OpenGL ES 2.2 어플리케이션은 OES 접미사를 제거하도록 한다.

1. 프레임버퍼 생성 및 바인드해서 미래의 OpenGL ES 프레임버퍼 명령들이 이것을 가리킬 수 있도록 한다.
GLuint framebuffer;
glGenFramebuffersOES(1, &framebuffer);  //생성
glBindFramebufferOES(GL_FRAMEBUFFER_OES, framebuffer);  //바인딩

2.색상 렌더버퍼를 생성, 메모리 할당, 그리고 프레임 버퍼에 attach

GLuint colorRenderbuffer;
glGenRenderbuffersOES(1, &colorRenderbuffer); //생성
glBindRenderbufferOES(GL_RENDERBUFFER_OES, colorRenderbuffer);  //바인딩
glRenderbufferStorageOES(GL_RENDERBUFFER_OES, GL_RGBA8_OES, width, height);  //메모리 할당
glFramebufferRenderbufferOES(GL_FRAMEBUFFER_OES, GL_COLOR_ATTACHMENT0_OES, GL_RENDERBUFFER_OES, colorRenderbuffer);  //프레임 버퍼에 attach

3. 깊이 렌더 버퍼 생성및 어테치하기 위해 비슷한 과정을 수행
GLuint depthRenderbuffer;
glGenRenderbuffersOES(1, &depthRenderbuffer);
glBindRenderbufferOES(GL_RENDERBUFFER_OES, depthRenderbuffer);
glRenderbufferStorageOES(GL_RENDERBUFFER_OES, GL_DEPTH_COMPONENT16_OES, width, height);
glFramebufferRenderbufferOES(GL_FRAMEBUFFER_OES, GL_DEPTH_ATTACHMENT_OES, GL_RENDERBUFFER_OES, depthRenderbuffer);

4. 제대로 됐는지 프레임 버퍼 확인.
GLenum status = glCheckFramebufferStatusOES(GL_FRAMEBUFFER_OES);
if(status != GL_FRAMEBUFFER_COMPLETE_OES){
    NSLog(@"failed to make complete framebuffer object %x", status);
}


텍스쳐 렌더링에 프레임버퍼 오브젝트 사용 
당신의 어플리케이션은 텍스쳐에 바로 렌더링 하고 다음에 드로잉하기 위한 소스로 사용하기를 원할것이다. 예를 들어, 당신은 이것을 당신의 씬에 합성하여 거울에 반사되는 것을 렌더링 하는데 사용할 수 있다.  이 프레임버퍼를 생성하는 코드는 color attachment point에 어테치 되는 현재의 텍스쳐를 제외하고, 오프스크린의 예와 거의 동일하다.

1. 프레임 버퍼 오브젝트 생성
GLuint framebuffer;
glGenFramebuffersOES(1, &framebuffer);
glBindFramebufferOES(GL_FRAMEBUFFER_OES, framebuffer);

2. 색상 데이터를 담을 텍스쳐 생성
//Create the texture
GLuint texture;
glGenTextures(1, &texture);
glBindTexture(GL_TEXTURE_2D, texture);
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, NULL);

3. 프레임버퍼에 텍스쳐 Attach
glFramebufferTextrue2DOES(GL_FRAMEBUFFER_OES, GL_COLOR_ATTACHMENT0_OES, GL_TEXTURE_2D, texture, 0);

4. 깊이 버퍼 할당및 Attach(부착?)
GLuint depthRenderbuffer;
glGenRenderbufferOES(1, &depthRenderbuffer);
glBindRenderbufferOES(GL_RENDERBUFFER_OES, depthRenderbuffer);
glRenderbufferStorageOES(GL_RENDERBUFFER_OES, GL_DEPTH_COMPONENT16_OES, width, height);
glFramebufferRenderbufferOES(GL_FRAMEBUFFER_OES, GL_DEPTH_ATTACHMENT_OES, GL_RENDERBUFFER_OES, depthRenderbuffer);

5. 프레임버퍼 테스트
GLenum status  = glCheckFramebufferStatusOES(GL_FRAMEBUFFER_OES);
if(status != GL_FRAMEBUFFER_COMPLETE_OES){
    NSLog(@"failed to make complete framebuffer object %x", status);
}


스크린에 드로잉하기
오프스크린 타겟들과 텍스쳐들 모두 흥미롭긴 하지만, 둘다 그들의 픽셀들을 스크린에 디스플레이 할 수는 없다. 그것을 하기 위해서 당신의 애플리케이션은 코어 애니메이션과 상호작용을 할 필요가 있다.
iPhone OS 에서는 모든 UIView 오브젝트들이 CoreAnimation 레이어들을 깔고 있다.  당신의애플리케이션이 OpenGL ES 컨텐츠를 스크린에 나타내기 위해서는,UIView 오브젝트를 타겟으로 할 필요가 있다.  나아가, 그 뷰는 반드시 특별한 CoreAnimation 레이어인 CAEAGLLayer오브젝트를 깔고(?)있어야 한다.(역주 : 즉, OpenGL ES 컨텐츠를 나타낼 타겟으로 하는 UIView의 레이어는 CAEAGLLayer이어야 한다는 뜻.)  그림 3-1에서 보여지는 바와 같이 CAEAGLLayer 오브젝트는 OpenGL ES를 잘 알고 있고, 렌더버퍼를 참조한다.
당신의 어플리케이션에서 이러한 결과들을 나타내려고 할 때, 렌더버퍼의 컨텐츠들은 다른 코어 애니메이션 레이어들과 애니메이션되고 합성되어 스크린으로 보내진다.

[그림 3-1] CoreAnimation은 OpenGL ES 와 렌더버퍼를 공유한다.


Xcode 에서는 당신이 이런 작업을 할 수 있도록 OpenGL ES 템플릿을 제공하지만, 이것은
이 OpenGL ES 템플릿은 Xcode 에서 당신이 이 작업을 할 수 있게 제공되지만, 이것은 스크린에 나타낼 수 있는 프레임 버퍼 오브젝트를 생성하는데 사용되는 과정들을 보여주는 예일 뿐이다.

1. UIView를 서브클래싱 하고 당신의 iPhone 어플리케이션을 위한 뷰를 설정한다.

2. 당신의 뷰 클래스의 오브젝트를 생성한 후, CALayer 오브젝트 대신에 CAEAGLLayer 오브젝트로 초기화 하기 위하여 UIView 클래스의 layerClass 메서드를 오버라이드 한다.
+(Class)layerClass
{
    return [CAEAGLLayer class];
}

3. UIView의 layer 메서드를 호출하여 뷰와 연관된 레이어를 얻는다.
myEAGLLayer = (CAEAGLLayer *)self.layer;

4. 레이어 속성들을 설정한다.
선택 작업을 위해서, CALayer 클래스에서 제공되는 opaque 속성을 설정함으로써 불투명한 레이어를 나타내는 것이 권장된다. "당신의 결과를 나타내기"를 보자.

5. CAEAGLLayer 오브젝트의 drawableProperties 속성값에 새 딕셔너리를 할당하는 것에 의해서 렌더링 서페이스의 서페이스 속성들을 선택적으로 구성한다.
EAGL은 당신이 렌더링된 픽셀들의 포멧을 렌더버퍼가 그의 컨텐츠들을 스크린에 표시한 후에도 유지하든 말든 간에 명세할 수 있게 한다.  당신은 이 속성들을 kEAGLDrawablePropertyColorFormat 과 kEAGLDrawablePropertyRetainedBacking 키들을 사용하는 딕셔너리에서 식별할 수 있다.  당신이 설정할 수 있는 키들의 리스트들은  EAGLDrawable Protocol Reference 를 보도록 하자.

6. 앞서, 프레임 버퍼를 생성한다.
GLuint framebuffer;
glGenFramebuffersOES(1, &framebuffer);
glBindFramebufferOES(GL_FRAMEBUFFER_OES, framebuffer);

7. 색상 렌더버퍼를 생성하고 렌더링 컨텍스트를 호출하여 우리의 CoreAnimation 레이어의 저장소에 할당하도록 하자. 렌더버퍼 저장소의 가로, 세로, 그리고 포멧은 renderbufferStorage:fromDrawable: 메소드가 호출된 순간에 CAEAGLLayer 오브젝트의 속성들과 바운드들로 부터 얻어진다.
GLuint colorRenderbuffer;
glGenRenderbuffersOES(1, &colorRenderbuffer);
glBindRenderbufferOES(GL_RENDERBUFFER_OES, colorRenderbuffer);
[myContext renderbufferStorage:GL_RENDERBUFFER_OES fromDrawable:myEAGLLayer];
glFramebufferRenderbufferOES(GL_FRAMEBUFFER_OES, GL_COLOR_ATTACHMENT0_OES, GL_RENDERBUFFER_OES, colorRenderbuffer);
만약에 코어 애니메이션 레이어의 속성들이 변하면, 당신의 애플리케이션은 반드시  renderbufferStorage:fromDrawable: 을 다시 호출하여 렌더버퍼를 다시 할당해 줘야 한다.
디스플레이를 위해 스케일 또는 이동시킨 이미지는 상당한 퍼포먼스 비용이 발생할 수 있으므로, 성공적으로 렌더링할수 없을 수도 있다.  예를 들어, 템플릿에서, 프레임버퍼와 렌더버퍼 오브젝트들은 CAEAGLLayer 오브젝트가 변하는 범위에서는 언제든지 파괴되고 재생성된다.

8. 색상 렌더버퍼의 가로와 세로를 얻는다.
GLint width;
GLint height;
glGetRenderbufferParameterivOES(GL_RENDERBUFFER_OES, GL_RENDERBUFFER_WIDTH_OES, &width);
glGetRenderbufferParameterivOES(GL_RENDERBUFFER_OES, GL_RENDERBUFFER_HEIGHT_OES, &height);

9. 깊이 버퍼 할당및 어태치(Attach)
GLint depthRenderbuffer;
glGenRenderbuffersOES(1, &depthRenderbuffer);
glBindRenderbufferOES(GL_RENDERBUFFER_OES, depthRenderbuffer);
glRenderbufferStorageOES(GL_RENDERBUFFER_OES, GL_DEPTH_COMPONENT16_OES, width, height);
glFramebufferRenderbufferOES(GL_FRAMEBUFFER_OES, GL_DEPTH_ATTACHMENT_OES, GL_RENDERBUFFER_OES, depthRenderbuffer);

10. 프레임 버퍼 오브젝트 테스트
GLenum status = glCheckFramebufferStatusOES(GL_FRAMEBUFFER_OES);
if(status != GL_FRAMEBUFFER_COMPLETE_OES)
{
    NSLog(@"failed to make complete framebuffer object %x", status);
}

프레임버퍼 오브젝트를 생성하는 과정을 반복하는 것은 세가지 경우가 모두 비슷하며, 프레이버퍼 오브젝트의 color attachment point 로 어태치 된 오브젝트의 할당을 어떻게 할 것인지에 대한 것만 다르다.

[표 3-1] 프레임버퍼의 Color Attachment 할당을 위한 매커니즘
오프스크린 렌더버퍼 glRenderbufferStorageOES
그릴 수 있는 렌더버퍼 renderbufferStorage:fromDrawable:
텍스쳐 glFramebufferTexture2DOES

프레임 버퍼 오브젝트 그리기
프레임 버퍼 오브젝트를 할당했을 때, 당신은 그곳에 렌더링 할 수 있었다. 모든 렌더링은 현재 프레임 버퍼 영역의 타겟이 된다.
glBindFramebufferOES(GL_FRAMEBUFFER_OES, framebuffer);


당신의 결과들을 나타내기
당신이 색상 렌더버퍼를 CoreAnimation 레이어에서 포인트로 할당했다고 가정하면, 당신은 현재 렌더버퍼를 만들고 렌더링 컨텍스트에서 presentRenderbuffer:메서드를 호출 하는 것으로 그 컨텐츠들을 나타낼 수 있다.
glBindRenderbufferOES(GL_RENDERBUFFER_OES, colorRenderbuffer);
[context presentRenderbuffer:GL_RENDERBUFFER_OES];

기본적으로, 이 렌더버퍼의 컨텐츠들은 스크린에 표시된 후에는 유효하지 않다.  당신의 어플리케이션은 반드시 프레임을 그릴때마다 렌더버퍼의 컨텐츠들을 완전히 재생성해 주어야 한다.  만약에 당신의 어플리케이션이 프레임들 사이에 컨텐츠들을 보존해야 한다면, kEAGLDrawablePropertyRetainedBacking 키를 CAEAGLLayer오브젝트의 drawableProperties 속성에 저장된 딕셔너리에 추가해야 한다.  레이어의 컨텐츠를 유지하는 것은 할당에 필요한 부가적인 메모리가 요구될 것이다. 이것은, 당신의 어플리케이션의 퍼포먼스를 경감시킬 수 있다.

렌더버퍼가 스크린에 표시되었을 때, 이것은 스크린 상에 보이는 다른 코어 애니메이션 레이어들과 OpenGL ES, Quartz 또는 그밖의 다른 그래픽스 라이브러리로 그려진 레이어들이든 말든간에 애니메이션 되고, 합성된다.  다른 컨텐츠와 섞인 OpenGL ES 컨텐츠는 성능에 불리한 점을 가져온다. 가장 좋은 연습을 위해서는, 당신의 애플리케이션에서 OpenGL ES로만 컨텐츠를 렌더링해 보는 것이다.  이것을 하기 위해서는, 스크린 크기의 CAEAGLLayer 오브젝트를 생성하고, opaque 속성을 YES, 그리고 다른 눈에 보이는 Core Animation 레이어들이나 뷰들은 없도록 하는 것이다.
만약 다른 레이어들과 OpenGL ES 를 합성해야 한다면, 당신의 CAEAGLLayer 오브젝트의 불투명도를 줄이도록 한다. 이것은 퍼포먼스 감소를 없애지는 않는다.

만약 당신의 CAEAGLLayer 오브젝트가 다른 레이어들과 블렌드되었다면, 코어 애니메이션은 상당한 퍼포먼스 패널티를 얻게 된다.  당신은 이런 패널티를  다른 UIKit 레이어들의 뒤에 당신의 레이어를 동작시키는 것으로 감소시킬 수 있다.
주의 : 만약에 반드시 투명한 OpenGL ES 컨텐츠를 블랜드 해야 한다면, 당신의 렌더버퍼는 코어 애니메이션에 의해서 알맞게 합성되기 위해서 알파값이 먼저 곱해진 버퍼를 반드시 제공해야 한다.

결론적으로 CAEAGLLayer 오브젝트에 코어 애니메이션 변형을 사용할 필요는 거의 없으며, 코어 애니메이션 처리는 당신의 컨텐츠를 디스플레이 하기 전에 반드시 해야 한다.  당신의 애플리케이션은 모델 뷰와 투영 행렬들(또는 당신의 버텍스 쉐이더와 같은 것들), 그리고 glViewport와 glScissor 함수들로 가로와 세로 속성들을 변경하는 것에 의해서 종종 같은 동작을 수행할 수 있다.

공유그룹
EAGLSharegroup 오브젝트는 하나이상의 EAGLContext와 관련된 OpenGL ES 리소스들을 관리한다.  공유그룹은 보통 EAGLContext 오브젝트가 릴리즈 된 것이 참조하는 것이 마지막 EAGLContext 오브젝트일 때 초기화되고, 배치되었을 때 생성된다.  불투명 오브젝트로서, 개발자가 접근가능한 API 는 없다.
단일 공유그룹을 사용하여 다중 컨텍스트들을 생성하려면, 앞에서와 같이 당신의 어플리케이션은 첫번째로 하나의 컨텍스트를 생성한 후, initWithAPI:sharegroupe: 를 사용해서 하나이상의 부가적인 컨텍스트들을 생성한다.
EAGLContext * firstContext = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1];
EAGLContext * secondContext = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1 sharegroup:[firstContext sharegroup]];

공유그룹들은 텍스쳐, 버퍼, 프레임버퍼, 그리고 렌더 버퍼들을 관리한다.  공유그룹의 다중 컨텍스트들이 이 오브젝트에 접근했을 때, 공유된 오브젝트들의 상태 변화를 관리하는 것은 당신의 어플리케이션 책임이다.  다른 컨텍스트에서 렌더링 되기 위해 사용되는 동안 공유 오브젝트의 상태변화의 결과는 정의되지 않는다.  확실한 결과들을 얻으려면, 당신의 어플리케이션은 당신의 어플리케이션이 그것을 수정할 때 렌더링을 위해 사용되는 현재 공유되고 있지 않은 오브젝트를 확실히 할 과정을 명확히 해야 한다.
나아가, 상태 변화들은 공유그룹에서 그 컨텍스트가 공유된 오브젝트를 다시 바인드 할때까지 다른 컨텍스트에 의해서 발견될 상태 변화들은 보장받지 못한다.


공유그룹에서 컨텍스트 전반에 걸쳐 공유된 오브젝트들로 상태변화의 결과를 정의하기 위해, 당신의 어플리케이션은 반드시 다음의 작업들을 순서대로 수행해야 한다:

  1. 오브젝트의 상태 변경
  2. 상태수정 루틴을 수행하는 렌더링 컨텍스트에서 glFlush를 호출한다.
  3. 각 컨텍스트는 반드시 변화를 보기 위해서 오브젝트를 다시 바인드 해야 한다.
원래의 오브젝트는 공유 그룹의 모든 컨텍스트들이 새로운 오브젝트의 영역을 가지게 된 후에는 삭제된다.




========================================
가독성도 떨어지고, 해석도 이상해서 못봐주겠다 싶으면 원문 참고 하세요.
오타, 오역은 댓글로 알려주시면 "Thank you very 감사" 하겠습니다 ^^

내 블로그 목록

팔로어