source: xtideuniversalbios/trunk/XTIDE_Universal_BIOS_Configurator_v2/Src/Menuitem.asm@ 628

; Project name  :   XTIDE Universal BIOS Configurator v2
; Description   :   Functions for accessing MENUITEM structs.

;
; XTIDE Universal BIOS and Associated Tools
; Copyright (C) 2009-2010 by Tomi Tilli, 2011-2023 by XTIDE Universal BIOS Team.
;
; This program is free software; you can redistribute it and/or modify
; it under the terms of the GNU General Public License as published by
; the Free Software Foundation; either version 2 of the License, or
; (at your option) any later version.
;
; This program is distributed in the hope that it will be useful,
; but WITHOUT ANY WARRANTY; without even the implied warranty of
; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
; GNU General Public License for more details.
; Visit http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
;

; Section containing code
SECTION .text

;--------------------------------------------------------------------
; Menuitem_DisplayHelpMessageFromDSSI
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, DX, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
Menuitem_DisplayHelpMessageFromDSSI:
    mov     di, [si+MENUITEM.szName]
    mov     dx, [si+MENUITEM.szHelp]
    jmp     Dialogs_DisplayHelpFromCSDXwithTitleInCSDI


;--------------------------------------------------------------------
; Menuitem_ActivateMultichoiceSelectionForMenuitemInDSSI
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, BX, CX, SI, DI, ES
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
Menuitem_ActivateMultichoiceSelectionForMenuitemInDSSI:
    call    Registers_CopyDSSItoESDI

    mov     cl, DIALOG_INPUT_size
    call    Memory_ReserveCLbytesFromStackToDSSI
    call    InitializeDialogInputInDSSIfromMenuitemInESDI
    mov     ax, [es:di+MENUITEM.itemValue+ITEM_VALUE.szMultichoice]
    mov     [si+DIALOG_INPUT.fszItems], ax
    push    di
    CALL_MENU_LIBRARY GetSelectionToAXwithInputInDSSI
    pop     di

    inc     ax              ; NO_ITEM_SELECTED ?
    jz      SHORT .NothingToChange
    dec     ax
    call    Registers_CopyESDItoDSSI
    call    Menuitem_StoreValueFromAXtoMenuitemInDSSI
.NothingToChange:
    add     sp, BYTE DIALOG_INPUT_size
    ret


;--------------------------------------------------------------------
; Menuitem_ActivateHexInputForMenuitemInDSSI
; Menuitem_ActivateUnsignedInputForMenuitemInDSSI
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;   Returns:
;       CF:     Cleared if value inputted
;               Set if user cancellation
;   Corrupts registers:
;       AX, BX, CX, SI, DI, ES
;--------------------------------------------------------------------
Menuitem_ActivateHexInputForMenuitemInDSSI:
    mov     bl, 16
    SKIP2B  ax
Menuitem_ActivateUnsignedInputForMenuitemInDSSI:
    mov     bl, 10

    call    Registers_CopyDSSItoESDI
    mov     cl, WORD_DIALOG_IO_size
    call    Memory_ReserveCLbytesFromStackToDSSI
    call    InitializeDialogInputInDSSIfromMenuitemInESDI
    mov     [si+WORD_DIALOG_IO.bNumericBase], bl
    mov     ax, [es:di+MENUITEM.itemValue+ITEM_VALUE.wMinValue]
    mov     [si+WORD_DIALOG_IO.wMin], ax
    mov     ax, [es:di+MENUITEM.itemValue+ITEM_VALUE.wMaxValue]
    mov     [si+WORD_DIALOG_IO.wMax], ax
    push    di
    CALL_MENU_LIBRARY GetWordWithIoInDSSI
    pop     di

    mov     cl, [si+WORD_DIALOG_IO.bUserCancellation]
    cmp     cl, TRUE
    je      SHORT .NothingToChange
    mov     ax, [si+WORD_DIALOG_IO.wReturnWord]
    call    Registers_CopyESDItoDSSI
    call    Menuitem_StoreValueFromAXtoMenuitemInDSSI
.NothingToChange:
    add     sp, BYTE WORD_DIALOG_IO_size
    shr     cl, 1
    ret


;--------------------------------------------------------------------
; InitializeDialogInputInDSSIfromMenuitemInESDI
;   Parameters:
;       DS:SI:  Ptr to DIALOG_INPUT
;       ES:DI:  Ptr to MENUITEM
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
InitializeDialogInputInDSSIfromMenuitemInESDI:
    mov     ax, [es:di+MENUITEM.itemValue+ITEM_VALUE.szDialogTitle]
    mov     [si+DIALOG_INPUT.fszTitle], ax
    mov     [si+DIALOG_INPUT.fszTitle+2], cs

    mov     [si+DIALOG_INPUT.fszItems+2], cs

    mov     ax, [es:di+MENUITEM.szQuickInfo]
    mov     [si+DIALOG_INPUT.fszInfo], ax
    mov     [si+DIALOG_INPUT.fszInfo+2], cs
    ret

