comphy-lab · pull · Jan 16, 2026 · Dec 20, 2025 · Dec 20, 2025 · Dec 20, 2025
diff --git a/cmake/CMakeLists.txt b/cmake/CMakeLists.txt
@@ -292,6 +292,7 @@ set(STANDARD_PACKAGES
   EXTRA-MOLECULE
   EXTRA-PAIR
   FEP
+  GRAPHICS
   GRANULAR
   H5MD
   INTERLAYER
@@ -533,29 +534,6 @@ if(PKG_ML-QUIP OR PKG_ML-POD OR PKG_ELECTRODE OR PKG_RHEO OR BUILD_TOOLS)
   endif()
 endif()
 
-# tweak jpeg library names to avoid linker errors with MinGW cross-compilation
-set(JPEG_NAMES libjpeg libjpeg-62)
-find_package(JPEG QUIET)
-option(WITH_JPEG "Enable JPEG support" ${JPEG_FOUND})
-if(WITH_JPEG)
-  find_package(JPEG REQUIRED)
-  target_compile_definitions(lammps PRIVATE -DLAMMPS_JPEG)
-  target_link_libraries(lammps PRIVATE JPEG::JPEG)
-endif()
-
-find_package(PNG QUIET)
-find_package(ZLIB QUIET)
-if(PNG_FOUND AND ZLIB_FOUND)
-  option(WITH_PNG "Enable PNG support" ON)
-else()
-  option(WITH_PNG "Enable PNG support" OFF)
-endif()
-if(WITH_PNG)
-  find_package(PNG REQUIRED)
-  find_package(ZLIB REQUIRED)
-  target_link_libraries(lammps PRIVATE PNG::PNG ZLIB::ZLIB)
-  target_compile_definitions(lammps PRIVATE -DLAMMPS_PNG)
-endif()
 
 find_program(GZIP_EXECUTABLE gzip)
 find_package_handle_standard_args(GZIP REQUIRED_VARS GZIP_EXECUTABLE)
@@ -568,16 +546,6 @@ if(WITH_GZIP)
   endif()
 endif()
 
-find_program(FFMPEG_EXECUTABLE ffmpeg)
-find_package_handle_standard_args(FFMPEG REQUIRED_VARS FFMPEG_EXECUTABLE)
-option(WITH_FFMPEG "Enable FFMPEG support" ${FFMPEG_FOUND})
-if(WITH_FFMPEG)
-  if(FFMPEG_FOUND OR ((CMAKE_SYSTEM_NAME STREQUAL "Windows") AND CMAKE_CROSSCOMPILING))
-    target_compile_definitions(lammps PRIVATE -DLAMMPS_FFMPEG)
-  else()
-    message(FATAL_ERROR "ffmpeg executable not found")
-  endif()
-endif()
 
 if(BUILD_SHARED_LIBS)
   set(CONFIGURE_REQUEST_PIC "--with-pic")
@@ -589,7 +557,7 @@ else()
   set(CUDA_REQUEST_PIC)
 endif()
 
-foreach(PKG_WITH_INCL KSPACE PYTHON ML-IAP VORONOI COLVARS ML-HDNNP MDI MOLFILE NETCDF
+foreach(PKG_WITH_INCL GRAPHICS KSPACE PYTHON ML-IAP VORONOI COLVARS ML-HDNNP MDI MOLFILE NETCDF
         PLUMED QMMM ML-QUIP SCAFACOS MACHDYN VTK KIM COMPRESS ML-PACE LEPTON EXTRA-COMMAND)
   if(PKG_${PKG_WITH_INCL})
     include(Packages/${PKG_WITH_INCL})

diff --git a/cmake/Modules/Packages/GRAPHICS.cmake b/cmake/Modules/Packages/GRAPHICS.cmake
@@ -0,0 +1,34 @@
+# tweak jpeg library names to avoid linker errors with MinGW cross-compilation
+set(JPEG_NAMES libjpeg libjpeg-62)
+find_package(JPEG QUIET)
+option(WITH_JPEG "Enable JPEG support" ${JPEG_FOUND})
+if(WITH_JPEG)
+  find_package(JPEG REQUIRED)
+  target_compile_definitions(lammps PRIVATE -DLAMMPS_JPEG)
+  target_link_libraries(lammps PRIVATE JPEG::JPEG)
+endif()
+
+find_package(PNG QUIET)
+find_package(ZLIB QUIET)
+if(PNG_FOUND AND ZLIB_FOUND)
+  option(WITH_PNG "Enable PNG support" ON)
+else()
+  option(WITH_PNG "Enable PNG support" OFF)
+endif()
+if(WITH_PNG)
+  find_package(PNG REQUIRED)
+  find_package(ZLIB REQUIRED)
+  target_link_libraries(lammps PRIVATE PNG::PNG ZLIB::ZLIB)
+  target_compile_definitions(lammps PRIVATE -DLAMMPS_PNG)
+endif()
+
+find_program(FFMPEG_EXECUTABLE ffmpeg)
+find_package_handle_standard_args(FFMPEG REQUIRED_VARS FFMPEG_EXECUTABLE)
+option(WITH_FFMPEG "Enable FFMPEG support" ${FFMPEG_FOUND})
+if(WITH_FFMPEG)
+  if(FFMPEG_FOUND OR ((CMAKE_SYSTEM_NAME STREQUAL "Windows") AND CMAKE_CROSSCOMPILING))
+    target_compile_definitions(lammps PRIVATE -DLAMMPS_FFMPEG)
+  else()
+    message(FATAL_ERROR "ffmpeg executable not found")
+  endif()
+endif()
diff --git a/cmake/presets/all_off.cmake b/cmake/presets/all_off.cmake
@@ -35,6 +35,7 @@ set(ALL_PACKAGES
   EXTRA-PAIR
   FEP
   GPU
+  GRAPHICS
   GRANULAR
   H5MD
   INTEL

diff --git a/cmake/presets/all_on.cmake b/cmake/presets/all_on.cmake
@@ -37,6 +37,7 @@ set(ALL_PACKAGES
   EXTRA-PAIR
   FEP
   GPU
+  GRAPHICS
   GRANULAR
   H5MD
   INTEL

diff --git a/cmake/presets/basic.cmake b/cmake/presets/basic.cmake
@@ -1,7 +1,7 @@
 # preset that turns on just a few, frequently used packages
 # this will be compiled quickly and handle a lot of common inputs.
 
-set(ALL_PACKAGES KSPACE MANYBODY MOLECULE RIGID)
+set(ALL_PACKAGES GRAPHICS KSPACE MANYBODY MOLECULE RIGID)
 
 foreach(PKG ${ALL_PACKAGES})
   set(PKG_${PKG} ON CACHE BOOL "" FORCE)

diff --git a/cmake/presets/mingw-cross.cmake b/cmake/presets/mingw-cross.cmake
@@ -30,6 +30,7 @@ set(WIN_PACKAGES
   EXTRA-PAIR
   FEP
   GPU
+  GRAPHICS
   GRANULAR
   INTERLAYER
   KSPACE

diff --git a/cmake/presets/most.cmake b/cmake/presets/most.cmake
@@ -33,6 +33,7 @@ set(ALL_PACKAGES
   EXTRA-MOLECULE
   EXTRA-PAIR
   FEP
+  GRAPHICS
   GRANULAR
   INTERLAYER
   KSPACE

diff --git a/cmake/presets/windows.cmake b/cmake/presets/windows.cmake
@@ -28,6 +28,7 @@ set(WIN_PACKAGES
   EXTRA-MOLECULE
   EXTRA-PAIR
   FEP
+  GRAPHICS
   GRANULAR
   INTERLAYER
   KSPACE

diff --git a/doc/doxygen/Doxyfile.in b/doc/doxygen/Doxyfile.in
@@ -8,7 +8,6 @@ PROJECT_LOGO           = lammps-logo.png
 CREATE_SUBDIRS         = NO
 ALLOW_UNICODE_NAMES    = NO
 OUTPUT_LANGUAGE        = English
-OUTPUT_TEXT_DIRECTION  = LTR
 
 BRIEF_MEMBER_DESC      = YES
 REPEAT_BRIEF           = YES

diff --git a/doc/src/Bibliography.rst b/doc/src/Bibliography.rst
@@ -230,7 +230,7 @@ Bibliography
    A Caro, DA Crowson, M Caro; Phys Rev Lett, 95, 075702 (2005)
 
 **(CasP)**
-   CasP webpage: http://www.casp-program.org/
+   CasP webpage: https://lief.if.ufrgs.br/pub/CasP/
 
 **(Cawkwell2012)**
    A.\  M. N. Niklasson, M. J. Cawkwell, Phys. Rev. B, 86 (17), 174308 (2012).

diff --git a/doc/src/Build_cmake.rst b/doc/src/Build_cmake.rst
@@ -233,6 +233,42 @@ for IDEs like Eclipse, CodeBlocks, or Kate can be selected using the ``-G``
 command-line flag.  A list of available generator settings for your
 specific CMake version is given when running ``cmake --help``.
 
+.. _cmake_targets:
+
+Build targets
+^^^^^^^^^^^^^
+
+The LAMMPS CMake files are set up to have multiple "targets", one for
+each component that is set up to be built.  If you do not provide an
+explicit target when building, the target "all" is assumed.  This should
+build all configured targets and include re-running CMake to update the
+build files when files have changed or new files were added which could
+require updates in the build process.  The most important individual
+targets are "lammps" to build the LAMMPS library and "lmp" to build the
+LAMMPS executable.  If you want to selectively want to update only one
+of them you can use the command:
+
+.. code-block:: bash
+
+   cmake --build build --target lmp
+
+Especially, when programming LAMMPS and you are making just local
+changes, or only want to make certain that the code still compiles
+and links, you may want to skip may of the extra steps that are
+run by default and then append "/fast" to the target.  Example:
+
+.. code-block:: bash
+
+   cmake --build build --target lammps/fast
+
+Note that this speeds up the build by skipping a lot of checks for
+dependencies, and avoiding to re-run CMake, so you may occasionally need
+to compile without the "/fast" suffix or use the "all" (= default)
+target to update everything.
+
+Some custom targets, e.g. "install-python" are explicitly excluded
+from the "all" target and must be built individually.
+
 .. _cmake_multiconfig:
 
 Multi-configuration build systems
@@ -241,7 +277,7 @@ Multi-configuration build systems
 Throughout this manual, it is mostly assumed that LAMMPS is being built
 on a Unix-like operating system with "make" as the underlying "builder",
 since this is the most common case.  In this case the build
-"configuration" is chose using ``-D CMAKE_BUILD_TYPE=<configuration>``
+"configuration" is chosen using ``-D CMAKE_BUILD_TYPE=<configuration>``
 with ``<configuration>`` being one of "Release", "Debug",
 "RelWithDebInfo", or "MinSizeRel".  Some build tools, however, can also
 use or even require having a so-called multi-configuration build system

diff --git a/doc/src/Build_development.rst b/doc/src/Build_development.rst
@@ -5,6 +5,7 @@ The build procedures in LAMMPS offers a few extra options which are
 useful during development, testing or debugging.
 
 .. contents::
+   :local:
 
 ----------
 

diff --git a/doc/src/Build_extras.rst b/doc/src/Build_extras.rst
@@ -41,6 +41,7 @@ This is the list of packages that may require additional steps.
    * :ref:`COLVARS <colvar>`
    * :ref:`COMPRESS <compress>`
    * :ref:`ELECTRODE <electrode>`
+   * :ref:`GRAPHICS <graphics>`
    * :ref:`GPU <gpu>`
    * :ref:`H5MD <h5md>`
    * :ref:`INTEL <intel>`
@@ -110,6 +111,83 @@ versions use an incompatible API and thus LAMMPS will fail to compile.
 
 ----------
 
+.. _graphics:
+
+GRAPHICS package
+----------------
+
+.. versionadded:: TBD
+
+   *dump image*\ , *dump_movie* and supporting classes were moved to form
+   the new GRAPHICS package together with several *fix graphics/...* styles.
+
+The :doc:`dump image <dump_image>` command has options to output JPEG or
+PNG image files in addition to the default PPM format, and the :doc:`fix
+graphics/labels <fix_graphics_labels>` can read images in JPEG or PNG
+format in addition to PPM format files.  Likewise, the :doc:`dump movie
+<dump_image>` command outputs movie files in a variety of movie formats.
+Using these additional options requires the following settings:
+
+.. tabs::
+
+   .. tab:: CMake build
+
+      .. code-block:: bash
+
+         -D WITH_JPEG=value    # yes or no
+                               # default = yes if CMake finds JPEG development files, else no
+         -D WITH_PNG=value     # yes or no
+                               # default = yes if CMake finds PNG and ZLIB development files,
+                               # else no
+         -D WITH_FFMPEG=value  # yes or no
+                               # default = yes if CMake can find ffmpeg, else no
+
+      Usually these settings are all that is needed.  If CMake cannot
+      find the graphics header, library, executable files, you can set
+      these variables:
+
+      .. code-block:: bash
+
+         -D JPEG_INCLUDE_DIR=path    # path to jpeglib.h header file
+         -D JPEG_LIBRARY=path        # path to libjpeg.a (.so) file
+         -D PNG_INCLUDE_DIR=path     # path to png.h header file
+         -D PNG_LIBRARY=path         # path to libpng.a (.so) file
+         -D ZLIB_INCLUDE_DIR=path    # path to zlib.h header file
+         -D ZLIB_LIBRARY=path        # path to libz.a (.so) file
+         -D FFMPEG_EXECUTABLE=path   # path to ffmpeg executable
+
+   .. tab:: Traditional make
+
+      .. code-block:: make
+
+         LMP_INC = -DLAMMPS_JPEG -DLAMMPS_PNG -DLAMMPS_FFMPEG  <other LMP_INC settings>
+
+         JPG_INC = -I/usr/local/include   # path to jpeglib.h, png.h, zlib.h headers
+                                          # if make cannot find them
+         JPG_PATH = -L/usr/lib            # paths to libjpeg.a, libpng.a, libz.a (.so)
+                                          # files if make cannot find them
+         JPG_LIB = -ljpeg -lpng -lz       # library names
+
+      As with CMake, you do not need to set ``JPG_INC`` or ``JPG_PATH``,
+      if make can find the graphics header and library files in their
+      default system locations.  You must specify ``JPG_LIB`` with a
+      list of graphics libraries to include in the link.  You must make
+      certain that the ffmpeg executable (or ffmpeg.exe on Windows) is
+      in a directory where LAMMPS can find it at runtime; that is
+      usually a directory list in your ``PATH`` environment variable.
+
+Using ``ffmpeg`` to output movie files requires that your machine
+supports the "popen" function in the standard runtime library.
+
+.. note::
+
+   On some clusters with high-speed networks, using the fork()
+   library call (required by popen()) can interfere with the fast
+   communication library and lead to simulations using ffmpeg to hang or
+   crash.
+
+----------
+
 .. _gpu:
 
 GPU package

diff --git a/doc/src/Build_package.rst b/doc/src/Build_package.rst
@@ -148,8 +148,8 @@ other files dependent on that package are also excluded.
    however, if you downloaded a tarball, 3 packages (KSPACE, MANYBODY,
    MOLECULE) were pre-installed via the traditional make procedure in
    the ``src`` directory.  That is no longer the case, so that CMake
-   will build as-is without needing to first uninstall those
-   packages. You can quickly include those packages (plus RIGID) by
+   will build as-is without needing to first uninstall those packages.
+   You can quickly include those packages (plus RIGID and GRAPHICS) by
    using the "basic" preset with CMake or ``make yes-basic`` with
    traditional make as discussed below.
 
@@ -174,7 +174,7 @@ make a copy of one of them and modify it to suit your needs.
 
 .. code-block:: bash
 
-    # enable just a few core packages
+    # enable just a few core packages (MOLECULE, KSPACE, MANYBODY, RIGID, GRAPHICS)
     cmake -C ../cmake/presets/basic.cmake    [OPTIONS] ../cmake
 
     # enable most packages
-Original file line number
+Diff line change
@@ Expand Up / @@ -35,6 +35,7 @@ set(ALL_PACKAGES @@
       EXTRA-PAIR
       FEP
       GPU
+      GRAPHICS
       GRANULAR
       H5MD
       INTEL
@@ Expand Down @@