Home > Function descriptions > History back  Previous chapter  Next chapter  Print  

SetRenderMode

uEye ActiveX Manual Version 4.00

SetRenderMode

Syntax

LONG SetRenderMode (LONG nMode)

Description

SetRenderMode() sets the way the image is scaled and displayed. Three modes of operation are available:

Normal rendering:
The image is displayed with a scale factor of 1. If the image is larger than the display window then the image is clipped at the right and bottom side.

Fit to display window:
The image is scaled to fit exactly in the display window. The aspect ratio of the displayed image may not be identical to the aspect ratio of the original image. Therefore objects may appear stretched or shrinked.

Downscale 1:2:
The image is displayed with a downscale factor of 2. If the scaled image is larger than the display window then the image is clipped at the right and bottom side. This mode is not supported when using Direct3D.

Parameters

nMode

 

IS_RENDER_NORMAL

Non-scaled image display

IS_RENDER_FIT_TO_WINDOW

scaled image display to fit in the display window

IS_RENDER_DOWNSCALE_1_2

1:2 downscaled image

Return values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related properties

InitFitToWindow

Related functions

SetViewWindow()


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.


© 2012 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com