From 542908617338d7d37407be7c00c6663e30eb8b27 Mon Sep 17 00:00:00 2001
From: Mathis Rosenhauer <rosenhauer@dkrz.de>
Date: Mon, 21 Aug 2023 11:30:31 +0200
Subject: [PATCH] Version 1.1.0 (#25)
---
CHANGELOG.md | 16 ++++++++++++----
CMakeLists.txt | 2 +-
LICENSE.txt | 2 +-
README.md | 27 ++++++++++++++++-----------
configure.ac | 4 ++--
include/libaec.h.in | 2 +-
include/szlib.h | 2 +-
src/CMakeLists.txt | 2 +-
src/Makefile.am | 2 +-
src/decode.c | 2 +-
src/decode.h | 2 +-
src/encode.c | 2 +-
src/encode.h | 2 +-
src/encode_accessors.c | 2 +-
src/encode_accessors.h | 2 +-
src/graec.c | 2 +-
src/sz_compat.c | 2 +-
src/utime.c | 2 +-
18 files changed, 45 insertions(+), 32 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 29223a7..731b530 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,14 +1,22 @@
# libaec Changelog
All notable changes to libaec will be documented in this file.
-## [1.1.0]
+## [1.1.0] - 2023-08-21
### Changed
- Rename aec executable to graec. This avoids a name clash with the
library itself in cmake builds using the Ninja
- generator. Furthermore, the executable and its manpage will not be
- installed any more since it is mainly used for internal testing and
- benchmarking.
+ generator. Furthermore, the executable and its manual page will not
+ be installed any more since it is mainly used for internal testing
+ and benchmarking.
+
+- The include file libaec.h now contains version information.
+
+### Added
+- Support for decoding data ranges by Eugen Betke. You can now start
+ decoding at previously noted offsets of reference samples. New API
+ functions allow you to extract possible offsets and decode ranges
+ from encoded data.
## [1.0.6] - 2021-09-17
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 40abf56..2fe3a94 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,5 +1,5 @@
cmake_minimum_required(VERSION 3.13...3.19)
-project(libaec LANGUAGES C VERSION 1.0.6)
+project(libaec LANGUAGES C VERSION 1.1.0)
# Automatically export symbols for Windows DLLs
set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS TRUE)
diff --git a/LICENSE.txt b/LICENSE.txt
index 3f4751f..b39f735 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
All rights reserved.
Redistribution and use in source and binary forms, with or without
diff --git a/README.md b/README.md
index c976d7a..e446653 100644
--- a/README.md
+++ b/README.md
@@ -218,8 +218,8 @@ The actual values of coding parameters are in fact only relevant for
efficiency and performance. Data integrity only depends on consistency
of the parameters.
-The exact length of the original data is not preserved and must also be
-transmitted out of band. The decoder can produce additional output
+The exact length of the original data is not preserved and must also
+be transmitted out of band. The decoder can produce additional output
depending on whether the original data ended on a block boundary or on
zero blocks. The output data must therefore be truncated to the
correct length. This can also be achieved by providing an output
@@ -227,12 +227,16 @@ buffer of just the correct length.
### Decoding data ranges
-The Libaec library has functionality that allows individual data areas to be decoded without having to decode the entire file.
-This allows efficient access to the data.
+The Libaec library has functionality that allows individual data areas
+to be decoded without having to decode the entire file. This allows
+efficient access to the data.
-This is possible because AEC-encoded data consists of independent blocks.
-It is, therefore, possible to decode individual blocks if their offsets are known.
-The Libaec library can capture the offsets when encoding or decoding the data and make them available to the user.
+This is possible because AEC-encoded data consists of independent
+blocks. It is, therefore, possible to decode individual blocks if
+their offsets are known. If the preprocessor requires reference
+samples, then decoding can commence only at blocks containing a
+reference sample. The Libaec library can capture the offsets when
+encoding or decoding the data and make them available to the user.
The following example shows how to obtain the offsets.
@@ -274,10 +278,11 @@ The following example shows how to obtain the offsets.
...
```
-The offsets can then be used to decode ranges of data.
-The procedure is similar to the previous section, but use aec_decode_range() instead of aec_decode() and pass the offsets and the range as parameters.
-The decoded ranges are written to the buffer as a stream.
-When decoding the ranges into the individual buffers, set strm.total_out to zero.
+The offsets can then be used to decode ranges of data. The procedure
+is similar to the previous section, but use aec_decode_range() instead
+of aec_decode() and pass the offsets and the range as parameters. The
+decoded ranges are written to the buffer as a stream. When decoding
+the ranges into the individual buffers, set strm.total_out to zero.
```c
#include <libaec.h>
diff --git a/configure.ac b/configure.ac
index e2ba962..afafb49 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,8 +1,8 @@
AC_PREREQ([2.64])
m4_define([VERSION_MAJOR], [1])
-m4_define([VERSION_MINOR], [0])
-m4_define([VERSION_PATCH], [6])
+m4_define([VERSION_MINOR], [1])
+m4_define([VERSION_PATCH], [0])
AC_INIT([libaec], [VERSION_MAJOR.VERSION_MINOR.VERSION_PATCH], [rosenhauer@dkrz.de])
diff --git a/include/libaec.h.in b/include/libaec.h.in
index 147f9b4..26d2fe8 100644
--- a/include/libaec.h.in
+++ b/include/libaec.h.in
@@ -2,7 +2,7 @@
* @file libaec.h
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/include/szlib.h b/include/szlib.h
index 256b3a4..6922a02 100644
--- a/include/szlib.h
+++ b/include/szlib.h
@@ -2,7 +2,7 @@
* @file szlib.h
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index c664efa..4c7fbfb 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -22,7 +22,7 @@ add_library(aec_shared SHARED "$<TARGET_OBJECTS:aec>")
target_link_libraries(aec_shared PUBLIC aec)
set_target_properties(aec_shared
PROPERTIES
- VERSION 0.0.12
+ VERSION 0.1.0
SOVERSION 0
OUTPUT_NAME aec
PUBLIC_HEADER ${CMAKE_CURRENT_BINARY_DIR}/../include/libaec.h)
diff --git a/src/Makefile.am b/src/Makefile.am
index 084b237..be452d4 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -5,7 +5,7 @@ AM_CPPFLAGS = -I$(top_srcdir)/include -I$(top_builddir)/include \
lib_LTLIBRARIES = libaec.la libsz.la
libaec_la_SOURCES = encode.c encode_accessors.c decode.c vector.c\
encode.h encode_accessors.h decode.h vector.h
-libaec_la_LDFLAGS = -version-info 0:12:0 -no-undefined
+libaec_la_LDFLAGS = -version-info 1:0:1 -no-undefined
libsz_la_SOURCES = sz_compat.c
libsz_la_LIBADD = libaec.la
diff --git a/src/decode.c b/src/decode.c
index 5b68e2a..b742e2c 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -2,7 +2,7 @@
* @file decode.c
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/decode.h b/src/decode.h
index a033ad4..4bb8111 100644
--- a/src/decode.h
+++ b/src/decode.h
@@ -2,7 +2,7 @@
* @file decode.h
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/encode.c b/src/encode.c
index b87a364..7704389 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -2,7 +2,7 @@
* @file encode.c
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/encode.h b/src/encode.h
index 05c5862..940a562 100644
--- a/src/encode.h
+++ b/src/encode.h
@@ -2,7 +2,7 @@
* @file encode.h
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/encode_accessors.c b/src/encode_accessors.c
index 077a884..7e5f901 100644
--- a/src/encode_accessors.c
+++ b/src/encode_accessors.c
@@ -2,7 +2,7 @@
* @file encode_accessors.c
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/encode_accessors.h b/src/encode_accessors.h
index 10d0efe..734747f 100644
--- a/src/encode_accessors.h
+++ b/src/encode_accessors.h
@@ -2,7 +2,7 @@
* @file encode_accessors.h
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/graec.c b/src/graec.c
index e537327..3591dbb 100644
--- a/src/graec.c
+++ b/src/graec.c
@@ -2,7 +2,7 @@
* @file aec.c
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/sz_compat.c b/src/sz_compat.c
index 3d3344a..a9a5398 100644
--- a/src/sz_compat.c
+++ b/src/sz_compat.c
@@ -2,7 +2,7 @@
* @file sz_compat.c
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
diff --git a/src/utime.c b/src/utime.c
index 33e667b..aa32a7a 100644
--- a/src/utime.c
+++ b/src/utime.c
@@ -4,7 +4,7 @@
* @author Thomas Jahns, Deutsches Klimarechenzentrum
*
* @section LICENSE
- * Copyright 2021 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
+ * Copyright 2023 Mathis Rosenhauer, Moritz Hanke, Joerg Behrens, Luis Kornblueh
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
--
GitLab