Skip to content

Latest commit

 

History

History
88 lines (66 loc) · 6.96 KB

image.org

File metadata and controls

88 lines (66 loc) · 6.96 KB

❮ Back to Casual

Casual Image

An interface for viewing an image file with image-mode. Resizing an image is supported if ImageMagick 6 or 7 is installed. This interface deviates significantly with naming conventions used by image-mode to be more in alignment with conventional image editing tools. images/casual-image-main-screenshot.png

Install

If installed via MELPA then add these lines to your Emacs initialization file with your binding of preference.

(require 'casual-image) ; optional if using autoloaded menu
(keymap-set image-mode-map "C-o" #'casual-image-tmenu)

Usage

Command Naming

Casual Image makes a number of opinionated changes to the naming of commands provided by image-mode.

The table below shows the mapping between names used by Casual to commands provided by image-mode.

Casual NameImage Mode NameNotes
Zoom Inimage-increase-size“Zoom” is more commonly used.
Zoom Outimage-decrease-size“Zoom” is more commonly used.
Original Sizeimage-transform-reset-to-originalUsing a more concise name.
Fit to Windowimage-transform-fit-to-windowUsing a more concise name.
Rotate Clockwise 90°ximage-transform-set-rotationRotation command is absolute and only works in increments of 90°.
% of Originalimage-transform-set-percentPercent command is absolute in that it computes from the original image size.
Cropimage-cropCommand modifies image.
Fillimage-cutCommand modifies image. This command is primarily a fill operation, so is renamed appropriately.
Set Fill Colorimage-cut-colorThis variable supports a fill operation, so is renamed appropriately.
Savesave-bufferSaves modified image file.
Save asimage-saveCommand to save mutated image as another file via a mini-buffer prompt.
Renamerename-visited-fileRenames the current image file.
Revertrevert-bufferReverts the current image file.
Scroll Upimage-previous-lineRename to use arrow key direction.
Scroll Downimage-next-lineRename to use arrow key direction.
Scroll Leftimage-backward-hscrollRename to use arrow key direction.
Scroll Rightimage-forward-hscrollRename to use arrow key direction.
Left Edgeimage-bolRename to use better descriptive term.
Right Edgeimage-eolRename to use better descriptive term.
Top-leftimage-bobRename to use better descriptive term.
Bottom-rightimage-eobRename to use better descriptive term.
Previous Imageimage-previous-fileVisit the preceding image in the same directory as the current file.
Next Imageimage-next-fileVisit the next image in the same directory as the current file.
Mark Imageimage-mode-mark-fileMark the current file in the appropriate Dired buffer(s).
Unmark Imageimage-mode-unmark-fileUnmark the current file in the appropriate Dired buffer(s).
Copy filenameimage-mode-copy-file-name-as-killPush the currently visited file name onto the kill ring.

Resize

If ImageMagick (version 6 or 7) is installed, Casual Image can resize an image using it. The Transient casual-image-resize-tmenu is a streamlined interface to the ImageMagick -resize function.

Note that if the image file has been modified, the resize interface will be disabled. Save the image file before resizing.

images/casual-image-resize-screenshot.png

Options

  • (g) Geometry - ImageMagick specifier for the resize geometry.
  • (o) Output to another file - If enabled, then the user will be prompted for a different output file, else it will irreversibly update the current image file.
  • (t) Type - Specify if adaptive or interpolative resizing should be used. If nothing is specified then standard resizing is used.

Unicode Symbol Support

By enabling “Use Unicode Symbols” from the Settings menu, Casual Image will use Unicode symbols as appropriate in its menus.

Sponsorship

If you enjoy using Casual Image, consider making a modest financial contribution to help support its development and maintenance.

images/default-yellow.png

See Also