readEncodedStrip

Read data from specified strip

collapse all in page

Syntax

stripData = readEncodedStrip(t,stripNumber)
[Y,Cb,Cr] = readEncodedStrip(t,stripNumber)

Description

stripData = readEncodedStrip(t,stripNumber) returns the image data from the strip specified by stripNumber from the TIFF file represented by the Tiff object t.

The readEncodedStrip function trims the area in a strip that falls outside of the ImageLength boundary. Therefore, image data from a strip at the bottom edge of the image can have different dimensions.

example

[Y,Cb,Cr] = readEncodedStrip(t,stripNumber) returns the YCbCr components of the strip data specified by stripNumber from the TIFF file represented by the Tiff object t. Use this syntax only with images that have a YCbCr photometric interpretation.

Depending upon the values of the YCbCrSubSampling tag, the size of the Cb component can differ from the Y component.

example

Examples

collapse all

Open Live Script

Read a strip of image data from a TIFF file that contains an image with a stripped layout.

t = Tiff('peppers_RGB_stripped.tif','r');

Determine the number of strips and the length of the strip in the image. 

numberOfStrips(t)
ans = 
6

getTag(t,'RowsPerStrip')
ans = 
35

Read and display the third strip of the image. The readEncodedStrip function trims the area in a strip that falls outside of the ImageLength boundary. Therefore, image data from a strip at the bottom edge of the image can have different dimensions.

strip = readEncodedStrip(t,3);
imshow(strip);
title('3^{rd} Strip Peppers Image');

Figure contains an axes object. The hidden axes object with title 3 toThePowerOf rd baseline Strip Peppers Image contains an object of type image.

Close the Tiff object.

close(t);
Open Live Script

Read a strip of image data from a YCbCr TIFF file that contains an image with a stripped layout.

t = Tiff('peppers_YCbCr_stripped.tif','r');

Determine the number of strips and the length of each strip in the image. 

numberOfStrips(t)
ans = 
6

getTag(t,'RowsPerStrip')
ans = 
35

Read and display the Y component of the third strip of the image. The readEncodedStrip function trims the area in a strip that falls outside of the ImageLength boundary. Therefore, image data from a strip at the bottom edge of the image can have different dimensions.

[Y,Cb,Cr] = readEncodedStrip(t,3);
imshow(Y);
title('3^{rd} Strip of Peppers Image (YCbCr)')

Figure contains an axes object. The hidden axes object with title 3 toThePowerOf rd baseline blank Strip blank of blank Peppers blank Image blank (YCbCr) contains an object of type image.

Close the Tiff object.

close(t);

Input Arguments

collapse all

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

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

Example: 15

Data Types: double

Output Arguments

collapse all

Strip data, returned as a numeric array.

Luma component of the strip data, returned as a two-dimensional numeric array.

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

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

Limitations

  • readEncodedStrip returns image data from SVS files as RGB data only, even for SVS files with YCbCr photometric interpretation.

Algorithms

collapse all

Version History

Introduced in R2009b

See Also

| |

Topics