Chikyu Kuru Kuru (CKK) 1.24

Chikyu Kuru Kuru (CKK)は地球表示用のソフトウェアです。
CKKは、Hiroki Ichikawaがダジック・アース・プロジェクト (http://dagik.org)と協力して開発しています。
ライセンスに関してはCOPYING.txtをご覧下さい。

===============================================================
1. 基本操作：キー入力による操作

再生の開始・停止：「スペース」キー
逆向き再生の開始・停止：「r」キー
	再生時は最初の画像で少し停止する。

再生速度を速く：「+」キー		再生速度を遅く：「-」キー

1コマ送り：「a」キー			1コマ戻し：「b」キー
	再生を止めた状態で使う。最後あるいは最初の画像まで行くと止まる。

北を上にする：「n」キー

最初の画面と視点にする：「i」キー
最初の画面にする：「I」キー
最後の画面にする：「J」キー

地球の回転の開始・停止：「s」キー
緯線、経線の表示・非表示：「m」キー
回転速度を速く：「>」キー		回線速度を遅く：「<」キー

終了：「q」キー

===============================================================
2. 詳細な捜査

回転：矢印キー
斜めの回転：F1, F2, F3, F4キー
Arrow keys: Rotation
F1, F2, F3 and F4 keys: Oblique rotation

10コマ進める：「A」キー			10コマ戻す：「B」キー

ズーム・イン：「l」キー　　　ズーム・アウト：「h」キー
より速く：ズーム・イン：「L」キー　　　ズーム・アウト：「H」キー

ズーム・イン/アウト：シフト＋マウス・ドラッグ：

全画面化・解除（マッキントッシュのみ）：「f」キー

「スクリーン」画像を縮小：「1」キー
「スクリーン」画像を拡大：「2」キー
「スクリーン」画像を左に移動：「3」キー
「スクリーン」画像を右に移動：「4」キー
「スクリーン」画像を下に移動：「5」キー
「スクリーン」画像を上に移動：「6」キー
  
 地表画像のレイヤーの切り替え：「o」キー
 キャプション画像の表示・非表示：「c」
 アイコンの表示・非表示：「C」

メニュー表示（マッキンントッシュのみ）：右クリック

===============================================================
3. ファイルの説明
3-1. docs/README_JPN.txt (本ファイル)
Chikyu Kuru Kuru (CKK)の説明（日本語）。

3-2. docs/COPYING.txt
CKKのライセンスについて

3-3. data/images/map
マップ画像（ppm形式）の標準フォルダ。マップ画像の標準のファイル名は
"map_[0-9]*.ppm"です。
これらは、設定ファイルの以下の箇所で設定できます。
#TextureName data/images/map/map_
#TextureSuffix ppm
#TextureStart 0
#TextureEnd 9999

3-4. data/images/screen
キャプション画像（ppm形式）の標準フォルダ。キャプション画像の標準のファイル名は
"screen_[0-9]*.ppm"です。
これらは、設定ファイルの以下の箇所で設定できます。
#ScreenName data/images/screen/screen_
#ScreenSuffix ppm

3-5. data/conf
設定ファイル（ "data/conf/init_conf.txt" と "data/conf/conf.txt"）のフォルダ

3-6. data/icons
アイコンのフォルダ

===============================================================
4. 設定ファイル： "data/conf/init_conf.txt" and "data/conf/conf.txt"
これらの２つが設定ファイルで同じ設定が出来ますが、"conf.txt"での設定が"init_conf.txt"
よりも優先されます。

設定の行は"#"から始まります。例：#Latitude, #Spin。
そのあとに設定の値が続きます。

----- Initial view point ------
#Latitude 0.0  :[-90,90]
#Longitude 0.0 :[-180,180]
#Latitude2 0.0  :[-90,90] （二つ目の地球用、#EarthRotationSynch がゼロのときのみ有効）
#Longitude2 0.0 :[-180,180]（二つ目の地球用、#EarthRotationSynch がゼロのときのみ有効）
#Perspective 0:[0: orthogonal, 1: perspective]
	図法の指定。1はperspective、0はorthogonal
#EyePosition 11.0
	視点のz座標。#EyePosition 11.0の場合(0,0,11.0)に視点が位置する。
----- Initial setup for animation and spin ------
#Animation 0 :[0: stop, 1: play, -1: reverse play]
	1 が再生、-1が逆再生。
#AnimationSpeed 8 :[-30,30]
#Repeat 1 
#StopAt1stMap 0.
#Spin 1
#SpinSpeed 4 :[-200,200]
#FullScreen 0
--- Size of Window and Earth ---
#WindowSizeXY 800 600
	画像の上がy軸、右がx軸。画面の手前側がz軸
	描画領域はy方向に[-2,2]（固定）。
	x方向は描画領域のアスペクト比による。
	ただし、座標の中心(0,0,0)は画面の中心になるように固定されている。
	アスペクト比の初期値は
	#WindowSizeXY：ウィンドウのピクセルの幅、で決められる。
#Scale 1.9
	視点より後ろ側に地球の表面が行かないようにしている。
	地球のz座標は0で固定されているので、
	#Scaleの最大値は#EyePositionで指定した値より0.01だけ小さい値（視点が地球の中に入らないように）。
	アプリケーション起動中に地球の大きさを変化させた場合は、地球の半径が変化している。
	そのとき、視点の位置は固定されている。
#EarthXY 0.4 0.0
#NumberOfEarth 2
描画する地球の数。この場合は２個
#TextureOfEarth2 1
２個目の地球のテクスチャが一個目と同じかどうか。
0の場合は同じで、1の場合は異なる。

#Earth2XY 1.5 0.0
２個目の地球の１個目の地球に対する相対位置。この場合は、１個目の地球の中心の場所に対して、x方向に1.5ずれた位置に２個目の地球の中心がある。
#Earth2AngleAxisXY -180 0.0 1.0
	この場合、Earth2のEarth1に対する角度のずれが -180度でその時の軸が (0,1)、すなわちy軸方向
	
#EarthSizeSynch 1
２個目の地球の拡大縮小、平行移動が一つ目の地球とシンクロするかどうか。
1のときはシンクロする。0の時はしない。

#EarthRotationSynch 1
２個目の地球の回転が一つ目の地球とシンクロするかどうか。
1のときはシンクロする。0の時はしない。

#Scale2 1.70 
２個目の地球のスケール
	
#ScreenScaleXY 4.3 -2.6 1.9
	最初の引数はscaleで２番目がx座標、三番目がy座標、xy座標は画像の左上の部分の座標。
	scaleは画像の縦幅。縦横比は保存される。

#ScreenScaleXY2 6 -0.9 0.9
	二つ目のwindowのscreen画像の大きさと位置
	
#ScreenFront 1
	0の時はScreen画像（キャプション画像）が地球の後ろに表示、
	1の時はScreen画像（キャプション画像）が地球の前に表示される。
	
#TimebarScaleXY .2 -1.6 -1.65


#MeridianLatitude 1 6 6 1.0 1.5
経線や緯線を表示するか否か。
最初の引数が1の時は表示、0の時は非表示。
二番目の引数は経線での地球の分割数（経線の数ではない）。72の公約数でなくてはならない
三番目の引数は緯線での地球の分割数（緯線の数ではない）。36の公約数でなくてはならない
四番目の引数は緯線や経線の太さ
五番目の引数は赤道の太さ
例えば、緯線が2の時は赤道のみを表示、6の時は北緯と南緯60度、30度、０度の緯線を表示

#ColorMeridianLatitude 1.0 1.0 1.0 1.0  0.8 0.2 0.2 1.0
緯線と経線、赤道の色を設定する。
最初の四つの引数は緯線と経線の色に対応し、それぞれRGBと透明度に対応。0から1までの実数で強弱。
次の四つの引数は赤道の色に対応。
----- GUI ------
#InvisibleCursor 0 
	1のときマウスカーソルが消える。0は通常
	
#NoMouseDragRotation 1		
	回転させたくないコンテンツではマウス・ドラッグで回転しないようにする：
					
#Icon 2 : 
	アイコンは正方形の大きさでなければならない。
	Icon の 引数は、何番のIconまでつかえるようにするか。（0 ~ 6)
		[ 1: play/pause, 2: play/pause, rewind]
