CGII/framework/include/cgv/data/packing_info.h
2018-05-17 16:01:02 +02:00

73 lines
3.5 KiB
C++

#pragma once
#include <cgv/data/lib_begin.h>
namespace cgv {
namespace data {
/** the packing_info class stores information about packed integers
structures. It is typically used to define packed component formats.
The stored information includes, whether packing is used,
the alignment of the components and bit depths of up to 4 components.
The aligment is an integer defining a multiple to which the components
are aligned. If the alignment is 1, the components are packed densely.
If it is for example 8, the components are stored at starting at
locations that are multiples of 8. For example if the components have
bit depth 6 and the alignment is 8, then the first component is stored
starting with the first bit, the second component starting with the 8th
bit and so on. In case no packing is used the alignment is measured in
bytes. The bit depths and alignment are stored as unsigned integers
with 6 bits, i.e. the maximum value is 63.
*/
class CGV_API packing_info
{
protected:
bool is_packed : 1;
unsigned int bd0 : 6;
unsigned int bd1 : 6;
unsigned int bd2 : 6;
unsigned int bd3 : 6;
unsigned int ca : 6;
///
bool prepare_bit_operation(unsigned int ci, void* ptr, unsigned int &off, unsigned int &bd, unsigned int* &iptr) const;
bool prepare_bit_operation(unsigned int ci, const void* ptr, unsigned int &off, unsigned int &bd, const unsigned int* &iptr) const;
unsigned int get_bit_offset(unsigned int ci) const;
public:
/** construct packing information from alignment and bit depths. If no bit depths are given, the components are not
packed and the alignment is in bytes. If one or more depths are specified, the alignment is in bits. If exactly
one depth is given, all component bit depths are set to this bit depth */
packing_info(unsigned int align = 1, unsigned int d0 = 0, unsigned int d1 = 0, unsigned int d2 = 0, unsigned int d3 = 0);
/// clear packing info information
void clear();
/// return the bit depth of the ci-th component
unsigned int get_bit_depth(unsigned int ci) const;
/// set the bit depth of the ci-th component
void set_bit_depth(unsigned int ci, unsigned int depth);
/// return whether packing is enabled
bool is_packing() const;
/// set the packing flag
void set_packing(bool enable = true);
/// return the component alignment in bits in the packed case and in bytes in the unpacked case
unsigned int get_component_alignment() const;
/// set the component alignment in bits in the packed case and in bytes in the unpacked case
void set_component_alignment(unsigned int a);
/// return the next integer larger or equal to v which is dividable by a
static unsigned int align(unsigned int v, unsigned int a);
/// return the ci-th component of the data entry pointed to by the given pointer of a signed packed component
int get_signed(unsigned int ci, const void* ptr) const;
/// return the ci-th component of the data entry pointed to by the given pointer of an unsigned packed component
unsigned int get_unsigned(unsigned int ci, const void* ptr) const;
/// set the ci-th component of the data entry pointed to by the given pointer of a signed packed component
bool set_signed(unsigned int ci, void* ptr, int v) const;
/// set the ci-th component of the data entry pointed to by the given pointer of an unsigned packed component
bool set_unsigned(unsigned int ci, void* ptr, unsigned int v) const;
/// equal comparison
bool operator == (const packing_info& pi) const;
/// unequal comparison
bool operator != (const packing_info& pi) const;
};
}
}
#include <cgv/config/lib_end.h>