SetOverlayImage方法

总结

为某个索引设置覆盖图像。

语法

objective - c

c++

Java

公共无效SetOverlayImage (int指数，RasterImageoverlayImage，RasterGetSetOverlayImageMode模式）

公共子SetOverlayImage (_按值传递指数作为整数, _按值传递overlayImage作为RasterImage, _按值传递模式作为RasterGetSetOverlayImageMode＿）

- (BOOL)setOverlay:(nullable LTRasterImage *)overlayImageforImageAtIndex:(NSInteger)指数模式:(LTRasterGetSetOverlayImageMode)模式错误:错误(NSError * *)

公共无效setOverlayImage (int指数，RasterImageoverlayImage，RasterGetSetOverlayImageMode模式）

公共：无效SetOverlayImage (int指数，RasterImage ^overlayImage，RasterGetSetOverlayImageMode模式）

参数

指数
要为其设置图像的覆盖的索引。该索引是从零开始的，应该小于或等于MaxOverlays．

overlayImage
新的叠加图像。这可以是零，在这种情况下，相应的覆盖图像将被释放。

模式
决定如何插入图像，可能的值有:

模式	描述
RasterGetSetOverlayImageMode。复制	的副本overlayImage插入到叠加列表中。
RasterGetSetOverlayImageMode。NoCopy	overlayImage设置到覆盖列表中，无需复制。修改的时候一定要小心overlayImage因为您可以修改/使叠加图像列表中的条目无效。
RasterGetSetOverlayImageMode。移动	overlayImage被移动到覆盖列表中。它也将被处置，因此您不能对其进行更改。这是推荐的RasterGetSetOverlayImageMode。NoCopy．

讲话

方法中提供了此方法(文档/医疗只有)工具包。

使用设置的有效图像调用此方法overlayImage释放指定索引处的旧覆盖图像，并将索引处的覆盖图像设置为引用的新图像overlayImage．

如果overlayImage是零，旧的叠加图像被释放，大小重置为:

OverlayWidth =图像。OverlayImage.Origin.X OverlayHeight = Image。ImageHeight - OverlayImage.Origin.Y

如果模式是RasterGetSetOverlayImageMode。NoCopy和overlayImage不是零(无)，图像按原样插入到叠加数组中。这意味着无论何时更新来自的数据overlayImage，叠加图像也随之改变。在使用此标志时应该非常小心，因为您可以使存储在数组中的覆盖图像无效。例如，如果您处置覆盖图像，覆盖图像从内部数组指向的数据也被释放，但数组不知道这已经发生，并认为数据指针仍然有效。如果以某种方式访问覆盖图像，将发生崩溃。更安全的快速设置数据的方法是使用RasterGetSetOverlayImageMode。移动．

如果模式是RasterGetSetOverlayImageMode。移动，数据来自overlayImage复制到覆盖数组，然后overlayImage对象被处置。这意味着您可以使用overlayImage对象和存储在数组中的覆盖图像将不受影响。这是设置叠加图像最有效的方法，因为不会发生复制。overlayImage必须引用1位的图像，否则，此方法将抛出异常。

有关更多信息，请参阅覆盖概述．

例子

示例请参见GetOverlayImage

需求

目标平台

另请参阅