#IconScaleXY 0.4 2.24 -1.57
#Icon2ScaleXY 0.4 1.8 -1.57
	Icon1は再生、停止ボタン、Icon2は最初の時間に戻るボタン
	Icon3は巻き戻し、停止ボタン、Icon4はスピンオンオフ
	Icon5は一つ進める。Icon6は一つもどる。
	Icon9は緯線と経線の表示切り替え、「m」に対応。
	Icon8は拡大ボタン、「L」に対応。
	Icon9は縮小ボタン、「H」に対応。
	Icon10は北を上にするボタン、「n」に対応。
	Icon11は再生速度を速くするボタン、「+」に対応。
	Icon12は再生速度を遅くするボタン、「-」に対応。
	Icon13は終了ボタン、「q」に対応。
	Icon14は全画面ボタン、「f」に対応。
	
	最初の引数はアイコンのサイズ、次の二つの引数はアイコンの位置。
	#Icon?ScaleXY を書かない場合は、アイコンが表示されない。
	
	
----- Image file names ------
#TextureName data/images/map/map_
#TextureSuffix ppm
#ScreenName data/images/screen/screen_
#ScreenSuffix ppm
#TextureStart 0
#TextureEnd 9999
----- Misc ------
#SpinIntervalSecond 0.01
#InertiaOfRotation 0.02 0.01 0.02 0.9999 : [Start_criteria, Stop_criteria, Speed of rotation, Damping rate (1= no damping, 0 = no inertia rotation)]
	マウスを止めた自転で0.02より小さい回転速度の場合、慣性による回転をしない。
	0.01より回転速度が小さくなった場合は慣性による回転を止める。
	0.02は慣性回転の速度
	0.9999は慣性回転の減衰係数（1は減衰しない。0は慣性で回転しない）

