ShellPkg: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / ShellPkg / Library / UefiShellDebug1CommandsLib / HexEdit / BufferImage.h

/** @file\r
    Defines BufferImage - the view of the file that is visible at any point,\r
    as well as the event handlers for editing the file\r
\r
  Copyright (c) 2005 - 2018, Intel Corporation. All rights reserved. <BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef _LIB_BUFFER_IMAGE_H_\r
#define _LIB_BUFFER_IMAGE_H_\r
\r
#include "HexEditor.h"\r
\r
/**\r
  Initialization function for HBufferImage\r
\r
  @retval EFI_SUCCESS       The operation was successful.\r
  @retval EFI_LOAD_ERROR    A load error occured.\r
**/\r
EFI_STATUS\r
HBufferImageInit (\r
  VOID\r
  );\r
\r
/**\r
  Cleanup function for HBufferImage\r
\r
  @retval EFI_SUCCESS  The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageCleanup (\r
  VOID\r
  );\r
\r
/**\r
  Refresh function for HBufferImage.\r
\r
  @retval EFI_SUCCESS     The operation was successful.\r
  @retval EFI_LOAD_ERROR  A Load error occured.\r
\r
**/\r
EFI_STATUS\r
HBufferImageRefresh (\r
  VOID\r
  );\r
\r
/**\r
  Dispatch input to different handler\r
\r
  @param[in] Key    The input key:\r
                     the keys can be:\r
                       ASCII KEY\r
                        Backspace/Delete\r
                        Direction key: up/down/left/right/pgup/pgdn\r
                        Home/End\r
                        INS\r
\r
  @retval EFI_SUCCESS           The operation was successful.\r
  @retval EFI_LOAD_ERROR        A load error occured.\r
  @retval EFI_OUT_OF_RESOURCES  A Memory allocation failed.\r
**/\r
EFI_STATUS\r
HBufferImageHandleInput (\r
  IN  EFI_INPUT_KEY *Key\r
  );\r
\r
/**\r
  Backup function for HBufferImage. Only a few fields need to be backup.\r
  This is for making the file buffer refresh as few as possible.\r
\r
  @retval EFI_SUCCESS  The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageBackup (\r
  VOID\r
  );\r
\r
/**\r
  Read an image into a buffer friom a source.\r
\r
  @param[in] FileName     Pointer to the file name.  OPTIONAL and ignored if not FileTypeFileBuffer.\r
  @param[in] DiskName     Pointer to the disk name.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] DiskOffset   Offset into the disk.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] DiskSize     Size of the disk buffer.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] MemOffset    Offset into the Memory.  OPTIONAL and ignored if not FileTypeMemBuffer.\r
  @param[in] MemSize      Size of the Memory buffer.  OPTIONAL and ignored if not FileTypeMemBuffer.\r
  @param[in] BufferType   The type of buffer to save.  IGNORED.\r
  @param[in] Recover      TRUE for recovermode, FALSE otherwise.\r
\r
  @return EFI_SUCCESS     The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageRead (\r
  IN CONST CHAR16                   *FileName,\r
  IN CONST CHAR16                   *DiskName,\r
  IN UINTN                          DiskOffset,\r
  IN UINTN                          DiskSize,\r
  IN UINTN                          MemOffset,\r
  IN UINTN                          MemSize,\r
  IN EDIT_FILE_TYPE                 BufferType,\r
  IN BOOLEAN                        Recover\r
  );\r
\r
/**\r
  Save the current image.\r
\r
  @param[in] FileName     Pointer to the file name.  OPTIONAL and ignored if not FileTypeFileBuffer.\r
  @param[in] DiskName     Pointer to the disk name.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] DiskOffset   Offset into the disk.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] DiskSize     Size of the disk buffer.  OPTIONAL and ignored if not FileTypeDiskBuffer.\r
  @param[in] MemOffset    Offset into the Memory.  OPTIONAL and ignored if not FileTypeMemBuffer.\r
  @param[in] MemSize      Size of the Memory buffer.  OPTIONAL and ignored if not FileTypeMemBuffer.\r
  @param[in] BufferType   The type of buffer to save.  IGNORED.\r
\r
  @return EFI_SUCCESS     The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageSave (\r
  IN CHAR16                         *FileName,\r
  IN CHAR16                         *DiskName,\r
  IN UINTN                          DiskOffset,\r
  IN UINTN                          DiskSize,\r
  IN UINTN                          MemOffset,\r
  IN UINTN                          MemSize,\r
  IN EDIT_FILE_TYPE                 BufferType\r
  );\r
\r
/**\r
  According to cursor's file position, adjust screen display.\r
\r
  @param[in] NewFilePosRow    Row of file position ( start from 1 ).\r
  @param[in] NewFilePosCol    Column of file position ( start from 1 ).\r
  @param[in] HighBits         Cursor will on high4 bits or low4 bits.\r
**/\r
VOID\r
HBufferImageMovePosition (\r
  IN UINTN    NewFilePosRow,\r
  IN UINTN    NewFilePosCol,\r
  IN BOOLEAN  HighBits\r
  );\r
