cichlid 0.2.1

A color math library for programming addressable LEDs.
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! Architecture specific math functions
#![allow(dead_code)]

#[allow(unused_imports)]
#[cfg(feature = "no-std")]
use core::mem;
#[allow(unused_imports)]
#[cfg(not(feature = "no-std"))]
use std::mem;

#[cfg(all(armv7em, nightly))]
macro_rules! dsp_call {
    ($name:expr, $a:expr, $b:expr) => {
        mem::transmute($name(mem::transmute($a), mem::transmute($b)))
    };
}

#[derive(Copy, Clone, Debug)]
#[allow(non_camel_case_types)]
#[cfg_attr(nightly, repr(simd))]
pub struct uint8x4_t(pub u8, pub u8, pub u8, pub u8);

#[derive(Copy, Clone, Debug)]
#[allow(non_camel_case_types)]
#[cfg_attr(nightly, repr(simd))]
pub struct uint16x2_t(pub u16, pub u16);

// http://www.keil.com/support/man/docs/armasm/armasm_dom1361289919288.htm
#[inline(always)]
pub fn uqadd8(a: uint8x4_t, b: uint8x4_t) -> uint8x4_t {
    match () {
        #[cfg(all(armv7em, nightly))]
        () => unsafe {
            extern "C" {
                #[link_name = "llvm.arm.uqadd8"]
                fn arm_uqadd8(a: u32, b: u32) -> u32;
            }
            dsp_call!(arm_uqadd8, a, b)
        },

        #[cfg(not(all(armv7em, nightly)))]
        () => uint8x4_t(
            a.0.saturating_add(b.0),
            a.1.saturating_add(b.1),
            a.2.saturating_add(b.2),
            a.3.saturating_add(b.3),
        ),
    }
}

// http://www.keil.com/support/man/docs/armasm/armasm_dom1361289919618.htm
#[inline(always)]
pub fn uqadd16(a: uint16x2_t, b: uint16x2_t) -> uint16x2_t {
    match () {
        #[cfg(all(armv7em, nightly))]
        () => unsafe {
            extern "C" {
                #[link_name = "llvm.arm.uqadd16"]
                fn arm_uqadd16(a: u32, b: u32) -> u32;
            }
            dsp_call!(arm_uqadd16, a, b)
        },

        #[cfg(not(all(armv7em, nightly)))]
        () => uint16x2_t(a.0.saturating_add(b.0), a.1.saturating_add(b.1)),
    }
}

// http://www.keil.com/support/man/docs/armasm/armasm_dom1361289920727.htm
#[inline(always)]
pub fn uqsub8(a: uint8x4_t, b: uint8x4_t) -> uint8x4_t {
    match () {
        #[cfg(all(armv7em, nightly))]
        () => unsafe {
            extern "C" {
                #[link_name = "llvm.arm.uqsub8"]
                fn arm_uqsub8(a: u32, b: u32) -> u32;
            }
            dsp_call!(arm_uqsub8, a, b)
        },

        #[cfg(not(all(armv7em, nightly)))]
        () => uint8x4_t(
            a.0.saturating_sub(b.0),
            a.1.saturating_sub(b.1),
            a.2.saturating_sub(b.2),
            a.3.saturating_sub(b.3),
        ),
    }
}

// http://www.keil.com/support/man/docs/armasm/armasm_dom1361289921077.htm
// uqsub16
#[inline(always)]
pub fn uqsub16(a: uint16x2_t, b: uint16x2_t) -> uint16x2_t {
    match () {
        #[cfg(all(armv7em, nightly))]
        () => unsafe {
            extern "C" {
                #[link_name = "llvm.arm.uqsub16"]
                fn arm_uqsub16(a: u32, b: u32) -> u32;
            }
            dsp_call!(arm_uqsub16, a, b)
        },

        #[cfg(not(all(armv7em, nightly)))]
        () => uint16x2_t(a.0.saturating_sub(b.0), a.1.saturating_sub(b.1)),
    }
}