←Select platform

RasterColor Structure

Summary

Describes a color consisting of relative intensities of alpha, red, green, and blue.

Syntax

Java

Objective-C

WinRT C#

C++

[SerializableAttribute()] 
public struct RasterColor : System.ValueType

<SerializableAttribute()> 
Public Structure RasterColor  
   Inherits System.ValueType

[SerializableAttribute()] 
public class RasterColor

@interface LTRasterColor : NSObject <NSCopying, NSCoding>

public final class RasterColor

JAVASCRIPT_NOSTRUCTS

[SerializableAttribute()] 
public value class RasterColor : public System.ValueType

Remarks

The LEADTOOLS RasterColor class provides a platform independent representation of an ARGB color that can be used in any platform supported by LEADTOOLS such as GDI, GDI+, WPF and Silverlight.

To convert a LEADTOOLS RasterColor object to/from a device dependent color, you can either use the various properties of methods of this class (such as the A, R, G, B properties and the RasterColor(int alpha, int red, int green, int blue) constructor) directly, or use the following helper classes:

Leadtools.Drawing.RasterColorConverter to convert to/from a System.Drawing (GDI+) System.Drawing.Color object.
Leadtools.Windows.Media.RasterColorConverter to convert to/from a System.Windows.Media.Color (WPF and Silverlight) System.Windows.Media.Color object.

In the Document and Medical toolkits, the COLORREF value can represent a 16 bit grayscale value if RasterImage is a 12 or 16-bit grayscale bitmap. To avoid confusion with an RGB value, set the COLORREF_GRAY16 mask (0x04000000). In this case (0x0400YYYY), the lower 16 bits (0xYYYY) of the COLORREF value represent the 16-bit grayscale value. (0x0400FFFF is 16-bit white and 0x04000000 is 16-bit black.) This is not a standard Windows value. Therefore, although LEADTOOLS methods will recognize a COLORREF having this format, but Windows methods will not.

Example

Converts a .NET color to a RasterColor and back.

Silverlight C#

Silverlight VB

using Leadtools; 
 
public void Example() 
{ 
   const int A = 128, R = 24, G = 87, B = 134; 
 
   // Create a RasterColor 
   RasterColor clr = new RasterColor(A, R, G, B); 
 
   // Make sure the color is correct 
   Assert.IsTrue(clr.A == A); 
   Assert.IsTrue(clr.R == R); 
   Assert.IsTrue(clr.G == G); 
   Assert.IsTrue(clr.B == B); 
 
   // Show its value 
   Console.WriteLine(clr); 
 
   // Show the A, R, G and B values 
   Console.WriteLine("Alpha value: " + clr.A); 
   Console.WriteLine("Red value: " + clr.R); 
   Console.WriteLine("Green value: " + clr.G); 
   Console.WriteLine("Blue value: " + clr.B); 
}

Imports Leadtools 
 
Public Sub Example() 
   ' Create a RasterColor 
   Dim clr As New RasterColor(128, 24, 87, 134) 
 
   ' Make sure the color is correct 
   Debug.Assert(clr.A = 128) 
   Debug.Assert(clr.R = 24) 
   Debug.Assert(clr.G = 87) 
   Debug.Assert(clr.B = 134) 
 
   ' Show its value 
   Console.WriteLine(clr) 
 
   ' Show the A, R, G and B values 
   Console.WriteLine("Alpha value: " + clr.A.ToString()) 
   Console.WriteLine("Red value: " + clr.R.ToString()) 
   Console.WriteLine("Green value: " + clr.G.ToString()) 
   Console.WriteLine("Blue value: " + clr.B.ToString()) 
End Sub

using Leadtools; 
using Leadtools.Windows.Media; 
 
public void Example() 
{ 
   Random rand = new Random(); 
 
   // Create a random .NET color 
   Color clr1 = Color.FromArgb((byte)rand.Next(256), (byte)rand.Next(256), (byte)rand.Next(256), (byte)rand.Next(256)); 
 
   // Convert this color to a LEADTOOLS color 
   RasterColor clr2 = RasterColorConverter.FromColor(clr1); 
 
   // Make sure both colors are equal 
   Debug.Assert(clr1.A == clr2.A); 
   Debug.Assert(clr1.R == clr2.R); 
   Debug.Assert(clr1.G == clr2.G); 
   Debug.Assert(clr1.B == clr2.B); 
 
   // Convert the LEADTOOLS color back to .NET 
   clr1 = RasterColorConverter.ToColor(clr2); 
 
   // Make sure both colors are equal 
   Debug.Assert(clr1.A == clr2.A); 
   Debug.Assert(clr1.R == clr2.R); 
   Debug.Assert(clr1.G == clr2.G); 
   Debug.Assert(clr1.B == clr2.B); 
}

Imports Leadtools 
Imports Leadtools.Windows.Media 
 
<TestMethod> 
Public Sub Example() 
   Dim rand As Random = New Random() 
 
   ' Create a random .NET color 
   Dim clr1 As Color = Color.FromArgb(CByte(rand.Next(256)), CByte(rand.Next(256)), CByte(rand.Next(256)), CByte(rand.Next(256))) 
 
   ' Convert this color to a LEADTOOLS color 
   Dim clr2 As RasterColor = RasterColorConverter.FromColor(clr1) 
 
   ' Make sure both colors are equal 
   Debug.Assert(clr1.A = clr2.A) 
   Debug.Assert(clr1.R = clr2.R) 
   Debug.Assert(clr1.G = clr2.G) 
   Debug.Assert(clr1.B = clr2.B) 
 
   ' Convert the LEADTOOLS color back to .NET 
   clr1 = RasterColorConverter.ToColor(clr2) 
 
   ' Make sure both colors are equal 
   Debug.Assert(clr1.A = clr2.A) 
   Debug.Assert(clr1.R = clr2.R) 
   Debug.Assert(clr1.G = clr2.G) 
   Debug.Assert(clr1.B = clr2.B) 
End Sub