Skip to content

Latest commit

 

History

History
108 lines (105 loc) · 6.35 KB

README.md

File metadata and controls

108 lines (105 loc) · 6.35 KB

LITIV utils Module

This module is the spiritual equivalent of OpenCV’s “core”, and was at the root of the framework's creation. It contains miscellaneous utilities needed by other modules (e.g. OpenGL wrappers, platform wrappers, distance functions, C++11/14 compatibility tricks). In other words, this is a compacted gold mine for other programmers who might dabble in related computer vision work.

Here is a non-exhaustive (and probably not fully up-to-date) list of features:

  • OpenGL:
    • GLFW/GLUT window handler wrappers
    • Object-based GL context creation
    • OpenCV <=> OpenGL image type conversion functions
    • Texture/matrices deep copy functions
    • Templated array-based glGetInteger wrapper
    • 32-bit Tiny Mersenne Twister GLSL implementation
    • Packed GL matrix/vertex data containers
    • Object-based wrappers for VAOs, PBOs, (dynamic)textures(arrays), billboards, etc.
    • Object-based wrapper for GLSL shader compilation, linking, and global program management
    • GLSL source code for passthrough fragment/vertex/compute shaders
    • Pre-coded shaders for various compute operations (parallel sums, shared data preloading, ...)
    • Image processing GLSL algorithm interface (hides all the ugly binding/prep calls)
  • Defines:
    • Forward declarations of all CMake options as defines (including SIMD bit flags)
    • Assert/DbgAssert and Warn/Error/Log one-liners with logging support
    • Mutex'd cerr and cout printers
    • Symbol export/import logic for WIN32 via LV_PUBLIC and LV_LOCAL macros
  • CUDA:
    • Version/compute/architecture define flags taken from cmake
    • Initialization function w/ test kernel execution for device warmup
    • Helper functions for error handling and kernel param passing
  • OpenCV:
    • Type compatiblity lookup helpers (templated, constexpr)
    • Mat type/size helpers w/ support for printing in ostreams
    • Submatrix getters & squeezers for templated opencv matrices
    • Bilinear interp value getters for 2D matrices
    • Generic matrix allocators/element getters for sparse/dense mats
    • Matrix content copy function w/ double ROI validation
    • Vector-based opencv matrix concatenator
    • Random pixel lookup functions (based on 4-NN, 8-NN, Gaussian kernels, ...)
    • Matrix printer for 1D/2D templated array types
    • Matrix element unique/equal testing functions
    • BGR to HSL to BGR image color converters
    • BGR to packed YCbCr to BGR image color converters
    • Color map generator for 2d arrays with unique labels
    • Color map generator for optical flow maps (2D vectors)
    • Display helper object with mouse feedback for debugging
    • Generic cv::Mat archiver/loader (binary, text, YML, LZ4-compressed)
    • Matrix pixel circular shifting algorithm
    • Aligned memory allocator for opencv matrices
  • OpenGM:
    • Graph model info printer utility
    • Config define flags taken from CMake module parser
    • ExplicitViewFunction implementation to avoid in-graph LUT reallocations
    • ExplicitScaledViewFunction implementation; same as above w/ scale factor
    • Clique interface and static implementations for fast node info lookup
    • Higher order factor reduction utilities for QPBO interfaces (from FGBZ)
  • SIMD:
    • Wrappers for missing SSE calls (e.g. _mm_mullo_epi32, _mm_extract_epi32)
    • Horizontal SSE sums/min/max functions
  • Platform:
    • Files/subdirectories query functions with name filtering
    • File creation function with prealloc size on disk
    • Multi-platform console signal event registration function
    • Memory usage request function
  • Kinect:
    • Data structures re-implementation for body joint tracking
  • Console:
    • Various line/symbol/block drawing & updating utilities (most taken from rlutil)
    • Console window/buffer resizing utilities (win32 only)
    • Progress bar w/ global console mutex
  • Cxx:
    • Generic C++ string-generating printf (putf) function
    • String comparison/transformation functions (lowercase, clamping, split, ...)
    • Time, version stamp generators for loggers
    • Global framework logging verbosity getter/setter
    • Stream guard for non-overlapping logging in multithreaded algos
    • Exception extenders & loggers
    • STL unique_pointer type casting helpers
    • Static loop unroller (templated, constexpr)
    • Digit counter for templated arithmetic types
    • Vector manipulation functions (concat, filter, member accumulation, ...)
    • Sorting utilities (sort indices, uniques, nearest neighbor, ...)
    • Worker thread pool implementation for generic tasking/queueing
    • High-precision stopwatch
    • enable_shared_from_this wrapper with cast function
    • has_const_iterator type traits helper
    • get_bigger_integer type traits helper
    • Tuple for_each, unpack, unpack_call, reduce, transform
    • Aligned memory allocator for STL containers
    • Default-init memory allocator for STL containers
    • AutoBuffer implementation for static-alloc and dynamic swap at runtime
    • Lookup Table implementation for templated types and runtime defined funcs
    • Mutex unlock guards
    • C++11 semaphore implementation
  • Math:
    • Type-templated L1/L2sqr/L2/Hamming/Gradient/ColorDistortion distance functions (w/ some GLSL impls)
    • LUT-based Hamming weight functions for processors that do not support Intel's POPCNT
    • Earth mover's (L1) distance function with circular distance variation
    • Array sparseness evaluator (uses Hoyer's metric)
    • Array descriptor root sift transformation function
    • Nearest neighbor helper function
    • L1 vector/pointset interpolation function (matlab-compat)
    • Linearly separated vector generator function (matlab-compat)
    • Integer flag bit expander
    • Lower-Upper (LU) matrix decomposition function (templated)
    • Matrix determinant computation function (templated)
    • Matrix inverter function (templated)
    • Gaussian Mixture Model implementation w/ fitting and probability density evaluation

This module also links all external dependencies for the framework, meaning that executables only have to link to this target (along with other LITIV targets, as needed) to fully link to, e.g., OpenCV. Also, note that most important CMake variables have symbol entrypoints in the defines.hpp.in file, which is converted by CMake into an actual header file.