aBitmap MANUAL

arclab aBitmap-Control copyright 1998 arclab software GdbR Herbrig&Lappert
Deutschherrnweg 2, D-93053 Regensburg, Germany, Fax: +49 941 990065
Internet: www.arclab.com EMail: office@arclab.com

arclab aBitmap - Control

Manual

required import libraries: mfc42.dll, msvcrt.dll

Properties:

BitmapFilename	BitmapRealSize	Transparent	EraseBackground
Width	Height	BackgroundColor	MaskUse1stPixel
BackColorRed	BackColorGreen	BackColorBlue	MaskColorRed
MaskColorGreen	MaskColorBlue	hWnd

Methods:

InsertMap

DeleteMap

DeleteAllMaps

Events:

Click	DblClick	MouseDown	MouseUp
MouseMove	MapClick

Samples:

Sample1

Sample2

Sample3

Shareware version:

The fully licensed version could be used royalty free in your own applications. Order now for only 20 US$. The shareware version is fully functionable, but there is our company name displayed (very small) in the image to remind you, that you are using a shareware version. After ordering we will send you another .lic file which will hide this reminder.
First try it, then buy it!

Properties:

BitmapFilename = String[MAX_PATH]
path+filename of the bitmap, which should be loaded. this path must be relative to your application directory.

BitmapRealSize = BOOL
TRUE -> displays the bitmap in real size (does not strech the image)
FALSE -> strech image

Width,Height = SHORT (VB:INTERGER)
(if you have selected BitmapRealSize=TRUE you can only read this property.
if you have selected BitmapRealSite=FALSE than you can specify the control size.
in this case the image will be streched to the given size!)
Width = Control Width
Height = Control Height

Transparent = BOOL
TRUE -> displays the image transparent. the masked pixels will be drawn with theselected backcolor
FALSE -> displays the image as it is

EraseBackground = BOOL
TRUE -> erases the background of the control and fills it with the selected backcolor
FALSE -> does not erase the background! this means, that masked out pixels will not be erased

BackgroundColor = 0 , 1 , 2
this property is only used when EraseBackground is set to TRUE
0 : use the system(back)color for dialogs (3DFACE_COLOR)
1 : use the system(back)color for windows (WINDOW_COLOR)
2 : use the user defined color (RGB) given by:
BackColorRed = 0 - 255
BackColorGreen = 0 - 255
BackColorBlue = 0 - 255

MaskUse1stPixel = BOOL
TRUE -> use the first pixel in the image as maskcolor
FALSE -> use the user defined color (RGB) given by:
MaskColorRed = 0 - 255
MaskColorGreen = 0 - 255
MaskColorBlue = 0 - 255

hWnd = HWND (STOCK PROPERTY)
(READ ONLY) returns the windows handle for the control

Methods:

InsertMap (ID, x1, y1, x2, y2)
Insert a new map specifying the identifier and the rectangle.
ID: Identifier for the new map = SHORT (VB:INTERGER)
x1: x-coordinate for topleft point of map (rectangle) = SHORT (VB:INTERGER)
y1: y-coordinate for topleft point of map (rectangle) = SHORT (VB:INTERGER)
x2: x-coordinate for bottomright point of map (rectangle) = SHORT (VB:INTERGER)
y2: y-coordinate for bottomright point of map (rectangle) = SHORT (VB:INTERGER)

DeleteMap (ID)
Delete a map by specifying the ID.
ID: Identifier for the map = SHORT (VB:INTERGER)

DeleteAllMaps
Delete all maps!

Events:

Click (STOCK EVENT)
User has clicked inside the bitmap.

DblClick (STOCK EVENT)
User has double-clicked inside the bitmap

MouseDown (Button, Shift, x, y) (STOCK EVENT)
User has pushed down a mouse button.
Button: 1=left button 2=middle button 3=right button
Shift: represents a bitmask indicating if a key was pressed (shift key (bit 0), ctrl key (bit 1), alt key (bit 2 ) )
x: x-coordinate of the mouse pointer
y: y-coordinate of the mouse pointer

