# GrapeCity.Documents.Imaging.BitmapRenderer

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="GrapeCity_Documents_Imaging_BitmapRenderer" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer" class="text-break">BitmapRenderer Class
</h1>
  <div class="markdown level0 summary"><p>Provides methods for drawing on a <a class="xref" href="GrapeCity.Documents.Imaging.GcBitmap.html">GcBitmap</a>.</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">BitmapRenderer</span></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.Documents.Imaging.html">GrapeCity.Documents.Imaging</a></h6>
  <h6><strong>Assembly</strong>: DS.Documents.Imaging.dll</h6>
  <h5 id="GrapeCity_Documents_Imaging_BitmapRenderer_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class BitmapRenderer</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class BitmapRenderer</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_Imaging_BitmapRenderer_Aliased" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Aliased">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Aliased.html#GrapeCity_Documents_Imaging_BitmapRenderer_Aliased">Aliased</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the graphic objects are drawn without anti-aliasing.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_BackgroundBitmap" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.BackgroundBitmap">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.BackgroundBitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_BackgroundBitmap">BackgroundBitmap</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a bitmap providing background for all drawing and filling operations.</p>
<p>The same bitmap cannot be used as background and target at the same time.</p>
<p>The background bitmap must be of the same pixel size as the target bitmap.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_BackgroundBitmapContainsUnmodifiedImage" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.BackgroundBitmapContainsUnmodifiedImage">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.BackgroundBitmapContainsUnmodifiedImage.html#GrapeCity_Documents_Imaging_BitmapRenderer_BackgroundBitmapContainsUnmodifiedImage">BackgroundBitmapContainsUnmodifiedImage</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating that copying pixels from the <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.BackgroundBitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_BackgroundBitmap">BackgroundBitmap</a>
to the target bitmap should not be marked as changed in the <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.UpdatedPixelMask.html#GrapeCity_Documents_Imaging_BitmapRenderer_UpdatedPixelMask">UpdatedPixelMask</a>.</p>
<p>
The default is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a>, indicating that pixels copied from the background bitmap
to the target are marked as changed.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_Bitmap" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Bitmap">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Bitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_Bitmap">Bitmap</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the target bitmap.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_BlendMode" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.BlendMode">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.BlendMode.html#GrapeCity_Documents_Imaging_BitmapRenderer_BlendMode">BlendMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the method of mixing source and destination colors when drawing.</p>
<p>Default is <a class="xref" href="GrapeCity.Documents.Drawing.BlendMode.html#GrapeCity_Documents_Drawing_BlendMode_Normal">Normal</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_ClipRect" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.ClipRect">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.ClipRect.html#GrapeCity_Documents_Imaging_BitmapRenderer_ClipRect">ClipRect</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a rectangle, in pixels, to which all subsequent drawing operations are clipped.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_ClipRegion" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.ClipRegion">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.ClipRegion.html#GrapeCity_Documents_Imaging_BitmapRenderer_ClipRegion">ClipRegion</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a region to which the subsequient drawing operations are clipped.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_ForceAntialiasingForText" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.ForceAntialiasingForText">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.ForceAntialiasingForText.html#GrapeCity_Documents_Imaging_BitmapRenderer_ForceAntialiasingForText">ForceAntialiasingForText</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value specifying whether a <a class="xref" href="GrapeCity.Documents.Text.TextLayout.html">TextLayout</a> is always drawn with antialiasing regardless the value of the <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Aliased.html#GrapeCity_Documents_Imaging_BitmapRenderer_Aliased">Aliased</a> property.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_InterpolationMode" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.InterpolationMode">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.InterpolationMode.html#GrapeCity_Documents_Imaging_BitmapRenderer_InterpolationMode">InterpolationMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the sampling mode to use when drawing bitmaps with resizing.</p>
<p>Default is <a class="xref" href="GrapeCity.Documents.Drawing.InterpolationMode.html#GrapeCity_Documents_Drawing_InterpolationMode_Linear">Linear</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_Multithreaded" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Multithreaded">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Multithreaded.html#GrapeCity_Documents_Imaging_BitmapRenderer_Multithreaded">Multithreaded</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the rendering engine uses multiple threads to boost performance.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_SlowAntialiasing" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.SlowAntialiasing">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.SlowAntialiasing.html#GrapeCity_Documents_Imaging_BitmapRenderer_SlowAntialiasing">SlowAntialiasing</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the antialiasing algorithm should produce better quality with lower speed.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_Transform" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Transform">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Transform.html#GrapeCity_Documents_Imaging_BitmapRenderer_Transform">Transform</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the world transformation matrix.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_TransformInverse" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.TransformInverse">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.TransformInverse.html#GrapeCity_Documents_Imaging_BitmapRenderer_TransformInverse">TransformInverse</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the inverted world transformation matrix. Used for filling regions with gradient brushes.</p>
<p><a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.TransformInverse.html#GrapeCity_Documents_Imaging_BitmapRenderer_TransformInverse">TransformInverse</a> is automatically updated when the <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Transform.html#GrapeCity_Documents_Imaging_BitmapRenderer_Transform">Transform</a> property is changed.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_TransparencyMaskBitmap" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.TransparencyMaskBitmap">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.TransparencyMaskBitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_TransparencyMaskBitmap">TransparencyMaskBitmap</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a grayscale bitmap providing transparency mask for all drawing and filling operations.</p>
<p>
Pixels in the mask with value 0 are fully opaque and will completely mask any drawing
(i.e. the pixels of the target bitmap will remain unchanged).
Pixels in the mask with value 255 are fully transparent, i.e. any drawing
will have the same effect as if there was no mask.
Pixels with values between 0 and 255 will modify the transparency of the pixels being drawn
according to their value.
</p>
<p>
Note that the transparency mask bitmap must be of the same pixel size as the target bitmap.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_UpdatedPixelMask" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.UpdatedPixelMask">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.UpdatedPixelMask.html#GrapeCity_Documents_Imaging_BitmapRenderer_UpdatedPixelMask">UpdatedPixelMask</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a <a class="xref" href="GrapeCity.Documents.Imaging.BilevelBitmap.html">BilevelBitmap</a> that can be used to monitor changes in the target bitmap.
Its pixels are used as boolean flags indicating changes in the target.
When a pixel in the target bitmap is changed, the corresponding pixel in this bitmap
is set to 1 (true).
The <a class="xref" href="GrapeCity.Documents.Imaging.BilevelBitmap.html">BilevelBitmap</a> must have the same pixel size as the target bitmap.
It is user's responsibility to clear this bitmap (fill it with zeros) before any drawing on the target occurs.</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_Imaging_BitmapRenderer_Clear_System_Drawing_Color_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Clear(System.Drawing.Color)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Clear.html#GrapeCity_Documents_Imaging_BitmapRenderer_Clear_System_Drawing_Color_">Clear(Color)</a>
        </td>
        <td class="markdown level1 summary"><p>Clears the image with the specified color.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_Clear_System_UInt32_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.Clear(System.UInt32)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Clear.html#GrapeCity_Documents_Imaging_BitmapRenderer_Clear_System_UInt32_">Clear(uint)</a>
        </td>
        <td class="markdown level1 summary"><p>Clears the image with the specified color.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_DrawBitmap_GrapeCity_Documents_Imaging_GcBitmap_System_Drawing_RectangleF_System_Single_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.DrawBitmap(GrapeCity.Documents.Imaging.GcBitmap,System.Drawing.RectangleF,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.DrawBitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_DrawBitmap_GrapeCity_Documents_Imaging_GcBitmap_System_Drawing_RectangleF_System_Single_">DrawBitmap(GcBitmap, RectangleF, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Draws a <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.Bitmap.html#GrapeCity_Documents_Imaging_BitmapRenderer_Bitmap">Bitmap</a> at the specified location and with the specified size.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_DrawTextLayout_GrapeCity_Documents_Text_TextLayout_System_Single_System_Single_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.DrawTextLayout(GrapeCity.Documents.Text.TextLayout,System.Single,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.DrawTextLayout.html#GrapeCity_Documents_Imaging_BitmapRenderer_DrawTextLayout_GrapeCity_Documents_Text_TextLayout_System_Single_System_Single_">DrawTextLayout(TextLayout, float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Draws a <a class="xref" href="GrapeCity.Documents.Text.TextLayout.html">TextLayout</a> at the given location.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_GrapeCity_Documents_Drawing_Brush_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath(GrapeCity.Documents.Imaging.GraphicsPath,GrapeCity.Documents.Drawing.Brush)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_GrapeCity_Documents_Drawing_Brush_">FillPath(GraphicsPath, Brush)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.GraphicsPath.html">GraphicsPath</a> with the given brush.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_GrapeCity_Documents_Drawing_Brush_System_Drawing_RectangleF_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath(GrapeCity.Documents.Imaging.GraphicsPath,GrapeCity.Documents.Drawing.Brush,System.Drawing.RectangleF)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_GrapeCity_Documents_Drawing_Brush_System_Drawing_RectangleF_">FillPath(GraphicsPath, Brush, RectangleF)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.GraphicsPath.html">GraphicsPath</a> with the given brush.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_System_Drawing_Color_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath(GrapeCity.Documents.Imaging.GraphicsPath,System.Drawing.Color)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_System_Drawing_Color_">FillPath(GraphicsPath, Color)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.GraphicsPath.html">GraphicsPath</a> with a solid color.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_System_UInt32_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath(GrapeCity.Documents.Imaging.GraphicsPath,System.UInt32)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillPath.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillPath_GrapeCity_Documents_Imaging_GraphicsPath_System_UInt32_">FillPath(GraphicsPath, uint)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.GraphicsPath.html">GraphicsPath</a> with a solid color.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_GrapeCity_Documents_Drawing_Brush_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion(GrapeCity.Documents.Imaging.Region,GrapeCity.Documents.Drawing.Brush)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_GrapeCity_Documents_Drawing_Brush_">FillRegion(Region, Brush)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.Region.html">Region</a> with the given brush.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_GrapeCity_Documents_Drawing_Brush_System_Drawing_RectangleF_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion(GrapeCity.Documents.Imaging.Region,GrapeCity.Documents.Drawing.Brush,System.Drawing.RectangleF)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_GrapeCity_Documents_Drawing_Brush_System_Drawing_RectangleF_">FillRegion(Region, Brush, RectangleF)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.Region.html">Region</a> with the given brush.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_System_Drawing_Color_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion(GrapeCity.Documents.Imaging.Region,System.Drawing.Color)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_System_Drawing_Color_">FillRegion(Region, Color)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.Region.html">Region</a> with a solid color.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_System_UInt32_" data-uid="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion(GrapeCity.Documents.Imaging.Region,System.UInt32)">
          <a class="xref" href="GrapeCity.Documents.Imaging.BitmapRenderer.FillRegion.html#GrapeCity_Documents_Imaging_BitmapRenderer_FillRegion_GrapeCity_Documents_Imaging_Region_System_UInt32_">FillRegion(Region, uint)</a>
        </td>
        <td class="markdown level1 summary"><p>Fills a <a class="xref" href="GrapeCity.Documents.Imaging.Region.html">Region</a> with a solid color.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
