libgm 0.7.2

A tool for unpacking and modding GameMaker games
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

// SPDX-License-Identifier: GPL-3.0-only
use core::fmt::Debug;
use core::hash::Hash;

use crate::prelude::*;
use crate::util::fmt::typename;

pub trait GMEnum: Copy + Eq + Hash + Debug {
    #[must_use]
    fn try_from_i32(integer: i32) -> Option<Self>;

    fn from_i32(integer: i32) -> Result<Self> {
        Self::try_from_i32(integer).ok_or_else(|| {
            err!(
                "Invalid {} enum value {} (0x{:08X})",
                typename::<Self>(),
                integer,
                integer,
            )
        })
    }

    #[must_use]
    fn as_i32(self) -> i32;
}

macro_rules! gm_enum {
    ($(#[$meta:meta])* $name:ident { $( $(#[$vmeta:meta])* $variant:ident = $int:literal, )+  } ) => {
        $(#[$meta])*
        #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
        pub enum $name {
            $( $(#[$vmeta])* $variant, )+
        }

        impl crate::gm_enum::GMEnum for $name {
            fn try_from_i32(integer: i32) -> Option<Self> {
                match integer {
                    $( $int => Some(Self::$variant), )+
                    _ => None,
                }
            }

            fn as_i32(self) -> i32 {
                match self {
                    $( Self::$variant => $int, )+
                }
            }
        }
    };
}

pub(crate) use gm_enum;