adtffile  v0.9.2
ADTF File Library

Description

The ADTF File Library will enable you to read and write an .adtfdat file.

  • basic serialisations for samples (container for timestamped streamed data)
  • basic deserialisations for samples
  • the file format IFHD itself (Indexed File Format)

ADTF File Library Packages

This library contains following internal packages:

adtf_file (see src/libraries/adtf_file)

The ADTF File Package with 'adtf_file::Writer' and 'adtf_file::Reader'. Depending on the ADTF File Version you may create and read Indexed Files with samples.

ifhd_file (see src/libraries/ifhd_file)

The IFHD File Package with the 'cIndexedFileWriter' and 'cIndexedFileReader'. Depending on the File Version you may create and read Indexed Files. This will not contain sample. The organisation type of data is chunk.

  • 'ifhd::v400' is for ADTF 3.
  • 'ifhd::v201_v301' is for ADTF 2.

utils5extension (see src/libraries/utils5extension)

This Package will provide some further helper classes needed to create an Indexed File.

adtfdat_processing (see src/libraries/adtfdat_processing)

This package will provide interfaces to export (adtf::dat::ant::Processor) and import (adtf::dat::ant::Reader) data from/to a adtf_file::Stream of an .adtfdat file.

ADTF File Library Tools

adtf_dattool (see src/tools/adtf_dattool)

Command line application to export/import data from/to .adtfdat files by using delivered or customized adtf::dat::ant::Processor and adtf::dat::ant::Reader. For more information please launch the tool with command –help.

Further Documentation

See ADTF File Library Documentation(link)

License Information

Have also a look at [MPL License](LICENSE). and see License Information(link)


Dependencies

dev_essential libraries

The libraries above depend on the dev_essential library bundle See http://www.cip.audi.de/bitbucket/projects/OPENDEV/repos/odautil

How to build

Build Environment

The libraries are build and tested only under following compilers and operating systems:

Windows 10 64 Bit

  • Visual Studio C++ 2019

Linux Ubuntu 18.04 LTS (Desktop and Aarch64)

  • On other distributions make at least sure that libc has version >= 2.27 and libstdc++ >= 6.0.25.
  • gcc 7

How to build

If you can not reach the above online repositories the bundle of it is delivered within a separate download area or installation. See Versions(link).

Build a_util first

The ADTF File Library will only build if a installation of dev_essential library bundle is provided. Following libraries of the dev_essential are necessary:

  • dev_essential::concurrency
  • dev_essential::memory
  • dev_essential::regex
  • dev_essential::strings
  • dev_essential::datetime
  • dev_essential::filesystem
  • dev_essential::xml
  • dev_essential::ddl
  • Use CMAKE at least in version 3.5.1.
  • Use the Release Branch "Release/dev_essential-version-branch" see Versions
  • Use CMakeLists.txt within the main directory as Source Directory
  • Do not forget to set a CMAKE_INSTALL_PREFIX
  • Build and install for Debug and RelWithDebInfo

Build adtf_file

  • Use CMAKE at least in version 3.5.
  • Use the Release Branch "Release/adtf-file-version-branch" See Versions
  • Use CMakeLists.txt within the main directory as Source Directory
  • Set the a_util_DIR to your a_util Install "lib/cmake/a_util"
  • Do not forget to set a CMAKE_INSTALL_PREFIX
  • Build and install for Debug and RelWithDebInfo