Awesome Open Source
Awesome Open Source

FINAL CUT

Library for creating terminal applications with text-based widgets

FINAL CUT is a C++ class library and widget toolkit with full mouse support for creating a text-based user interface. The library supports the programmer to develop an application for the text console. It allows the simultaneous handling of multiple text windows on the screen.

The structure of the Qt framework was originally the inspiration for the C++ class design of FINAL CUT. It provides common controls like dialog boxes, push buttons, check boxes, radio buttons, input lines, list boxes, status bars and so on.

Building and code analysis

Badge
Latest release Latest Release
License LGPL v3
Class Reference documented
ARM build ARM build
FreeBSD build FreeBSD build
NetBSD build NetBSD build
OpenBSD build OpenBSD build
macOS build macOS build
Cygwin build Cygwin build
Solaris build Solaris build
CodeQL analysis CodeQL analysis
LGTM Language grade: C/C++
Coverity Scan Coverity Scan Status
SonarCloud Quality gate
CodeFactor CodeFactor

Installation

> git clone https://github.com/gansm/finalcut.git
> cd finalcut
> autoreconf --install --force
> ./configure --prefix=/usr
> make
> su -c "make install"

Supported platforms

  • Linux
  • FreeBSD
  • NetBSD
  • OpenBSD
  • macOS
  • Cygwin
  • GNU Hurd
  • Solaris

Documentation

See the first steps documentation for information on how to use the library.

Frequently Asked Questions

For general questions about FINAL CUT, likely the answer is already included in the FAQ.

Screenshots

The FFileDialog widget with incremental file name search:

FFileDialog

The FINAL CUT FProgressbar widget:

FProgressbar

Scrollable text in the FTextView widget:

FTextView

The Mandelbrot set example:

Mandelbrot set

FINAL CUT newfont

A graphical text font for X11 and the Linux console.

ui example in newfont mode

Newfont drive symbols:

drive symbols

The calculator example in newfont mode:

calculator

Benchmark

Here you can find a test for measuring the character speed in the terminal.

Virtual terminal

FINAL CUT uses a virtual terminal to print character via an update method on the screen. It provides (as an overlying layer) virtual windows for the realization of window movements. The update methods only transfer differences to the virtual terminal or physical screen.

 print(...)
printf(...)
  
            [ vterm ]
            createVTerm()                                            
                                                        
                                                                     
                                            restoreVTerm(x,y,w,h)  
    [ vwin ]                                
    createArea(area)                                   
                                                                    
                                                                    
                    putArea(area)                    
                                                                     
                              putArea(x,y,area)                  
                                                                     
                         getArea(x,y,area)                       
                                                                     
                                                                     
                                                                     
                     resizeArea(area)                                
                                     
                                                                      
                                                        resizeVTerm()
             
                     
                        putVTerm()
                      updateTerminalLine(y)
                       updateTerminal()            
                                                   
                                           
                                            output_buffer 
                                           
                                                   
                                                    flushOutputBuffer()
                                                    and putchar(char)
                                                   
                                           
                                                          
                                               screen     
                                             
                                            real terminal 
                                                          
                                           
                                                  
                                               

Class digramm

    1
     FTermLinux ------
          :
  1     :
   FTermFreeBSD ------
        :
  1     :
   FTermOpenBSD ------
        :
1     :
 FTermDetection ------
      :
1     :
 FTermcapQuirks ------
      :            
1     :        FKeyEvent 
 FTermXTerminal ------           
      :           
      1     :        FMouseEvent 
       FTermcap ------           
            :           
      1     :        FWheelEvent 
       FTermios ------           
            :           
 1     :        FFocusEvent 
  FColorPalette ------           
       :           
     1     :        FAccelEvent 
      FOptiMove ------           
           :           
     1     :        FResizeEvent 
      FOptiAttr ------           
           :           
     1     :        FShowEvent 
      FKeyboard ------           
           :           
 1     :        FHideEvent 
  FMouseControl ------           
       :           
       1     :        FCloseEvent 
        FSystem ------           
             :           
       *     :        FTimerEvent 
        FString ---  :           
          :  :           1    1
 *  :  :        FUserEvent ------ FData 
  FStringStream ---  :                 
    :  :                  
        *  :  :                FLog  FLogger 
         FPoint ---  :                  
           :  :                  :1
         *  :  :               
          FRect ---  :           FApplication 
            :  :              
         *  :  :              
          FSize ---  :           FLabel 
            :  :              
                     :1 :1             
                           FLineEdit 
                  FTerm              
                              
                     :1             FSpinBox 
             
 FOutput  FTermOutput           
          FButton 
     :                       
     :1             FEvent              
                 FButtonGroup     FRadioButton 
  FVTerm          :1                   
                      
               FWidget  FToggleButton  FCheckBox 
                     
 FObject          :1                   
         FProgressbar     FSwitch 
                  FWidgetColors             
                       
                                     FScrollbar 
                                        
                                        
                                     FTextView 
                                        
                                        1    1
                                     FComboBox ------ FDropDownListBox 
                                              
 1                      1     *1
  FVTermBuffer ------------------- FListBox ------- FListBoxItem --
                                 :
                                       11    * :
                                     FListView ------ FListViewItem  :
                                               :
                                                     :1       :
                                     FScrollView          1   :
                                                  FData ----
                                                                
                                        1   *
                                      FStatusBar ----- FStatusKey 
                                            
                                     
                                                            
                                      FFileDialog 
                                 FWindow  FDialog   
                                       
                                                          FMessageBox 
                                                            
                                             
                                      FToolTip  FBusyIndicator 
                                              
                                             
                                                          FMenuBar 
                                         
                                   FMenuList    
                                              FMenu 
                                       :1                        
                                       :               
                                       :             FDialogListMenu 
                                       :            
                                       --------------------------------
                                       :*          *  :
                                     FCheckMenuItem ---
                                  FMenuItem      :
                                      *  :
                                                 FRadioMenuItem ---
                                                   

Please send bug reports to

https://github.com/gansm/finalcut/issues

License

Licensed under the GNU Lesser General Public License, Version 3.0 LGPLv3



Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Plus Plus (238,787
Cpp (238,779
Text (33,050
Terminal (17,838
Dialog (6,850
Cut (2,334
Tui (1,184
Tty (852
Terminal App (460
Widget Toolkit (16
Termcaps (9
Text Mode Gui (7