1 /*
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17 package org.apache.commons.imaging.formats.webp.chunks;
18
19 import java.nio.charset.StandardCharsets;
20
21 import org.apache.commons.imaging.ImagingException;
22
23 /**
24 * XML chunk.
25 *
26 * <pre>{@code
27 * 0 1 2 3
28 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
29 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
30 * | ChunkHeader('XMP ') |
31 * | |
32 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
33 * : XMP Metadata :
34 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
35 * }</pre>
36 *
37 * @see <a href="https://developers.google.com/speed/webp/docs/riff_container#metadata">Extended File Format#Metadata</a>
38 * @since 1.0-alpha4
39 */
40 public final class WebPChunkXml extends WebPChunk {
41 private final String xml;
42
43 /**
44 * Create a XML chunk.
45 *
46 * @param type chunk type.
47 * @param size chunk size.
48 * @param bytes chunk data.
49 * @throws ImagingException if the chunk data and the size provided do not match.
50 */
51 public WebPChunkXml(final int type, final int size, final byte[] bytes) throws ImagingException {
52 super(type, size, bytes);
53 this.xml = new String(bytes, StandardCharsets.UTF_8);
54 }
55
56 /**
57 * @return the XML.
58 */
59 public String getXml() {
60 return xml;
61 }
62 }