| 1 |
//! How to read samples (a grid of `f32`, `f16` or `u32` values). |
| 2 |
|
| 3 |
use crate::image::*; |
| 4 |
use crate::meta::header::{Header}; |
| 5 |
use crate::error::{Result, UnitResult}; |
| 6 |
use crate::block::lines::LineRef; |
| 7 |
use crate::math::Vec2; |
| 8 |
use crate::meta::attribute::{ChannelDescription, SampleType}; |
| 9 |
use crate::image::read::any_channels::{SamplesReader, ReadSamples}; |
| 10 |
use crate::image::read::levels::{ReadSamplesLevel, ReadAllLevels, ReadLargestLevel}; |
| 11 |
use crate::block::chunk::TileCoordinates; |
| 12 |
// use crate::image::read::layers::ReadChannels; |
| 13 |
|
| 14 |
/// Specify to read only flat samples and no "deep data" |
| 15 |
// FIXME do not throw error on deep data but just skip it! |
| 16 |
#[derive(Debug, Copy, Clone, Eq, PartialEq)] |
| 17 |
pub struct ReadFlatSamples; |
| 18 |
// pub struct ReadAnySamples; |
| 19 |
|
| 20 |
impl ReadFlatSamples { |
| 21 |
|
| 22 |
// TODO |
| 23 |
// e. g. `let sum = reader.any_channels_with(|sample, sum| sum += sample)` |
| 24 |
// pub fn any_channels_with <S> (self, storage: S) -> { } |
| 25 |
|
| 26 |
/// Specify to read only the highest resolution level, skipping all smaller variations. |
| 27 |
pub fn largest_resolution_level(self) -> ReadLargestLevel<Self> { ReadLargestLevel { read_samples: self } } |
| 28 |
|
| 29 |
/// Specify to read all contained resolution levels from the image, if any. |
| 30 |
pub fn all_resolution_levels(self) -> ReadAllLevels<Self> { ReadAllLevels { read_samples: self } } |
| 31 |
|
| 32 |
// TODO pub fn specific_resolution_level<F: Fn(&[Vec2<usize>])->usize >(self, select_level: F) -> ReadLevelBy<Self> { ReadAllLevels { read_samples: self } } |
| 33 |
} |
| 34 |
|
| 35 |
|
| 36 |
/*pub struct AnySamplesReader { TODO |
| 37 |
resolution: Vec2<usize>, |
| 38 |
samples: DeepAndFlatSamples |
| 39 |
}*/ |
| 40 |
|
| 41 |
/// Processes pixel blocks from a file and accumulates them into a grid of samples, for example "Red" or "Alpha". |
| 42 |
#[derive(Debug, Clone, PartialEq)] |
| 43 |
pub struct FlatSamplesReader { |
| 44 |
level: Vec2<usize>, |
| 45 |
resolution: Vec2<usize>, |
| 46 |
samples: FlatSamples |
| 47 |
} |
| 48 |
|
| 49 |
|
| 50 |
// only used when samples is directly inside a channel, without levels |
| 51 |
impl ReadSamples for ReadFlatSamples { |
| 52 |
type Reader = FlatSamplesReader; |
| 53 |
|
| 54 |
fn create_sample_reader(&self, header: &Header, channel: &ChannelDescription) -> Result<Self::Reader> { |
| 55 |
self.create_samples_level_reader(header, channel, Vec2(0, 0), header.layer_size) |
| 56 |
} |
| 57 |
} |
| 58 |
|
| 59 |
impl ReadSamplesLevel for ReadFlatSamples { |
| 60 |
type Reader = FlatSamplesReader; |
| 61 |
|
| 62 |
fn create_samples_level_reader(&self, _header: &Header, channel: &ChannelDescription, level: Vec2<usize>, resolution: Vec2<usize>) -> Result<Self::Reader> { |
| 63 |
Ok(FlatSamplesReader { |
| 64 |
level, resolution, // TODO sampling |
| 65 |
samples: match channel.sample_type { |
| 66 |
SampleType::F16 => FlatSamples::F16(vec![f16::ZERO; resolution.area()]), |
| 67 |
SampleType::F32 => FlatSamples::F32(vec![0.0; resolution.area()]), |
| 68 |
SampleType::U32 => FlatSamples::U32(vec![0; resolution.area()]), |
| 69 |
} |
| 70 |
}) |
| 71 |
} |
| 72 |
} |
| 73 |
|
| 74 |
|
| 75 |
impl SamplesReader for FlatSamplesReader { |
| 76 |
type Samples = FlatSamples; |
| 77 |
|
| 78 |
fn filter_block(&self, tile: TileCoordinates) -> bool { |
| 79 |
tile.level_index == self.level |
| 80 |
} |
| 81 |
|
| 82 |
fn read_line(&mut self, line: LineRef<'_>) -> UnitResult { |
| 83 |
let index = line.location; |
| 84 |
let resolution = self.resolution; |
| 85 |
|
| 86 |
// the index is generated by ourselves and must always be correct |
| 87 |
debug_assert_eq!(index.level, self.level, "line should have been filtered"); |
| 88 |
debug_assert!(index.position.x() + index.sample_count <= resolution.width(), "line index calculation bug"); |
| 89 |
debug_assert!(index.position.y() < resolution.height(), "line index calculation bug"); |
| 90 |
debug_assert_ne!(resolution.0, 0, "sample size bug"); |
| 91 |
|
| 92 |
let start_index = index.position.y() * resolution.width() + index.position.x(); |
| 93 |
let end_index = start_index + index.sample_count; |
| 94 |
|
| 95 |
debug_assert!( |
| 96 |
start_index < end_index && end_index <= self.samples.len(), |
| 97 |
"for resolution {:?}, this is an invalid line: {:?}", |
| 98 |
self.resolution, line.location |
| 99 |
); |
| 100 |
|
| 101 |
match &mut self.samples { |
| 102 |
FlatSamples::F16(samples) => |
| 103 |
line.read_samples_into_slice(&mut samples[start_index .. end_index]) |
| 104 |
.expect("writing line bytes failed"), |
| 105 |
|
| 106 |
FlatSamples::F32(samples) => |
| 107 |
line.read_samples_into_slice(&mut samples[start_index .. end_index]) |
| 108 |
.expect("writing line bytes failed"), |
| 109 |
|
| 110 |
FlatSamples::U32(samples) => |
| 111 |
line.read_samples_into_slice(&mut samples[start_index .. end_index]) |
| 112 |
.expect("writing line bytes failed"), |
| 113 |
} |
| 114 |
|
| 115 |
Ok(()) |
| 116 |
} |
| 117 |
|
| 118 |
fn into_samples(self) -> FlatSamples { |
| 119 |
self.samples |
| 120 |
} |
| 121 |
} |
| 122 |
|