GetImage(DecodingSettings,IProgressController) Method (ArwPage)

In This Topic

Returns an image associated with this ARW-page.

Syntax

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

'Declaration

Public Overloads Overrides Function GetImage( _
   ByVal decodingSettingsThe decoding settings that should be used for decoding of page image.
 As Vintasoft.Imaging.Codecs.Decoders.DecodingSettings, _
   ByVal progressControllerProgress controller.
 As Vintasoft.Imaging.Utils.IProgressController _
) As Vintasoft.Imaging.VintasoftImage

public override Vintasoft.Imaging.VintasoftImage GetImage(
   Vintasoft.Imaging.Codecs.Decoders.DecodingSettings decodingSettings, 
   Vintasoft.Imaging.Utils.IProgressController progressController
)

public: Vintasoft.Imaging.VintasoftImage* GetImage(
   Vintasoft.Imaging.Codecs.Decoders.DecodingSettings* decodingSettings, 
   Vintasoft.Imaging.Utils.IProgressController* progressController
); override

public:
Vintasoft.Imaging.VintasoftImage^ GetImage(
   Vintasoft.Imaging.Codecs.Decoders.DecodingSettings^ decodingSettings, 
   Vintasoft.Imaging.Utils.IProgressController^ progressController
); override

Parameters

decodingSettings: The decoding settings that should be used for decoding of page image.
progressController: Progress controller.

Return Value

The image associated with this ImagePage object if image was loaded successfully; otherwise, null.

Remarks

SDK uses LibRaw library when calling this method - please specify path to a LibRaw library using the LibRawPath property.

Example

Here is an example that shows how to open Sony ARW-file, get RAW-image from ARW-file and save image to a PNG-file:

VB.NET


''' <summary>
''' Opens Sony ARW-file, gets RAW-image from ARW-file and saves image to a PNG-file.
''' </summary>
''' <param name="arwFilename">The name of ARW-file.</param>
Public Sub RenderAndSaveArwImage(arwFilename As String)
    ' set path to the "libraw.dll" file - VintaSoft Imaging .NET SDK uses LibRaw for parsing Sony ARW-file
    Vintasoft.Imaging.RawCodec.LibRawHelper.LibRawPath = System.IO.Path.Combine(System.IO.Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location), "libraw.dll")

    ' open ARW-file stream
    Using fs As New System.IO.FileStream(arwFilename, System.IO.FileMode.Open, System.IO.FileAccess.Read)
        ' open ARW-file
        Dim rawImageFile As New Vintasoft.Imaging.Codecs.ImageFiles.Raw.RawImageFile(fs)
        ' get ARW-page
        Dim arwPage As Vintasoft.Imaging.Codecs.ImageFiles.Raw.ArwPage = TryCast(rawImageFile.Page, Vintasoft.Imaging.Codecs.ImageFiles.Raw.ArwPage)
        ' if ARW-page is found in RAW-file
        If arwPage IsNot Nothing Then
            ' get RAW-image as 48-bpp RGB image
            Using rawImage As Vintasoft.Imaging.VintasoftImage = arwPage.GetImage()
                ' save 48-bpp RGB image to a PNG file
                rawImage.Save(arwFilename & ".png")
            End Using
        End If
    End Using
End Sub


/// <summary>
/// Opens Sony ARW-file, gets RAW-image from ARW-file and saves image to a PNG-file.
/// </summary>
/// <param name="arwFilename">The name of ARW-file.</param>
public void RenderAndSaveArwImage(string arwFilename)
{
    // set path to the "libraw.dll" file - VintaSoft Imaging .NET SDK uses LibRaw for parsing Sony ARW-file
    Vintasoft.Imaging.RawCodec.LibRawHelper.LibRawPath =
        System.IO.Path.Combine(System.IO.Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location), "libraw.dll");

    // open ARW-file stream
    using (System.IO.FileStream fs = new System.IO.FileStream(arwFilename, System.IO.FileMode.Open, System.IO.FileAccess.Read))
    {
        // open ARW-file
        Vintasoft.Imaging.Codecs.ImageFiles.Raw.RawImageFile rawImageFile =
            new Vintasoft.Imaging.Codecs.ImageFiles.Raw.RawImageFile(fs);
        // get ARW-page
        Vintasoft.Imaging.Codecs.ImageFiles.Raw.ArwPage arwPage =
            rawImageFile.Page as Vintasoft.Imaging.Codecs.ImageFiles.Raw.ArwPage;
        // if ARW-page is found in RAW-file
        if (arwPage != null)
        {
            // get RAW-image as 48-bpp RGB image
            using (Vintasoft.Imaging.VintasoftImage rawImage = arwPage.GetImage())
            {
                // save 48-bpp RGB image to a PNG file
                rawImage.Save(arwFilename + ".png");
            }
        }
    }
}

Requirements

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

Reference

ArwPage Class
ArwPage Members

LibRawPath
Overload List

Send Feedback