aboutsummaryrefslogtreecommitdiffstats
path: root/include/core/SkPackBits.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/core/SkPackBits.h')
-rw-r--r--include/core/SkPackBits.h86
1 files changed, 86 insertions, 0 deletions
diff --git a/include/core/SkPackBits.h b/include/core/SkPackBits.h
new file mode 100644
index 0000000..c11231b
--- /dev/null
+++ b/include/core/SkPackBits.h
@@ -0,0 +1,86 @@
+/*
+ * Copyright (C) 2008 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef SkPackBits_DEFINED
+#define SkPackBits_DEFINED
+
+#include "SkTypes.h"
+
+class SkPackBits {
+public:
+ /** Given the number of 16bit values that will be passed to Pack16,
+ returns the worst-case size needed for the dst[] buffer.
+ */
+ static size_t ComputeMaxSize16(int count);
+
+ /** Given the number of 8bit values that will be passed to Pack8,
+ returns the worst-case size needed for the dst[] buffer.
+ */
+ static size_t ComputeMaxSize8(int count);
+
+ /** Write the src array into a packed format. The packing process may end
+ up writing more bytes than it read, so dst[] must be large enough.
+ @param src Input array of 16bit values
+ @param count Number of entries in src[]
+ @param dst Buffer (allocated by caller) to write the packed data
+ into
+ @return the number of bytes written to dst[]
+ */
+ static size_t Pack16(const uint16_t src[], int count, uint8_t dst[]);
+
+ /** Write the src array into a packed format. The packing process may end
+ up writing more bytes than it read, so dst[] must be large enough.
+ @param src Input array of 8bit values
+ @param count Number of entries in src[]
+ @param dst Buffer (allocated by caller) to write the packed data
+ into
+ @return the number of bytes written to dst[]
+ */
+ static size_t Pack8(const uint8_t src[], int count, uint8_t dst[]);
+
+ /** Unpack the data in src[], and expand it into dst[]. The src[] data was
+ written by a previous call to Pack16.
+ @param src Input data to unpack, previously created by Pack16.
+ @param srcSize Number of bytes of src to unpack
+ @param dst Buffer (allocated by caller) to expand the src[] into.
+ @return the number of dst elements (not bytes) written into dst.
+ */
+ static int Unpack16(const uint8_t src[], size_t srcSize, uint16_t dst[]);
+
+ /** Unpack the data in src[], and expand it into dst[]. The src[] data was
+ written by a previous call to Pack8.
+ @param src Input data to unpack, previously created by Pack8.
+ @param srcSize Number of bytes of src to unpack
+ @param dst Buffer (allocated by caller) to expand the src[] into.
+ @return the number of bytes written into dst.
+ */
+ static int Unpack8(const uint8_t src[], size_t srcSize, uint8_t dst[]);
+
+ /** Unpack the data from src[], skip the first dstSkip bytes, then write
+ dstWrite bytes into dst[]. The src[] data was written by a previous
+ call to Pack8. Return the number of bytes actually writtten into dst[]
+ @param src Input data to unpack, previously created by Pack8.
+ @param dst Buffer (allocated by caller) to expand the src[] into.
+ @param dstSkip Number of bytes of unpacked src to skip before writing
+ into dst
+ @param dstWrite Number of bytes of unpacked src to write into dst (after
+ skipping dstSkip bytes)
+ */
+ static void Unpack8(uint8_t dst[], size_t dstSkip, size_t dstWrite,
+ const uint8_t src[]);
+};
+
+#endif