writeRegion

R2026b

Class: ImageAdapter

(Not recommended) Write block of data to region of image

The writeRegion method of the ImageAdapter class is not recommended. Instead of ImageAdapter, use a blockedImage object. For more information, see Version History.

Syntax

writeRegion(adapter,region_start,region_data)


Description

writeRegion(adapter,region_start,region_data) writes a contiguous block of data region_data to the region of the image with top-left pixel at coordinate region_start.

Input Arguments

adapter — Image adapter

ImageAdapter

Image adapter, specified as an instance of an ImageAdapter.

region_start — Top-left coordinates of region

2-element vector of positive integers

Top-left coordinates of the region to write, specified as a 2-element vector of positive integers of the form [row column].

region_data — Image data

numeric array

Image data, specified as a numeric array.

Tips

• When you construct a class that inherits from the ImageAdapter class, you can optionally implement this method to enable incremental, region-based writing of images. Image adapter classes that do not implement the writeRegion method are read-only.

Version History

Introduced in R2010a

R2026b: ImageAdapter.writeRegion is not recommended

The writeRegion method of the ImageAdapter class is not recommended. Instead, use a blockedImage object. The blockedImage object provides several advantages, including built-in adapters for common image formats. For unsupported formats, create a custom adapter by subclassing images.blocked.Adapter.

If your image format is supported by blockedImage, update your code by using the setBlock function of blockedImage. For unsupported image formats, use the setIOBlock function of images.blocked.Adapter.