;--------------------------------------------------------------------
; Menuitem_StoreValueFromAXtoMenuitemInDSSI
;   Parameters:
;       AX:     Value or multichoice selection to store
;       DS:SI:  Ptr to MENUITEM
;       SS:BP:  Menu handle
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, BX, DI, ES
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
Menuitem_StoreValueFromAXtoMenuitemInDSSI:
%if 0
    ; 3 bytes more but this will always invoke the Writer, even if it's an invalid item type (which might be useful).
    eMOVZX  bx, [si+MENUITEM.bType]
    cmp     bl, TYPE_MENUITEM_HEX
%else
    ; This will only invoke the Writer for valid item types.
    mov     bx, -TYPE_MENUITEM_MULTICHOICE & 0FFh
    add     bl, [si+MENUITEM.bType]
    jnc     SHORT .InvalidItemType
    cmp     bl, TYPE_MENUITEM_HEX - TYPE_MENUITEM_MULTICHOICE
%endif
    ja      SHORT .InvalidItemType

    call    GetConfigurationBufferToESDIforMenuitemInDSSI
    add     di, [si+MENUITEM.itemValue+ITEM_VALUE.wRomvarsValueOffset]

    push    WORD [cs:bx+.rgfnJumpToStoreValueBasedOnItemType]
    mov     bx, [si+MENUITEM.itemValue+ITEM_VALUE.fnValueWriter]
    test    bx, bx
    jnz     SHORT .InvokeWriter
.InvalidItemType:
    pop     bx
.InvokeWriter:
    jmp     bx              ; The Writer can freely corrupt BX

ALIGN WORD_ALIGN
.rgfnJumpToStoreValueBasedOnItemType:
;   dw      .InvalidItemType                                    ; TYPE_MENUITEM_PAGEBACK
;   dw      .InvalidItemType                                    ; TYPE_MENUITEM_PAGENEXT
;   dw      .InvalidItemType                                    ; TYPE_MENUITEM_ACTION
    dw      .StoreMultichoiceValueFromAXtoESDIwithItemInDSSI    ; TYPE_MENUITEM_MULTICHOICE
    dw      .StoreByteOrWordValueFromAXtoESDIwithItemInDSSI     ; TYPE_MENUITEM_UNSIGNED
    dw      .StoreByteOrWordValueFromAXtoESDIwithItemInDSSI     ; TYPE_MENUITEM_HEX

;--------------------------------------------------------------------
; .StoreMultichoiceValueFromAXtoESDIwithItemInDSSI
;   Parameters:
;       AX:     Multichoice selection (index)
;       DS:SI:  Ptr to MENUITEM
;       ES:DI:  Ptr to value variable
;       SS:BP:  Menu handle
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, BX, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
.StoreMultichoiceValueFromAXtoESDIwithItemInDSSI:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_MASKVALUE
    jnz     SHORT .ClearBitsUsingMask
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_FLAGVALUE
    jz      SHORT .TranslateChoiceToValueUsingLookupTable

    test    ax, ax          ; Setting item flag?
    mov     ax, [si+MENUITEM.itemValue+ITEM_VALUE.wValueBitmask]
    jnz     SHORT .SetFlagFromAX
    not     ax
    and     [es:di], ax     ; Clear flag
    jmp     SHORT .SetUnsavedChanges
ALIGN JUMP_ALIGN
.SetFlagFromAX:
    or      [es:di], ax
    jmp     SHORT .SetUnsavedChanges

ALIGN JUMP_ALIGN
.ClearBitsUsingMask:
    mov     bx, [si+MENUITEM.itemValue+ITEM_VALUE.wValueBitmask]
    not     bx
    and     [es:di], bx
    ; Fall to .TranslateChoiceToValueUsingLookupTable


ALIGN JUMP_ALIGN
.TranslateChoiceToValueUsingLookupTable:
;
; if the lookup pointer is NULL, no translation is needed
;
    mov     bx, [si+MENUITEM.itemValue+ITEM_VALUE.rgwChoiceToValueLookup]
    test    bx, bx
    jz      SHORT .StoreByteOrWordValueFromAXtoESDIwithItemInDSSI

    eSHL_IM ax, 1           ; Shift for WORD lookup
    add     bx, ax
    mov     ax, [bx]        ; Lookup complete
    ; Fall to .StoreByteOrWordValueFromAXtoESDIwithItemInDSSI

