## Please enable JavaScript to view this site.

# FALCON/EAGLE user manual 4.62

- Zoom window out
- Larger text | Smaller text
- Hide page header
- Show expanding text
- Print topic
- Send mail feedback
- Copy topic URL

is_SetDisplayMode | Scroll Previous Top Next More

Syntax

INT is_SetDisplayMode (HIDS hf, INT Mode)

Description

is_SetDisplayMode() defines the way in which images are displayed on the screen. For real live video plus overlay, the DirectDraw overlay surface mode has been introduced. The availability of this mode depends upon the type of VGA card used. Only certain VGA controllers support this mode. The best known are the S3 Virge VX (limitations apply) S3 Virge DX/GX/GX2 and the 3D RagePro Chip. This overlay mode can be used with these VGA chips in 8, 15 and 16 bit VGA mode. True color (24 bit) is not supported. In 8 bit VGA mode, the color mode has to be set to RGB15!

The VGA card should have at least 4MB on-board, as the overlay mode requires memory up to the size of the current VGA resolution.

For example: VGA with 1024 x 768 x 16 = 1.5 MB > OverlayBuffer with up to 1.5 MB required: VGA card with 4MB recommended

Using a VGA resolution of 640 x 480 the image size must be limited to the same size before starting a Direct-Draw mode. For this purpose function is_SetImageSize() can be used.

Example

is_SetDisplayMode (hf, Mode);

•Bitmap mode (digitized in system memory):
Mode = IS_SET_DM_DIB

•DirectDraw back buffer mode (overlay possible, see is_EnableDDOverlay()):
Mode = IS_SET_DM_DIRECTDRAW

•Direct3D mode (overlay possible, see is_DirecRenderer()):
Mode = IS_SET_DM_DIRECT3D

•Allows memory storage in system memory:
Mode = IS_SET_DM_DIRECTDRAW | IS_SET_DM_ALLOW_SYSMEM

•DirectDraw primary surface mode (no overlay possible):
Mode = IS_SET_DM_DIRECTDRAW | IS_SET_DM_ALLOW_PRIMARY

•DirectDraw overlay surface mode (best live overlay):
Mode = IS_SET_DM_DIRECTDRAW | IS_SET_DM_ALLOW_OVERLAY

•Allows automatic scaling to the size of window:
Mode = IS_SET_DM_DIRECTDRAW | IS_SET_DM_ALLOW_OVERLAY | IS_SET_DM_ALLOW_SCALING

•Allows automatic scaling to the size of window:
Mode = IS_SET_DM_DIRECTDRAW | IS_SET_DM_ALLOW_OVERLAY | IS_SET_DM_ALLOW_SCALING | IS_SET_DM_ALLOW_FIELDSKIP

All other combinations are not valid!

Parameters

hf | Frame grabber handle
Mode |
1 IS_SET_DM_DIB | Acquire image in image memory (no automatic display!)
2 IS_SET_DM_DIRECTDRAW | DirectDraw mode (back buffer mode)
IS_SET_DM_DIRECT3D | Direct3D mode
DirectDraw Back Buffer Erweiterung |
0x40 IS_SET_DM_ALLOW_SYSMEM | DirectDraw buffer can be set in PC, if the VGA memory is not large enough
DirectDraw Primary Surface Erweiterung |
0x80 IS_SET_DM_ALLOW_PRIMARY | Primary surface mode (no overlay possible)
DirectDraw Overlay Surface Erweiterung |
0x100 IS_SET_DM_ALLOW_OVERLAY | Overlay surface mode
0x200 IS_SET_DM_ALLOW_SCALING | Real time scaling in overlay surface mode
0x400 IS_SET_DM_ALLOW_FIELDSKIP | Field representation at ysize ≤ PAL/2 (288)
Rücklesemodus |
0x8000 IS_GET_DISPLAY_MODE | Returns the current setting

Return value

When used with IS_GET_DISPLAY_MODE | Current setting
IS_SUCCESS | General success message
IS_NO_SUCCESS | General error message
IS_DR_LIBRARY_NOT_FOUND | The DirectRender library could not be found
IS_DR_DEVICE_OUT_OF_MEMORY | Insufficient graphics adapter video memory
IS_DR_CANNOT_CREATE_SURFACE | The image or overlay surface could not be created
IS_DR_CANNOT_CREATE_VERTEX_BUFFER | The vertex buffer could not be created
IS_DR_CANNOT_CREATE_TEXTURE | The texture could not be created
IS_DR_CANNOT_LOCK_OVERLAY_SURFACE | The overlay surface could not be locked
IS_DR_CANNOT_UNLOCK_OVERLAY_SURFACE | The overlay surface could not be unlocked
IS_DR_CANNOT_GET_OVERLAY_DC | Cannot get the overlay surface DC
IS_DR_CANNOT_RELEASE_OVERLAY_DC | Cannot release the overlay surface DC
IS_DR_DEVICE_CAPS_INSUFFICIENT | Insufficient graphics adapter capabilities
IS_DR_SURFACE_LOST | Created surfaces were lost and recreated
IS_DR_CANNOT_LOCK_IMAGE_SURFACE | The image surface could not be locked
IS_DR_CANNOT_UNLOCK_IMAGE_SURFACE | The image surface could not be unlocked
IS_DR_LIBRARY_NOT_FOUND | The DirectRender library could not be found
IS_DR_DEVICE_OUT_OF_MEMORY | Insufficient graphics adapter video memory
IS_DR_CANNOT_CREATE_SURFACE | The image or overlay surface could not be created
IS_DR_CANNOT_CREATE_VERTEX_BUFFER | The vertex buffer could not be created
IS_DR_CANNOT_CREATE_TEXTURE | The texture could not be created
IS_DR_CANNOT_LOCK_OVERLAY_SURFACE | The overlay surface could not be locked
IS_DR_CANNOT_UNLOCK_OVERLAY_SURFACE | The overlay surface could not be unlocked
IS_DR_CANNOT_GET_OVERLAY_DC | Cannot get the overlay surface DC
IS_DR_CANNOT_RELEASE_OVERLAY_DC | Cannot release the overlay surface DC
IS_DR_DEVICE_CAPS_INSUFFICIENT | Insufficient graphics adapter capabilities
IS_DR_SURFACE_LOST | Created surfaces were lost and recreated
IS_DR_CANNOT_LOCK_IMAGE_SURFACE | The image surface could not be locked
IS_DR_CANNOT_UNLOCK_IMAGE_SURFACE | The image surface could not be unlocked

© 2020 IDS Imaging Development Systems GmbH