RatingBox.java revision dd9eb897ee7c7b507cbdcf80263bb4b5de6966bf
1dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu/* 2dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Copyright 2008 CoreMedia AG, Hamburg 3dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 4dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Licensed under the Apache License, Version 2.0 (the License); 5dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * you may not use this file except in compliance with the License. 6dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * You may obtain a copy of the License at 7dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 8dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * http://www.apache.org/licenses/LICENSE-2.0 9dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 10dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Unless required by applicable law or agreed to in writing, software 11dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * distributed under the License is distributed on an AS IS BASIS, 12dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * See the License for the specific language governing permissions and 14dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * limitations under the License. 15dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 16dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 17dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhupackage com.coremedia.iso.boxes; 18dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 19dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.coremedia.iso.IsoFile; 20dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.coremedia.iso.IsoTypeReader; 21dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.coremedia.iso.IsoTypeWriter; 22dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.coremedia.iso.Utf8; 23dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.googlecode.mp4parser.AbstractFullBox; 24dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 25dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport java.nio.ByteBuffer; 26dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 27dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 28dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu/** 29dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Contained a the <code>UserDataBox</code> and containing information about the media's rating. E.g. 30dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * PG13or FSK16. 31dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 32dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhupublic class RatingBox extends AbstractFullBox { 33dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public static final String TYPE = "rtng"; 34dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 35dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu private String ratingEntity; 36dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu private String ratingCriteria; 37dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu private String language; 38dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu private String ratingInfo; 39dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 40dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public RatingBox() { 41dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu super(TYPE); 42dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 43dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 44dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 45dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public void setRatingEntity(String ratingEntity) { 46dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu this.ratingEntity = ratingEntity; 47dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 48dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 49dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public void setRatingCriteria(String ratingCriteria) { 50dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu this.ratingCriteria = ratingCriteria; 51dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 52dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 53dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public void setLanguage(String language) { 54dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu this.language = language; 55dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 56dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 57dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public void setRatingInfo(String ratingInfo) { 58dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu this.ratingInfo = ratingInfo; 59dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 60dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 61dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public String getLanguage() { 62dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return language; 63dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 64dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 65dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 66dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets a four-character code that indicates the rating entity grading the asset, e.g., 'BBFC'. The values of this 67dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * field should follow common names of worldwide movie rating systems, such as those mentioned in 68dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * [http://www.movie-ratings.net/, October 2002]. 69dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 70dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return the rating organization 71dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 72dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public String getRatingEntity() { 73dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return ratingEntity; 74dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 75dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 76dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 77dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets the four-character code that indicates which rating criteria are being used for the corresponding rating 78dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * entity, e.g., 'PG13'. 79dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 80dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return the actual rating 81dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 82dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public String getRatingCriteria() { 83dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return ratingCriteria; 84dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 85dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 86dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public String getRatingInfo() { 87dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return ratingInfo; 88dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 89dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 90dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu protected long getContentSize() { 91dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return 15 + Utf8.utf8StringLengthInBytes(ratingInfo); 92dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 93dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 94dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu @Override 95dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public void _parseDetails(ByteBuffer content) { 96dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu parseVersionAndFlags(content); 97dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu ratingEntity = IsoTypeReader.read4cc(content); 98dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu ratingCriteria = IsoTypeReader.read4cc(content); 99dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu language = IsoTypeReader.readIso639(content); 100dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu ratingInfo = IsoTypeReader.readString(content); 101dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 102dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 103dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 104dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu @Override 105dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu protected void getContent(ByteBuffer byteBuffer) { 106dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu writeVersionAndFlags(byteBuffer); 107dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu byteBuffer.put(IsoFile.fourCCtoBytes(ratingEntity)); 108dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu byteBuffer.put(IsoFile.fourCCtoBytes(ratingCriteria)); 109dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu IsoTypeWriter.writeIso639(byteBuffer, language); 110dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu byteBuffer.put(Utf8.convert(ratingInfo)); 111dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu byteBuffer.put((byte) 0); 112dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 113dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 114dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu public String toString() { 115dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu StringBuilder buffer = new StringBuilder(); 116dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append("RatingBox[language=").append(getLanguage()); 117dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append("ratingEntity=").append(getRatingEntity()); 118dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append(";ratingCriteria=").append(getRatingCriteria()); 119dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append(";language=").append(getLanguage()); 120dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append(";ratingInfo=").append(getRatingInfo()); 121dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu buffer.append("]"); 122dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu return buffer.toString(); 123dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu } 124dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu} 125