## NP_Paint ヘルプ

### Plugin概要

お絵かきアプレットとの連携を可能にするプラグインです

※このプラグインは単体では動きません。下記の「最低限やらなければならないこと」をご覧の上セットアップを行ってください。

### 必要環境

Nucleus: 3.2以降

PHP: 4.3.2以降、サーバ側でJPEG変換を使う場合にはGDサポートが必要です。

動作確認はサーバ側PHP 5.2.5および、Nucleus 3.31SP1(UTF-8/EUC-JP)で行っています

動作確認済みクライアント(これ以外の環境で動作確認ができた場合にはご連絡ください)

・Firefox(win)

・IE6(win)

・Firefox(MacOSX)

・Safari(MacOSX)

・IE5.1(MacOS9)[ただし、動的パレット動作不可]

・Netscape7(MacOS9)動作不安定のため

### ファイル構成

圧縮ファイルを展開すると以下の通りになります。

    (Nucleusのpluginフォルダ)
    ├NP_Paint.php
    ├paint/
    │├applet/　←　お絵かきアプレット配置ディレクトリ
    ││├index.html
    ││└readme.txt
    │├Applet_PaintBBS.php (PaintBBS)
    │├Applet_Shipainter.php (しぃペインター)
    │├Applet_Shipainterpro.php (しぃペインターPro)
    │├index.php
    │├paint.css
    │├paint.js
    │├PaintPlugin.php
    │├Palette_None.php (パレットなし)
    │├Palette_Selfy.php (Selfyパレット)
    │├Palette_WCS.php (WCSパレット)
    │├Parser_PaintBBS.php
    │├Viewer_Continue.php (Continue機能)
    │├Viewer_Pch.php (pchビュアー)
    │└Viewer_Spch.php (spchビュアー)
    └sharedlibs/
    　└PEAR/共通ライブラリ群

### 最低限やらなければならないこと

このプラグインにはライセンスの関係上、お絵かきに必要なアプレット類を同梱していません。

（※アプレットや動的パレットはNucleusと違い、GPLライセンスではありません。ダウンロードの際にはライセンスをよく読んでください。）

このため、下記の手順にてセットアップを行う必要があります。

1. NP_Paintの圧縮ファイルを展開してNucleusのプラグインディレクトリに配置します。(上記参照)
2. 下記のリンクよりアプレット,PCHビュアー(アニメーションを再生するときのみ)をダウンロードします
   ・PaintBBS
   ・しぃペインター(複数ファイルバージョン)
3. 下記のリンクより動的パレットをダウンロードします(必要な場合のみ。なくても動きます。)
   ・WCS 動的パレットコントロールセット(DynPalette)
   ・Palette-Selfy
4. 2、3でダウンロードしたファイルを展開し、中身を全て「お絵かきアプレット配置ディレクトリ」(上記参照)に配置します
5. Nucleus管理画面から、NP_Paintのインストールを実行します
6. プラグインオプションの「デフォルトApplet」「デフォルトPalette」のプルダウンに項目が表示されていればインストールは成功です。
   リストが表示が出ない場合には正常にインストールされていません。プラグインオプションの 「ログを出力を行うか？」をはいにして、管理者操作履歴を参照してみてください。 足りないファイルがログに出力されているはずです。
7. スキンのどこかに`<%Paint%>`を記述します
8. ログインした状態で、上記のスキンを表示するとお絵かき画面に入るためのフォームが出現します
9. 「Paint」ボタンを押すとApplet画面が開きます。
   Appletが表示されない場合には、お絵かきアプレット配置ディレクトリおよび上位ディレクトリ、2、3で配置したファイルのパーミッションを確認してみてください。
10. あとは絵を描くだけ。設定によってはファイルがセーブされない可能性もあるので、一度は試書きをすることをオススメします。

### オプション

プラグインオプション（サイト全体の設定）

オプション | 解説
--- | ---
デフォルトのキャンバスサイズ(幅) | デフォルトのキャンバスサイズ(幅)を指定します。 デフォルト: 300
デフォルトのキャンバスサイズ(高さ) | デフォルトのキャンバスサイズ(高さ)を指定します。 デフォルト: 300
動画ファイルを保存するか？ | デフォルトで動画ファイル(pch/spch)を保存するか指定します。 デフォルト: はい
デフォルトApplet | デフォルトで使用するAppletを指定します。
デフォルトの画像形式 | デフォルトで使用する画像形式を指定します。通常、AUTOの場合にデータは一番小さくなります。 デフォルト: AUTO
画像形式がAUTOの場合の減色・圧縮率[0-100] | PNGの減色率、JPEGの圧縮率を設定します。下記の閾値を越えた場合に使われます。 デフォルト: 15 (推奨値)
画像形式がAUTOの場合に減色が有効になる閾値[KB](利用しない場合は0) | ファイルがこの容量を超える場合に減色を行います。この機能を利用しない場合には0、必ず減色したい場合には1を設定します。 デフォルト: 60 (推奨値)
画像形式がJPGの場合の画像品質[0-100] | 画像形式でJPGを選択した場合の画像品質 デフォルト: 75
本文テンプレート | お絵かき後に追加するエントリの本文を指定します。 テンプレート内で使えるタグについては別途解説してあります デフォルト: <%paint(<%url%>|<%w%>|<%h%>|pbbsimage)%>
Paintタグテンプレート | 本文中に記述した<%paint()%>をどのように展開するか指定します。 アニメーションファイルが見つからない場合にはこのテンプレートは使用されず、下記の画像部テンプレートのみが出力されます。 テンプレート内で使えるタグについては別途解説してあります
画像部テンプレート | Paintタグテンプレート内の<%img%>をどのように置換するか指定します。 テンプレート内で使えるタグについては別途解説してあります
ログを出力を行うか？ | `はい`にすることにより「管理者操作履歴」ログを記録するようになります。 膨大なログが出力されるので動作確認時以外は`いいえ`にしておくことを推奨します。 `いいえ`の場合であっても重大なエラーについては記録されます。 デフォルト: いいえ

