nvtiffDecode()¶
Decodes image data on the GPU which is specified in tiff_stream
.
Each image in the TIFF file is copied into the respective buffer pointed to by “imageOut_d”. This function is fully asynchronous.
Signature:
nvtiffStatus_t nvtiffDecode(nvtiffStream_t tiff_stream,
nvtiffDecoder_t nvtiff_decoder,
unsigned char **image_out,
cudaStream_t cuda_stream);
Parameters:
Parameter |
Input/Output |
Memory |
Description |
---|---|---|---|
nvtiffStream_t tiff_stream |
Input |
Host |
|
nvtiffDecoder_t nvtiff_decoder |
Input |
Host |
decoder handle |
unsigned char **imageOut_d |
Output |
Host |
host array (of size num_images in the TIFF file) of pointers to device buffers.Each device buffer should have a size of image_width * image height * bitdepth * samples_per_pixel |
cudaStream_t cuda_stream |
Input |
Host |
|
Returns:
nvtiffStatus_t
- An error code as specified in Version 2 API Return Status Codes
nvtiffDecodeRange()¶
This function is similar to nvtiffDecode()
. It allows the user to specify a range of images to be decoded
(instead of decoding all images in the file).
Signature:
nvtiffStatus_t NVTIFFAPI nvtiffDecodeRange(nvtiffStream_t tiff_stream,
nvtiffDecoder_t decoder,
unsigned int sub_file_start,
unsigned int sub_file_num,
unsigned char **image_out,
cudaStream_t cuda_stream);
Parameters:
Parameter |
Input/Output |
Memory |
Description |
---|---|---|---|
nvtiffStream_t tiff_stream |
Input |
Host |
|
nvtiffDecoder_t nvtiff_decoder |
Input |
Host |
decoder handle |
unsigned int sub_file_start |
Input |
Host |
index of the first image to decode, in [0, tiff_info.num_sub_files). |
unsigned int sub_file_num |
Input |
Host |
number of images to decode starting from |
unsigned char **imageOut_d |
Output |
Host |
host array (of size num_images in the TIFF file) of pointers to device buffers.Each device buffer should have a size of image_width * image height * bitdepth * samples_per_pixel |
cudaStream_t cuda_stream |
Input |
Host |
|
Returns:
nvtiffStatus_t
- An error code as specified in Version 2 API Return Status Codes