MouseUp (Button, Shift, x, y) (STOCK EVENT)
User has pushed down a mouse button.
Button: 1=left button, 2=middle button, 3=right button
Shift: represents a bitmask indicating if a key was pressed (shift key (bit 0), ctrl key (bit 1), alt key (bit 2 ) )
x: x-coordinate of the mouse pointer
y: y-coordinate of the mouse pointer

MouseMove (Button, Shift, x, y) (STOCK EVENT)
User has pushed down a mouse button.
Button: 1=left button, 2=middle button, 3=right button
Shift: represents a bitmask indicating if a key was pressed (shift key (bit 0), ctrl key (bit 1), alt key (bit 2 ) )
x: x-coordinate of the mouse pointer
y: y-coordinate of the mouse pointer

MapClick (ID)
User has clicked (the left mouse-button) inside a map-area.
ID: Identifier for the map = SHORT (VB:INTERGER)

Sample 1:
This sample shows you how you can load a bitmap and display it transparent without using our property dialog.

bitmap.BackgroundColor = DIALOG_BACKGROUND
set the background color to system value for a dialog

bitmap.BitmapRealSize = True
do not strech the bitmap

bitmap.MaskUse1stPixel = True
use color of bitmap pixel 0,0 as maskcolor

bitmap.EraseBackground = True
erase the background

bitmap.Transparent = True
set the bitmap transparent

bitmap.BitmapFilename = "images\arclab.bmp"
finally load the bitmap; this is to prevent the control from "flickering"; always set all other properties, before setting the filename, to prevent "flickering"!

Sample 2:
This sample shows you how to add 3 rectangles as maps inside your bitmap

Call bitmap.InsertMap(1, 0, 0, 100, 100)
the first rectangle

Call bitmap.InsertMap(2, 150, 200, 250, 250)
the second rectangle

Call bitmap.InsertMap(3, 200, 400, 250, 450)
the third rectangle; you can add further rectangles to one map, by using the same ID
i.e. Call bitmap.InsertMap (3,300,500,350,550)

Now when the user clicks inside one of the specified areas the event MapClick ( ID ) will be fired. The ID contains the identifier for the area!

Sample 3:
This sample shows you how you can load a bitmap and display it transparent without using our property dialog. It is quite the same code as sample 1, but now the mask and fillcolor is selected by using RGB values!

Abitmap3.BackColorRed = 0
Abitmap3.BackColorGreen = 0
Abitmap3.BackColorBlue = 0
use RGB values 0,0,0 (black) as backcolor

bitmap.BitmapRealSize = True
do not strech the bitmap

bitmap.MaskColorRed = 125
bitmap.MaskColorGreen = 0
bitmap.MaskColorBlue = 125
bitmap.MaskUse1stPixel = False
use RGB values (125,0,125) as maskcolor

bitmap.EraseBackground = True
erase the background

bitmap.Transparent = True
set the bitmap transparent

Order:

Credit card orders will be processed by PsL, Inc.

Price:

Email delivery of registration code (no disk will be sent): 20 US$
3,5" Diskette, worldwide: 20 US$ + 7US$

For more details, on how to order, on non credit card orders... please refer to: http://www.arclab.com/products/abitmap/order

Remember:
PsL, Inc. is a credit card order service, not the publisher! To insure that you get the latest version, PsL will notify us within one business day of your order and we will ship the product directly to you. Upon receipt of payment we will send you one license key for each copy of aBitmap-Control paid for. The new license key(s) will have no expiration. The license file will be sent to you via e-mail or postal mail. All updates to the software will be made available via our web page.

Online order:

Secure ordering - If your browser supports secure transactions, try this link first.
Non-enrypted ordering - If your browser does not support secure transactions, use this link.
Backup server - If the server above is not accessible, use this order server.

Fax order:

To (USA) 713-524-6398 ask for product #30359 and please type or block print very plainly.
THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY.

Email order:

To PsL at "30359@pslweb.com"
THIS EMAIL ADDRESS IS FOR CREDIT CARD ORDERING ONLY.

All other questions, comments, bug reports... must be directed to:

arclab software GdbR, Deutschherrnweg 2, D-93053 Regensburg, Germany, Fax: +49 941 990065
Internet: www.arclab.com EMail: office@arclab.com