Box::parse( Avifinfo\stream $handle, int $num_parsed_boxes, int $num_remaining_bytes = MAX_SIZE ): Avifinfo\Status

231  public function parse( $handle, &$num_parsed_boxes, $num_remaining_bytes = MAX_SIZE ) {232    // See ISO/IEC 14496-12:2012(E) 4.2233    $header_size = 8; // box 32b size + 32b type (at least)234    if ( $header_size > $num_remaining_bytes ) {235      return INVALID;236    }237    if ( !( $data = read( $handle, 8 ) ) ) {238      return TRUNCATED;239    }240    $this->size = read_big_endian( $data, 4 );241    $this->type = substr( $data, 4, 4 );242    // 'box->size==1' means 64-bit size should be read after the box type.243    // 'box->size==0' means this box extends to all remaining bytes.244    if ( $this->size == 1 ) {245      $header_size += 8;246      if ( $header_size > $num_remaining_bytes ) {247        return INVALID;248      }249      if ( !( $data = read( $handle, 8 ) ) ) {250        return TRUNCATED;251      }252      // Stop the parsing if any box has a size greater than 4GB.253      if ( read_big_endian( $data, 4 ) != 0 ) {254        return ABORTED;255      }256      // Read the 32 least-significant bits.257      $this->size = read_big_endian( substr( $data, 4, 4 ), 4 );258    } else if ( $this->size == 0 ) {259      // ISO/IEC 14496-12 4.2.2:260      //   if size is 0, then this box shall be in a top-level box261      //   (i.e. not contained in another box)262      // Unfortunately the presence of a parent box is unknown here.263      $this->size = $num_remaining_bytes;264    }265    if ( $this->size < $header_size ) {266      return INVALID;267    }268    if ( $this->size > $num_remaining_bytes ) {269      return INVALID;270    }271 272    // 16 bytes of usertype should be read here if the box type is 'uuid'.273    // 'uuid' boxes are skipped so usertype is part of the skipped body.274 275    $has_fullbox_header = $this->type == 'meta' || $this->type == 'pitm' ||276                          $this->type == 'ipma' || $this->type == 'ispe' ||277                          $this->type == 'pixi' || $this->type == 'iref' ||278                          $this->type == 'auxC';279    if ( $has_fullbox_header ) {280      $header_size += 4;281    }282    if ( $this->size < $header_size ) {283      return INVALID;284    }285    $this->content_size = $this->size - $header_size;286    // Avoid timeouts. The maximum number of parsed boxes is arbitrary.287    ++$num_parsed_boxes;288    if ( $num_parsed_boxes >= MAX_NUM_BOXES ) {289      return ABORTED;290    }291 292    $this->version = 0;293    $this->flags   = 0;294    if ( $has_fullbox_header ) {295      if ( !( $data = read( $handle, 4 ) ) ) {296        return TRUNCATED;297      }298      $this->version = read_big_endian( $data, 1 );299      $this->flags   = read_big_endian( substr( $data, 1, 3 ), 3 );300      // See AV1 Image File Format (AVIF) 8.1301      // at https://aomediacodec.github.io/av1-avif/#avif-boxes (available when302      // https://github.com/AOMediaCodec/av1-avif/pull/170 is merged).303      $is_parsable = ( $this->type == 'meta' && $this->version <= 0 ) ||304                     ( $this->type == 'pitm' && $this->version <= 1 ) ||305                     ( $this->type == 'ipma' && $this->version <= 1 ) ||306                     ( $this->type == 'ispe' && $this->version <= 0 ) ||307                     ( $this->type == 'pixi' && $this->version <= 0 ) ||308                     ( $this->type == 'iref' && $this->version <= 1 ) ||309                     ( $this->type == 'auxC' && $this->version <= 0 );310      // Instead of considering this file as invalid, skip unparsable boxes.