'Declaration
 
Public Function RegisterToModel( _
   ByVal imageToRegister As FormImage, _
   ByVal model As FormModel _
) As RegistrationResult

'Usage
 
Dim instance As RegistrationProcessor
Dim imageToRegister As FormImage
Dim model As FormModel
Dim value As RegistrationResult
 
value = instance.RegisterToModel(imageToRegister, model)

public RegistrationResult RegisterToModel( 
   FormImage imageToRegister,
   FormModel model
)

public: RegistrationResult* RegisterToModel( 
   FormImage* imageToRegister,
   FormModel* model
) 

public:
RegistrationResult^ RegisterToModel( 
   FormImage^ imageToRegister,
   FormModel^ model
) 

Parameters

imageToRegister

The FormImage object containing one of the images that this method will compare. Normally, this is a filled form.

model

The FormModel object that represents the form model.

Return Value

This method compares an image against a FormModel and attempts to register them by using special registration marks.

Each of the four marks must be shaped like an "L", with the corner of the mark pointing toward the corner of the image. The straight parts of the mark must be parallel to the edges of the image. Each of the straight parts of the mark should be between 1/6 and 1/2 inch long and up to 1/12 inch thick. The marks must be less than two inches from the corner of each image.

If your images (either model or imageToRegister) could be skewed, you should use Accusoft's ScanFix or ImagXpress component to deskew them prior to using this function.

If you cannot represent the model image using a FormModel object or if you will only register a single image to this model, you should consider using the RegisterToImage method.

This method will not throw an exception if it is unable to register the images. Instead, it will set RegistrationResult.State to RegistrationState.Failure.

If the AutoAlign property is set to true and if the registration process is successful, as indicated by the RegistrationResult.State, then this method will align the imageToRegister with the model. Otherwise, the imageToRegister will not be modified.

Reference

RegistrationProcessor Class
RegistrationProcessor Members
RegisterToImage Method
WriteDataItem Event
ReadFormImage Event