/rust/registry/src/index.crates.io-1949cf8c6b5b557f/read-fonts-0.46.0/generated/generated_dsig.rs

Source
// THIS FILE IS AUTOGENERATED.
// Any changes to this file will be overwritten.
// For more information about how codegen works, see font-codegen/README.md

#[allow(unused_imports)]
use crate::codegen_prelude::*;

impl<'a> MinByteRange<'a> for Dsig<'a> {
    fn min_byte_range(&self) -> Range<usize> {
        0..self.signature_records_byte_range().end
    }
    fn min_table_bytes(&self) -> &'a [u8] {
        let range = self.min_byte_range();
        self.offset_data().as_bytes().get(range).unwrap_or_default()
    }
}

impl TopLevelTable for Dsig<'_> {
    /// `DSIG`
    const TAG: Tag = Tag::new(b"DSIG");
}

impl ReadArgs for Dsig<'_> {
    type Args = ();
}

impl<'a> FontRead<'a> for Dsig<'a> {
    fn read_with_args(data: FontData<'a>, _: ()) -> Result<Self, ReadError> {
        #[allow(clippy::absurd_extreme_comparisons)]
        if data.len() < Self::MIN_SIZE {
            return Err(ReadError::OutOfBounds);
        }
        let Some(data) = TableDataRef::new(data.as_bytes()) else {
            return Err(ReadError::OutOfBounds);
        };
        Ok(Self { data })
    }
}

/// The fields at the start of the table, which are read directly.
#[derive(Clone, Copy, bytemuck :: AnyBitPattern)]
#[repr(C, packed)]
#[doc(hidden)]
pub struct DsigFixedHeader {
    pub version: BigEndian<u32>,
    pub num_signatures: BigEndian<u16>,
    pub flags: BigEndian<PermissionFlags>,
}

#[allow(clippy::absurd_extreme_comparisons)]
const _: () = assert!(std::mem::size_of::<DsigFixedHeader>() <= Dsig::MIN_SIZE);

/// [DSIG (Digital Signature Table)](https://docs.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure) table
#[derive(Clone)]
pub struct Dsig<'a> {
    data: TableDataRef<'a, DsigFixedHeader>,
}

#[allow(clippy::needless_lifetimes)]
impl<'a> Dsig<'a> {
    pub const MIN_SIZE: usize =
        (u32::RAW_BYTE_LEN + u16::RAW_BYTE_LEN + PermissionFlags::RAW_BYTE_LEN);
    basic_table_impls!(impl_the_methods);

    /// Version number of the DSIG table (0x00000001)
    pub fn version(&self) -> u32 {
        self.data.header().version.get()
    }

    /// Number of signatures in the table
    pub fn num_signatures(&self) -> u16 {
        self.data.header().num_signatures.get()
    }

    /// Permission flags
    pub fn flags(&self) -> PermissionFlags {
        self.data.header().flags.get()
    }

    /// Array of signature records
    pub fn signature_records(&self) -> &'a [SignatureRecord] {
        let range = self.signature_records_byte_range();
        self.offset_data()
            .read_array(range)
            .ok()
            .unwrap_or_default()
    }

    pub fn version_byte_range(&self) -> Range<usize> {
        let start = 0;
        let end = start + u32::RAW_BYTE_LEN;
        start..end
    }

    pub fn num_signatures_byte_range(&self) -> Range<usize> {
        let start = self.version_byte_range().end;
        let end = start + u16::RAW_BYTE_LEN;
        start..end
    }

    pub fn flags_byte_range(&self) -> Range<usize> {
        let start = self.num_signatures_byte_range().end;
        let end = start + PermissionFlags::RAW_BYTE_LEN;
        start..end
    }

    pub fn signature_records_byte_range(&self) -> Range<usize> {
        let num_signatures = self.num_signatures();
        let start = self.flags_byte_range().end;
        let end = start
            + (transforms::to_usize(num_signatures)).saturating_mul(SignatureRecord::RAW_BYTE_LEN);
        start..end
    }
}

const _: () = assert!(FontData::default_data_long_enough(Dsig::MIN_SIZE));

impl Default for Dsig<'_> {
    fn default() -> Self {
        Self {
            data: TableDataRef::new(FontData::default_table_data().as_bytes())
                .unwrap_or_else(|| unreachable!("the default data covers MIN_SIZE")),
        }
    }
}

/// [Permission flags](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
#[derive(Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash, bytemuck :: AnyBitPattern)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[repr(transparent)]
pub struct PermissionFlags {
    bits: u16,
}

impl PermissionFlags {
    /// Bit 0: Cannot be resigned
    pub const CANNOT_BE_RESIGNED: Self = Self {
        bits: 0b0000_0000_0000_0001,
    };
}

