view.h

Go to the documentation of this file.

/** @file view.h
    @brief View data structures, enums, types, end external declarations
    @author Bill Waller
    Copyright (c) 2025
    MIT License
    billxwaller@gmail.com
    @date 2026-02-09
 */
 
#ifndef _VIEW_H
#define _VIEW_H 1
 
#define _GNU_SOURCE
// #define _XOPEN_SOURCE_EXTENDED 1
#define NCURSES_WIDECHAR 1
#ifdef UAL_UI
#include "../ui/ui_ncurses_internal.h"
#include "ui_backend.h"
#include <ncursesw/ncurses.h>
#include <ncursesw/panel.h>
#else
#include "../ui/ui_notcurses_internal.h"
#include "ui_backend.h"
#include <notcurses/notcurses.h>
#endif
 
#include <signal.h>
#include <stddef.h>
#include <stdlib.h>
#ifndef _COMMON_H
typedef struct Init Init;
#endif
#define COLOR_LEN 8
#define NPOS 256
#define NMARKS 256
#define MAXLEN 256
#define NULSL
#define NULL_POSITION -1
#define VBUFSIZ 65536
#define BUFSIZ 8192
#define PAD_COLS 4096
 
typedef enum { PT_NONE,
               PT_SHORT,
               PT_LONG,
               PT_STRING } PromptType;
 
#define LINE_TBL_INCR
    1024 // number of entries to add to line_tbl when reallocating
 
typedef struct {
    off_t sl_ln_no;        // Line number
    char *sl_s[MAXLEN];    // Stripped subline
    UiCell *sl_cc[MAXLEN]; // Subline cchar_t array
    uint sl_cols[MAXLEN];  // Column widths (for cursor/layout calculations)
    uint sl_cells[MAXLEN]; // Number of cchar_t items in this subline chunk
    uint sl_idx;           // Index tracking sublines
    uint sl_cnt;           // Number of sublines
} SplitLine;
 
