Declaration
Delphi
procedure SetSignImageEx(Assign: Boolean; Encoding: Integer; Width, Height: Integer; Image: PByte; Size: Cardinal);
C/C++
SOPAD_API void SOPAD_setSignImageEx(int bAssign, int nEncoding, int nWidth, int nHeight, const void* pImage, int nSize);
ActiveX
HRESULT SetSignImageEx([in] VARIANT_BOOL Assign, [in] long Encoding, [in] long Width, [in] long Height, [in] VARIANT Image);
Description
It's possible to display custom image (for example, part of the document) on the pad's LCD during signing. This function allows to define custom image. Image will be actually drawn on the call of startCapture function.
NOTE: This function only works with signature pads with B/W display. For Signature Pads with colour display please see LCDImage or LCDImageEx, LCDImageExR
Arguments
Assign
Pass a non-zero value to store image, zero value to clear image.
Encoding
Image encoding method
| Value | Description |
|---|
| 0 | Pre-naturaSign compatible. One byte represents one horizontal line of 8 pixels. |
| 1 | naturaSign compatibe. One byte represents one vertical line of 8 pixels. |
Width and Height
Size of signature image
LCDImageArray, Image
Single-dimensional array, containing byte values.
Array should have the following format:
Each bit represents one pixel, bit value = 1 means that pixel should be lit, thus one byte determines eight pixels state. The first byte of array corresponds to a line of pixels starting from (0, 0). In a byte bit 0 determines the leftmost or topmost pixel.
Size
Size of binary data block.
Sample-Code
device = new StepOverSignatureDevice();
string padsettings = "";
bool foundPad = device.checkConnectedPad("", true, false, true, ref padsettings);
string devicetyp = device.GetDriverString(0);
if ((devicetyp == "StepOver naturaSign Pad Mobile") || (devicetyp == "StepOver naturaSign Pad Biometric"))
{
int w = device.GetDriverLong(20) /* width */;
int h = device.GetDriverLong(21) /* height */;
// Create Image
Bitmap bmp = new Bitmap(w, h, System.Drawing.Imaging.PixelFormat.Format24bppRgb);
Graphics gr = Graphics.FromImage(bmp);
gr.FillRectangle(new SolidBrush(Color.White), new Rectangle(0, 0, w, h));
gr.DrawString("Hello, World,", new Font("Arial", 16), Brushes.Black, new PointF(10, 10));
gr.DrawString("This is a Test", new Font("Arial", 16), Brushes.Black, new PointF(10, 50));
// Image to ByteArray
int BufferSize = (int) Math.Ceiling((double) h / 8) * w;
// Pad Typ StepOver naturaSign Mobile
Byte[] bytes = new Byte[BufferSize];
for (int i = 0; i < h / 8; i++)
{
for (int j = 0; j < w; j++)
{
byte b = 0;
for (int k = 0; k < 8; k++)
{
b >>= 1;
if (bmp.GetPixel(j, i * 8 + k).ToArgb() != Color.White.ToArgb())
b |= 0x80;
}
int idx = i * w + j;
if (idx < BufferSize)
bytes[idx] = b;
else
throw new Exception("Range check error.");
}
}
bmp.Dispose();
device.SetSignImageEx(true, 1, w, h, bytes);
}
// remove on Signatur-line by the LCD Pads
/*
const int DRIVER_OPTION1_TRANSPARENT_DRAW_MODE = 0x00000010;
device.SetDriverLong(0, device.GetDriverLong(0) & ~DRIVER_OPTION1_TRANSPARENT_DRAW_MODE);
*/
device.startCapture("", true, true, true, true, ref padsettings);
// LCD Pad (Standard, Mobile, Classic or Biometric)
int w = SigDev.GetDriverLong(DRIVER_LCD_WIDTH);
int h = SigDev.GetDriverLong(DRIVER_LCD_HEIGHT);
//prepare the bitmap attributes
BITMAPINFO bmInfo;
memset(&bmInfo.bmiHeader,0,sizeof(BITMAPINFOHEADER));
bmInfo.bmiHeader.biSize = sizeof(BITMAPINFOHEADER);
bmInfo.bmiHeader.biWidth = w;
bmInfo.bmiHeader.biHeight = h;
bmInfo.bmiHeader.biPlanes = 1;
bmInfo.bmiHeader.biBitCount = 24;
//create a temporary dc in memory.
HDC pDC = ::GetDC(0);
HDC TmpDC = CreateCompatibleDC(pDC);
//create a new bitmap and select it in the memory dc
BYTE *pbase;
HBITMAP TmpBmp = CreateDIBSection(pDC,&bmInfo,DIB_RGB_COLORS,(void**)&pbase,0,0);
HGDIOBJ TmpObj = SelectObject(TmpDC,TmpBmp);
HBRUSH hbr = CreateSolidBrush(RGB(255,255,255));
RECT pos = {0,0,w,h};
FillRect(TmpDC,&pos,hbr);
//choose the font
CFont m_Font;
LOGFONT *m_pLF;
m_pLF = (LOGFONT*) calloc(1,sizeof(LOGFONT));
wcsncpy_s(m_pLF->lfFaceName,32,_T("Arial Bold"),11);
m_pLF->lfHeight = 16;
m_pLF->lfWeight = 0;
m_pLF->lfItalic = 0;
m_pLF->lfUnderline = 0;
HFONT hfont = CreateFontIndirect(m_pLF);
HGDIOBJ pOldFont;
if (hfont)
pOldFont = SelectObject(TmpDC,hfont);
else
pOldFont = SelectObject(TmpDC,GetStockObject(DEFAULT_GUI_FONT));
//draw the text
SetBkMode(TmpDC,TRANSPARENT);
SetTextColor(TmpDC,RGB(0,0,0));
TextOut(TmpDC,10,10,_T("Hello, World,") ,13);
TextOut(TmpDC,10,50,_T("This is a Test"),14);
// cleanup
SelectObject(TmpDC,pOldFont);
m_Font.DeleteObject();
free(m_pLF);
// Create the Byte Array of the Image
int BufferSize = (int) (h / 8) * w;
unsigned char *bytes = (unsigned char *) malloc(BufferSize);
for (int i = 0; i < h / 8; i++)
{
for (int j = 0; j < w; j++)
{
byte b = 0;
for (int k = 0; k < 8; k++)
{
b >>= 1;
if (GetPixel(TmpDC,j, i * 8 + k) != RGB(255,255,255))
b |= 0x80;
}
int idx = i * w + j;
if (idx < BufferSize)
{
bytes[idx] = b;
}
}
}
HRESULT hr;
VARIANT vrRawData;
VariantInit(&vrRawData);
SAFEARRAY *psarray;
SAFEARRAYBOUND sabounds[1];
sabounds[0].lLbound=0;
sabounds[0].cElements = BufferSize;
psarray = SafeArrayCreate(VT_UI1, 1, sabounds);
vrRawData.vt = VT_ARRAY|VT_UI1;
if(psarray != NULL)
{
vrRawData.parray = psarray;
long lDimension = 0;
for ( long i = 0; i < BufferSize; i++ )
{
unsigned char dc = bytes[i];
hr = SafeArrayPutElement(vrRawData.parray,&i,&dc);
}
}
// upload Image
SigDev.SetSignImageEx(true, 1, w, h, vrRawData);
' LCD Pad (Standard, Mobile, Classic or Biometric)
Dim w As Integer = AxStepOverSignatureDevice1.GetDriverLong(DRIVER_LCD_WIDTH)
Dim h As Integer = AxStepOverSignatureDevice1.GetDriverLong(DRIVER_LCD_HEIGHT)
' Create a new Image
Dim bmp As Bitmap = new Bitmap(w, h, System.Drawing.Imaging.PixelFormat.Format24bppRgb)
Dim gr As Graphics = Graphics.FromImage(bmp)
' Add some text to the Image
gr.FillRectangle(new SolidBrush(Color.White), new Rectangle(0, 0, w, h))
gr.DrawString("Hello, World,", new Font("Arial", 16), Brushes.Black, new PointF(10, 10))
gr.DrawString("This is a Test", new Font("Arial", 16), Brushes.Black, new PointF(10, 50))
' Create the Byte Array of the Image
Dim BufferSize As Integer = Math.Ceiling(h / 8) * w
Dim bytes(BufferSize) As Byte
for i as Integer = 0 to (h / 8)-1
for j as Integer = 0 to w-1
Dim b as Byte = 0
for k as Integer = 0 to 7
b = b >> 1
If (i * 8 + k) < h then
if (bmp.GetPixel(j, (i * 8 + k)).ToArgb() <> Color.White.ToArgb()) then
b = b or &H80
end if
end if
next
Dim idx as Integer = i * w + j
if (idx < BufferSize) then
bytes(idx) = b
else
throw new Exception("Range check error.")
End if
Next
Next
bmp.Dispose()
AxStepOverSignatureDevice1.SetSignImageEx(true, 1, w, h, bytes)
// LCD Pad (Standard, Mobile, Classic or Biometric)
w := SigDev.GetDriverLong(DRIVER_LCD_WIDTH);
h := SigDev.GetDriverLong(DRIVER_LCD_HEIGHT);
// Create a new Image
bmp := TBitmap.Create;
bmp.Width := w;
bmp.Height := h;
bmp.PixelFormat := pf24bit;
bmp.Canvas.Brush.Color := clWhite;
bmp.Canvas.FillRect(Rect(0,0,w,h));
// Add some text to the Image
bmp.Canvas.Font.Name := 'Arial';
bmp.Canvas.Font.Height := 16;
bmp.Canvas.Font.Color := clBlack;
bmp.Canvas.TextOut(10,10,'Hello World');
bmp.Canvas.TextOut(10,50,'This is a Test');
// Create the Byte Array of the Image
BufferSize := Integer(Ceil(h / 8) * w);
SetLength(BMPBytes,Buffersize);
for i := 0 to (h shr 3) do
begin
for j := 0 to w-1 do
begin
b := 0;
for k := 0 to 7 do
begin
b := b shr 1;
if bmp.Canvas.Pixels[j, i * 8 + k] <> clWhite then
begin
b := b or $80;
end;
end;
BMPbytes[i * w + j] := b;
end;
end;
bmp.Free;
SigDev.SetSignImageEx(true, 1, w, h, BMPbytes);