pedrocr / rawloader

rust library to extract the raw data and some metadata from digital camera images
GNU Lesser General Public License v2.1
314 stars 54 forks source link

more examples #31

Open ovisan opened 4 years ago

ovisan commented 4 years ago

Hi,

So glad you made this library, thank you! Can you please add more examples, besides ppm? Maybe also a link to a good learning resource.

pedrocr commented 4 years ago

See imagepipe and chimper for practical uses of the library:

https://github.com/pedrocr/imagepipe/ https://github.com/pedrocr/chimper

aaronleopold commented 3 years ago

Does this library have any support for conversion operations? Such as CR2 -> JPG?

pedrocr commented 3 years ago

@aaronleopold rawloader only deals with interpreting and decoding the raw data itself, it doesn't process it in any way. imagepipe is what you want if you want to create an RGB image as that requires a raw processing pipeline to convert the raw data into RGB output with proper demosaic, white balance, levels, etc. You can then write that image out to a jpeg. The converter binary in imagepipe includes a full JPG output from any raw file that you can use as a guide:

https://github.com/pedrocr/imagepipe/blob/d95a17f7a55c7d6fb73d8006791a9436e80de10c/src/bin/converter.rs

This just uses the default values for the operations. imagepipe operations have options that can be set to use different whitebalance, color conversion, crop, rotate, etc.

Documenting imagepipe a bit more would be a good first issue. I'll put that in that project.

aaronleopold commented 3 years ago

@pedrocr Thank you so much for the detailed reply!! I'll look at the linked file for reference!

pedrocr commented 3 years ago

More than welcome. If you want to discuss anything live I have IRC always running on #chimper irc.freenode.net. I may not always be available but I'll eventually reply, and check it often.

qarmin commented 2 years ago

It is possible to use this library to extend extension number supported byimage-rs? I can't find anywhere example how to decode image in this library and results pass to image-rs.

pedrocr commented 2 years ago

@qarmin see my comment above with the link to imagepipe. That converter example uses the image crate and so does chimper.

qarmin commented 2 years ago

Well, if I read this correctly, then decoded image from rawloader is not used in any other place, so still I don't know how to use this https://github.com/pedrocr/imagepipe/blob/d95a17f7a55c7d6fb73d8006791a9436e80de10c/src/bin/converter.rs#L36-L39

                if file_entry.path.to_string_lossy().ends_with(".cr2"){
                    let raw_image = match rawloader::decode_file(&file_entry.path){
                        Ok(t) => t,
                        Err(e) => {
                            println!("Failed to process image {:?}, reason {}", file_entry.path,e);
                            return Some(Some((file_entry,Vec::new())));
                        }
                    };

                    raw_image.
                    match raw_image.data{
                        RawImageData::Integer(vec_16) => {
                            vec_16.u
                        }
                        RawImageData::Float(vec_32) => {

                        }
                    }
                    // image = image::load_from_memory(raw_image.data);
}

For now I wrote this code, but I don't know how to convert vec_16 or vec_32 to &[u8] needed by load_from_memory and I'm not sure if it will work.

pedrocr commented 2 years ago

That part is only used to print out some metadata. The actual decode and conversion is just this call:

https://github.com/pedrocr/imagepipe/blob/d95a17f7a55c7d6fb73d8006791a9436e80de10c/src/bin/converter.rs#L53-L56

It gives you an 8bit output directly no matter what the internal pipeline needed to do to achieve that.

That can then be used with the image crate:

https://github.com/pedrocr/imagepipe/blob/d95a17f7a55c7d6fb73d8006791a9436e80de10c/src/bin/converter.rs#L67-L71

That's the simplest API. If you want to change settings then you need to actually setup a pipeline:

https://github.com/pedrocr/imagepipe/blob/12269f04ac2fa0d165fc860d853ca828a8b8de3e/src/lib.rs#L22-L25

and then you can alter the conversion settings of the pipeline, by writing to pipeline.ops.*. The pipeline also has a 16bit output option which is useful if you want to use an 16bit format with the image crate.