\r
\r
/**\r
  Create a new line and append it to the line list.\r
    Fields affected:\r
    NumLines\r
    Lines\r
\r
  @retval NULL    create line failed.\r
  @return         the line created.\r
\r
**/\r
HEFI_EDITOR_LINE  *\r
HBufferImageCreateLine (\r
  VOID\r
  );\r
\r
/**\r
  Free the current image.\r
\r
  @retval EFI_SUCCESS   The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageFree (\r
  VOID\r
  );\r
\r
/**\r
  Delete character from buffer.\r
\r
  @param[in] Pos      Position, Pos starting from 0.\r
  @param[in] Count    The Count of characters to delete.\r
  @param[out] DeleteBuffer    The DeleteBuffer.\r
\r
  @retval EFI_SUCCESS Success\r
**/\r
EFI_STATUS\r
HBufferImageDeleteCharacterFromBuffer (\r
  IN  UINTN         Pos,\r
  IN  UINTN         Count,\r
  OUT UINT8         *DeleteBuffer\r
  );\r
\r
/**\r
  Add character to buffer, add before pos.\r
\r
  @param[in] Pos        Position, Pos starting from 0.\r
  @param[in] Count      Count of characters to add.\r
  @param[in] AddBuffer  Add buffer.\r
\r
  @retval EFI_SUCCESS   Success.\r
**/\r
EFI_STATUS\r
HBufferImageAddCharacterToBuffer (\r
  IN  UINTN          Pos,\r
  IN  UINTN          Count,\r
  IN  UINT8          *AddBuffer\r
  );\r
\r
/**\r
  Change the raw buffer to a list of lines for the UI.\r
\r
  @param[in] Buffer   The pointer to the buffer to fill.\r
  @param[in] Bytes    The size of the buffer in bytes.\r
\r
  @retval EFI_SUCCESS           The operation was successful.\r
  @retval EFI_OUT_OF_RESOURCES  A memory allocation failed.\r
**/\r
EFI_STATUS\r
HBufferImageBufferToList (\r
  IN VOID   *Buffer,\r
  IN UINTN  Bytes\r
  );\r
\r
/**\r
  Change the list of lines from the UI to a raw buffer.\r
\r
  @param[in] Buffer   The pointer to the buffer to fill.\r
  @param[in] Bytes    The size of the buffer in bytes.\r
\r
  @retval EFI_SUCCESS   The operation was successful.\r
**/\r
EFI_STATUS\r
HBufferImageListToBuffer (\r
  IN VOID   *Buffer,\r
  IN UINTN  Bytes\r
  );\r
\r
/**\r
  Move the mouse in the image buffer.\r
\r
  @param[in] TextX    The x-coordinate.\r
  @param[in] TextY    The y-coordinate.\r
**/\r
VOID\r
HBufferImageAdjustMousePosition (\r
  IN INT32 TextX,\r
  IN INT32 TextY\r
  );\r
\r
/**\r
  Function to decide if a column number is stored in the high bits.\r
\r
  @param[in] Column     The column to examine.\r
  @param[out] FCol      The actual column number.\r
\r
  @retval TRUE      The actual column was in high bits and is now in FCol.\r
  @retval FALSE     There was not a column number in the high bits.\r
**/\r
BOOLEAN\r
HBufferImageIsAtHighBits (\r
  IN  UINTN Column,\r
  OUT UINTN *FCol\r
  );\r
\r
/**\r
  Get the size of the open buffer.\r
\r
  @retval The size in bytes.\r
**/\r
UINTN\r
HBufferImageGetTotalSize (\r
  VOID\r
  );\r
\r
#endif\r