Tightened the source code and README documentations in the library.
This commit is contained in:
@@ -1,18 +1,16 @@
|
||||
extension Graphics {
|
||||
/// An 8×8 two-color pattern: 8 rows of image data followed by 8 rows of mask.
|
||||
/// An 8×8 pattern. Mirrors `LCDPattern`: 8 image rows then 8 mask rows,
|
||||
/// one byte per row, one bit per pixel.
|
||||
public struct Pattern: Sendable {
|
||||
/// The pattern's 8 rows of image data followed by 8 rows of mask,
|
||||
/// one byte per row.
|
||||
public var bytes: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
|
||||
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8)
|
||||
|
||||
/// Creates a pattern from 8 rows of image data and 8 rows of mask.
|
||||
public init(bytes: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
|
||||
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8)) {
|
||||
self.bytes = bytes
|
||||
}
|
||||
|
||||
/// Creates an opaque pattern from 8 rows of image data.
|
||||
/// An opaque pattern (mask rows all `0xff`).
|
||||
public init(rows r: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8)) {
|
||||
bytes = (r.0, r.1, r.2, r.3, r.4, r.5, r.6, r.7,
|
||||
0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff)
|
||||
@@ -20,24 +18,20 @@ extension Graphics {
|
||||
}
|
||||
}
|
||||
|
||||
// InlineArray needs macOS 26 on the host, so these conveniences are gated
|
||||
// there while the tuple API keeps working on older systems. The device and
|
||||
// Linux have no such restriction. Both representations are 16 contiguous
|
||||
// bytes, so converting between them is a reinterpretation, not a copy.
|
||||
// InlineArray needs macOS 26 on the host; device and Linux are unrestricted.
|
||||
// Conversions reinterpret the same 16 bytes.
|
||||
@available(macOS 26, *)
|
||||
extension Graphics.Pattern {
|
||||
/// Creates a pattern from 8 rows of image data and 8 rows of mask.
|
||||
public init(bytes: [16 of UInt8]) {
|
||||
self.init(bytes: unsafeBitCast(bytes, to: Bytes.self))
|
||||
}
|
||||
|
||||
/// Creates an opaque pattern from 8 rows of image data.
|
||||
/// An opaque pattern (mask rows all `0xff`).
|
||||
public init(rows: [8 of UInt8]) {
|
||||
self.init(bytes: [16 of UInt8] { $0 < 8 ? rows[$0] : 0xff })
|
||||
}
|
||||
|
||||
/// The pattern's bytes as an inline array: 8 rows of image data
|
||||
/// followed by 8 rows of mask.
|
||||
/// `bytes` as an inline array.
|
||||
public var inlineBytes: [16 of UInt8] {
|
||||
get { unsafeBitCast(bytes, to: [16 of UInt8].self) }
|
||||
set { bytes = unsafeBitCast(newValue, to: Bytes.self) }
|
||||
|
||||
Reference in New Issue
Block a user