Brightness

ImageData.Brightness property

获取或设置图片的亮度。 此属性的值必须是从 0.0(最暗)到 1.0(最亮)的数字。

public double Brightness { get; set; }

评论

默认值为 0.5。

例子

显示如何编辑形状的图像数据。

Document imgSourceDoc = new Document(MyDir + "Images.docx");
Shape sourceShape = (Shape)imgSourceDoc.GetChildNodes(NodeType.Shape, true)[0];

Document dstDoc = new Document();

 // 从源文档中导入一个形状并将其附加到第一段。
Shape importedShape = (Shape)dstDoc.ImportNode(sourceShape, true);
dstDoc.FirstSection.Body.FirstParagraph.AppendChild(importedShape);

 // 导入的形状包含一个图像。我们可以通过 ImageData 对象访问图像的属性和原始数据。
ImageData imageData = importedShape.ImageData;
imageData.Title = "Imported Image";

Assert.True(imageData.HasImage);

 // 如果图像没有边框,它的 ImageData 对象将定义边框颜色为空。
Assert.AreEqual(4, imageData.Borders.Count);
Assert.AreEqual(Color.Empty, imageData.Borders[0].Color);

 // 此图像未链接到本地文件系统中的另一个形状或图像文件。
Assert.False(imageData.IsLink);
Assert.False(imageData.IsLinkOnly);

 // “亮度”和“对比度”属性定义图像亮度和对比度
 // 在 0-1 范围内,默认值为 0.5.
imageData.Brightness = 0.8;
imageData.Contrast = 1.0;

 // 上面的亮度和对比度值已经创建了一个有很多白色的图像。
 // 我们可以用 ChromaKey 属性选择一种颜色来替换为透明度,比如 white.
imageData.ChromaKey = Color.White;

// 再次导入源形状并将图像设置为单色.
importedShape = (Shape)dstDoc.ImportNode(sourceShape, true);
dstDoc.FirstSection.Body.FirstParagraph.AppendChild(importedShape);

importedShape.ImageData.GrayScale = true;

 // 再次导入源形状以创建第三个图像并将其设置为 BiLevel.
 // BiLevel 将每个像素设置为黑色或白色,以更接近原始颜色为准。
importedShape = (Shape)dstDoc.ImportNode(sourceShape, true);
dstDoc.FirstSection.Body.FirstParagraph.AppendChild(importedShape);

importedShape.ImageData.BiLevel = true;

 // 裁剪以 0-1 的比例确定。将一侧裁剪 0.3
 // 将在裁剪侧裁剪 30% 的图像。
importedShape.ImageData.CropBottom = 0.3;
importedShape.ImageData.CropLeft = 0.3;
importedShape.ImageData.CropTop = 0.3;
importedShape.ImageData.CropRight = 0.3;

dstDoc.Save(ArtifactsDir + "Drawing.ImageData.docx");

也可以看看