rename notcurses-view to ncplayer #1299

CMakeLists.txt

@@ -588,17 +588,17 @@ target_link_libraries(ncls
 )
 
 ############################################################################
-# notcurses-view
+# ncplayer
 if(NOT ${USE_MULTIMEDIA} STREQUAL "none")
 file(GLOB VIEWSRCS CONFIGURE_DEPENDS src/view/*.cpp)
-add_executable(notcurses-view ${VIEWSRCS} ${COMPATSRC})
+add_executable(ncplayer ${VIEWSRCS} ${COMPATSRC})
-target_include_directories(notcurses-view
+target_include_directories(ncplayer
   PRIVATE
     include
     src
     "${PROJECT_BINARY_DIR}/include"
 )
-target_link_libraries(notcurses-view
+target_link_libraries(ncplayer
   PRIVATE
     notcurses++
 )
@@ -750,7 +750,7 @@ install(TARGETS notcurses-tetris DESTINATION bin)
 if(NOT ${USE_MULTIMEDIA} STREQUAL "none")
 install(TARGETS ncneofetch DESTINATION bin)
 install(TARGETS ncls DESTINATION bin)
-install(TARGETS notcurses-view DESTINATION bin)
+install(TARGETS ncplayer DESTINATION bin)
 endif()
 
 install(TARGETS notcurses-core notcurses notcurses++

NEWS.md

@@ -6,6 +6,7 @@ rearrangements of Notcurses.
     `notcurses`. The latter contains the heavyweight multimedia code,
     so that applications which don't need this functionality can link against
     only the former. `pkg-config` support is present for both.
+  * The `notcurses-view` binary has been renamed `ncplayer`.
 
 * 2.1.5 (2021-01-15):
   * Notcurses **now depends on GNU Readline at build and runtime**, entirely

README.md

@@ -131,12 +131,12 @@ may well be possible to use still older versions. Let me know of any successes!
 
 Seven binaries are installed as part of Notcurses:
 * `notcurses-demo`: some demonstration code
-* `notcurses-view`: renders visual media (images/videos)
+* `ncls`: an `ls` that displays multimedia in the terminal
+* `ncneofetch`: a [neofetch](https://github.com/dylanaraps/neofetch) ripoff
+* `ncplayer`: renders visual media (images/videos)
 * `notcurses-input`: decode and print keypresses
 * `notcurses-tester`: unit testing
 * `notcurses-tetris`: a tetris clone
-* `ncneofetch`: a [neofetch](https://github.com/dylanaraps/neofetch) ripoff
-* `ncls`: an `ls` that displays multimedia in the terminal
 
 To run `notcurses-demo` from a checkout, provide the `tests/` directory via
 the `-p` argument. Demos requiring data files will otherwise abort. The base

doc/man/index.html

@@ -31,13 +31,13 @@
   <h3>Executables (section 1)</h3>
   <a href="ncls.1.html">ncls</a>—list files, displaying multimedia along with them<br/>
   <a href="ncneofetch.1.html">ncneofetch</a>—generate low-effort posts for r/unixporn<br/>
+  <a href="ncplayer.1.html">ncplayer</a>—renders images and video to a terminal<br/>
   <a href="notcurses-demo.1.html">notcurses-demo</a>—shows off some notcurses features<br/>
   <a href="notcurses-direct-pydemo.1.html">notcurses-direct-pydemo</a>—validates the Python direct-mode wrappers<br/>
   <a href="notcurses-input.1.html">notcurses-input</a>—reads and decodes input events<br/>
   <a href="notcurses-pydemo.1.html">notcurses-pydemo</a>—validates the Python wrappers<br/>
   <a href="notcurses-tester.1.html">notcurses-tester</a>—unit test driver<br/>
   <a href="notcurses-tetris.1.html">notcurses-tetris</a>—Tetris in a terminal<br/>
-  <a href="notcurses-view.1.html">notcurses-view</a>—renders images and video to a terminal<br/>
   <div style="float:left">
    <h3>C library (section 3)</h3>
    <a href="notcurses_capabilities.3.html">notcurses_capabilities</a>—runtime capability detection<br/>

doc/man/man1/ncplayer.1.md

@@ -1,21 +1,22 @@
-% notcurses-view(1)
+% ncplayer(1)
 % nick black <nickblack@linux.com>
 % v2.1.5
 
 # NAME
 
-notcurses-view - Render images and video to a terminal
+ncplayer - Render images and video to a terminal
 
 # SYNOPSIS
 
-**notcurses-view** [**-h**] [**-V**] [**-q**] [**-d** ***delaymult***] [**-l** ***loglevel***] [**-s** ***scalemode***] [**-k**] [**-L**] [**-t** ***seconds***] files
+**ncplayer** [**-h**] [**-V**] [**-q**] [**-d** ***delaymult***] [**-l** ***loglevel***] [**-s** ***scalemode***] [**-k**] [**-L**] [**-t** ***seconds***] files
 
 # DESCRIPTION
 
-**notcurses-view** uses a multimedia-enabled notcurses to render images
+**ncplayer** uses a multimedia-enabled Notcurses to render images and videos to a
-and videos to a terminal. By default, **stretch**-type scaling is used to
+terminal. By default, **stretch**-type scaling is used to fill the rendering
-fill the rendering area, and the **sexblitter** blitter is used for a
+area, and the **sexblitter** blitter is used (where known to work well) for a
-3x2→1 mapping from pixels to cells.
+3x2→1 mapping from pixels to cells. In a terminal that doesn't support Unicode
+13 sextants, the **quadblitter** is used instead.
 
 # OPTIONS
 

doc/testing-checklist.md

@@ -15,7 +15,7 @@ Run, using `valgrind --tool=memcheck --leak-check=full`:
 * `notcurses-demo` with `USE_QRCODEGEN=off`
 * `notcurses-demo` in ASCII mode (`export LANG=C`)
 * `notcurses-input`
-* `notcurses-view` with each scaling mode and an image + video, in three
+* `ncplayer` with each scaling mode and an image + video, in three
    terminal geometries: square, tall, wide
 * `notcurses-demo` with margins
 * `notcurses-demo` with FPS plot and HUD up

src/view/view.cpp

@@ -173,7 +173,7 @@ auto handle_opts(int argc, char** argv, notcurses_options& opts, bool* quiet,
         usage(std::cout, argv[0], EXIT_SUCCESS);
         break;
       case 'V':
-        printf("notcurses-view version %s\n", notcurses_version());
+        printf("ncplayer version %s\n", notcurses_version());
         exit(EXIT_SUCCESS);
       case 'q':
         *quiet = true;