# GrapeCity.Documents.Drawing.Image

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="GrapeCity_Documents_Drawing_Image" data-uid="GrapeCity.Documents.Drawing.Image" class="text-break">Image Class
</h1>
  <div class="markdown level0 summary"><p>A lightweight class representing an image in a file, stream, or array of bytes.</p>
<p>By default, this class does not load or decode the actual pixel data
unless <a class="xref" href="GrapeCity.Documents.Drawing.ImageBinding.html#GrapeCity_Documents_Drawing_ImageBinding_InMemoryData">InMemoryData</a> is passed to
<a class="xref" href="GrapeCity.Documents.Drawing.Image.FromFile.html#GrapeCity_Documents_Drawing_Image_FromFile_System_String_GrapeCity_Documents_Drawing_ImageBinding_System_Int32_">FromFile(string, ImageBinding, int)</a>,
<a class="xref" href="GrapeCity.Documents.Imaging.TiffFrame.ToImage.html#GrapeCity_Documents_Imaging_TiffFrame_ToImage_GrapeCity_Documents_Drawing_ImageBinding_">ToImage(ImageBinding)</a> or <a class="xref" href="GrapeCity.Documents.Imaging.GifFrame.ToImage.html#GrapeCity_Documents_Imaging_GifFrame_ToImage_GrapeCity_Documents_Drawing_ImageBinding_">ToImage(ImageBinding)</a>.
</p>
<p>
Use the <a class="xref" href="GrapeCity.Documents.Drawing.Image.ToGcBitmap.html#GrapeCity_Documents_Drawing_Image_ToGcBitmap">ToGcBitmap()</a> method to load the image into a <a class="xref" href="GrapeCity.Documents.Imaging.GcBitmap.html">GcBitmap</a>
in order to access and manipulate the image data.
</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><span class="xref">Image</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="GrapeCity.Documents.Drawing.IImage.html">IImage</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.Documents.Drawing.html">GrapeCity.Documents.Drawing</a></h6>
  <h6><strong>Assembly</strong>: DS.Documents.Imaging.dll</h6>
  <h5 id="GrapeCity_Documents_Drawing_Image_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class Image : IImage, IDisposable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class Image
    Implements IImage, IDisposable</code></pre>
  </div>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Binding" data-uid="GrapeCity.Documents.Drawing.Image.Binding">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Binding.html#GrapeCity_Documents_Drawing_Image_Binding">Binding</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the value indicating how the image data is attached to the <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> object.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Encoding" data-uid="GrapeCity.Documents.Drawing.Image.Encoding">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Encoding.html#GrapeCity_Documents_Drawing_Image_Encoding">Encoding</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the encoding of the image.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_ExifProfile" data-uid="GrapeCity.Documents.Drawing.Image.ExifProfile">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.ExifProfile.html#GrapeCity_Documents_Drawing_Image_ExifProfile">ExifProfile</a>
        </td>
        <td class="markdown level1 summary"><p>Gets an instance of <a class="xref" href="GrapeCity.Documents.Imaging.Exif.ExifProfile.html">ExifProfile</a> with Exif metadata of the image.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_FilePath" data-uid="GrapeCity.Documents.Drawing.Image.FilePath">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.FilePath.html#GrapeCity_Documents_Drawing_Image_FilePath">FilePath</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the full path to the image file, if <a class="xref" href="GrapeCity.Documents.Drawing.Image.Binding.html#GrapeCity_Documents_Drawing_Image_Binding">Binding</a> is equal to <a class="xref" href="GrapeCity.Documents.Drawing.ImageBinding.html#GrapeCity_Documents_Drawing_ImageBinding_FilePath">FilePath</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_FrameIndex" data-uid="GrapeCity.Documents.Drawing.Image.FrameIndex">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.FrameIndex.html#GrapeCity_Documents_Drawing_Image_FrameIndex">FrameIndex</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the index of the image frame.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Height" data-uid="GrapeCity.Documents.Drawing.Image.Height">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Height.html#GrapeCity_Documents_Drawing_Image_Height">Height</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the height of the image in pixels.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_HorizontalResolution" data-uid="GrapeCity.Documents.Drawing.Image.HorizontalResolution">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.HorizontalResolution.html#GrapeCity_Documents_Drawing_Image_HorizontalResolution">HorizontalResolution</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the horizontal resolution (dots per inch) of the image.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_InMemoryData" data-uid="GrapeCity.Documents.Drawing.Image.InMemoryData">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.InMemoryData.html#GrapeCity_Documents_Drawing_Image_InMemoryData">InMemoryData</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the byte array with image data, if <a class="xref" href="GrapeCity.Documents.Drawing.Image.Binding.html#GrapeCity_Documents_Drawing_Image_Binding">Binding</a> is equal to <a class="xref" href="GrapeCity.Documents.Drawing.ImageBinding.html#GrapeCity_Documents_Drawing_ImageBinding_InMemoryData">InMemoryData</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Initialized" data-uid="GrapeCity.Documents.Drawing.Image.Initialized">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Initialized.html#GrapeCity_Documents_Drawing_Image_Initialized">Initialized</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a value indicating if the image is initialized and not disposed yet.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_IsDisposed" data-uid="GrapeCity.Documents.Drawing.Image.IsDisposed">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.IsDisposed.html#GrapeCity_Documents_Drawing_Image_IsDisposed">IsDisposed</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a value indicating whether the <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> has been disposed of.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_OwnStream" data-uid="GrapeCity.Documents.Drawing.Image.OwnStream">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.OwnStream.html#GrapeCity_Documents_Drawing_Image_OwnStream">OwnStream</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a value indicating if the input stream should be closed when the <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> is disposed.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Rotation" data-uid="GrapeCity.Documents.Drawing.Image.Rotation">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Rotation.html#GrapeCity_Documents_Drawing_Image_Rotation">Rotation</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the flip and rotate transformations that must be applied to the image.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Stream" data-uid="GrapeCity.Documents.Drawing.Image.Stream">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Stream.html#GrapeCity_Documents_Drawing_Image_Stream">Stream</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the image stream, if <a class="xref" href="GrapeCity.Documents.Drawing.Image.Binding.html#GrapeCity_Documents_Drawing_Image_Binding">Binding</a> is equal to <a class="xref" href="GrapeCity.Documents.Drawing.ImageBinding.html#GrapeCity_Documents_Drawing_ImageBinding_Stream">Stream</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_StreamStartPosition" data-uid="GrapeCity.Documents.Drawing.Image.StreamStartPosition">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.StreamStartPosition.html#GrapeCity_Documents_Drawing_Image_StreamStartPosition">StreamStartPosition</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the start position for image data in the associated Stream.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_VerticalResolution" data-uid="GrapeCity.Documents.Drawing.Image.VerticalResolution">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.VerticalResolution.html#GrapeCity_Documents_Drawing_Image_VerticalResolution">VerticalResolution</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the vertical resolution (dots per inch) of the image.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Width" data-uid="GrapeCity.Documents.Drawing.Image.Width">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Width.html#GrapeCity_Documents_Drawing_Image_Width">Width</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the width of the image in pixels.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Dispose" data-uid="GrapeCity.Documents.Drawing.Image.Dispose">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Dispose.html#GrapeCity_Documents_Drawing_Image_Dispose">Dispose()</a>
        </td>
        <td class="markdown level1 summary"><p>Disposes the current instance.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_Dispose_System_Boolean_" data-uid="GrapeCity.Documents.Drawing.Image.Dispose(System.Boolean)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.Dispose.html#GrapeCity_Documents_Drawing_Image_Dispose_System_Boolean_">Dispose(bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Disposes the current instance.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_FromBytes_System_Byte___System_Int32_" data-uid="GrapeCity.Documents.Drawing.Image.FromBytes(System.Byte[],System.Int32)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.FromBytes.html#GrapeCity_Documents_Drawing_Image_FromBytes_System_Byte___System_Int32_">FromBytes(byte[], int)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> from a byte array. JPEG, PNG, WEBP, GIF, BMP and TIFF formats are supported.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_FromFile_System_String_GrapeCity_Documents_Drawing_ImageBinding_System_Int32_" data-uid="GrapeCity.Documents.Drawing.Image.FromFile(System.String,GrapeCity.Documents.Drawing.ImageBinding,System.Int32)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.FromFile.html#GrapeCity_Documents_Drawing_Image_FromFile_System_String_GrapeCity_Documents_Drawing_ImageBinding_System_Int32_">FromFile(string, ImageBinding, int)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> from a file. JPEG, PNG, WEBP, GIF, BMP and TIFF formats are supported.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_FromStream_System_IO_Stream_System_Boolean_System_Int32_" data-uid="GrapeCity.Documents.Drawing.Image.FromStream(System.IO.Stream,System.Boolean,System.Int32)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.FromStream.html#GrapeCity_Documents_Drawing_Image_FromStream_System_IO_Stream_System_Boolean_System_Int32_">FromStream(Stream, bool, int)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a> from a stream. JPEG, PNG, WEBP, GIF, BMP and TIFF formats are supported.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_ToGcBitmap" data-uid="GrapeCity.Documents.Drawing.Image.ToGcBitmap">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.ToGcBitmap.html#GrapeCity_Documents_Drawing_Image_ToGcBitmap">ToGcBitmap()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an instance of the <a class="xref" href="GrapeCity.Documents.Imaging.GcBitmap.html">GcBitmap</a> class from the current <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_ToGcBitmap_GrapeCity_Documents_Imaging_GcBitmap_" data-uid="GrapeCity.Documents.Drawing.Image.ToGcBitmap(GrapeCity.Documents.Imaging.GcBitmap)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.ToGcBitmap.html#GrapeCity_Documents_Drawing_Image_ToGcBitmap_GrapeCity_Documents_Imaging_GcBitmap_">ToGcBitmap(GcBitmap)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads the image into an existing instance of <a class="xref" href="GrapeCity.Documents.Imaging.GcBitmap.html">GcBitmap</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_ToGcBitmap_System_Boolean_" data-uid="GrapeCity.Documents.Drawing.Image.ToGcBitmap(System.Boolean)">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.ToGcBitmap.html#GrapeCity_Documents_Drawing_Image_ToGcBitmap_System_Boolean_">ToGcBitmap(bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an instance of the <a class="xref" href="GrapeCity.Documents.Imaging.GcBitmap.html">GcBitmap</a> class from the current <a class="xref" href="GrapeCity.Documents.Drawing.Image.html">Image</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Drawing_Image_ToStream" data-uid="GrapeCity.Documents.Drawing.Image.ToStream">
          <a class="xref" href="GrapeCity.Documents.Drawing.Image.ToStream.html#GrapeCity_Documents_Drawing_Image_ToStream">ToStream()</a>
        </td>
        <td class="markdown level1 summary"><p>Saves the source image (all frames) to a MemoryStream.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
