CreateBpp Method (CiImage)

Visual Basic
C#
Delphi
JScript
C++/CLI

'Declaration
 
Public Function CreateBpp( _
   ByVal Width As System.Integer, _
   ByVal Height As System.Integer, _
   ByVal BitsPerPixel As System.Integer _
) As System.Integer

'Usage
 
Dim instance As CiImage
Dim Width As System.Integer
Dim Height As System.Integer
Dim BitsPerPixel As System.Integer
Dim value As System.Integer
 
value = instance.CreateBpp(Width, Height, BitsPerPixel)

public System.int CreateBpp( 
   System.int Width,
   System.int Height,
   System.int BitsPerPixel
)

public function CreateBpp( 
    Width: System.Integer;
    Height: System.Integer;
    BitsPerPixel: System.Integer
): System.Integer;

public function CreateBpp( 
   Width : System.int,
   Height : System.int,
   BitsPerPixel : System.int
) : System.int;

public:
System.int CreateBpp( 
   System.int Width,
   System.int Height,
   System.int BitsPerPixel
)

Parameters

Width: Width of the new image in pixels
Height: Height of the new image in pixels
BitsPerPixel: Color scheme of the new image in pixels. Valid values are 1, 8, 24

If BitsPerPixel = 1 this method creates a bi-tonal image with all pixels are set to white and resolution is 300 dpi.

If BitsPerPixel = 8 or BitsPerPixel = 24 this method creates a grayscale (GS) or color (RGB) image respectively. All pixels are set to black and resolution is 1 dpi. Set HorzDpi and VertDpi properties to the required value.

This method generates an error if object.Image.IsZone is true.

C#
VB.NET

void ImageMethods()
{
    CiServer ci = Inlite.ClearImageNet.Server.GetThreadServer();
    CiImage image = ci.CreateImage();
    // Initialize 3000 pixels by 2000 pixels RGB image. All pixels of new RGB image are black.  Default resolution is 1 dpi
    image.CreateBpp(3000, 2000, 24);
    // Change DPI to 200
    image.HorzDpi = 200; image.VertDpi = 200;
    // Crop area of the image
    image.Crop(100, 200, 800, 1000);
    // Initialize 8.5" by 11" bi-tonal image. All pixels of new Bi-tonal image are white.  Default resolution is 300 dpi
    // Image initialization closes and frees memory of the previously crated RGB image
    image.Create((int)(8.5 * 300), (int)(11.0 * 300));
    // Convert to grayscale
    image.ToGrayscale();
    // Create zone in the center of the image
    CiImage zoneCenter = image.CreateZone(image.Width / 3, image.Height / 3, image.Width * 2 / 3, image.Height * 2 / 3);
    // Invert center area of the image
    zoneCenter.Invert();
    // Re-define zone to upper left quadrant of the image
    CiRect rect = ci.CreateRect(0, 0, image.Width / 2, image.Height / 2);
    CiImage zoneCorner = image.CreateZoneRect(rect);
    // Clear corner area on the image
    zoneCorner.Clear();
    // Duplicate center area to a new image
    CiImage imageCenter = zoneCenter.Duplicate();
    // Copy from the original image
    CiImage imageCopy = ci.CreateImage();
    imageCopy.Copy(image);
    // Convert image to bi-tonal
    imageCopy.ToBitonal();
    // Clean-up. Free image memory
    image.Close();
    imageCenter.Close();
    imageCopy.Close();
}

Sub ImageMethods()
    Dim ci As CiServer = Inlite.ClearImageNet.Server.GetThreadServer()
    Dim image As CiImage = ci.CreateImage()
    '  Initialize 3000 pixels by 2000 pixels RGB image. All pixels of new RGB image are black.  Default resolution is 1 dpi
    image.CreateBpp(3000, 2000, 24)
    '  Change DPI to 200
    image.HorzDpi = 200 : image.VertDpi = 200
    '  Crop area of the image
    image.Crop(100, 200, 800, 1000)
    '  Initialize 8.5" by 11" bi-tonal image. All pixels of new Bi-tonal image are white.  Default resolution is 300 dpi
    '  Image initialization closes and frees memory of the previously crated RGB image
    image.Create(8.5 * 300, 11 * 300)
    '  Convert to grayscale
    image.ToGrayscale()
    '  Create zone in the center of the image
    Dim zoneCenter As CiImage = image.CreateZone(image.Width / 3, image.Height / 3,
            image.Width * 2 / 3, image.Height * 2 / 3)
    '  Invert center area of the image
    zoneCenter.Invert()
    '  Re-define zone to upper left quadrant of the image
    Dim rect As CiRect = ci.CreateRect(0, 0, image.Width / 2, image.Height / 2)
    Dim zoneCorner As CiImage = image.CreateZoneRect(rect)
    '  Clear corner area on the image
    zoneCorner.Clear()
    '  Duplicate center area to a new image
    Dim imageCenter As CiImage = zoneCenter.Duplicate()
    '  Copy from the original image
    Dim imageCopy As CiImage = ci.CreateImage()
    imageCopy.Copy(image)
    '  Convert image to bi-tonal
    imageCopy.ToBitonal()
    '  Clean-up. Free image memory
    image.Close()
    imageCenter.Close()
    imageCopy.Close()
End Sub

Reference

CiImage Class
CiImage Members