impl PermissionFlags {
    ///  Returns an empty set of flags.
    #[inline]
    pub const fn empty() -> Self {
        Self { bits: 0 }
    }

    /// Returns the set containing all flags.
    #[inline]
    pub const fn all() -> Self {
        Self {
            bits: Self::CANNOT_BE_RESIGNED.bits,
        }
    }

    /// Returns the raw value of the flags currently stored.
    #[inline]
    pub const fn bits(&self) -> u16 {
        self.bits
    }

    /// Convert from underlying bit representation, unless that
    /// representation contains bits that do not correspond to a flag.
    #[inline]
    pub const fn from_bits(bits: u16) -> Option<Self> {
        if (bits & !Self::all().bits()) == 0 {
            Some(Self { bits })
        } else {
            None
        }
    }

    /// Convert from underlying bit representation, dropping any bits
    /// that do not correspond to flags.
    #[inline]
    pub const fn from_bits_truncate(bits: u16) -> Self {
        Self {
            bits: bits & Self::all().bits,
        }
    }

    /// Returns `true` if no flags are currently stored.
    #[inline]
    pub const fn is_empty(&self) -> bool {
        self.bits() == Self::empty().bits()
    }

    /// Returns `true` if there are flags common to both `self` and `other`.
    #[inline]
    pub const fn intersects(&self, other: Self) -> bool {
        !(Self {
            bits: self.bits & other.bits,
        })
        .is_empty()
    }

    /// Returns `true` if all of the flags in `other` are contained within `self`.
    #[inline]
    pub const fn contains(&self, other: Self) -> bool {
        (self.bits & other.bits) == other.bits
    }

    /// Inserts the specified flags in-place.
    #[inline]
    pub fn insert(&mut self, other: Self) {
        self.bits |= other.bits;
    }

    /// Removes the specified flags in-place.
    #[inline]
    pub fn remove(&mut self, other: Self) {
        self.bits &= !other.bits;
    }

    /// Toggles the specified flags in-place.
    #[inline]
    pub fn toggle(&mut self, other: Self) {
        self.bits ^= other.bits;
    }

    /// Returns the intersection between the flags in `self` and
    /// `other`.
    ///
    /// Specifically, the returned set contains only the flags which are
    /// present in *both* `self` *and* `other`.
    ///
    /// This is equivalent to using the `&` operator (e.g.
    /// [`ops::BitAnd`]), as in `flags & other`.
    ///
    /// [`ops::BitAnd`]: https://doc.rust-lang.org/std/ops/trait.BitAnd.html
    #[inline]
    #[must_use]
    pub const fn intersection(self, other: Self) -> Self {
        Self {
            bits: self.bits & other.bits,
        }
    }

    /// Returns the union of between the flags in `self` and `other`.
    ///
    /// Specifically, the returned set contains all flags which are
    /// present in *either* `self` *or* `other`, including any which are
    /// present in both.
    ///
    /// This is equivalent to using the `|` operator (e.g.
    /// [`ops::BitOr`]), as in `flags | other`.
    ///
    /// [`ops::BitOr`]: https://doc.rust-lang.org/std/ops/trait.BitOr.html
    #[inline]
    #[must_use]
    pub const fn union(self, other: Self) -> Self {
        Self {
            bits: self.bits | other.bits,
        }
    }

    /// Returns the difference between the flags in `self` and `other`.
    ///
    /// Specifically, the returned set contains all flags present in
    /// `self`, except for the ones present in `other`.
    ///
    /// It is also conceptually equivalent to the "bit-clear" operation:
    /// `flags & !other` (and this syntax is also supported).
    ///
    /// This is equivalent to using the `-` operator (e.g.
    /// [`ops::Sub`]), as in `flags - other`.
    ///
    /// [`ops::Sub`]: https://doc.rust-lang.org/std/ops/trait.Sub.html
    #[inline]
    #[must_use]
    pub const fn difference(self, other: Self) -> Self {
        Self {
            bits: self.bits & !other.bits,
        }
    }
}

impl std::ops::BitOr for PermissionFlags {
    type Output = Self;

    /// Returns the union of the two sets of flags.
    #[inline]
    fn bitor(self, other: PermissionFlags) -> Self {
        Self {
            bits: self.bits | other.bits,
        }
    }
}

impl std::ops::BitOrAssign for PermissionFlags {
    /// Adds the set of flags.
    #[inline]
    fn bitor_assign(&mut self, other: Self) {
        self.bits |= other.bits;
    }
}

impl std::ops::BitXor for PermissionFlags {
    type Output = Self;

