webpkit 0.1.0

A pure-Rust WebP codec: lossless (VP8L) and lossy (VP8) behind one decode/encode API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Feature-gated bridge to the deterministic work counters (L0).
//!
//! With the `work-count` feature OFF this compiles to nothing: the [`work!`]
//! macro drops its argument tokens, [`crate::work_count`] is not a dependency, and
//! production output and behavior are unchanged. With it ON, each `work!` site
//! is an `#[inline]` relaxed atomic add.
//!
//! Instrumented modules bring the macro into scope with `use crate::lossy::work::work;`
//! and write `work!(FdctCall);` (bump by one) or `work!(TrellisEval, n);`
//! (add `n`). The macro expands through the absolute `$crate::lossy::work::Counter`
//! path, so it resolves identically from any call-site module.

/// The counter vocabulary, re-exported so `$crate::lossy::work::Counter` resolves.
#[cfg(feature = "work-count")]
pub(crate) use crate::work_count::Counter;

/// Bump a work counter. `work!(Slot)` adds one; `work!(Slot, n)` adds `n`.
///
/// Expands to nothing (and never type-checks its arguments) when the
/// `work-count` feature is off.
#[cfg(feature = "work-count")]
macro_rules! work {
    ($slot:ident) => {
        $crate::lossy::work::Counter::$slot.bump()
    };
    ($slot:ident, $n:expr) => {
        $crate::lossy::work::Counter::$slot.add($n)
    };
}

#[cfg(not(feature = "work-count"))]
macro_rules! work {
    ($($tt:tt)*) => {{}};
}

pub(crate) use work;