vex-sdk 0.28.0

FFI bindings to VEXos system APIs.
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

//! Brain Display

use core::ffi::c_char;

/// A decoded image written to by VEXos.
#[repr(C, packed)]
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
pub struct v5_image {
    /// Definitive width of the output image.
    pub width: u16,

    /// Definitive height of the output image.
    pub height: u16,

    /// Buffer of RGB8 pixels that containing the image's data.
    ///
    /// This field must be set before the read operation as a pointer to the pre-allocated pixel buffer.
    /// After an image read operation, said image’s pixels are written to the location specified by this field.
    pub data: *mut u32,

    /// Points to the first pixel of the second row in the pixel buffer.
    ///
    /// Only set by the SDK after a [`vexImageBmpRead`] call.
    pub p: *mut u32,
}

unsafe extern "system" {
    pub fn vexDisplayForegroundColor(col: u32);
    pub fn vexDisplayBackgroundColor(col: u32);
    pub fn vexDisplayErase();
    pub fn vexDisplayScroll(nStartLine: i32, nLines: i32);
    pub fn vexDisplayScrollRect(x1: i32, y1: i32, x2: i32, y2: i32, nLines: i32);
    pub fn vexDisplayCopyRect(x1: i32, y1: i32, x2: i32, y2: i32, pSrc: *mut u32, srcStride: i32);
    pub fn vexDisplayPixelSet(x: u32, y: u32);
    pub fn vexDisplayPixelClear(x: u32, y: u32);
    pub fn vexDisplayLineDraw(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayLineClear(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayRectDraw(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayRectClear(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayRectFill(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayCircleDraw(xc: i32, yc: i32, radius: i32);
    pub fn vexDisplayCircleClear(xc: i32, yc: i32, radius: i32);
    pub fn vexDisplayCircleFill(xc: i32, yc: i32, radius: i32);
    pub fn vexDisplayTextSize(n: u32, d: u32);
    pub fn vexDisplayFontNamedSet(pFontName: *const c_char);
    pub fn vexDisplayForegroundColorGet() -> u32;
    pub fn vexDisplayBackgroundColorGet() -> u32;
    pub fn vexDisplayStringWidthGet(pString: *const c_char) -> i32;
    pub fn vexDisplayStringHeightGet(pString: *const c_char) -> i32;
    pub fn vexDisplayClipRegionSet(x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexDisplayRender(bVsyncWait: bool, bRunScheduler: bool);
    pub fn vexDisplayDoubleBufferDisable();
    pub fn vexDisplayClipRegionSetWithIndex(index: i32, x1: i32, y1: i32, x2: i32, y2: i32);
    pub fn vexImageBmpRead(ibuf: *const u8, oBuf: *mut v5_image, maxw: u32, maxh: u32) -> u32;
    pub fn vexImagePngRead(
        ibuf: *const u8,
        oBuf: *mut v5_image,
        maxw: u32,
        maxh: u32,
        ibuflen: u32,
    ) -> u32;
}

unsafe extern "C" {
    pub unsafe fn vexDisplayPrintf(xpos: i32, ypos: i32, bOpaque: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayString(nLineNumber: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayStringAt(xpos: i32, ypos: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayBigString(nLineNumber: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayBigStringAt(xpos: i32, ypos: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplaySmallStringAt(xpos: i32, ypos: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayCenteredString(nLineNumber: i32, format: *const c_char, ...);
    pub unsafe fn vexDisplayBigCenteredString(nLineNumber: i32, format: *const c_char, ...);
}