#SecondTexture_at_startup 1
	起動時に２つ目のレイヤーを表示する場合。

#SecondTextureName data/images/map_second/map_
#SecondTextureSuffix jpg
#SecondTextureName2 data/images_2/map_second/map_
#SecondTextureSuffix2 jpg
	２つ目のレイヤーの画像の置き場所

#Icon21ScaleXY 0.2 -0.85  -1.75		  ###Switch Layers	
	アイコン（layer1.ppm, layer2.ppm）の位置
	
#Icon22ScaleXY 0.2 -1.25  -1.75		  ###Screen Show/Hide
		アイコン（screen_on.ppm, screen_off.ppm）の位置

#Icon23ScaleXY 0.2 -1.5  -1.75		  ###Icon Show/Hide
		アイコン（icon_on.ppm, icon_off.ppm）の位置

===============================================================
5. 謝辞

Chikyu Kuru Kuru (CKK) は、OpenGLとfreeglutあるいはglutライブラリを使用しています。
Chikyu Kuru Kuru (CKK) は、The Independent JPEG Groupの成果を使用しています。

===============================================================
  Freeglut Copyright
  ------------------
  
  Freeglut code without an explicit copyright is covered by the following 
  copyright:
  
  Copyright (c) 1999-2000 Pawel W. Olszta. All Rights Reserved.
  Permission is hereby granted, free of charge,  to any person obtaining a copy 
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction,  including without limitation the rights 
  to use, copy,  modify, merge,  publish, distribute,  sublicense,  and/or sell 
  copies or substantial portions of the Software.
  
  The above  copyright notice  and this permission notice  shall be included in 
  all copies or substantial portions of the Software.
  
  THE SOFTWARE  IS PROVIDED "AS IS",  WITHOUT WARRANTY OF ANY KIND,  EXPRESS OR 
  IMPLIED,  INCLUDING  BUT  NOT LIMITED  TO THE WARRANTIES  OF MERCHANTABILITY, 
  FITNESS  FOR  A PARTICULAR PURPOSE  AND NONINFRINGEMENT.  IN  NO EVENT  SHALL 
  PAWEL W. OLSZTA BE LIABLE FOR ANY CLAIM,  DAMAGES OR OTHER LIABILITY, WHETHER 
  IN  AN ACTION  OF CONTRACT,  TORT OR OTHERWISE,  ARISING FROM,  OUT OF  OR IN 
  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  
  Except as contained in this notice,  the name of Pawel W. Olszta shall not be 
  used  in advertising  or otherwise to promote the sale, use or other dealings 
  in this Software without prior written authorization from Pawel W. Olszta.
===============================================================