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 |
Acquire image in image memory (no automatic display!) |
2 |
DirectDraw mode (back buffer mode) |
IS_SET_DM_DIRECT3D |
Direct3D mode |
DirectDraw Back Buffer Erweiterung |
|
0x40 |
DirectDraw buffer can be set in PC, if the VGA memory is not large enough |
DirectDraw Primary Surface Erweiterung |
|
0x80 |
Primary surface mode (no overlay possible) |
DirectDraw Overlay Surface Erweiterung |
|
0x100 |
Overlay surface mode |
0x200 |
Real time scaling in overlay surface mode |
0x400 |
Field representation at ysize ≤ PAL/2 (288) |
Rücklesemodus |
|
0x8000 |
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 |
