[Android] Digital Clock Designer

※『DigitalClockDesigner』は2015-03-20をもって
※ Playストアでの公開を停止しました。
※ これまでご使用いただいた皆様に感謝申し上げます。
※ 本エントリは記念に残しておきます。

Android用のフルカスタマイズ可能なカレンダー・デジタル時計ウィジェット『DigitalClockDesigner』をマーケット公開しました。 このウィジェットでは、日付・時刻を構成する「年・月・日・曜日、時・分・午前午後（AM/PM）」等の要素について、フォント・サイズ・色（透過度）や、ウィジェット中での位置・傾きを自由にカスタマイズすることができます。 ダウンロードと readme は続きから…

【ダウンロード】

ココか、右のコードでマーケットにジャンプできます。

【更新履歴】

• ver. 1.0.6（20110801a版）：
  
  • 誤操作等によりフォントサイズダイアログに不正な値が入力された場合に強制終了していた不具合を修正しました。
    これに伴い、使用できるフォントサイズは２sp.以上400sp.以下となります。
  • ウィジェット設置時の選択リストに表示されるウィジェットサイズが正しくない表記になっていた不具合を修正しました。
    これに伴い、ウィジェットサイズ表記は（横×縦）に変更されます。
• ver. 1.0.5（20110726a版）：背景に画像を表示させていた場合に設定画面に遷移するとクラッシュしていたバグを修正
• ver. 1.0.4（20110725a版）：起動直後等のSDカードにアクセスしづらい状況でクラッシュしていた不具合を修正
• ver. 1.0.3（20110720a版）：表示文字列にSimpleDateFormatとして正しくない文字列を与えた場合、クラッシュせずに表示文字列をそのまま出力するよう修正
• ver. 1.0.2（20110704a版）：文字の下が数ピクセル切れていた不具合を修正
• ver. 1.0.1（20110701a版）：
  
  • ［アンカーポイント ］［揃え方 ］で「右揃え」が選択できなかったバグを修正
  • 一部機種で［ロケール ］「日本語」を選んだ際に文字化けする不具合を修正
• ver. 1.0 （20110627a版）：マーケット公開

【既知の不具合】

• ［フォントスタイル］で現れるリストダイアログにおいて、デフォルトオンされているスタイルが設定されたものと異なっている場合がある
  →　実際の動作には問題ない。次バージョンアップで対応予定。
  

【インストール】

インストール後、通常の方法でウィジェットをホーム画面に設置してください。 ウィジェットクリックで設定画面になります（※ランチャーはありません）。 設置できるウィジェットサイズは、「１×１、１×２、２×１、２×２、３×１、３×２、４×１、４×２（横×縦）」です。 ホーム画面には、異なるサイズのウィジェットをいくつでも設置することができ、各々に異なったスキンを適用することができます。

【設定】
ウィジェットをクリックすることで、下図の設定画面になります。

［背景に画像を表示 ］にチェックを入れると、ファイル選択ダイアログが表示され、SDカード直下の「com.gmail.kanitawa.dcd/images/」以下にある背景として表示したい画像ファイルを選ぶことができます。画像ファイルには、透過度を含む 24 ビットPNG画像ファイルを使用してください。 ［ロケール ］をクリックすることで、ウィジェット表示に関わる言語設定（日本語・英語）を選ぶことができます。この設定によって、曜日（水/Wed）や午前午後（午前/AM）が変化します。

※現バージョンでは［ロケール ］設定はスキン全体で共通で、「月名」「曜日名」の日本語・英語表記を混在させることはできません。

設定画面で[Menu]ハードボタンを押すと、右図オプションメニューが表示されます。

［スキンの読み込み ］ で、SDカード直下「com.gmail.kanitawa.dcd/skins/」以下にあるスキンファイルを読み込むことができます。

［スキンの保存 ］で、現在のウィジェットのスキンを上記フォルダーに指定した名前で保存できます。
※ スキンファイルは「.skin」という拡張子を付けてありますが、中身は設定がJSON形式で書かれたテキストファイルですので、エディタ等で編集することが可能です。

※ 背景画像とウィジェットサイズについて
［背景に画像を表示 ］しない場合のウィジェット描画可能領域は、「縦 100 dp×横 80 dp」を１マスとして使用するウィジェットサイズ分だけ足しあわせたものになります。つまり、「縦２×横３」のウィジェットの場合ですと「縦 200 dp×横 240 dp」となります。
［背景に画像を表示 ］した場合はちょっと複雑で、用いる画像のピクセル数と、デバイスのピクセル密度で異なってきます。
まず、用いる画像のピクセルサイズを、そのまま「画像の dp サイズ」だと考えます（つまりピクセル密度 160 dpi で描かれたと考える）。そして、その dp サイズと上記「背景に画像を表示 」しない場合のウィジェット描画領域の大きさをくらべて、はみ出る部分は画像の左上を基点としてクリッピングします。このことは、デバイスのピクセル密度によって画像の実表示される大きさが変わらないという利点がありますが、ピクセル密度の高いデバイスでは画像が拡大表示されてしまうため劣化するという欠点もあります。
…例えば、「縦 60 px×横 200 px」の画像を「縦１×横２」のウィジェットに表示する場合、ウィジェット描画可能領域は「縦 100 dp×横 160 dp」なので、画像の右端 40 px分が削られます。
これを QVGA(320×480)デバイスで表示する場合は「ドット・バイ・ドット」で表示されるんですが、WVGA(480×800)デバイスの場合には画像が「480÷320 = 1.5」倍に拡大されて表示されることになります。

