English
资源说明：An image (jpg/png/bmp/...) viewer works on curses.
* スクリーンショット
#+CAPTION: 猫写真
[[https://github.com/laysakura/CursesImageViewer/raw/master/screenshot/cat_screenshot.png]]
#+CAPTION: うぐいすイラスト
[[https://github.com/laysakura/CursesImageViewer/raw/master/screenshot/ume_uguisu_soft_screenshot.png]]
* はじめに
CursesImageViewer は現在ベータリリースです．
このドキュメントを読んだ上で，
- 動作要件を満たしているのに動かない
- コンパイルが通らない
などございましたらご連絡ください．
(対応が遅れる場合もございます)
Twitter: [[http://twitter.jp/laysakura][@laysakura]]
* CursesImageViewer (CIV) の概要
CursesImageViewer は，curses を使って画像を閲覧するためのソフトです．
X などのウィンドウシステムに依存しないため，CUI のサーバ上などでも画像を閲覧することができます．
* 動作要件
バージョンなどもざっくりです．
「このバージョンだと動かない」といったご報告もお待ちしております．
** OS
Linux, BSD, Unix
を(一応)想定．
現在，Ubuntu Linux, Debian Linux で動作確認をとってます．
** curses ライブラリ
- libncurses
** OpenCV ライブラリ
- libcv
- libhighgui
参考までに，Ubuntu での必要ライブラリのインストール法も記述します．
#+BEGIN_SRC sh
sudo apt-get install libncurses-dev libcv-dev libhighgui-dev
#+END_SRC
* インストール
このマニュアルのあるディレクトリで make をして，できた実行ファイルを適当なところに置いて実行してください．
#+BEGIN_SRC sh
make
ls curses_image_viewer
#+END_SRC
* 使い方
** 起動
#+BEGIN_SRC sh
./curses_image_viewer path/to/image_file
#+END_SRC
** 操作
- h,j,k,l キー
それぞれ画像の表示範囲を左，上，下，右に移動
- L,R,T,B キー
それぞれ画像の左端，右端，上端，下端に移動
- C キー
画像の中央に移動
- f キー
画像を縮小して端末サイズに合わせる
- o キー
画像サイズを戻す
- q キー
終了
** ヒント
文字サイズを変更できる端末を使用している場合は，文字サイズを小さくすることで画像が見えやすくなります．
* サポート画像フォーマット
OpenCV の cvLoadImage 関数のサポートする画像に準じます．
参考: [[http://opencv.jp/opencv-2svn_org/c/highgui_reading_and_writing_images_and_video.html?highlight=cvloadimage#cvLoadImage][http://opencv.jp/opencv-2svn_org/c/highgui_reading_and_writing_images_and_video.html?highlight=cvloadimage#cvLoadImage]]
- Windows bitmaps - BMP, DIB;
- JPEG files - JPEG, JPG, JPE;
- Portable Network Graphics - PNG;
- Portable image format - PBM, PGM, PPM;
- Sun rasters - SR, RAS;
- TIFF files - TIFF, TIF;
- OpenEXR HDR images - EXR;
- JPEG 2000 images - jp2.
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