    /// Returns the left flags, but with all the right flags toggled.
    #[inline]
    fn bitxor(self, other: Self) -> Self {
        Self {
            bits: self.bits ^ other.bits,
        }
    }
}

impl std::ops::BitXorAssign for PermissionFlags {
    /// Toggles the set of flags.
    #[inline]
    fn bitxor_assign(&mut self, other: Self) {
        self.bits ^= other.bits;
    }
}

impl std::ops::BitAnd for PermissionFlags {
    type Output = Self;

    /// Returns the intersection between the two sets of flags.
    #[inline]
    fn bitand(self, other: Self) -> Self {
        Self {
            bits: self.bits & other.bits,
        }
    }
}

impl std::ops::BitAndAssign for PermissionFlags {
    /// Disables all flags disabled in the set.
    #[inline]
    fn bitand_assign(&mut self, other: Self) {
        self.bits &= other.bits;
    }
}

impl std::ops::Sub for PermissionFlags {
    type Output = Self;

    /// Returns the set difference of the two sets of flags.
    #[inline]
    fn sub(self, other: Self) -> Self {
        Self {
            bits: self.bits & !other.bits,
        }
    }
}

impl std::ops::SubAssign for PermissionFlags {
    /// Disables all flags enabled in the set.
    #[inline]
    fn sub_assign(&mut self, other: Self) {
        self.bits &= !other.bits;
    }
}

impl std::ops::Not for PermissionFlags {
    type Output = Self;

    /// Returns the complement of this set of flags.
    #[inline]
    fn not(self) -> Self {
        Self { bits: !self.bits } & Self::all()
    }
}

impl std::fmt::Debug for PermissionFlags {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        let members: &[(&str, Self)] = &[("CANNOT_BE_RESIGNED", Self::CANNOT_BE_RESIGNED)];
        let mut first = true;
        for (name, value) in members {
            if self.contains(*value) {
                if !first {
                    f.write_str(" | ")?;
                }
                first = false;
                f.write_str(name)?;
            }
        }
        if first {
            f.write_str("(empty)")?;
        }
        Ok(())
    }
}

impl std::fmt::Binary for PermissionFlags {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::Binary::fmt(&self.bits, f)
    }
}

impl std::fmt::Octal for PermissionFlags {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::Octal::fmt(&self.bits, f)
    }
}

impl std::fmt::LowerHex for PermissionFlags {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::LowerHex::fmt(&self.bits, f)
    }
}

impl std::fmt::UpperHex for PermissionFlags {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::UpperHex::fmt(&self.bits, f)
    }
}

impl font_types::Scalar for PermissionFlags {
    type Raw = <u16 as font_types::Scalar>::Raw;
    fn to_raw(self) -> Self::Raw {
        self.bits().to_raw()
    }
    fn from_raw(raw: Self::Raw) -> Self {
        let t = <u16>::from_raw(raw);
        Self::from_bits_truncate(t)
    }
}

/// [Signature Record](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
#[derive(Clone, Debug, Copy, bytemuck :: AnyBitPattern)]
#[repr(C)]
#[repr(packed)]
pub struct SignatureRecord {
    /// Format of the signature
    pub format: BigEndian<u32>,
    /// Length of signature in bytes
    pub length: BigEndian<u32>,
    /// Offset to the signature block from the beginning of the table
    pub signature_block_offset: BigEndian<Offset32>,
}

impl SignatureRecord {
    /// Format of the signature
    pub fn format(&self) -> u32 {
        self.format.get()
    }

    /// Length of signature in bytes
    pub fn length(&self) -> u32 {
        self.length.get()
    }

    /// Offset to the signature block from the beginning of the table
    pub fn signature_block_offset(&self) -> Offset32 {
        self.signature_block_offset.get()
    }
}

impl FixedSize for SignatureRecord {
    const RAW_BYTE_LEN: usize = u32::RAW_BYTE_LEN + u32::RAW_BYTE_LEN + Offset32::RAW_BYTE_LEN;
}

impl<'a> MinByteRange<'a> for SignatureBlockFormat1<'a> {
    fn min_byte_range(&self) -> Range<usize> {
        0..self.signature_byte_range().end
    }
    fn min_table_bytes(&self) -> &'a [u8] {
        let range = self.min_byte_range();
        self.offset_data().as_bytes().get(range).unwrap_or_default()
    }
}

impl ReadArgs for SignatureBlockFormat1<'_> {
    type Args = ();
}

