/* Ebitor_private.h
Copyright (C) 2021-2025 Pierre Sarrazin
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 3 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.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
*/
#ifndef _H_Ebitor_private
#define _H_Ebitor_private
#include "Ebitor.h"
#include
#define min(a, b) ((a) < (b) ? (a) : (b))
extern Ebitor Ebitor_instance;
void Ebitor_startCommandMode(void);
// key: Must be a printable character in 32..255.
//
void Ebitor_processPrintableChar(word key, byte cursorCol, byte cursorRow);
// Prints the edit buffer starting from firstLogicalCharOffsetToPrint and stopping
// when the end of the edit buffer or the end of the window has been reached.
// The printing starts at column 0 of firstRowToFill.
//
void Ebitor_fillTerminalToBottom(size_t firstLogicalCharOffsetToPrint, byte firstRowToFill);
// Does not move the logical cursor.
//
void Ebitor_insertChar(char c);
// Determines if the region of the text at 'regionOffset' and of the given 'regionLength'
// is entirely visible in the terminal, assuming that the cursor offset is at (cursorCol, cursorRow)
// on the terminal.
// Assumes that the region specification is valid, i.e., it is within the filled buffer.
// Assumes that the insert buffer is empty.
//
// *homeOffset gets filled by Ebitor_getLogicalOffsetAtHome().
// Returns -1 if region is (entirely or partly) before displayed text (*firstOffWindowOffset does NOT get filled).
// Returns +1 if region is (entirely or partly) after displayed text (*firstOffWindowOffset gets filled).
// Returns 0 if region is entirely in the displayed text (*firstOffWindowOffset gets filled).
//
char Ebitor_isRegionVisible(size_t regionOffset, size_t regionLength, byte cursorCol, byte cursorRow,
size_t *homeOffset, size_t *firstOffWindowOffset);
// firstOffWindowOffset: Must designate a position that would be displayed at the start of a window row.
//
size_t Ebitor_countRowsToScrollUp(size_t logicalOffsetToShow, size_t firstOffWindowOffset);
// Stores in *logicalOffsetAtStartOfTermRow the number rows by which the terminal
// must be scrolled down to show the given logical offset (logicalOffsetToShow) in the first row.
// homeOffset: Value obtained from Ebitor_getLogicalOffsetAtHome().
//
size_t Ebitor_countRowsToScrollDown(size_t logicalOffsetToShow, size_t homeOffset,
size_t *logicalOffsetAtStartOfTermRow);
void Ebitor_processBackspace(byte cursorCol, byte cursorRow);
// solOffset: Must be the start of the edit buffer or be preceded by an EOL terminator.
// Returns solOffset itself if no previous line.
//
size_t Ebitor_findPreviousSOL(size_t solOffset);
// firstLogicalCharOffsetToPrint: Must designate a character that is to appear at the start of a terminal row.
//
void Ebitor_fillWindowFromHomeToRow(size_t firstLogicalCharOffsetToPrint, byte numRowsToFill);
// startOfRowOffset: Logical offset of a character that is in column 0.
// Returns the logical offset of another character down the text that is also in column 0.
// If there are not enough rows, stops at the last row.
//
size_t Ebitor_goDownRows(size_t startOfRowOffset, size_t numRows);
void Ebitor_locateAndSavePos(byte col, byte row);
#endif /* _H_Ebitor_private */