キャラクターなんとかJ
Fork
編集= キャラクターなんとかJ Version 1.0 =
== お知らせ ==
{{{ html
<font color="red"><b>現在、ver0.999のリリースに向けて作業中です。</b></font>
}}}
最新版はver0.998です。2014/9に頂いた中国語(簡体字)リソース一式を本体に組み込みました。それに合わせて使用中のリソースを表示できないフォントは選択しないように修正しました。機能的に変更はありません。(2015/7/20)
= このアプリケーションについて =
このアプリケーションは複数の画像を選択し重ね合わせることで一つの画像を作り出す、モンタージュを行うアプリケーションです。
用途としてパーツを組み合わせてキャラクターをデザインするという、一種の着せ替えを楽しむことを想定していますが、それに限りません。
モンタージュするための素材の画像データがないと、このアプリケーションは何もできません。ご自身で作成するか、既にある画像データを用意するなどしてください。
カテゴリ、レイヤー、カラーグループを増減させたりなど、画像の組み合わせ方については新しいプロファイルを作成することで自分好みの設定にすることができます。
このアプリケーションは、[http://khmix.sakura.ne.jp/download.shtml K.Hみっくす ふぁーすとえでぃしょん さんの 「キャラクターなんとか機」]を目標にJAVAによりフルスクラッチから書き起こしたものです。
初期状態で、「キャラクターなんとか機」と同じカテゴリ、レイヤー順序、ディレクトリ、カラーグループの設定がされたプロファイルが作成されますので、 「キャラクターなんとか機」のパーツデータをインポートして使うことができます。
= 使い方・機能説明 =
* [Usage 使い方について、デフォルトのプロファイルと「キャラクターなんとか機」互換パーツを使用する例をとって説明します。]
* もし、あなたが日本語OS以外で使用する場合は、日本語ファイル名を正しく扱うために、このインポート機能を使うことをお勧めします。
{{{ html
<br><font color="red"><u>If you are using a none Japanese OS, it is recommended that you use this "Import" function to handle Japanese filenames correctly.</u></font>
}}}
* [Usage_AddParts パーツの追加インポートの方法 (「キャラクターなんとか機 追加パーツ保管庫」の利用例)]
* [Usage_AddProfiles そのほかのキャラクターデータのインポート方法の例]
* [Usage2 画面の操作方法について説明します。]
* [Usage3 画面のズームと画像の確認モード、背景画像について説明します。]
* [EditProfile 新しくプロファイルを作成する方法・プロファイルを修正する方法について説明します。]
* [Usage4 お気に入りメニューと、お気に入りの管理について説明します。]
* [Usage5 パーツのランダム選択について説明します。]
* [Usage6 カスタムレイヤーパターンについて説明します。]
{{{ html
<font color="red"><b>← NEW Ver0.999</b></font>
}}}
* [Notes 技術資料など]
[[BR]]
= 動作環境およびインストール方法 =
以下の環境での利用を想定しています。
* Mac OS X
* 10.7 Lion Java6以降 (AppleのJavaを利用する場合は[InstallForLion Java for Mac OS X 10.7が必要])
* 10.8 Mountain Lion Java6以降
* 10.9 Marvericks (Intel) Java6以降
* 10.10 Yosemite Java8以降
* 10.11 El Capitan Java8以降
* 10.12 Sierra Java8以降
* 10.13 High Sierra Java8以降
* 10.14 Mojave Java8以降
* Microsoft Windows
* Windows 7 (32/64Bit) JavaSE6, JavaSE8以降
* Windows 10 (32/64Bit) JavaSE6, JavaSE8以降
* Linux
* UbuntuなどJava6のデスクトップ環境をサポートしているものであれば動作するはず。
Ver.999より、Java6互換でのコンパイルとなったため、
{{{ html
<font color="red"><b>Java6以降の環境が必要</b></font>
}}}
となりました。(Ver0.998以前はJavaSE5以降で動作します。)
※ JRE同梱版の動作環境は、Macの場合は10.13 High Sierra以降、Windowsの場合はWindows7以降となります。
JRE同梱版は、Ver0.999では、Windows, Mac版ともに [https://adoptopenjdk.net AdoptoOpenJDK 8u202] のビルド済みバイナリを同梱しております。
※ ver0.999の時点で、本アプリケーションはHiDPIに一部対応です。
Mac版の場合、Java8以降は自動的に画像を含めてスケールされた状態で表示されます。
Windows版の場合、Java8ではシステムのスケールの状態にあうように各種画面サイズを拡大表示しますが、画像そのものは等倍で表示されます。Java11では(Java11の標準機能により)各種画面、画像ともにスケールされます。
※ Ubuntu13以降, Ubuntu 14, 16, 18等では、Ying-Chun Liu (Paul Liu)さんが[https://packages.ubuntu.com/bionic/charactermanaj Ubuntu用のパッケージ]を作成してくれているので、
'''sudo apt-get install charactermanaj''' でインストールすることもできます。(Ver0.998+α版です。このパッケージは本ページで説明する単純なjar配備とは異なり、Debian系Linuxの作法に従ったディレクトリ構成に直してアプリケーションとしてインストールされます。ユーザーは'''charactermanaj'''というコマンドで簡単に起動することができます。)
[[BR]]
== Windowsの場合 ==
=== JRE同梱版の場合 ===
[http://sourceforge.jp/projects/charactermanaj/downloads/61464/CharacterManaJ_0.996b_with_JRE8.zip/ ここから、最新リリースのJRE付のzipファイル]を取得してください。
JRE同梱版はサイズが大きいですが、そのかわりインストール作業なしで、お好きなフォルダにzipファイルを展開するだけで実行可能となります。
=== JREなし版の場合 ===
まずは、お使いのマシンにJava6以降がインストールされていることを確認してください。
Java8以降の最新版を推奨します。Java11でも動作します。(Java7以前、java9, 10はサポート切れで入手できないと思います)
{{{ html
<del>以下のJava配布サイトにゆくと、Javaのバージョンの確認と必要ならばインストーラを取得することができます。</del>
}}}
現在は、いくつかのサイトから、ビルド済みJAVAランタイムが配布されていますので、'''おきなものを'''選んでください。
(Oracle版は有償になりました。また、Oracleでは、クライアント向けのJREは配布されなくなりました。)
(現在の開発はAdoptOpenJDK8で行っています。)
* https://aws.amazon.com/jp/corretto/ ← オススメ
* https://adoptopenjdk.net/
* https://www.azul.com/downloads/zulu/
* http://jdk.java.net/
そのほかにもあると思います。
amazonのcorrettoは、インストーラによって従来のOracle版と同等のレジストリにjavaのインストール場所を記録するため、本アプリはレジストリからJavaインストール先を判断できます。
しかし、それ以外のものはレジストリを設定したりはしないため、本アプリは自動ではjavaのインストール先を見つけることができません。
ver0.999からは、本アプリにJREが同梱されておらず、レジストリからもjavaの位置を判断できない場合は、手動でJAVAのインストール先を選択できるようになっていますが、
これらの手順が大変だと思われるのであれば、'''JRE同梱版をダウンロードしたほうが簡単'''です。
[[BR]]
つぎに[http://sourceforge.jp/projects/charactermanaj/releases/ ここから、最新リリース]のzipファイルを取得してください。
zipファイルを展開すると、実行ファイルcharactermanaj.exeと、その設定ファイルcharactermanaj.l4j.iniが得られます。
このcharactermanaj.exeを実行すると、本アプリケーションが起動します。
前述のとおり、本アプリにJREが同梱されていない場合は、レジストリからJAVAのインストール先を判断します。
本アプリにJREが同梱されておらず、レジストリにも登録されておらず、JAVAの場所が不明である場合は、JAVAのインストール場所を選ぶフォルダ選択ダイアログが開きますので、手動で選択してください。
[[BR]]
メモリはWindowsのEXE形式での配布形式では、初期状態で96MB、最大で128MBの設定を行っています。
実行可能JAR形式ではJREのデフォルトのサイズが使われます。(JavaSE6以降では搭載している物理メモリに応じて64MBあるいは256MBなど可変となります。)
なお、WindowsのEXE形式の場合は、[ini_settings charactermanaj.l4j.ini設定ファイル]をメモ帳などで編集することで最大使用メモリサイズなどを調整できます。
実際のメモリ使用状況については Aboutメニューからシステム情報タブの中で確認することができます。
== Linuxの場合 ==
まずはjavaのランタイムをインストールしてください。
Linuxをお使いの場合は、openjdk7を推奨します。
[[BR]]
つぎに、[http://sourceforge.jp/projects/charactermanaj/releases/ ここから、最新リリース]のjarファイルを取得してください。
[[BR]]
Ubuntuで実行できるようにするには、このjarに実行ビットを立てる(chmod +x)必要があります。
Fedoraで実行するには、ターミナルから、{{{java -jar CharacterManaJ.jar}}} のように起動する必要があります。
あるいは、{{{java -cp CharacterManaJ.jar charactermanaj.Main}}} としても良いです。(自分で起動シェルを書きたい場合など。)
[[BR]]
実行可能JAR形式ではJREのデフォルトのサイズが使われます。
JavaSE6以降では搭載している物理メモリに応じて64MBあるいは256MBなど可変となります。
実際のメモリ使用状況については Aboutメニューからシステム情報タブの中で確認することができます。
== Macの場合 ==
=== JRE同梱版の場合 ===
[https://sourceforge.jp/projects/charactermanaj/downloads/61464/CharacterManaJ%200.996%20with%20JRE7.dmg ここから、最新リリースのJRE付のdmgファイル]を取得してください。
JRE同梱版はサイズが大きいですが、そのかわりインストール作業なしで、開いたdmgから、お好きなフォルダにアプリをコピーするだけで実行可能となります。
=== JREなし版の場合 ===
まずは、MacにJavaがインストールされていることを確認してください。
現在は、いくつかのサイトから、ビルド済みJAVAランタイムが配布されていますので、'''おきなものを'''選んでください。
(Oracle版は有償になりました。また、Oracleでは、クライアント向けのJREは配布されなくなりました。)
(現在の開発はAdoptOpenJDK8で行っています。)
* https://aws.amazon.com/jp/corretto/
* https://adoptopenjdk.net/
* https://www.azul.com/downloads/zulu/
* http://jdk.java.net/
そのほかにもあると思います。
なお、Javaのインストール方法がわからない場合は'''JRE同梱版をダウンロードしたほうが簡単'''です。
[[BR]]
つぎに、[http://sourceforge.jp/projects/charactermanaj/releases/ ここから、最新リリース]のdmgファイルを取得してください。
dmg形式はディスクイメージですので、この中に格納されている「キャラクターなんとかJ.app」(日本語環境でなければ、{{{CharacterManaJ.app}}})を任意の場所に移動してください。
これが実行ファイルとなります。
=== Mac版の起動時のオプション指定について (ver0.999より)
~/Library/CharacterManaJ/jvm_options ファイルで起動オプションを指定できます。
たとえば、 -Xmx512m のように記述すれば最大ヒープサイズを指定することができます。(指定がない場合はJavaのデフォルトとなります。)
実際のメモリ使用状況については Aboutメニューからシステム情報タブの中で確認することができます。
=== Mountain Lion以降のGatekeeperによる保護について ===
本アプリに限らないことですが、Lion以降に搭載されているGatekeeper機能では、Mountain Lion以降、Marvericks等では「システム環境設定」の「セキュリティとプライバシー」の「一般タブ」で、「ダウンロードしたアプリケーションの実行許可」が、「Mac App Storeと確認済み開発元のみ」にデフォルトで設定されています。
そのため、Mac App Storeからダウンロードするか、Appleに認証されている企業コードがあるアプリでないと、ダウンロードしたアプリケーションを実行できません。
'''標準のままではOSDN.NET(旧SOURCEFORGE.JP)からダウンロードでは実行が許可されませんので、ご注意ください。'''
また本アプリケーションのJava6用のアプリケーションバンドルでは、Gatekeeperにより「破損している」と報告されゴミ箱に捨てるように指示されますが、実際は破損しておりません。
これは、任意のフォルダに移動して一度実行を許可すれば、以降は、通常どおり使用できるようになります。
詳しくは、各種Macの使い方サイトを検索するか、'''[http://support.apple.com/kb/ht5290?viewlocale=ja_JP Apple公式サイトからGatekeeperについて]機能と設定方法について確認してください。'''
=== MacでJAR形式を使用する場合の注意(Java7u60よりも前の場合) ===
OracleのJava7以降をインストールしているMac上で、jarファイルにより本アプリを起動する場合は環境変数LANGまたはLC_CTYPEの設定が不可欠です。
ターミナルからではなく、ダブルクリックで"jarファイル"を実行する場合は環境変数の設定はランチャへの設定追加が必要となります。
(Java7u60以降では、LC_CTYPEの設定がなくとも問題ないようです。)
[[BR]]
= アンインストール方法 =
実行ファイルは、そのまま削除できます。
レジストリ等は使用しておりません。
実行すると、実行ユーザのホームディレクトリまたはアプリケーションデータ用ディレクトリに各種キャッシュデータやキャラクターデータが作成されます。
使用していたユーザーデータやログ、キャッシュ等が不要であれば、以下のディレクトリから不要なものを削除してください。
* Windowsであれば、環境変数「APPDATA」と「LOCALAPPDATA」の示すディレクトリ下にある「{{{CharacterManaJ}}}」というディレクトリとなります。
* たとえば、{{{C:/Users/ユーザー名/AppData/Roming/CharacterManaJ}}} と、 {{{C:/Users/ユーザー名/AppData/Local/CharacterManaJ}}}
* Mac OS Xであれば、ホームディレクトリの下にある「{{{~/Library/CharacterManaJ}}}」というディレクトリとなります。
* 10.7 Lion以降の標準設定においてFinderではLibraryなどのフォルダが表示されません。ターミナルを使うか、chflags nohiddenを設定してFinderに表示できるようにするなどしてください。
* Ubuntuであれば、ホームディレクトリの下にある「{{{CharacterManaJ}}}」というディレクトリとなります。
なお、キャラクターデータを格納するディレクトリは起動時に選択できます。
[[BR]]
= ライセンス/使用許諾条件 =
「キャラクターなんとかJ」はオープンソースソフトウェアです。
ソースコードは「The Apache License Version 2.0」です。
本ソフトウェアは完全に無保証です。本ソフトウェアは「現状のまま」、かつ明示か暗黙であるかを問わず、一切の保証を付けずに提供されます。
ここから[http://sourceforge.jp/projects/charactermanaj/releases/ 最新リリース] 、および[http://sourceforge.jp/projects/charactermanaj/scm/git/CharacterManaJ/ 最新リリースのソースコード]を取得することができます。
商用利用であるかを否かを問わず、どなたでも、自由にお使いいただけます。
登録や費用は一切必要ありません。再配布も自由になさってかまいません。
[[BR]]
= 開発について =
このアプリケーション自身(javaコード)はseraphyによって書かれました。
個人なので人的リソースに限りがあり、メンテナンスや改善に時間がかかることが予想されます。
このアプリケーションをより良くしようという有志がおられましたら、ぜひ、ご協力・ご連絡くださいますようお願いいたします。歓迎いたします。
また、バグ等をみつけられた場合には、どなた様も[http://sourceforge.jp/ticket/newticket.php?group_id=5265 プロジェクトページからチケットにてご報告]くださいますよう、お願いいたします。(それは私が既に気付いているバグかもしれませんし、私の使い方や開発マシンでは出てこない私の知らないバグかもしれません。)
== 利用コンポーネントについて ==
J2SE5の標準APIの他、Apache Antの一部(The Apache License Version 2.0)をライブラリとして使用しています。
また、カラーモデルのHSY(色相・彩度・輝度)計算には、[http://d.hatena.ne.jp/gununu/20090721/1248171222 gununuの日記]さんのところのC++計算ルーチンをJava用に書き直したものを使用しています。
[[ReleaseList]]
[[RecentTickets(limit=5)]]