ByteArrayOutput.h revision e507721000647a7d8afe44c63ef7fd04ef8971b1
1e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk/*
2e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * Copyright 2014 The Android Open Source Project
3e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk *
4e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * Licensed under the Apache License, Version 2.0 (the "License");
5e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * you may not use this file except in compliance with the License.
6e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * You may obtain a copy of the License at
7e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk *
8e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk *      http://www.apache.org/licenses/LICENSE-2.0
9e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk *
10e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * Unless required by applicable law or agreed to in writing, software
11e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * distributed under the License is distributed on an "AS IS" BASIS,
12e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * See the License for the specific language governing permissions and
14e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * limitations under the License.
15e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk */
16e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
17e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#ifndef IMG_UTILS_BYTE_ARRAY_OUTPUT_H
18e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#define IMG_UTILS_BYTE_ARRAY_OUTPUT_H
19e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
20e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#include <img_utils/Output.h>
21e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
22e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#include <utils/Errors.h>
23e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#include <utils/Vector.h>
24e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
25e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#include <cutils/compiler.h>
26e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#include <stdint.h>
27e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
28e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunknamespace android {
29e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunknamespace img_utils {
30e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
31e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk/**
32e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk * Utility class that accumulates written bytes into a buffer.
33e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk */
34e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunkclass ANDROID_API ByteArrayOutput : public Output {
35e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk    public:
36e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
37e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        ByteArrayOutput();
38e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
39e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual ~ByteArrayOutput();
40e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
41e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        /**
42e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Open this ByteArrayOutput.
43e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         *
44e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Returns OK on success, or a negative error code.
45e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         */
46e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual status_t open();
47e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
48e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        /**
49e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Write bytes from the given buffer.  The number of bytes given in the count
50e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * argument will be written.  Bytes will be written from the given buffer starting
51e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * at the index given in the offset argument.
52e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         *
53e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Returns OK on success, or a negative error code.
54e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         */
55e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual status_t write(const uint8_t* buf, size_t offset, size_t count);
56e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
57e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        /**
58e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Close this ByteArrayOutput.
59e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         *
60e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Returns OK on success, or a negative error code.
61e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         */
62e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual status_t close();
63e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
64e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        /**
65e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Get current size of the array of bytes written.
66e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         */
67e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual size_t getSize() const;
68e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
69e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        /**
70e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * Get pointer to array of bytes written.  It is not valid to use this pointer if
71e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         * open, write, or close is called after this method.
72e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk         */
73e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        virtual const uint8_t* getArray() const;
74e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
75e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk    protected:
76e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk        Vector<uint8_t> mByteArray;
77e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk};
78e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
79e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk} /*namespace img_utils*/
80e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk} /*namespace android*/
81e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk
82e507721000647a7d8afe44c63ef7fd04ef8971b1Ruben Brunk#endif /*IMG_UTILS_BYTE_ARRAY_OUTPUT_H*/
83