impl<'a> FontRead<'a> for SignatureBlockFormat1<'a> {
    fn read_with_args(data: FontData<'a>, _: ()) -> Result<Self, ReadError> {
        #[allow(clippy::absurd_extreme_comparisons)]
        if data.len() < Self::MIN_SIZE {
            return Err(ReadError::OutOfBounds);
        }
        let Some(data) = TableDataRef::new(data.as_bytes()) else {
            return Err(ReadError::OutOfBounds);
        };
        Ok(Self { data })
    }
}

/// The fields at the start of the table, which are read directly.
#[derive(Clone, Copy, bytemuck :: AnyBitPattern)]
#[repr(C, packed)]
#[doc(hidden)]
pub struct SignatureBlockFormat1FixedHeader {
    pub _reserved1: BigEndian<u16>,
    pub _reserved2: BigEndian<u16>,
    pub signature_length: BigEndian<u32>,
}

#[allow(clippy::absurd_extreme_comparisons)]
const _: () = assert!(
    std::mem::size_of::<SignatureBlockFormat1FixedHeader>() <= SignatureBlockFormat1::MIN_SIZE
);

/// [Signature Block Format 1](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
#[derive(Clone)]
pub struct SignatureBlockFormat1<'a> {
    data: TableDataRef<'a, SignatureBlockFormat1FixedHeader>,
}

#[allow(clippy::needless_lifetimes)]
impl<'a> SignatureBlockFormat1<'a> {
    pub const MIN_SIZE: usize = (u16::RAW_BYTE_LEN + u16::RAW_BYTE_LEN + u32::RAW_BYTE_LEN);
    basic_table_impls!(impl_the_methods);

    /// Length (in bytes) of the PKCS#7 packet in the signature field.
    pub fn signature_length(&self) -> u32 {
        self.data.header().signature_length.get()
    }

    /// PKCS#7 packet
    pub fn signature(&self) -> &'a [u8] {
        let range = self.signature_byte_range();
        self.offset_data()
            .read_array(range)
            .ok()
            .unwrap_or_default()
    }

    pub fn _reserved1_byte_range(&self) -> Range<usize> {
        let start = 0;
        let end = start + u16::RAW_BYTE_LEN;
        start..end
    }

    pub fn _reserved2_byte_range(&self) -> Range<usize> {
        let start = self._reserved1_byte_range().end;
        let end = start + u16::RAW_BYTE_LEN;
        start..end
    }

    pub fn signature_length_byte_range(&self) -> Range<usize> {
        let start = self._reserved2_byte_range().end;
        let end = start + u32::RAW_BYTE_LEN;
        start..end
    }

    pub fn signature_byte_range(&self) -> Range<usize> {
        let signature_length = self.signature_length();
        let start = self.signature_length_byte_range().end;
        let end = start + (transforms::to_usize(signature_length)).saturating_mul(u8::RAW_BYTE_LEN);
        start..end
    }
}

const _: () = assert!(FontData::default_data_long_enough(
    SignatureBlockFormat1::MIN_SIZE
));

impl Default for SignatureBlockFormat1<'_> {
    fn default() -> Self {
        Self {
            data: TableDataRef::new(FontData::default_table_data().as_bytes())
                .unwrap_or_else(|| unreachable!("the default data covers MIN_SIZE")),
        }
    }
}

Coverage Report

Created: 2026-10-24 07:19