;--------------------------------------------------------------------
; .StoreByteOrWordValueFromAXtoESDIwithItemInDSSI
;   Parameters:
;       AX:     Value to store
;       DS:SI:  Ptr to MENUITEM
;       ES:DI:  Ptr to value variable
;       SS:BP:  Menu handle
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
.StoreByteOrWordValueFromAXtoESDIwithItemInDSSI:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_MASKVALUE
    jz      SHORT .StoreByteOrWord
    push    cx
    mov     cl, [si+MENUITEM.itemValue+ITEM_VALUE.bFieldPosition]
    shl     ax, cl
    pop     cx
    or      [es:di], ax
    jmp     SHORT .SetUnsavedChanges

.StoreByteOrWord:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_BYTEVALUE
    jnz     SHORT .StoreByteFromAL

    mov     [es:di+1], ah
ALIGN JUMP_ALIGN
.StoreByteFromAL:
    mov     [es:di], al
    ; Fall to .SetUnsavedChanges

;--------------------------------------------------------------------
; .SetUnsavedChanges
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;       SS:BP:  Menu handle
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
.SetUnsavedChanges:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_PROGRAMVAR
    jnz     SHORT .NoUnsavedChangesForProgramVariables
    call    Buffers_SetUnsavedChanges
.NoUnsavedChangesForProgramVariables:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_MODIFY_MENU
    jnz     SHORT .ModifyItemVisibility
    CALL_MENU_LIBRARY RefreshTitle
    CALL_MENU_LIBRARY GetHighlightedItemToAX
    JMP_MENU_LIBRARY RefreshItemFromAX

ALIGN JUMP_ALIGN
.ModifyItemVisibility:
    push    es
    push    ds
    ePUSHA
    call    Menupage_GetActiveMenupageToDSDI
    call    [di+MENUPAGE.fnEnter]
    ePOPA
    pop     ds
    pop     es
    ret


;--------------------------------------------------------------------
; Menuitem_GetValueToAXfromMenuitemInDSSI
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;   Returns:
;       AX:     Menuitem value
;   Corrupts registers:
;       Nothing
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
Menuitem_GetValueToAXfromMenuitemInDSSI:
; Note! Changes to this procedure might require changes to
; ReadRamVars in ConfigurationMenu.asm as well!
    push    es
    push    di
    push    bx
    call    GetConfigurationBufferToESDIforMenuitemInDSSI
    add     di, [si+MENUITEM.itemValue+ITEM_VALUE.wRomvarsValueOffset]
    mov     ax, [es:di]

    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_BYTEVALUE
    jz      SHORT .NoConvertWordToByteValue
    xor     ah, ah          ; conversion needs to happen before call to the reader,
                            ; in case the reader unpacks the byte to a word

.NoConvertWordToByteValue:
    mov     bx, [si+MENUITEM.itemValue+ITEM_VALUE.fnValueReader]
    test    bx,bx
    jz      SHORT .NoReader

    call    bx              ; The Reader can freely corrupt BX, DI and ES

.NoReader:
    pop     bx
    pop     di
    pop     es

    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_MASKVALUE
    jz      SHORT .TestIfFlagValue

    and     ax, [si+MENUITEM.itemValue+ITEM_VALUE.wValueBitmask]
    push    cx
    mov     cl, [si+MENUITEM.itemValue+ITEM_VALUE.bFieldPosition]
    shr     ax, cl
    pop     cx
    ret

.TestIfFlagValue:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_FLAGVALUE
    jz      SHORT .Return

    test    ax, [si+MENUITEM.itemValue+ITEM_VALUE.wValueBitmask]
    mov     ax, TRUE<<1     ; Shift for lookup
    jnz     SHORT .Return
    xor     ax, ax

ALIGN JUMP_ALIGN, ret
.Return:
    ret


;--------------------------------------------------------------------
; GetConfigurationBufferToESDIforMenuitemInDSSI
;   Parameters:
;       DS:SI:  Ptr to MENUITEM
;   Returns:
;       ES:DI:  Ptr to configuration buffer
;   Corrupts registers:
;       Nothing
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
GetConfigurationBufferToESDIforMenuitemInDSSI:
    test    BYTE [si+MENUITEM.bFlags], FLG_MENUITEM_PROGRAMVAR
    jnz     SHORT .ReturnCfgvarsInESDI
    jmp     Buffers_GetFileBufferToESDI
ALIGN JUMP_ALIGN
.ReturnCfgvarsInESDI:
    push    cs
    pop     es
    mov     di, g_cfgVars
    ret


;--------------------------------------------------------------------
; EnableMenuitemFromCSBX
; DisableMenuitemFromCSBX
;   Parameters:
;       CS:BX:  Ptr to MENUITEM
;   Returns:
;       Nothing
;   Corrupts registers:
;       Nothing
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
EnableMenuitemFromCSBX:
    or      BYTE [cs:bx+MENUITEM.bFlags], FLG_MENUITEM_VISIBLE
    ret

ALIGN JUMP_ALIGN
DisableMenuitemFromCSBX:
    and     BYTE [cs:bx+MENUITEM.bFlags], ~FLG_MENUITEM_VISIBLE
    ret