Home | History | Annotate | Download | only in samplegrouping
      1 /*
      2  * Copyright 2012 castLabs, Berlin
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the License);
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *     http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an AS IS BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package com.googlecode.mp4parser.boxes.mp4.samplegrouping;
     18 
     19 import com.coremedia.iso.IsoTypeReader;
     20 
     21 import java.nio.ByteBuffer;
     22 
     23 /**
     24  * For some coding systems a sync sample is specified to be a random access point after which all samples in decoding order can be correctly decoded. However, it may be possible to encode an open random access point, after which all samples in output order can be correctly decoded, but some samples following the random access point in decoding order and preceding the random access point in output order need not be correctly decodable. For example, an intra picture starting an open group of pictures can be followed in decoding order by (bi-)predicted pictures that however precede the intra picture in output order; though they possibly cannot be correctly decoded if the decoding starts from the intra picture, they are not needed.
     25  *
     26  * Such open random-access samples can be marked by being a member of this group. Samples marked by this group must be random access points, and may also be sync points (i.e. it is not required that samples marked by the sync sample table be excluded).
     27  *
     28  */
     29 public class VisualRandomAccessEntry extends GroupEntry {
     30     public static final String TYPE = "rap ";
     31     private boolean numLeadingSamplesKnown;
     32     private short numLeadingSamples;
     33 
     34     public boolean isNumLeadingSamplesKnown() {
     35         return numLeadingSamplesKnown;
     36     }
     37 
     38     public void setNumLeadingSamplesKnown(boolean numLeadingSamplesKnown) {
     39         this.numLeadingSamplesKnown = numLeadingSamplesKnown;
     40     }
     41 
     42     public short getNumLeadingSamples() {
     43         return numLeadingSamples;
     44     }
     45 
     46     public void setNumLeadingSamples(short numLeadingSamples) {
     47         this.numLeadingSamples = numLeadingSamples;
     48     }
     49 
     50     @Override
     51     public void parse(ByteBuffer byteBuffer) {
     52         final byte b = byteBuffer.get();
     53         numLeadingSamplesKnown = ((b & 0x80) == 0x80);
     54         numLeadingSamples = (short) (b & 0x7f);
     55     }
     56 
     57     @Override
     58     public ByteBuffer get() {
     59         ByteBuffer content = ByteBuffer.allocate(1);
     60         content.put((byte) ((numLeadingSamplesKnown? 0x80 : 0x00)| (numLeadingSamples & 0x7f)));
     61         content.rewind();
     62         return content;
     63     }
     64 
     65     @Override
     66     public boolean equals(Object o) {
     67         if (this == o) return true;
     68         if (o == null || getClass() != o.getClass()) return false;
     69 
     70         VisualRandomAccessEntry that = (VisualRandomAccessEntry) o;
     71 
     72         if (numLeadingSamples != that.numLeadingSamples) return false;
     73         if (numLeadingSamplesKnown != that.numLeadingSamplesKnown) return false;
     74 
     75         return true;
     76     }
     77 
     78     @Override
     79     public int hashCode() {
     80         int result = (numLeadingSamplesKnown ? 1 : 0);
     81         result = 31 * result + (int) numLeadingSamples;
     82         return result;
     83     }
     84 
     85     @Override
     86     public String toString() {
     87         final StringBuilder sb = new StringBuilder();
     88         sb.append("VisualRandomAccessEntry");
     89         sb.append("{numLeadingSamplesKnown=").append(numLeadingSamplesKnown);
     90         sb.append(", numLeadingSamples=").append(numLeadingSamples);
     91         sb.append('}');
     92         return sb.toString();
     93     }
     94 }
     95