Unit 'CYBERGRAPHICS'	Package
[Overview][Constants][Types][Procedures and functions][Variables][Index]	[#morphunits]

BestCModeIDTagList

Calculate the best ModeID with given parameters

Declaration

Source position: cybergraphics.pas line 300

function BestCModeIDTagList(

BestModeIDTags: PTagItem

):LongWord;

Arguments

BestModeIDTags

Pointer to an array of TagItems describing the wanted screen mode

Function result

DisplayID of the best mode to use, or INVALID_ID if a match could not be found.

Description

Returns the CyberGraphX displaymode ID which fits best for the parameters supplied in the TagList.

Available Tags:

CYBRBIDTG_Depth

(Word) Depth the returned ModeID must support. Default is 8

CYBRBIDTG_NominalWidth

(Word) desired width the ModeID should have

CYBRBIDTAG_NominalHeight

(Word) desired height the ModeID should have

CYBRBIDTG_MonitorID

(LongWord) if multiple graphics boards are installed in the system, you can choose the desired one with this tag Currently supported boards are:

1 = CVision64
2 = Piccolo
3 = PicassoII
4 = Spectrum
5 = Domino
6 = RetinaZ3/DraCoAltais
7 = PiccoSD64
8 = A2410
13 = CVision3D (V41)
14 = Inferno (V41)
15 = PicassoIV (V41)

CYBRBIDTG_BoardName

(STRPTR) - Specify the card name directly. For example, pass 'CVision3D' to get a CyberVision64/3D board ID

Errors

Older versions return displaymode IDs with wrong depth if the desired color depth is not available. If you specify very small widths/heights (e.g. 50/20 icon size) this call returns INVALID_ID instead of the smallest available lowres ID.