設定画面の［スキンの編集… ］ をクリックすると、下図のスキン編集画面になります。

「スキン」を構成する各表示要素（タイポグラフィ）がリストとして表示されており、実際のウィジェット描画では、このリストの上から順に描画されていきます。 リスト項目を長押しすることで、項目の［１つ上へ移動 ］［１つ下へ移動 ］［削除 ］が行えます。項目の描画重なりを変えたい場合は［１つ上・下へ移動 ］を使用してください。 新しいタイポグラフィを追加するには、リスト末尾の［新規追加 ］をクリックしてください。

スキン編集画面で編集したいタイポグラフィ項目をクリックすると、下図のタイポグラフィ編集画面になります。
タイポグラフィの設定は、［表示文字 ］［フォント ］［アンカーポイント ］からなります。

［表示文字 ］は、 表示文字列 （表示される要素を表す記号） 文字サイズ （単位 sp） 文字の色 （透過度を含む16進表記） 文字の背景色 （透過度を含む16進表記） からなります。

※表示文字列について
表示文字列の記号は［java.text.SimpleDateFormat］で用いられ、以下のような記号があります。

記号	意味	表示例
		日本語	英語
G	紀元	AD	西暦
y	西暦年（下２桁）	11	11
yyyy	西暦年（４桁）	2011	2011
M	月（数値）	9	9
MM	月（数値）	09	09
MMM	短い月名	9月	Sep
MMMM	長い月名	9月	September
d	日	3	3
dd	日	03	03
E	短い曜日名	土	Sat
EEEE	長い曜日名	土曜日	Saturday
a	午前/午後	午後	PM
H	時（24時間） ※0時表記	0	0
k	時（24時間） ※24時表記	24	24
K	時（12時間） ※0時表記	0	0
h	時（12時間） ※12時表記	12	12
m	分	7	7
mm	分	07	07

※シングルクォートで囲まれた文字列は上記解釈を受けずに、そのまま表示されます

［フォント ］は、左図のような項目からなります。 ［外部フォントを利用 ］をチェックすると、下の［外部フォント名 ］が選べるようになり、SDカード直下「com.gmail.kanitawa.dcd/fonts/」以下にインストールしたフォント（ttfフォント）が使用できます（その代わり、［ファミリー名 ］と［フォントスタイル ］が選択不可になりますので、ボールド等を使いたい場合は、ボールドフォントをインストールしてください）。 ［外部フォントを利用 ］をチェックしない場合、［ファミリー名 ］で組み込みフォントのファミリーを、［フォントスタイル ］で［ノーマル、ボールド、イタリック、ボールド・イタリック］を選びます。

［アンカーポイント ］は、上記設定した文字列を描画するときの基準点と、その基準点に対する文字列の揃え方、および文字列の傾きからなります。

［水平アンカーポイント ］［垂直アンカーポイント ］（単位 dp）で 描画基準点を設定します。 ［揃え方 ］が［左揃え ］なら、文字列左端、［右揃え ］なら文字列右端、［中央揃え ］なら文字列中央が基準点に揃うよう描画します。 ※ このとき文字列高さ方向は、いわゆるベースラインが基準点に乗るように描画されます（文字列中心高さではない） ［文字列の傾き ］は 水平に対する文字列の傾き（時計回り方向がプラス）を「度」単位で指定します。

【おまけ】
サンプル画面で使用しているスキンを以下にアップしておきます。組み込み以外の外部フォントは同梱せず、リンクのみです。
ダウンロードした zip ファイルを解凍し、
「images/」以下のファイルを実機SDカード直下 「com.gmail.kanitawa.dcd/images/」以下に、
「skins/」以下のファイルを同「com.gmail.kanitawa.dcd/skins/」以下にインストールしてください。

	『himekuri』（１×１）  iPh○neアイコン風のカレンダースキンです。
	『himekuri2』（１×１） 日本語の日めくり風カレンダースキンです。
	『shitteruga』（２×２） （今日の日付を）知ってるがお前の態度が気に入らない。
	『corner-calendar』（２×１） R○inmeter用スキン「C○rnerCl○ck」風のカレンダースキンです。
	『keep-out』（４×１） 曜日と午前/午後の表示に使ってるフォントは「SF Minced Meat Bold.ttf」です。
	『cross-over_white-red』（１×１） Android時計ウィジェットの定番「B○bCl○ck」風の時計スキンです。 アレみたいにグラディエーションはかけられませんがorz
	『simple_clock_ampm』（２×１） シンプルな時計スキンです。