Resolution Property (Device)

In This Topic

Gets or sets the resolution of images for current scan session.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration

Public Property Resolution As Resolution

public Resolution Resolution { get; set; }

public: __property Resolution* get_Resolution();
public: __property void set_Resolution(
   Resolution* value
);

public:
property Resolution^ Resolution {
   Resolution^ get();
   void set(Resolution^ value);
}

Exceptions

Exception	Description
TwainInvalidStateException	Thrown if device is in wrong state.
TwainDeviceCapabilityException	Thrown if device does not support capability.
DebuggerException	Thrown if the .NET debugger is used and the function evaluation requires all threads to run.

Remarks

Call this property only when device is opened (State == DeviceState.Opened).

Supported resolutions can be received by the GetSupportedHorizontalResolutions method.

Example

This C#/VB.NET code shows how to acquire images from the device with different X and Y resolutions.

VB.NET


Public Sub ScanColorImage(device As Vintasoft.Twain.Device)
    device.ShowUI = False
    device.ShowIndicators = False
    device.DisableAfterAcquire = True

    device.Open()
    device.PixelType = Vintasoft.Twain.PixelType.RGB
    device.UnitOfMeasure = Vintasoft.Twain.UnitOfMeasure.Inches
    device.Resolution = New Vintasoft.Twain.Resolution(200.0F, 200.0F)
    device.ImageLayout.[Set](1.0F, 1.0F, 5.0F, 5.0F)

    device.Acquire()
End Sub


public void ScanColorImage(Vintasoft.Twain.Device device)
{
    device.ShowUI = false;
    device.ShowIndicators = false;
    device.DisableAfterAcquire = true;

    device.Open();
    device.PixelType = Vintasoft.Twain.PixelType.RGB;
    device.UnitOfMeasure = Vintasoft.Twain.UnitOfMeasure.Inches;
    device.Resolution = new Vintasoft.Twain.Resolution(200f, 200f);
    device.ImageLayout.Set(1f, 1f, 5f, 5f);

    device.Acquire();
}

Requirements

Target Platforms: .NET 10; .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

Device Class
Device Members

GetSupportedHorizontalResolutions
GetSupportedVerticalResolutions
Open

Send Feedback