dpxread

Read DPX image

collapse all in page

Syntax

X = dpxread(filename)

Description

X = dpxread(filename) reads image data from the DPX file specified by filename, returning the image X.

Digital Picture Exchange (DPX) is an ANSI standard file format commonly used for still-frame storage in digital intermediate post-production facilities and film labs.

example

Examples

collapse all

Open Live Script

Read image from DPX file into the workspace.

RGB = dpxread('peppers.dpx');

Create a scale factor based on the data range of the image data. The image needs to be scaled to span the 16-bit data range expected by imshow.

maxOfDataRange = 2^12 - 1;
scaleFactor = intmax('uint16') / maxOfDataRange;

Display the image.

figure
imshow(RGB * scaleFactor)

Figure contains an axes object. The hidden axes object contains an object of type image.

Input Arguments

collapse all

Name of a DPX file, specified as a string scalar or character vector. filename can contain the absolute path to the file, the name of a file on the MATLAB® path, or a relative path.

Example: RGB = dpxread('peppers.dpx');

Data Types: char | string

Output Arguments

collapse all

Image data from DPX file, returned as a numeric array of class uint8 or uint16, depending on the bit depth of the pixels in filename.

Version History

Introduced in R2015b

See Also