### テンプレート内で利用可能なタグ

テンプレート中には以下のタグが利用できます。

タグ | 解説
--- | ---
<%url%> | 保存された画像のmediaフォルダ以下のurl
<%w%> | 保存された画像の横幅
<%h%> | 保存された画像の縦幅
<%alt%> | altテキスト
<%img%> | ※Paintタグテンプレートのみ 画像部テンプレートの展開位置を指定します。
<%viewer%> | アニメーションファイルを表示するためのURL
<%continue%> | Continue機能へのリンク ※ログイン時かつ、自分のコレクション内のお絵かきのみ表示されます

### サポートとバグレポート

問題が解決できない場合にはNucleus(JP)フォーラムを活用しましょう。

バグレポートについては配布元のNP_cles()にて受け付けていますので、該当のバージョンのエントリにコメント又はトラックバックでどうぞ。

「動作確認しました」というだけでも開発者には重要な情報になります。

### アンインストール

`NP_Paint`を完全にアンインストールするための手順は以下の通りです

1. 「プラグイン管理」からNP_Paintをアンインストールする
2. Nucleusをインストールしているサーバの`nucleus/plugin/`ディレクトリから`NP_Paint.php`と`paint`ディレクトリを削除する

### バージョン履歴

新バージョンはNP_cles()で確認してください。

- Version 1.18: (2010/06/06)
- [Fixed] 表示されるHTMLの細部を改良
- [Fixed] register_globals,allow_url_fopen,allow_url_includeがonの場合にリモートコードインジェクションが発生する問題に対応しました(Thanks Katsumiさん)
- Version 1.17: (2008/03/03)
- [Changed] 関連ファイルのロード時にエラーが発生した場合の処理を厳格にした
- [Changed] ログが詳細に出力されるようにした
- [Fixed] GDがインストールされていない場合の不具合を修正
- Version 1.16: (2007/06/17)
- [Fixed] mysql_query()をsql_query()に変更
- [Fixed] デバッグ用の記述がそのままになっていた部分をコメント化
- [Changed] テンプレートで使うことができる変数の見直し
- [Fixed] ビュアー部分のtypoを訂正
- Version 1.15: (2006/11/26)
- [Added] Ticket処理を追加(CSRF対策)
- Version 1.14: (2006/10/09)
- [Changed] 画像投稿時の認証方法を変更
- [Added] 投稿エラーを回避するための機能を追加
- [Changed] 投稿画像に付くプレフィックスを日付にした
- Version 1.13: (2006/09/30)
- [Changed] セキュリティの向上
- Version 1.12: (2006/05/13)
- [Fixed] blogの管理権限を持たないユーザーの投稿がエラーとなる不具合を修正
- [Fixed] エントリ投稿時にコレクションを省略した場合の不具合を修正した
- [Fixed] Safariでの不具合を修正
- [Added] UTF-8,EUC-JP版を統一した
- Version 1.11: (2006/03/19)
- [Fixed] <%Paint%>で表示される際のフォームを変更した
- [Fixed] ライセンスを変更した
- Version 1.10: (2005/10/30)
- [Added] Quality値の設定に対応
- [Fixed] Continue時にしぃペインターとしぃペインターProの自動選択の問題を解決
- Version 1.9: (2005/10/05)
- [Fixed] ファイルの保存方法の変更を根本的に変更
- [Info ] PHP5環境での動作を確認
- [Added] Continue時の読み込み元をアニメファイルと画像から選べるようにした
- Version 1.8: (2005/10/04)
- [Fixed] ファイルの保存方法の変更とアプレットのパラメータ調整（ファイルが壊れる現象に対応）
- [Added] 管理画面からApplet/Paletteがインストールできる機能を追加
- [Added] 管理画面から動作確認ができる機能を追加
- Version 1.7: (2005/09/01)
- [Added] 画像の保存形式、関連パラメータが設定できるように修正
- Version 1.6: (2005/08/20)
- [Added] Continue機能を実装
- [Info ] MacOS9での動作確認
- Version 1.5: (2005/08/04)
- [Fixed] Firefox(MacOSX)で動作しないバグを修正
- Version 1.4(beta): (2005/07/31)
- [Added] <%paint()%>を追加(image,popupと引数互換)
- [Added] pch/spchの再生に対応した(ビュアーのインストールが必要)
- [Added] WCSDynPaletteを使用する際、最初に読み込むパレットを選択できるようにした
- Version 1.3(beta): (2005/07/28)
- [Fixed] 投稿エラー時に500 Internal Server Errorを返すようにした
- [Fixed] エラーチェックを厳密にした
- Version 1.2(beta): (2005/07/26)
- [Fixed] お絵かき後に<%image%>を生成する部分変更
- Version 1.1(beta): (2005/07/24)
- [Fixed] IEで投稿できないバグに対応した
- Version 1.0(beta): (2005/07/23)
- [New!] ベータ版として新規公開

### 開発者について

- hsur (cles::blog)
- 配布元： NP_cles() - NP_Paint
- ドネーションや仕事のご依頼も歓迎します。