Unit 'cybergraphics' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

BestCModeIDTagList

Calculate the best ModeID with given parameters

Declaration

Source position: cybergraphics.pas line 155

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:

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.

See also

BestCModeIDTags

  

VarArgs version of BestCModeIDTagList


Documentation generated on: 2021-07-30