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