Render(RasterImage,RasterRenderBuffer,LeadRect,RasterImageRenderProperties) Method

public static void Render( 
   RasterImage image,
   RasterRenderBuffer buffer,
   LeadRect destRect,
   RasterImageRenderProperties properties
)

'Declaration
 
Public Overloads Shared Sub Render( _
   ByVal image As RasterImage, _
   ByVal buffer As RasterRenderBuffer, _
   ByVal destRect As LeadRect, _
   ByVal properties As RasterImageRenderProperties _
) 

'Usage
 
Dim image As RasterImage
Dim buffer As RasterRenderBuffer
Dim destRect As LeadRect
Dim properties As RasterImageRenderProperties
 
RasterImageRenderer.Render(image, buffer, destRect, properties)

public static void Render( 
   RasterImage image,
   RasterRenderBuffer buffer,
   LeadRect destRect,
   RasterImageRenderProperties properties
)

 function Leadtools.Converters.RasterImageRenderer.Render(RasterImage,RasterRenderBuffer,LeadRect,RasterImageRenderProperties)( 
   image ,
   buffer ,
   destRect ,
   properties 
)

public:
static void Render( 
   RasterImage^ image,
   RasterRenderBuffer^ buffer,
   LeadRect destRect,
   RasterImageRenderProperties^ properties
) 

Parameters

image

The source image.

buffer

The destination RasterRenderBuffer conating the destination image data where the image will be rendered.

destRect

Leadtools.LeadRect

A Leadtools.LeadRect object that determines how the image is scaled and positioned in the destination buffer.

The coordinates of destRect are in pixels. There is no default for this parameter. You must specify the Leadtools.LeadRect values.

properties

Rendering options.

Assuming the source rectangle is the whole image, this method lets you specify a source rectangle (with coordinates relative to the image) and a destination rectangle (with coordinates relative to the destination buffer object). Scaling of the displayed image depends on the relationship between these two rectangles, as shown in the following illustration:

Note: These illustrations are for an image with a RasterViewPerspective.TopLeft view perspective. For an explanation of image coordinates and view perspectives, refer to Accounting for View Perspective. If the image is not in RasterViewPerspective.TopLeft view perspective, refer to Changing Image Coordinates.

In addition, you can specify a clipping area within either rectangle to limit the area to be rendered. For the destination rectangle, a clipping area is commonly specified to re-render part of the image that was temporarily covered up. For a source rectangle, you can use a clipping area to update the display when only part of the image in the source rectangle has changed.

The following illustration shows how specifying a source clipping area affects the display. Text has been added to the source image (using the image as a display surface), and the source clipping area specifies the area to be rendered.

You can specify the various rectangles in any way that meets your needs. Coordinates can have negative values and they can extend beyond the bounds of the image or destination buffer object. In fact, it is common for the display rectangle to be bigger than the destination buffer dimension, where scroll bars are used to see different parts of the image.

For an example, refer to RasterImageRenderer.

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RasterImageRenderer Class
RasterImageRenderer Members
Overload List