writeEncodedStrip

Write data to specified strip

Syntax

writeEncodedStrip(t,stripNumber,imageData)

writeEncodedStrip(t,stripNumber,Y,Cb,Cr)

Description

writeEncodedStrip(t,stripNumber,imageData) writes imageData to the strip specified by stripNumber to the TIFF file associated with the Tiff object t.

writeEncodedStrip(t,stripNumber,Y,Cb,Cr) writes the YCbCr component data to the strip specified by stripNumber to the TIFF file associated with the Tiff object t. To use this syntax, you must set the value of the YCbCrSubSampling tag.

Examples

Write Image Strip to TIFF File

Read two strips from a TIFF file and write them to a new TIFF file in different positions.

Open a TIFF file with image data in stripped layout, get the image data and the number of strips in the image.

tr = Tiff('peppers_RGB_stripped.tif','r');
imageR = read(tr);
nStrips = numberOfStrips(tr)

nStrips = 
6

Read the 2nd and 5th strips of the image.

stripTwo = readEncodedStrip(tr,2);
stripFive = readEncodedStrip(tr,5);

Create a Tiff object for a new file and copy the image and tag information from the first file.

tw = Tiff('write_strip.tif','w');
tagstruct.ImageLength = getTag(tr,'ImageLength');
tagstruct.ImageWidth =  getTag(tr,'ImageWidth');
tagstruct.Photometric = getTag(tr,'Photometric');
tagstruct.RowsPerStrip = getTag(tr,'RowsPerStrip');
tagstruct.BitsPerSample = getTag(tr,'BitsPerSample');
tagstruct.SamplesPerPixel = getTag(tr,'SamplesPerPixel');
tagstruct.PlanarConfiguration = getTag(tr,'PlanarConfiguration');  
setTag(tw,tagstruct); 
write(tw,imageR)

Write stripFive in the position for strip number 2 and stripTwo in the position for strip number 5.

writeEncodedStrip(tw,2,stripFive);
writeEncodedStrip(tw,5,stripTwo);

Read and display the new image next to the original image.

imageW = read(tw);
subplot(121);
imshow(imageR); 
title('Original Image')
subplot(122);
imshow(imageW); 
title('Strips Shuffled Image')

Close the Tiff objects.

close(tr);
close(tw);

Write Image Strip to YCbCr TIFF File

Read two strips from a YCbCr TIFF file and write them to a new TIFF file in different positions.

Open a TIFF file containing YCbCr image data in stripped layout, get the image data and the number of strips in the image.

tr = Tiff('peppers_YCbCr_stripped.tif','r');
[Yr,Cbr,Crr] = read(tr);
nStrips = numberOfStrips(tr)

nStrips = 
6

Read the 2nd and 5th strips of the image.

[Y2,Cb2,Cr2] = readEncodedStrip(tr,2);
[Y5,Cb5,Cr5] = readEncodedStrip(tr,5);

Create a Tiff object for a new file and copy the image and tag information from the first file.

tw = Tiff('write_strip.tif','w');
tagstruct.ImageLength = getTag(tr,'ImageLength');
tagstruct.ImageWidth =  getTag(tr,'ImageWidth');
tagstruct.SampleFormat = getTag(tr,'SampleFormat');
tagstruct.Photometric = getTag(tr,'Photometric');
tagstruct.RowsPerStrip = getTag(tr,'RowsPerStrip');
tagstruct.BitsPerSample = getTag(tr,'BitsPerSample');
tagstruct.SamplesPerPixel = getTag(tr,'SamplesPerPixel');
tagstruct.YCbCrSubSampling = getTag(tr,'YCbCrSubSampling');
tagstruct.Compression = getTag(tr,'Compression');
tagstruct.PlanarConfiguration = getTag(tr,'PlanarConfiguration');  
setTag(tw,tagstruct); 
write(tw,Yr,Cbr,Crr)

Write strip number 5 in the position for strip number 2 and strip number 2 in the position for strip number 5.

writeEncodedStrip(tw,2,Y5,Cb5,Cr5);
writeEncodedStrip(tw,5,Y2,Cb2,Cr2);

Read and display the Y component of the new image next to the original image.

[Yw,Crw,Cbw] = read(tw);
subplot(121);
imshow(Yr); 
title('Original Image (Y)')
subplot(122);
imshow(Yw); 
title('Strips Shuffled Image (Y)')

Close the Tiff objects.

close(tr);
close(tw);

Input Arguments

t — Tiff object

Tiff object

Tiff object representing a TIFF file. Use the Tiff function to create the object.

stripNumber — Strip number

positive integer

Strip number, specified as a positive integer. Strip numbers are one-based numbers.

Example: 15

Data Types: double

imageData — Image data

numeric array

Image data, specified as a numeric array.

• If imageData has more number of bytes than the size of the strip, then writeEncodedStrip issues a warning and truncates the data.

• If imageData has fewer number of bytes than the size of the strip, then writeEncodedStrip silently pads the strip.

To determine the size of the strip, view the value of the RowsPerStrip tag.

Data Types: double

Y — Luma component

numeric array

Luma component of the image data, specified as a two-dimensional numeric array.

Data Types: double

Cb — Blue-difference chroma component

numeric array

Blue-difference chroma component of the image data, specified as a two-dimensional numeric array.

Data Types: double

Cr — Red-difference chroma component

numeric array

Red-difference chroma component of the image data, specified as a two-dimensional numeric array.

Data Types: double

Algorithms

References

This function corresponds to the TIFFWriteEncodedStrip function in the LibTIFF C API. To use this function, you must be familiar with the TIFF specification and technical notes. View this documentation at LibTIFF - TIFF Library and Utilities.

Version History

Introduced in R2009b