This method retrieves the largest physical size that can be scanned with a given scan device.

[C++Builder]   [ bool = ]imagekitcontrolname->Scan->GetPhysicalSize(float &AWidth, float &AHeight)
[Delphi]   [ Boolean = ]imagekitcontrolname.Scan.GetPhysicalSize(var AWidth, AHeight: Single)

Parameters

Name Explanation
AWidth The largest physical width of the scan
AHeight The largest physical height of the scan

Return Value

Returns True when successful, returns False when not successful.

Explanation

The GetPhysicalSize method retrieves the largest physical size that can be scanned with a given scan device.

When the UnitMode property is set to vikScanPixel, please set XResolution and YResolution properties with the resolution (DPI) value. The physical size will be retrieved from these resolution values. If 0 is set into the XResolution and YResolution properties, the physical size retrieved will correspond to the current resolution.

To retrieve the largest physical size the DataSourceName, ScanMode, and UnitMode properties must be set. If the DataSourceName property is blank then prior to executing this method, please execute the Select method. (If the OpenDataSource method has been executed, the DataSourceName is disabled and the open scan device will be used.) Set the ScanMode property to vikScanDOC , vikScanADF1 , vikScanADF2, vikPositiveFilm1, or vikPositiveFilm2 and set the UnitMode to values supported by the datasource (scan device). The AWidth and AHeight parameters will return values depending on the ScanMode and UnitMode properties. When UnitMode is vikScanPixel, the AWidth and AHeight parameters will depend on the current resolution (DPI).

To execute the GetPhysicalSize method you must first execute the Initialize method. If the OpenDataSource method is executed prior to executing the GetPhysicalSize method then the open datasource cannot be used by another application until that datasource (scan device) is closed.

The GetPhysicalSize method corresponds to the Scan Control's ScanGetPhysicalSize method in earlier versions of the ImageKit

[Differences from the ImageKit7 ActiveX/VCL]

When the UnitMode property is vikScanPixel, the corresponding size can be retrieved from the resolution values.

 

The ImageKit10 VCL is a product created by Newtone Corporation