typedef struct {
    uint fg_clr_idx;             /**< foreground_color */
    uint bg_clr_idx;             /**< background_color */
    uint bo_clr_idx;             /**< bold_color */
    uint ln_clr_idx;             /**< line_number_color */
    uint ln_bg_clr_idx;          /**< line_number_background_color */
    char fg_clr_x[COLOR_LEN];    /**< foreground_color in hex, e.g. "#RRGGBB" */
    char bg_clr_x[COLOR_LEN];    /**< background_color in hex, e.g. "#RRGGBB" */
    char bo_clr_x[COLOR_LEN];    /**< bold_color in hex, e.g. "#RRGGBB" */
    char ln_clr_x[COLOR_LEN];    /**< line_number_color in hex, e.g. "#RRGGBB" */
    char ln_bg_clr_x[COLOR_LEN]; /**< line_number_background_color in hex */
    uint lines;                  /**< number of lines for window size */
    uint cols;                   /**< number of columns for window size */
    uint begy;                   /**< screen line upper left corner of window */
    uint begx;                   /**< screen column upper left corner of window */
    char provider_cmd[MAXLEN];   /**< command provides input */
    char receiver_cmd[MAXLEN];   /**< command receives output */
    char cmd[MAXLEN];            /**< command to execute in foreground, e.g. an editor */
    char cmd_all[MAXLEN];        /**< View - command to execute at start of program */
    char prompt_str[MAXLEN];     /**< prompt string for chyron */
    char title[MAXLEN];          /**< title string for window */
    int argc;                    /**< command line arguments count */
    char **argv;                 /**< command line arguments vector */
    int optind;                  /**< getopt pointer to non-option arguments in argv */
    bool f_ignore_case;          /**< View - ignore case in search */
    bool f_at_end_remove;        /**< obsolete, unneeded */
    bool f_squeeze;              /**< View - print one line for each group of blank lines */
    bool f_strip_ansi;           /**< strip ansi escape sequences when writing buffer */
    bool f_multiple_cmd_args;    /**< View - put multiple arguments in a single */
 
#ifdef ASDF
    WINDOW *box_win;
    PANEL *box_pan;
    WINDOW *win_win;
    WINDOW *lnno_win;
    WINDOW *cmdln_win;
    WINDOW *pad;
    WINDOW *pad_view_win;
    PANEL *pad_view_pan;
#endif
    UiSurface *sfc;              /**< pointer to UI surface structure */
    char tmp_prompt_str[MAXLEN]; /**< temporary prompt string used when building
                                    prompt */
    int curr_argc;               /**< current argument count when processing multiple */
 
    char cmd_arg[MAXLEN];   /**< argument string */
    int tab_stop;           /**< number of spaces between tab stops */
    int h_shift;            /**< horizontal scroll shift width */
    int next_cmd_char;      /**< index of next character in cmd string to process
                               when building prompt */
    bool f_bod;             /**< beginning of data */
    bool f_eod;             /**< end of data */
    bool f_forward;         /**< motion flag forward */
    bool f_is_pipe;         /**< input is from a pipe */
    char file_name[MAXLEN]; /**< basename of file being viewed */
    bool f_redisplay_page;  /**< flag indicating page needs to be redisplayed */
    bool f_displaying_help; /**< currently didsplaying help information */
    bool f_first_iter;      /**< first iteration of search */
    bool f_search_complete; /**< Entire file has been searched */
    bool f_full_screen;     /**< default mode if lines and columns not specified */
    bool f_timer;           /**< time commands and display elapsed time in prompt */
 
    bool f_cmd;                       /**< cmd is verified */
    bool f_cmd_all;                   /**< cmd_all is verified */
    char cur_file_str[MAXLEN];        /**< file currently open for viewing */
    char line_in_s[PAD_COLS];         /**< raw input line from buffer */
    char line_out_s[PAD_COLS];        /**< scratch buffer */
    char stripped_line_out[PAD_COLS]; /**< printable characters only */
    UiCell cmplx_buf[PAD_COLS];       /**< complex character buffer */
    char *line_out_p;                 /**< pointer to current position in line_out_s */
    char *line_in_beg_p;              /**< pointer used in matching search targets */
    char *line_in_end_p;              /**< pointer used in matching search targets */
    uint cury;                        /**< cury is the pad row of the cursor location */
    uint curx;                        /**< curx is the pad column of the cursor location */
    uint scroll_lines;                /**< number of lines to scroll */
    uint cmd_line;                    /**< command line location on pad */
    uint maxcol;                      /**< length of longest line on pad */
    uint pminrow;                     /**< first pad row displayed in view window */
    uint pmincol;                     /**< first pad column displayed in view window */
    uint sminrow;                     /**< screen position of first row of pad displayed in view
                                        window */
    uint smincol;                     /**< screen position of first column of pad displayed in view
                                        window */
    uint smaxrow;                     /**< screen position of last row of pad displayed in view
                                        windiow */
    uint smaxcol;                     /**< screen position of last column of pad displayed in view
                                        window */
    uint first_match_x;               /**< first column of current search match in
                                        stripped_line_out */
    uint last_match_x;                /**< last column of current search match in
                                        stripped_line_out */
    char in_spec[MAXLEN];             /**< input file spec */
    char out_spec[MAXLEN];            /**< output file spec */
    char help_spec[MAXLEN];           /**< help file spec */
    bool f_in_spec;                   /**< input file verified */
    bool f_out_spec;                  /**< output file verified */
    bool f_help_spec;                 /**< output file verified */
    char *file_spec_ptr;              /**< pointer to current file spec */
    char *next_file_spec_ptr;         /**< pointer to next file spec */
    char *tmp_file_name_ptr;          /**< pointer to temporary file spec */
    off_t file_size;                  /**< size of file being viewed */
    off_t file_pos;                   /**< current file position */
    off_t prev_file_pos;              /**< previous file position */
    off_t page_top_pos;               /**< file position of top line displayed */
    off_t page_bot_pos;               /**< file position of last line displayed */
    off_t page_bot_end_pos;           /**< file position of last line displayed */
    off_t srch_curr_pos;              /**< current search position */
    off_t srch_beg_pos;               /**< file position when search started */
    off_t page_top_ln_no;             /**< line number of top line displayed */
    off_t page_bot_ln_no;             /**< line number of last line displayed */
    off_t srch_curr_ln_no;            /**< current search position */
    off_t srch_beg_ln_no;             /**< file position when search started */
    off_t mark_tbl[NMARKS];           /**< not implemented */
    bool f_in_pipe;                   /**< input is from a pipe */
    int in_fd;                        /**< input file descriptor */
    int tmp_fd;                       /**< temporary file descriptor */
    int out_fd;                       /**< output file descriptor */
    FILE *in_fp;                      /**< pointer to input stream data structure */
    int stdin_fd;                     /**< standard input file descriptor */
    FILE *stdin_fp;                   /**< pointer to standard input stream data structure */
    int stdout_fd;                    /**< standard output file descriptor */
    FILE *stdout_fp;                  /**< pointer to standard output stream data structure */
    char *buf;                        /**< pointer to first byte of virtual buffer */
    char *buf_curr_ptr;               /**< pointer to current position in virtual buffer */
    char *buf_end_ptr;                /**< pointer to first byte after end of data in virtual
                                         buffer */
    char *lnbuf;                      /**< pointer to first byte of virtual buffer */
    char *lnbuf_curr_ptr;             /**< pointer to first byte of virtual buffer */
    char *lnbuf_end_ptr;              /**< pointer to first byte after end of data in virtual
                                       buffer */
    uint ln_win_lines;                /**< number of lines in line number window */
    uint ln_win_cols;                 /**< number of columns in line number window */
    bool f_ln;                        /**< flag - number lines */
    off_t ln_no;                      /**< line number */
    off_t ln_no_max;                  /**< last line number */
    char ln_s[10];                    /**< line number formatted string */
    off_t *ln_tbl;                    /**< line number table - array of file positions */
    off_t ln_tbl_size;                /**< number of entries allocated in line_tbl */
    off_t ln_tbl_cnt;                 /**< number of entries used in line_tbl */
    off_t ln_max_pos;                 /**< position of last page number increment */
    bool wrap;                        /** flag - wrap lines longer than window width */
    SplitLine cur;                    /**< split line structure for current line displayed */
    bool page_top_sl;                 /**< flag - flag top line split */
    bool page_bot_sl;                 /**< flag - flag bottom line split */
    uint page_top_sl_idx;             /**< flag - top line split index */
    uint page_bot_sl_idx;             /**< flag - bottom line split index */
    uint page_top_sl_cnt;             /**< flag - top line split count */
    uint page_bot_sl_cnt;             /**< flag - bottom line split count */
} View;
// extern View *view;
 
typedef struct {
    View *items;
    size_t capacity;
    size_t top;
} ViewStack;
 
extern int get_cmd_spec(View *, char *);
extern void go_to_position(View *, long);
extern void cat_file(View *);
extern char err_msg[MAXLEN];
extern int view_accept_cmd(View *);
#endif