Control iSignUtil

This control contains various utility functions to render and create graphic files.

VB Script Syntax:

Set object = CreateObject("CIC.iSignUtil")
object.InkToJpeg (….)
object.GetLastError
Set object = nothing

 

Property Summary
_Displaymode

DisplayMode

Sets the display mode of the control for image output.

_EncrAlg

EncryptionAlgorithm

Sets the encryption algorithm.

int

EncryptionEnabled

Enables/disables the encryption of the ink.

string

EncryptionKey

Sets the encryption key.

_WritingGuideStyle

WritingGuide

Sets the writing guide of the control for image output.

 

Method Summary
void

CreateGraphicsFile(long nFormat, long nWidth, long nHeight, long nInkColor, String sSignature, String sFilename)

Create a graphic file taking format, width, height, ink color, signature, and file name as arguments.

long

GetLastError( )

This function returns the last known error code.

void

InkToJpeg(Long nWidth, Long nHeight, Long nInkColor, String sSignature, String sFile)

Converts a Signature string into a JPEG file.

void

SetRenderingOptions (long InkQaulity)

Sets the rendering option of the newly created graphic file.

 

 

Property Details

DisplayMode

public static ISIGNUTILCONTROLLib._DisplayMode DisplayMode

Sets the display mode of the control for image output

Options:

0
Normal
1 ScaleToControl
2 ShiftToControl
3 Proportional Fit
4 Custom

VBScript Usage:

object.DisplayMode = 1


EncryptionAlgorithm

public static _EncrAlg EncryptionAlgorithm

Sets the encryption algorithm.

Options:

-1
NONE
No encryption algorithm specified.
0
FAST CIC's FAST encryption algorithm
1
DES DES 56 bit encryption algorithm
2
DES_40 DES 40 bit encryption algorithm
3
TRIPLE_DES DES 128 bit encryption algorithm

VBScript Usage:

object.EncryptionAlgorithm = 3


EncryptionEnabled

public static int EncryptionEnabled

Enables/disables the encryption of the ink.

Options:

0
Disabled
1
Enabled

VBScript Usage:

object.EncryptionEnabled = 1


EncryptionKey

public static string EncryptionKey

Sets the encryption key.

VBScript Usage:

object.Encryptionkey = "12345678"


WritingGuide

public static ISIGNUTILCONTROLLib._WritingGuideStyle WritingGuide

Sets the writing guide of the control for image output.

Options:

0
wgNONE No writing guide
1 wgUnderline Specify the underline guide
2 wgSignatureLine Specify the signature line guide

VBScript Usage:

object.WritingGuide = 2

 

Method Details

CreateGraphicsFile(long nFormat, long nWidth, long nHeight, long nInkColor, String sSignature, String sFilename)

public void CreateGraphicsFile (long nFormat, long nWidth, long nHeight, long nInkColor, String sSignature, String sFilename)

Create a graphic file taking format, width, height, ink color, signature, and file name as arguments.

nWidth - width in pixels

nHeight - height in pixels

nInkColor - ink color

sSignature - signature data

sFilename - output file name

nFormat: requesting graphics file format: GIF_FILE  = 1, JPEG_FILE = 2, TIFF_FILE = 3, PNG_FILE = 4,  BMP_FILE = 5

VBScript Usage:

object.CreateGraphicsFile(nFormat, nWidth, nHeight, nInkColor, sSignature, sFilename)


GetLastError( )

public long GetLastError( )

This function returns the last known error code.

Returns:

0
eOK
1 eNoInk
2 eCreateBmpFailed
6 eCreateJpegFailed
10 eStreamInFailed

VBScript Usage:

object.GetLastError


InkToJpeg(Long nWidth, Long nHeight, Long nInkColor, String sSignature, String sFile)

public void InkToJpeg(Long nWidth, Long nHeight, Long nInkColor, String sSignature, String sFile)

Converts a Signature string into a JPEG file.

nWidth - width of jpeg in pixels

nHeight - height of jpeg in pixels

nInkColor - ink color

sSignature - signature data

sFile - output file name

VBScript Usage:

object.InkToJpeg ( nWidth, nHeight, nInkColor, sSignature, sFile )


SetRenderingOptions(long InkQuality)

public void SetRenderingOptions(long InkQuality)

Sets the rendering option of the newly created graphic file.

Options:

0
OPT_DEFAULT no special treatment
1 OPT_ANTIALISING The signature will be anti-alized (GDIPlus)
2 OPT_SMOOTHING Points are connected through curved lines

VBScript Usage:

object.SetRenderingOptions(1)