IWritableBitmapDataSetPixel Method

KGy SOFT Drawing Libraries Help
Sets the color of the pixel at the specified coordinates.
See the Remarks section for details.

Namespace:  KGySoft.Drawing.Imaging
Assembly:  KGySoft.Drawing (in KGySoft.Drawing.dll) Version: 5.1.0
Syntax

void SetPixel(
	int x,
	int y,
	Color color
)

Parameters

x
Type: SystemInt32
The x-coordinate of the pixel to set.
y
Type: SystemInt32
The y-coordinate of the pixel to set.
color
Type: System.DrawingColor
A Color structure that represents the color to assign to the specified pixel.
Exceptions

ExceptionCondition
ArgumentOutOfRangeExceptionx is less than zero or is greater than or equal to Width.
-or-
y is less than zero or is greater than or equal to Height.
Remarks

If multiple pixels need to be set process the bitmap line by line for better performance.

Line by line processing is also possible by obtaining the first row by the FirstRow property, setting the pixels by the IWritableBitmapDataRow members and then moving to the next line by the MoveNextRow property.

The color argument represents a straight (non-premultiplied) color with gamma correction γ = 2.2, regardless of the underlying PixelFormat. To access the actual PixelFormat-dependent raw value obtain a row and use the WriteRaw method.

If the color to be set is not supported by owner Bitmap, then it will be quantized to a supported color value.

Note Note
For information about the possible usable PixelFormats on different platforms see the Remarks section of the ConvertPixelFormat method.
Note Note
See the Examples section of the GetReadWriteBitmapData method for an example.
See Also

Reference