Line	Count	Source
1		// THIS FILE IS AUTOGENERATED.
2		// Any changes to this file will be overwritten.
3		// For more information about how codegen works, see font-codegen/README.md
4
5		#[allow(unused_imports)]
6		use crate::codegen_prelude::*;
7
8		impl<'a> MinByteRange<'a> for Dsig<'a> {
9	0	fn min_byte_range(&self) -> Range<usize> {
10	0	0..self.signature_records_byte_range().end
11	0	}
12	0	fn min_table_bytes(&self) -> &'a [u8] {
13	0	let range = self.min_byte_range();
14	0	self.offset_data().as_bytes().get(range).unwrap_or_default()
15	0	}
16		}
17
18		impl TopLevelTable for Dsig<'_> {
19		/// `DSIG`
20		const TAG: Tag = Tag::new(b"DSIG");
21		}
22
23		impl ReadArgs for Dsig<'_> {
24		type Args = ();
25		}
26
27		impl<'a> FontRead<'a> for Dsig<'a> {
28	0	fn read_with_args(data: FontData<'a>, _: ()) -> Result<Self, ReadError> {
29		#[allow(clippy::absurd_extreme_comparisons)]
30	0	if data.len() < Self::MIN_SIZE {
31	0	return Err(ReadError::OutOfBounds);
32	0	}
33	0	let Some(data) = TableDataRef::new(data.as_bytes()) else {
34	0	return Err(ReadError::OutOfBounds);
35		};
36	0	Ok(Self { data })
37	0	}
38		}
39
40		/// The fields at the start of the table, which are read directly.
41		#[derive(Clone, Copy, bytemuck :: AnyBitPattern)]
42		#[repr(C, packed)]
43		#[doc(hidden)]
44		pub struct DsigFixedHeader {
45		pub version: BigEndian<u32>,
46		pub num_signatures: BigEndian<u16>,
47		pub flags: BigEndian<PermissionFlags>,
48		}
49
50		#[allow(clippy::absurd_extreme_comparisons)]
51		const _: () = assert!(std::mem::size_of::<DsigFixedHeader>() <= Dsig::MIN_SIZE);
52
53		/// [DSIG (Digital Signature Table)](https://docs.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure) table
54		#[derive(Clone)]
55		pub struct Dsig<'a> {
56		data: TableDataRef<'a, DsigFixedHeader>,
57		}
58
59		#[allow(clippy::needless_lifetimes)]
60		impl<'a> Dsig<'a> {
61		pub const MIN_SIZE: usize =
62		(u32::RAW_BYTE_LEN + u16::RAW_BYTE_LEN + PermissionFlags::RAW_BYTE_LEN);
63		basic_table_impls!(impl_the_methods);
64
65		/// Version number of the DSIG table (0x00000001)
66	0	pub fn version(&self) -> u32 {
67	0	self.data.header().version.get()
68	0	}
69
70		/// Number of signatures in the table
71	0	pub fn num_signatures(&self) -> u16 {
72	0	self.data.header().num_signatures.get()
73	0	}
74
75		/// Permission flags
76	0	pub fn flags(&self) -> PermissionFlags {
77	0	self.data.header().flags.get()
78	0	}
79
80		/// Array of signature records
81	0	pub fn signature_records(&self) -> &'a [SignatureRecord] {
82	0	let range = self.signature_records_byte_range();
83	0	self.offset_data()
84	0	.read_array(range)
85	0	.ok()
86	0	.unwrap_or_default()
87	0	}
88
89	0	pub fn version_byte_range(&self) -> Range<usize> {
90	0	let start = 0;
91	0	let end = start + u32::RAW_BYTE_LEN;
92	0	start..end
93	0	}
94
95	0	pub fn num_signatures_byte_range(&self) -> Range<usize> {
96	0	let start = self.version_byte_range().end;
97	0	let end = start + u16::RAW_BYTE_LEN;
98	0	start..end
99	0	}
100
101	0	pub fn flags_byte_range(&self) -> Range<usize> {
102	0	let start = self.num_signatures_byte_range().end;
103	0	let end = start + PermissionFlags::RAW_BYTE_LEN;
104	0	start..end
105	0	}
106
107	0	pub fn signature_records_byte_range(&self) -> Range<usize> {
108	0	let num_signatures = self.num_signatures();
109	0	let start = self.flags_byte_range().end;
110	0	let end = start
111	0	+ (transforms::to_usize(num_signatures)).saturating_mul(SignatureRecord::RAW_BYTE_LEN);
112	0	start..end
113	0	}
114		}
115
116		const _: () = assert!(FontData::default_data_long_enough(Dsig::MIN_SIZE));
117
118		impl Default for Dsig<'_> {
119	0	fn default() -> Self {
120		Self {
121	0	data: TableDataRef::new(FontData::default_table_data().as_bytes())
122	0	.unwrap_or_else(\|\| unreachable!("the default data covers MIN_SIZE")),
123		}
124	0	}
125		}
126
127		/// [Permission flags](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
128		#[derive(Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash, bytemuck :: AnyBitPattern)]
129		#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
130		#[repr(transparent)]
131		pub struct PermissionFlags {
132		bits: u16,
133		}
134
135		impl PermissionFlags {
136		/// Bit 0: Cannot be resigned
137		pub const CANNOT_BE_RESIGNED: Self = Self {
138		bits: 0b0000_0000_0000_0001,
139		};
140		}
141
142		impl PermissionFlags {
143		/// Returns an empty set of flags.
144		#[inline]
145	0	pub const fn empty() -> Self {
146	0	Self { bits: 0 }
147	0	}
148
149		/// Returns the set containing all flags.
150		#[inline]
151	0	pub const fn all() -> Self {
152	0	Self {
153	0	bits: Self::CANNOT_BE_RESIGNED.bits,
154	0	}
155	0	}
156
157		/// Returns the raw value of the flags currently stored.
158		#[inline]
159	0	pub const fn bits(&self) -> u16 {
160	0	self.bits
161	0	}
162
163		/// Convert from underlying bit representation, unless that
164		/// representation contains bits that do not correspond to a flag.
165		#[inline]
166	0	pub const fn from_bits(bits: u16) -> Option<Self> {
167	0	if (bits & !Self::all().bits()) == 0 {
168	0	Some(Self { bits })
169		} else {
170	0	None
171		}
172	0	}
173
174		/// Convert from underlying bit representation, dropping any bits
175		/// that do not correspond to flags.
176		#[inline]
177	0	pub const fn from_bits_truncate(bits: u16) -> Self {
178	0	Self {
179	0	bits: bits & Self::all().bits,
180	0	}
181	0	}
182
183		/// Returns `true` if no flags are currently stored.
184		#[inline]
185	0	pub const fn is_empty(&self) -> bool {
186	0	self.bits() == Self::empty().bits()
187	0	}
188
189		/// Returns `true` if there are flags common to both `self` and `other`.
190		#[inline]
191	0	pub const fn intersects(&self, other: Self) -> bool {
192	0	!(Self {
193	0	bits: self.bits & other.bits,
194	0	})
195	0	.is_empty()
196	0	}
197
198		/// Returns `true` if all of the flags in `other` are contained within `self`.
199		#[inline]
200	0	pub const fn contains(&self, other: Self) -> bool {
201	0	(self.bits & other.bits) == other.bits
202	0	}
203
204		/// Inserts the specified flags in-place.
205		#[inline]
206	0	pub fn insert(&mut self, other: Self) {
207	0	self.bits \|= other.bits;
208	0	}
209
210		/// Removes the specified flags in-place.
211		#[inline]
212	0	pub fn remove(&mut self, other: Self) {
213	0	self.bits &= !other.bits;
214	0	}
215
216		/// Toggles the specified flags in-place.
217		#[inline]
218	0	pub fn toggle(&mut self, other: Self) {
219	0	self.bits ^= other.bits;
220	0	}
221
222		/// Returns the intersection between the flags in `self` and
223		/// `other`.
224		///
225		/// Specifically, the returned set contains only the flags which are
226		/// present in both `self` and `other`.
227		///
228		/// This is equivalent to using the `&` operator (e.g.
229		/// [`ops::BitAnd`]), as in `flags & other`.
230		///
231		/// [`ops::BitAnd`]: https://doc.rust-lang.org/std/ops/trait.BitAnd.html
232		#[inline]
233		#[must_use]
234	0	pub const fn intersection(self, other: Self) -> Self {
235	0	Self {
236	0	bits: self.bits & other.bits,
237	0	}
238	0	}
239
240		/// Returns the union of between the flags in `self` and `other`.
241		///
242		/// Specifically, the returned set contains all flags which are
243		/// present in either `self` or `other`, including any which are
244		/// present in both.
245		///
246		/// This is equivalent to using the `\|` operator (e.g.
247		/// [`ops::BitOr`]), as in `flags \| other`.
248		///
249		/// [`ops::BitOr`]: https://doc.rust-lang.org/std/ops/trait.BitOr.html
250		#[inline]
251		#[must_use]
252	0	pub const fn union(self, other: Self) -> Self {
253	0	Self {
254	0	bits: self.bits \| other.bits,
255	0	}
256	0	}
257
258		/// Returns the difference between the flags in `self` and `other`.
259		///
260		/// Specifically, the returned set contains all flags present in
261		/// `self`, except for the ones present in `other`.
262		///
263		/// It is also conceptually equivalent to the "bit-clear" operation:
264		/// `flags & !other` (and this syntax is also supported).
265		///
266		/// This is equivalent to using the `-` operator (e.g.
267		/// [`ops::Sub`]), as in `flags - other`.
268		///
269		/// [`ops::Sub`]: https://doc.rust-lang.org/std/ops/trait.Sub.html
270		#[inline]
271		#[must_use]
272	0	pub const fn difference(self, other: Self) -> Self {
273	0	Self {
274	0	bits: self.bits & !other.bits,
275	0	}
276	0	}
277		}
278
279		impl std::ops::BitOr for PermissionFlags {
280		type Output = Self;
281
282		/// Returns the union of the two sets of flags.
283		#[inline]
284	0	fn bitor(self, other: PermissionFlags) -> Self {
285	0	Self {
286	0	bits: self.bits \| other.bits,
287	0	}
288	0	}
289		}
290
291		impl std::ops::BitOrAssign for PermissionFlags {
292		/// Adds the set of flags.
293		#[inline]
294	0	fn bitor_assign(&mut self, other: Self) {
295	0	self.bits \|= other.bits;
296	0	}
297		}
298
299		impl std::ops::BitXor for PermissionFlags {
300		type Output = Self;
301
302		/// Returns the left flags, but with all the right flags toggled.
303		#[inline]
304	0	fn bitxor(self, other: Self) -> Self {
305	0	Self {
306	0	bits: self.bits ^ other.bits,
307	0	}
308	0	}
309		}
310
311		impl std::ops::BitXorAssign for PermissionFlags {
312		/// Toggles the set of flags.
313		#[inline]
314	0	fn bitxor_assign(&mut self, other: Self) {
315	0	self.bits ^= other.bits;
316	0	}
317		}
318
319		impl std::ops::BitAnd for PermissionFlags {
320		type Output = Self;
321
322		/// Returns the intersection between the two sets of flags.
323		#[inline]
324	0	fn bitand(self, other: Self) -> Self {
325	0	Self {
326	0	bits: self.bits & other.bits,
327	0	}
328	0	}
329		}
330
331		impl std::ops::BitAndAssign for PermissionFlags {
332		/// Disables all flags disabled in the set.
333		#[inline]
334	0	fn bitand_assign(&mut self, other: Self) {
335	0	self.bits &= other.bits;
336	0	}
337		}
338
339		impl std::ops::Sub for PermissionFlags {
340		type Output = Self;
341
342		/// Returns the set difference of the two sets of flags.
343		#[inline]
344	0	fn sub(self, other: Self) -> Self {
345	0	Self {
346	0	bits: self.bits & !other.bits,
347	0	}
348	0	}
349		}
350
351		impl std::ops::SubAssign for PermissionFlags {
352		/// Disables all flags enabled in the set.
353		#[inline]
354	0	fn sub_assign(&mut self, other: Self) {
355	0	self.bits &= !other.bits;
356	0	}
357		}
358
359		impl std::ops::Not for PermissionFlags {
360		type Output = Self;
361
362		/// Returns the complement of this set of flags.
363		#[inline]
364	0	fn not(self) -> Self {
365	0	Self { bits: !self.bits } & Self::all()
366	0	}
367		}
368
369		impl std::fmt::Debug for PermissionFlags {
370	0	fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
371	0	let members: &[(&str, Self)] = &[("CANNOT_BE_RESIGNED", Self::CANNOT_BE_RESIGNED)];
372	0	let mut first = true;
373	0	for (name, value) in members {
374	0	if self.contains(*value) {
375	0	if !first {
376	0	f.write_str(" \| ")?;
377	0	}
378	0	first = false;
379	0	f.write_str(name)?;
380	0	}
381		}
382	0	if first {
383	0	f.write_str("(empty)")?;
384	0	}
385	0	Ok(())
386	0	}
387		}
388
389		impl std::fmt::Binary for PermissionFlags {
390	0	fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
391	0	std::fmt::Binary::fmt(&self.bits, f)
392	0	}
393		}
394
395		impl std::fmt::Octal for PermissionFlags {
396	0	fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
397	0	std::fmt::Octal::fmt(&self.bits, f)
398	0	}
399		}
400
401		impl std::fmt::LowerHex for PermissionFlags {
402	0	fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
403	0	std::fmt::LowerHex::fmt(&self.bits, f)
404	0	}
405		}
406
407		impl std::fmt::UpperHex for PermissionFlags {
408	0	fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
409	0	std::fmt::UpperHex::fmt(&self.bits, f)
410	0	}
411		}
412
413		impl font_types::Scalar for PermissionFlags {
414		type Raw = <u16 as font_types::Scalar>::Raw;
415	0	fn to_raw(self) -> Self::Raw {
416	0	self.bits().to_raw()
417	0	}
418	0	fn from_raw(raw: Self::Raw) -> Self {
419	0	let t = <u16>::from_raw(raw);
420	0	Self::from_bits_truncate(t)
421	0	}
422		}
423
424		/// [Signature Record](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
425		#[derive(Clone, Debug, Copy, bytemuck :: AnyBitPattern)]
426		#[repr(C)]
427		#[repr(packed)]
428		pub struct SignatureRecord {
429		/// Format of the signature
430		pub format: BigEndian<u32>,
431		/// Length of signature in bytes
432		pub length: BigEndian<u32>,
433		/// Offset to the signature block from the beginning of the table
434		pub signature_block_offset: BigEndian<Offset32>,
435		}
436
437		impl SignatureRecord {
438		/// Format of the signature
439	0	pub fn format(&self) -> u32 {
440	0	self.format.get()
441	0	}
442
443		/// Length of signature in bytes
444	0	pub fn length(&self) -> u32 {
445	0	self.length.get()
446	0	}
447
448		/// Offset to the signature block from the beginning of the table
449	0	pub fn signature_block_offset(&self) -> Offset32 {
450	0	self.signature_block_offset.get()
451	0	}
452		}
453
454		impl FixedSize for SignatureRecord {
455		const RAW_BYTE_LEN: usize = u32::RAW_BYTE_LEN + u32::RAW_BYTE_LEN + Offset32::RAW_BYTE_LEN;
456		}
457
458		impl<'a> MinByteRange<'a> for SignatureBlockFormat1<'a> {
459	0	fn min_byte_range(&self) -> Range<usize> {
460	0	0..self.signature_byte_range().end
461	0	}
462	0	fn min_table_bytes(&self) -> &'a [u8] {
463	0	let range = self.min_byte_range();
464	0	self.offset_data().as_bytes().get(range).unwrap_or_default()
465	0	}
466		}
467
468		impl ReadArgs for SignatureBlockFormat1<'_> {
469		type Args = ();
470		}
471
472		impl<'a> FontRead<'a> for SignatureBlockFormat1<'a> {
473	0	fn read_with_args(data: FontData<'a>, _: ()) -> Result<Self, ReadError> {
474		#[allow(clippy::absurd_extreme_comparisons)]
475	0	if data.len() < Self::MIN_SIZE {
476	0	return Err(ReadError::OutOfBounds);
477	0	}
478	0	let Some(data) = TableDataRef::new(data.as_bytes()) else {
479	0	return Err(ReadError::OutOfBounds);
480		};
481	0	Ok(Self { data })
482	0	}
483		}
484
485		/// The fields at the start of the table, which are read directly.
486		#[derive(Clone, Copy, bytemuck :: AnyBitPattern)]
487		#[repr(C, packed)]
488		#[doc(hidden)]
489		pub struct SignatureBlockFormat1FixedHeader {
490		pub _reserved1: BigEndian<u16>,
491		pub _reserved2: BigEndian<u16>,
492		pub signature_length: BigEndian<u32>,
493		}
494
495		#[allow(clippy::absurd_extreme_comparisons)]
496		const _: () = assert!(
497		std::mem::size_of::<SignatureBlockFormat1FixedHeader>() <= SignatureBlockFormat1::MIN_SIZE
498		);
499
500		/// [Signature Block Format 1](https://learn.microsoft.com/en-us/typography/opentype/spec/dsig#table-structure)
501		#[derive(Clone)]
502		pub struct SignatureBlockFormat1<'a> {
503		data: TableDataRef<'a, SignatureBlockFormat1FixedHeader>,
504		}
505
506		#[allow(clippy::needless_lifetimes)]
507		impl<'a> SignatureBlockFormat1<'a> {
508		pub const MIN_SIZE: usize = (u16::RAW_BYTE_LEN + u16::RAW_BYTE_LEN + u32::RAW_BYTE_LEN);
509		basic_table_impls!(impl_the_methods);
510
511		/// Length (in bytes) of the PKCS#7 packet in the signature field.
512	0	pub fn signature_length(&self) -> u32 {
513	0	self.data.header().signature_length.get()
514	0	}
515
516		/// PKCS#7 packet
517	0	pub fn signature(&self) -> &'a [u8] {
518	0	let range = self.signature_byte_range();
519	0	self.offset_data()
520	0	.read_array(range)
521	0	.ok()
522	0	.unwrap_or_default()
523	0	}
524
525	0	pub fn _reserved1_byte_range(&self) -> Range<usize> {
526	0	let start = 0;
527	0	let end = start + u16::RAW_BYTE_LEN;
528	0	start..end
529	0	}
530
531	0	pub fn _reserved2_byte_range(&self) -> Range<usize> {
532	0	let start = self._reserved1_byte_range().end;
533	0	let end = start + u16::RAW_BYTE_LEN;
534	0	start..end
535	0	}
536
537	0	pub fn signature_length_byte_range(&self) -> Range<usize> {
538	0	let start = self._reserved2_byte_range().end;
539	0	let end = start + u32::RAW_BYTE_LEN;
540	0	start..end
541	0	}
542
543	0	pub fn signature_byte_range(&self) -> Range<usize> {
544	0	let signature_length = self.signature_length();
545	0	let start = self.signature_length_byte_range().end;
546	0	let end = start + (transforms::to_usize(signature_length)).saturating_mul(u8::RAW_BYTE_LEN);
547	0	start..end
548	0	}
549		}
550
551		const _: () = assert!(FontData::default_data_long_enough(
552		SignatureBlockFormat1::MIN_SIZE
553		));
554
555		impl Default for SignatureBlockFormat1<'_> {
556	0	fn default() -> Self {
557		Self {
558	0	data: TableDataRef::new(FontData::default_table_data().as_bytes())
559	0	.unwrap_or_else(\|\| unreachable!("the default data covers MIN_SIZE")),
560		}
561	0	}
562		}