まさかろぐ

KSON(K-Shoot MANIA v2向け新譜面形式)とKSH(旧形式)の互換性について

投稿日時: 2026年6月22日

カテゴリ: K-Shoot MANIA

K-Shoot MANIA v2では、従来のKSH形式は非推奨となり、新たにKSON形式が標準フォーマットとして使用されるようになりました。

本記事では、新しい譜面フォーマットKSONについて、主に互換性周りで注意すべき点を紹介します。

※本記事の内容は、KSON形式バージョン1.0.0時点の内容となります。

KSON形式とは？

KSON形式は、K-Shoot MANIA用の新しい譜面形式です。
以下のページで譜面フォーマットの仕様が公開されています。

GitHub

https://github.com/kshootmania/ksm-chart-format/blob/master/kson_format.md

ksm-chart-format/kson_format.md at master · kshootmania/ksm-chart-format

Music game chart format (.ksh/.kson) specifications for K-Shoot MANIA - kshootmania/ksm-chart-format

主に以下の改善を目的としています。

外部ツール作成の容易化
- JSON形式は多くのプログラミング言語で標準で読み書きできるので、外部ツールの作成が容易になります。
- 従来形式(KSH)は人間には読みやすいものの、1小節の譜面行数を調べてからでないとノーツの位置や長さが判明せず、かつ小節をまたいだノーツの処理も必要になるため、読み込みに複雑な実装が必要でした。
1/32以下の長さのレーザーが直角扱いになってしまう問題の解消
- KSON形式では直角レーザーは長さを持たなくなったため、1/32以下のレーザーも直角化せず挿入できるようになりました。
- これにより、直角レーザーに対して曲線レーザーを接続した場合の仕様上の一貫性も向上しました。
ファイルサイズ削減
読み込みパフォーマンス向上
今後の機能拡張のしやすさ向上

KSONファイルの中身は、JSON形式と呼ばれるWeb等で一般的に利用されているフォーマットで記述されています。
これはテキストデータのため、従来通りテキストエディタで直接開くことができます。

おおよそ以下のような見た目です。
ファイルサイズ節約のためにぎゅっと1行にまとめられていますが、このままだと読みづらいです。

そのため、手動でのテキスト編集が必要な場合はVSCode等のテキストエディタを利用して見やすく自動整形してから編集するとよいでしょう。

↓ JSON自動整形した後の見た目

Q&A

Q1. 同名の.kshファイルと.ksonファイルを両方配置した場合はどうなりますか？

v2では.ksonファイルのみが使用され、.kshファイルは無視されます。

(例)
songs/package/music/music_ex.kson
songs/package/music/music_ex.ksh
の両方がある場合、music_ex.ksonのみが読み込まれる

そのため、KSON形式から自動変換した.kshファイルを同名で同梱しておくことで、v2の挙動を維持しつつv1ユーザー向けにもある程度同じ譜面を遊べるようにすることが可能です。

※ v2の新機能を使用した譜面はv1では正常に再生されません。そのためv1では、レーザーの曲線パラメータ・レーン回転(rotation_deg)・譜面速度(scroll_speed)を含むKSHファイルはインターネットランキングのスコア送信対象外となるよう対策しています。

※ v1ユーザー向けに別譜面(曲線レーザーの再現など)をKSH形式で作成して同梱することはおすすめしません。これは、インターネットランキング上で別譜面扱いになってしまうためです。あくまで同名で同梱する.kshファイルは自動変換したものに限ることを推奨します。

Q2. KSON形式では、インターネットランキングの譜面ハッシュ値はどのように計算されますか？

KSON→KSH形式に自動変換した上で、下記の記事のルールに従って計算されます。

K-Shoot MANIA IRの譜面管理の仕様について

そのため、KSON→KSH形式へ自動変換したファイルであれば譜面ハッシュ値は必ず同一となります。

Q3. 過去の譜面を再配布する場合、KSON形式に変換して配布した方が良いのですか？

いいえ。変換しないことを推奨します。
過去にKSH形式で配布したことがある譜面は、変換せずKSH形式のまま配布することが望ましいです。

これは、KSON形式へ変換することでインターネットランキングの譜面ハッシュ値が変化する場合があるためです。

Q4. 新機能を使っていない場合、KSH形式とKSON形式のどちらを使うべきでしょうか？

KSH形式は今後非推奨になっていくため、基本的にはKSON形式を推奨します。

ただし、v2が十分に普及するまでの間は、移行期間としてKSH形式を同梱することもご検討ください。

KSON形式・KSH形式の相互変換の制約について

いくつかの制約がありますが、KSH形式とKSON形式は相互変換が可能です。

K-Shoot Editor v2で開いて再保存するか、「ファイル＞ファイル一括変換...」からフォルダ指定で一括変換することが可能です。

KSH(旧)→KSON(新)形式の変換

KSH→KSON変換は、基本的には全ての内容が変換されます。

ただし細かい点として、以下のデータは失われます。

1/32未満の長さの直角レーザーの長さ情報は失われます。
- 変換後のKSON形式のまま使用する分には問題ありませんが、KSH→KSON→KSH形式へ再変換した場合に直角の長さが1/32(または衝突しないそれ以下の長さ)に変更されるため、元の譜面とは一致しません。
1小節のタイミングの分解能は960へ丸められます。
- KSON形式は、ノーツ等のタイミングを1小節＝960(※4/4拍子の場合)で換算した数値として記録します。
- そのため、KSH形式をテキスト編集で1小節を960で割り切れない行数で分割していた譜面の場合、KSON形式への変換で最も近いタイミングへ丸められます。
インターネットランキング用の譜面ハッシュ値がまれに一致しないことがあります。
- KSH→KSON→KSH変換時、同一時間位置にあるオプション行(視点変更等)の行順序が入れ替わる場合があるため、まれにハッシュ値が維持されない場合があります。
- そのほか、ver=160未満のKSH譜面は、KSH→KSON→KSH変換時にver=160に変換されるため、譜面ハッシュ値は維持されません(これは既存のv1エディタでの再保存と同様の制約)。

これらの制約があるため、これまでKSH形式で配布されていた譜面データは基本的にKSH形式のまま使用することを推奨します。

なお、以下の情報はKSON形式への変換後も保持されます。

KSH形式の互換性バージョン情報は保持されます。
- ver=160未満のバージョンについては、KSH→KSON→KSH変換時にKSHバージョン自体はver=160に更新されるものの、別途ver_compat=として元のKSHバージョンが互換性対応用に保持されます。
KSHファイルにテキスト編集で挿入した独自の行や、廃止済みのオプション内容(chiprate, longrate, laserrate)はデータ上保持されます。
- ヘッダ部のオプション行(「=」を含む行)はKSON内のcompat.ksh_unknown.metaへ保持されます。
- 譜面部のオプション行(「=」を含む行)は、KSON内のcompat.ksh_unknown.optionへ保持されます。
- オプション行以外(「=」を含まない行)は、KSON内のcompat.ksh_unknown.lineへ保持されます。
- 保持される内容の詳細はKSON譜面フォーマット仕様書の該当箇所をご覧ください。

KSON(新)→KSH(旧)形式の変換

新形式から旧形式への逆変換も可能です。

前述の制約を除き、元々KSHから変換して作成したKSONファイルであれば、KSON(新)→KSH(旧)への逆変換で元のKSHファイルと同一内容になることが多いです。

ただし、KSON形式で新しく導入された機能を利用している場合、逆変換時はKSH形式で表現できない情報は失われます。具体的には、KSH形式に変換すると以下のデータが失われます。

ロングFXノーツ毎の個別パラメータ上書きは、KSH形式に逆変換すると失われます。
レーザー横位置の分解能は、KSH形式に逆変換すると51段階に制限されます。
各種パラメータ値の小数は、KSH形式に逆変換すると丸められます。
- 視点変更等は整数に丸められます。
- BPMや曲線パラメータ等は小数第3位へ四捨五入されます。
1/32以下の長さの非直角レーザーは、KSH形式では表現できないため直角レーザーとして変換されます。

以下の情報はKSH形式に逆変換した場合でも保持されます。ただし、これらはv2の新機能のため、v1では再生されません。

曲線パラメータa,b
レーン回転角度(rotation_deg)
譜面速度(scroll_speed)
曲のタイトルの英字表記(title_translit)、アーティスト名の英字表記(artist_translit)
ユーザー定義エフェクトの新しい種類 peaking_filter, low_pass_filter, high_pass_filter 、およびそのパラメータ値

※ユーザー定義エフェクトの新しい種類は旧v1エディタでは開くことができないため、v1エディタで再保存すると情報が失われます(v1エディタで開いたときに警告ダイアログが表示されます)。

2023年、K-Shoot MANIAはv2になります

投稿日時: 2023年4月17日

カテゴリ: K-Shoot MANIA

K-Shoot MANIAは2023/4/17で10周年を迎えました。

そして2023年、K-Shoot MANIAはメジャーアップデートしてバージョン2になる予定です！

こちらが開発中のバージョン2の動画です。

……え？バージョン1から何も変わってない？

それもそのはずで、バージョン2は「バージョン1から何も変えず、基盤部分のみリニューアルする」ことを目的に、1から作り直しを実施しています。

具体的には、次のようなトピックを予定しています。

次世代譜面形式「kson」への移行

10年前から長らく使われていたksh形式はバージョン2では非推奨となり、「kson」という新形式に移行します。

新形式への移行により、下記のことが実現予定です。

LASERノーツやレーンズーム(視点変更)の値の推移へ曲線を利用可能に
32分より短い非直角LASERノーツが利用可能に
中身が一般的なJSON形式となるので、譜面データを利用するサードパーティ製ツールが作りやすくなる
ksh形式を扱える他ゲームとの互換性問題の解消

kson形式の仕様は現在ほぼ確定版となっていて、下記にて確認可能です。

GitHub

https://github.com/m4saka/ksm-chart-format-spec

GitHub - m4saka/ksm-chart-format-spec: Music game chart format (.ksh/.kson) s...

Music game chart format (.ksh/.kson) specifications for K-Shoot MANIA - GitHub - m4saka/ksm-chart-format-spec: Music game chart format (.ksh/.kson) specifications for K-Shoot MANIA

もちろん、ksh形式の譜面もこれまで通り遊ぶことができますし、ksh形式からkson形式に変換することもできます。

動作安定性の圧倒的向上

現行のバージョン1はハイスペックマシンでもカクつくことがあるほど動作が不安定でしたが、バージョン2では見違えるほど動作が安定します。

バージョン1ではウィンドウサイズやテクスチャサイズ(画質)を下げたり、背景をOFFにしたりすることで動作を改善する必要がありましたが、バージョン2では不要になるので、常に最高画質で遊ぶことができる見込みです。

譜面管理、ハイスコア管理、コースモードの改善

バージョン1では、songsフォルダ以外に譜面データが置けない、ハイスコアがファイル名依存なのでフォルダ名を変更できない、コースモードを利用するには譜面のフォルダやファイル名が一致している必要がある、などの問題がありましたが、これらはバージョン2で完全に解決される予定です。

LASERノーツの判定改善

バージョン1ではLASERノーツの判定がシビアでしたが、バージョン2では納得感のある形へ改善される予定です。

エディタ機能の改善

K-Shoot Editorは基本的な譜面を作るには足りるものの、凝った譜面を作ろうとするととんでもなく手間がかかっています。

具体的には、レーンズーム(視点変更)を曲線的に変化させるには細かい値変化を一つ一つ挿入しなければならない、わざわざテストプレイしないと見た目がプレビューできず試行錯誤が必要になる、ユーザー定義エフェクトを使用するためにはテキスト編集しないといけない、などの問題を抱えています。

バージョン2にて、これらについては抜本的に改善される予定です。

現在の開発状況は下記にて確認できます。

GitHub

https://github.com/m4saka/kshootmania-v2

GitHub - m4saka/kshootmania-v2: K-Shoot MANIA v2 (v1のC++移植版)

K-Shoot MANIA v2 (v1のC++移植版). Contribute to m4saka/kshootmania-v2 development by creating an account on GitHub.

ぜひ今年のバージョン2リリースにご期待ください！

K-Shoot MANIA v1のテクスチャはなぜGIF形式なのか？バカなのか？

投稿日時: 2022年5月19日

カテゴリ: K-Shoot MANIA

K-Shoot MANIAの微妙な点としてよく挙げられるのが、「テクスチャの画像ファイルにGIF形式を使用しているせいでグラフィックが汚い」という点です。

GIF形式は256色しか使えないため減色が必要で、グラデーションを含むような画像には明らかに不向きです。それなのに、なぜGIF形式なんかが使われているんでしょうか…

ズバリお答えすると、理由は「歴史的経緯」です。
…ですが、K-Shoot MANIA自体の歴史的経緯というよりは、少し別の歴史的経緯です。こちらについて触れていきましょう。

開発当時はね…

K-Shoot MANIAの最初のバージョンであるv0.10は2013/04/17公開ですが、開発自体は約半年前の2012/10に着手し始めました。

当時、慣れないVisual C++を片手にC言語で開発しようとしたのですが、テキストファイルの内容をコマンドプロンプト上に表示させるだけで苦労したので、完成を優先して当時使い慣れていたHSP(Hot Soup Processor)で作る方針に転換しました。

プログラミング言語 HSP3 公式 - HSPTV!

当時の最新版より少し前のHSP 3.3(または3.3a？)を使っていました。

使い慣れていたHSPを使うことで、譜面テキストをもとにノーツを描画するプログラムまで1～2日程度でたどり着くほど開発速度が向上しました。C言語で作るのやめて良かったね！

2012/10/20当時の試作バージョンはこんな感じでした(使用されていた譜面データは描画テストのための適当なもの)。

ノーツのテクスチャ画像の読み込みには、HSP標準命令であるpicload命令を使っていました。
それでは、当時(HSP3.3)のpicload命令のマニュアルを見てみましょう。

PNG形式は・・・

PNG形式は・・・！？

PNG形式は・・・

ありませんでした！！！

という訳で、当時のHSPにはPNG形式の画像を読み込む機能がそもそも備わっていなかった訳です¹。

そこで、当時取ることができる選択肢としては

BMP形式(非圧縮)
GIF形式(圧縮。256色のみ使用可)
JPEG形式(圧縮)

の3択でした。当時検討した感じでは、下記のような所感でした。

「BMP形式だと非圧縮なのでキレイに出せそう。でもファイルサイズがやたら大きくなる…。1024x768の画像で2.25MBも食ってしまうので、この調子だとテクスチャ全部で100～200MBは行きそうだし、BMP形式はやめておこう…」
「GIF形式は256色に減色しないといけないのでかなり微妙…。でもまあ、Photoshop上で誤差拡散法とかで減色すればある程度誤魔化せるし、ノーツのグラフィックとかであれば何とかなりそう？」
「JPEG形式はどちらかというと写真向けだし、ぼやける・にじむので論外。でも背景グラフィックだけに関しては写真とかと同じような部類のものだし、この中だとJPEGを使うのが妥当そう？」

このような経緯で、ノーツ等の画像ファイルには泣く泣くGIF形式を、背景グラフィックにはJPEG形式を採用するに至った訳です。

不幸な事実

ここまでがGIF形式を採用するに至った経緯なのですが、実は不幸な事実もありました。

HSPの更新履歴を見てみます。

まさか・・・

使用していたHSP 3.3ではPNG形式がサポートされていなかったものの、当時の最新バージョンであるHSP 3.31(2012/9/5)で、picload命令がPNG形式がサポートされたのでした。

当時HSPを最新版にアップデートさえしていれば、この歴史的経緯を生まずに済んだのかも知れません…²。

"スキン"の台頭

こちらは当初想定していなかったのですが、imgsフォルダ内の画像ファイルを差し替えるために非公式画像差分データ(俗に"スキン"と呼ばれているもの)を配布して、ゲーム画面の見た目をユーザー側で好きなものに変えるという流れが後付けで生まれていきました。

もちろん"スキン"はこちらで想定したものではなく、単にimgsフォルダ内の画像ファイルを上書きしているだけなので、ファイル名やファイル形式、画像サイズなどを元のものと同じに揃えて作成する必要が出てきます³。そのため、GIF形式で作成された"スキン"が数多く出回ることになりました。

v1.40(2014/11/12)でプレイ画面を一新した際に、そのタイミングでGIF形式のテクスチャを廃止してPNG形式に変更できないか検討していました。
しかし、当時の時点でGIF画像を使用した"スキン"が数多く出回っており、これが使用できなくなると影響が大きいとみられたので、変更を見送ることにしました⁴。
その後そのままの状態が現状という訳です。

結論

まとめると、こんな感じです。

当時のHSPが読み込める画像形式はBMP/GIF/JPEGのみであり、GIF形式が妥当だったので仕方なく選ばれた
配布されている"スキン"との互換性の観点でPNG形式への変更は見送ることになった

VPS Avenger_x64をインストールしてもerror表示になって起動できない

投稿日時: 2020年9月2日

カテゴリ: DTM

症状

Vengeance Soundのシンセ音源「VPS Avenger」のVSTプラグインをFL Studio 20にインストールすると、以下のようにStatusが「error」になってしまいました。

解決策

どうやら、VPS Avengerをインストールする前にCodeMeterというライセンスマネージャをインストールする必要があるようでした。 CodeMeterはRegisterページからダウンロードできます。
https://register.vps-avenger.com/

(IMPORTANTが点滅してて逆にわかりにくい気が…)

インストールすると、きちんと認識されるようになりました(VST+VST3に結合されてないのがちょっと気になるけど)。

VST3 SDKをコンパイルすると「abort() has been called」エラーが発生する(解決)

投稿日時: 2020年7月12日

カテゴリ: VST開発, プログラミング

症状

VSTプラグイン開発の書籍「VSTプラグイン (I・O BOOKS)」にしたがってVST3 SDKをコンパイルしたところ、以下のように大量のデバッグエラーが発生しました。

Debug Error!

Program: C:\VST_SDK\VST3_SDK\out\build\x64-Debug (既定値)\bin\validator.exe

abort() has been called

(Press Retry to debug the application)

発生環境: Visual Studio Community 2019 Version 16.6.3，VST SDK 3.6.14

解決方法

どうやら原因は構成の名前の末尾に「 (既定値)」が自動で付いてしまうせいみたいです。

「プロジェクト」メニュー→「vstsdk の CMake の設定」から設定を開きます。
「ビルドルート」の部分の最後を「${name}」ではなく「x64-Debug」にします。

↓

これでディレクトリ名に「 (既定値)」が含まれなくなり、エラーが出なくなりました。

(ちなみに、その状態で一度コンパイルすると構成の名前から「 (既定値)」が消え、「${name}」に戻してもコンパイルできるようになりました。SDK自体は最初の1回コンパイルできればOKなのであんまり意味ないですが、一応書いときます。)

補足

わざわざVisual Studio上でコンパイルするのが面倒なら以下の公式の手順でやればシェル上で完結できます(※CMakeのインストールが必要):
https://github.com/steinbergmedia/vst3sdk/wiki/Get-Started

K-Shoot MANIA IRの譜面管理の仕様について

投稿日時: 2019年12月11日

カテゴリ: K-Shoot MANIA

K-Shoot MANIA Internet Ranking Systemのベータ版が公開中です。
https://ir.kshootmania.com/beta/
本記事ではKSMIRと略して呼ぶことにします。

VSCodeをUbuntuへroot権限なしでインストールする方法(Ubuntu 18.04)

投稿日時: 2019年4月13日

カテゴリ: Linux, プログラミング

大学のPCでもVisual Studio Codeが使いたい！ということで、root権限なしでインストールする方法を紹介します。

この方法はVSCodeの動作に必要なパッケージが(管理者によってあらかじめ)インストール済みであることが前提となります。
(私の大学の環境ではうまく行きましたが、別の環境(Oracle Linux)ではインストールされているlibg++だったかlibstdg++だったかのバージョンが古すぎてダメだったこともありました。)

インストール手順

公式サイト(https://code.visualstudio.com/)から.debパッケージをダウンロード
debファイルを右クリック→「別のアプリケーションで開く」→アーカイブマネージャで開く
アーカイブ内に3つのファイルが出てくるので、「data.tar.xz」をダブルクリックして解凍

うちの環境だとdataフォルダが生成されてその中に解凍されました(環境によって違うかも)
「data/usr/share」の中身を「~/.local/share」の中へ移動
(ドットが先頭についたディレクトリが表示されない場合は、Ctrl+Lを押してアドレスバーを出し、「~/.local/share」と入れてEnterを押します)

マージするか聞かれると思うので、下のチェックを入れて「マージする」を選択

その後、ファイルを置き換えるか聞かれるので、同様にチェックを入れて「置き換える」を選択
「~/.local/share/code」ディレクトリへ移動し、その中の「code」が実行できることを確認(起動できない場合はパッケージがインストールされていない可能性が高いので無理そう？)

ここまでで使用自体は可能ですが、アプリケーションランチャーから起動したいので以下の作業を行います。

「~/.local/share/applications」を開き、「code.desktop」の実行権限を有効に
(コマンドでやる場合: chmod a+x code.desktop)
(GUIでやる場合: 右クリック→プロパティ→アクセス権→「プログラムとして実行可能」にチェック)
以下のようなメッセージが出るので「信頼して起動」をクリック

・・・しても、うまく起動できません。本来「/usr/share/code」内にインストールするところを「~/.local/share/code」内にインストールしているためです。

ちゃんと起動できるようにするためにはショートカット先を変更する作業が必要になります

先程まで.desktopファイルだったものは先程の手順の後は「Visual Studio Code」に表示が変わっています。

これを適当なテキストエディタで開き、以下の部分を編集します。
変更前:

[Desktop Entry]
Name=Visual Studio Code
Comment=Code Editing. Redefined.
GenericName=Text Editor
Exec=/usr/share/code/code --unity-launch %F
Icon=com.visualstudio.code
Type=Application
StartupNotify=false
StartupWMClass=Code
Categories=Utility;TextEditor;Development;IDE;
MimeType=text/plain;inode/directory;
Actions=new-empty-window;
Keywords=vscode;

[Desktop Action new-empty-window]
Name=New Empty Window
Exec=/usr/share/code/code --new-window %F
Icon=com.visualstudio.code

変更後(「■ホームディレクトリの絶対パス■」は適宜変更):

[Desktop Entry]
Name=Visual Studio Code
Comment=Code Editing. Redefined.
GenericName=Text Editor
Exec=/■ホームディレクトリの絶対パス■/.local/share/code/code --unity-launch %F
Icon=com.visualstudio.code
Type=Application
StartupNotify=false
StartupWMClass=Code
Categories=Utility;TextEditor;Development;IDE;
MimeType=text/plain;inode/directory;
Actions=new-empty-window;
Keywords=vscode;

[Desktop Action new-empty-window]
Name=New Empty Window
Exec=/■ホームディレクトリの絶対パス■/.local/share/code/code --new-window %F
Icon=com.visualstudio.code

※修正箇所は5行目と17行目の2箇所です

ここで、ホームディレクトリのパスに「~」は使えないので注意してください。ホームディレクトリのパスは典型的には「/home/ユーザー名」ですが、大学PCだと異なる場合があります。わからない場合はpwdコマンドとかで確認してください。

この修正を行うと、ダブルクリックで開けるようになると思います。

この時点でランチャーからも選択可能になりますが、アイコンはデフォルトのままです。

アイコン画像は「share/code/resources/app/resources/linux/code.png」に入っているので、これを直接指定します。
再度「code.desktop」(Visual Studio Code)をテキストエディタで開き、「Icon=」から始まる行を以下のように編集します。
```
Icon=/■ホームディレクトリの絶対パス■/.local/share/code/resources/app/resources/linux/code.png
```
※修正箇所は6行目と18行目の2箇所です
以下のようにアイコンもちゃんと表示されるようになりました

以上です。適宜「お気に入りに追加」をしてランチャーに常駐させましょう！

←わーい

たぶんGNOMEデスクトップ環境だったらUbuntu以外のLinuxも同じような手順でいけるはずです。

補足: プロキシ越しでのExtensionのインストール

大学環境とかだとプロキシがかかっていることが多いと思います。VSCodeのExtensionのインストールをプロキシ越しに行う場合は設定が必要になります。

VSCodeのプロキシの設定は以下のQiita記事で解説されています。

Qiita

https://qiita.com/cointoss1973/items/b3c84daeed90fd183501

Visual Studio Code に Proxy を設定する方法 - Qiita

Visual Studio Code に Proxy を設定する方法です。* Visual Studio Code 1.22.1## ユーザー設定を開き、http.proxy を追記する会社内等 Proxy環境でExt...

(新しいバージョンのVSCodeだとCtrl+,だけだとsettings.jsonが出て来ません。設定をコピペするには右上の「{}」アイコンをクリックする必要があります。)

ちなみに、うちの環境だと上記方法ではうまく行きませんでした。

(なぜか接続できない)

以下で対処法を説明します。

補足: プロキシ越しでのExtensionのインストールがうまく行かない場合の対処法(オフラインインストール)

vsixファイルというものをブラウザでダウンロードして、それをインストールさせます。

Qiitaに何やかんや手順を踏ませる古い記事が複数個ありますが、現在は以下の手順だけでOKになりました。

https://marketplace.visualstudio.com/にアクセス
検索してお目当てのExtensionを見つける
Extensionのページ右下のResourcesと書かれた場所にDownload Extensionリンクがあるのでクリックし、vsixファイルをダウンロード
Extensionサイドバーの「・・・」ボタンで出てくるメニューから「Install from VSIX...」をクリックし、ダウンロードしたvsixファイルを開く

ただし、私の環境では「Install from VSIX」でインストールできませんでした。
4の手順の代わりに以下のコマンドを実行してインストールすると、うまく行きました。

$ ~/.local/share/code/bin/code --install-extension (vsixファイル名)

(実行するのはcodeディレクトリ内直下のcodeではなく、binディレクトリ内のcodeの方なので注意)

ホームディレクトリにインストールしていることも関係しているかも知れませんが、原因は不明です。

VSCodeを日本語で使いたい場合は日本語の言語パックのExtensionをインストールしておくと良いでしょう。

gnuplotのグラフ配色のデフォルトを見やすいものに変更する

投稿日時: 2018年10月31日

カテゴリ: 便利ツール

gnuplot、実験結果をグラフにしたりするのに便利ですよね。
plotコマンドとreplotコマンドで1つのグラフに複数プロットすることができますが、デフォルトの配色はだいぶ奇抜でなんか見づらいです。

そこで、今回はデフォルトの配色を変更して見やすくしたいと思います。

一応デフォルトで3種類配色が用意されているが…

デフォルトで用意されている配色はこれです。
set colorsequence [default/classic/podo]で指定できます。

「default」

最初の色が紫から始まっていたりして、割と奇抜な配色です…。
そのまま使うとパワポとかで比較説明するときに紫と緑で図を作ることになってアレです。あと黄色が見づらい。

「classic」

原色系です。昔のバージョンはこれがデフォルトだったらしい。
2色目の緑色と5色目の水色が特に見づらいです。あと6色目あたりからグラデーションが始まってしまっています。

「podo」

色覚障害のある方にも優しい配色らしいです。
それ自体は良いのですが、黒色から始まっているので2つのプロットを比べるときに黒と黄土色を比較することになってしまいます。
あと黄色が見づらい。

オレオレ改良版配色

個人的に見やすそうな配色を作成してみました。
以下の内容を~/.gnuplotへ書き込むと起動時に自動で読み込まれます。
(試してないけどWindowsの場合はC:\Users\ユーザー名\AppData\Roaming\GNUPLOT.INIに書けばいいらしい)

set linetype 1 lc rgb "#0070f0" lw 1
set linetype 2 lc rgb "#e36c09" lw 1
set linetype 3 lc rgb "forest-green" lw 1
set linetype 4 lc rgb "dark-violet" lw 1
set linetype 5 lc rgb "dark-pink" lw 1
set linetype 6 lc rgb "#00d0f0" lw 1
set linetype 7 lc rgb "#60d008" lw 1
set linetype 8 lc rgb "brown"   lw 1
set linetype 9 lc rgb "gray50"  lw 1
set linetype cycle 9

最初が青、次がオレンジなのでPowerPointで資料を作成したりするときにも使いやすい配色になっているかなと思います。

HSP3のpicload命令で画像ファイルが読み込めなかった時にファイル名を表示する

投稿日時: 2018年10月22日

カテゴリ: HSP, プログラミング

HSPで画像を読み込むときは通常picload命令を利用すると思います。
しかし、実行時に画像ファイルが見つからなかったら「内部エラー13」を出力してプログラム自体が落ちてしまいます。

スクリプトエディタからデバッグ実行しているときは行数なども出るのでまだマシですが、実行ファイルにした後は「内部エラー13」としか出ないのでかなり不便です。

解決策

プログラムの上の方にこのプログラムを差し込むと、picload命令が置き換わってくれます。

#undef picload
#module
#deffunc picload str filename
  exist filename
  if(strsize=-1){
    dialog "Cannot open image \""+filename+"\""
  }
  picload@hsp filename
  return
#global

ファイルが見つからなかった場合には「Cannot open image "(ファイル名)"」というダイアログが表示された後に内部エラーとなってくれるので、最悪どのファイルが欠けているかがわかるようになります。

1行目の#undef picloadでpicload命令を(グローバルスコープから)削除し、3～9行目で定義したpicload命令に差し替えています。
このやり方はpicload命令以外(noteloadなど)にも応用可能だと思います。

細かい注意点

内部でexist命令を呼ぶようになるので、picload命令使用時にstrsizeの値が変化します。使用する場合は、strsizeを使用する部分にまたいでpicload命令を入れないよう注意して下さい。

(まっとうなプログラム言語なら、ファイルが見つからなかったとしてもエラーにならずに例外が発生するので、try-catchでファイルが見つからなかった場合の処理が書けたりするはずなんですがね… あとなんでstrsize変数なんていうstaticな変数に結果を出力するんだろう(疎結合化できない)…)

picload命令の第2引数も使いたい場合(2019/1/2追記)

picload命令に第2引数があることを知りませんでした。
第2引数も使う必要がある場合は以下のようにすれば問題ありません。

#undef picload
#module __picload__
#deffunc local picload_ str filename, int mode
  exist filename
  if(strsize=-1){
    dialog "Cannot open image \""+filename+"\""
  }
  picload@hsp filename,mode
  return
#define global picload(%1,%2=0) picload_@__picload__ %1,%2
#global

(デフォルト引数を定義するときの面倒さよ…)

K-Shoot MANIAのマイナーな機能 16選

投稿日時: 2018年10月11日

カテゴリ: K-Shoot MANIA

マニュアルに書くのが面倒だったりして埋もれてしまっているマイナーな機能があるので、雑に紹介していきます。
Windows起動するのが面倒だったのでスクショはUbuntuです…(Wineで割と快適に動く)。

チップBTオブジェクトにDDR風の色を付ける

選曲画面でBT-C(Kキー)を押すと出てくるメニューの「NOTE SKIN」を「NOTE」にすると使用できます。

どこで使うねん。DDRマットを繋いで足で踏みたい時にでもどうぞ。

プレイヤー別にハイスコアを分ける

複数人で使っている共用PCとかだったりして、数人で交代しながらプレイすると、プレイヤーごとにハイスコアを別にしたいことがあります。

そのような場合は、scoreディレクトリに新しくフォルダを作ってください。

ゲームを再起動すると、BT-B(Dキー)とBT-C(Fキー)を同時押ししながら左右矢印キーでプレイヤーが選べるようになり、ハイスコアがプレイヤー別で保存されるようになります。

左下にいつも「PLAYER」と表示されていたのは飾りではなくて選択中のプレイヤー名だった訳です。

譜面動画作成用の連番png出力をする

kshootmania.exeと同じディレクトリにあるconfig.iniを書き換えます。

メモ帳で開くと、以下のような行があると思います。

「output=」の値を1にして上書き保存するとプレイ時に連番png書き出しされるようになります。

ただし、「output_path=」の保存先のディレクトリパスは存在するものを指定してください。「c:\output\」のまま行く場合はC:の中にoutputフォルダをあらかじめ作成しておいてください。

「output_downscale=」の値を上げると画像を縮小することができます。例えば2にすると、1/2の画像サイズになります。昔はドットが荒かったので、ウィンドウサイズを上げた上でこれを使うことで、画質を上げていました。

連番PNG画像を動画にできるソフトにはVirtualDubなどがあります。
ただし、音声を別録りしないといけない、音ずれを治すのが大変、などなどの面倒さがあるので、よほどPCスペックに困っていなければ使わなくていいと思います。
Windows10からOSデフォルトでWinキー+G押せば動画が撮れるようになりましたし。

選曲画面で譜面が入っているフォルダ名を表示する

だんだんマニアックになっていきます。

config.iniを編集して、以下の行を足してください。

viewfoldername=1

すると、フォルダ名が曲名の横にカッコ書きで出るようになります。

譜面公募で同じ曲名ばっかりで困ったときとかに役立ちます(たぶん)。

エディタで使えるエフェクトの種類を追加する(ユーザー定義エフェクト)

譜面ファイル(.ksh)をメモ帳などで開いて、例えば最後の行の後に次のような行を足して保存、エディタで開くと、音の低いFlangerエフェクトが選べるようになっています。

#define_fx LoFl type=Flanger;delay=80samples;depth=60samples

そのほかLaserオブジェクトでピッチ変更など、いろんなエフェクトが追加できます(が、テキスト編集しないといけなくて割と面倒)。

詳細は昔のブログ記事をご参照ください。

masakaブログ

http://mtstdy.blog.fc2.com/blog-entry-27.html

[K-Shoot MANIA v1.60] ユーザー定義エフェクトの作成方法

K-Shoot MANIA v1.60以降では外部ソフトウェア(REAPER)によるエフェクト書き出しが不要になったため、譜面データの配布にはmp3ファイルと譜面ファイルのみで良くなりました。そのほか、FXエフェクト・LASER音声エフェクトをユーザー側で定義することができるようになりました。本記事では、このユーザー定義エフェクトの作成方法について説明します。重要： v1.60cより前のバージョンのエディタにはユーザー定義エフェクトの記述が...

よほどのこだわりがなきゃデフォルトのやつでやりくりできると思うので、個人的にはユーザー定義エフェクト不要論を唱えておきます(過激派)。

レーンの拡大(視点変更)を一瞬で変化させる

直角レーザーなどに合わせて変更する時、視点を一瞬で変化させたい場合があります。

その場合は、半角セミコロン(;)で区切って２つの値を指定すれば、その瞬間で値を変化させることができます。

例えばTOPの値に「0;100」を指定すると以下のようになります。

~~一瞬とは言っても本当に一瞬で変わると不自然なので、多少滑らかに変化するよう調整されています。~~

~~直角レーザーとBOTTOMの値をセミコロンで同時に変えると割と合います。~~

※追記(2019/1/3):
v1.67から滑らかに変化せず一瞬で変化するように仕様変更されています(傾き数値指定機能との仕様統一のため)。ご注意下さい。

譜面内でレーンを横に移動させる(zoom_side)

「ばねエフェクト」を使うと譜面でレーンを揺らすことができます(回転を入れた上でCtrl+クリックを2回押すと入れられます)。
しかし、揺らすだけじゃなく横で固定したいことがあるかも知れません。その場合、「zoom_side=」という行を譜面内に追加することでレーンを横移動することができます(マイナスで左、プラスで右にずれる)。

例えば「zoom_side=100」にした場合、以下のようになります。

複数入れれば0→100へ徐々に変化させたりなど、レーン拡大(視点変更)と同じように使えます。

エディタで挿入できないので、どこに入れたら良いか調べるのが大変かも知れません。
その場合、例えばエディタでTOPの値を123にするレーン拡大を追加した上で、メモ帳で「zoom_top=123」を検索し、zoom_sideの値を指定する行に書き換えるなどすればスムーズです(それでも面倒臭そう)。

エディタ上で確認すること自体はできます。「編集」→「選択範囲のレーン拡大をコピー」、「貼り付け」で一応コピペもできます。が、変更はできません(v1.66a時点)。

プレイ背景を自分で用意した画像に差し替える

これは譜面ごとに可能です。

まず、譜面のフォルダに背景に使いたい画像(推奨: 720x640px, JPEG形式)を入れてください。

次に、譜面ファイル(.ksh)をメモ帳などで開き、「bg=」の行の指定をファイル名に書き換えてください。

bg=(ファイル名).jpg

すると、譜面フォルダに入れた画像が使われます。

半角セミコロン(;)で区切ってファイル名を2つ指定すると、ゲージがクリアライン(70%)を超えた場合に別の背景を出すことができます。

同じように背景アニメーションも変更できます。その場合は「layer=」の行を画像ファイル名に変更してください。
アニメーション画像の作成はimgsフォルダ内のbgフォルダにあるgifファイルを参考にしてください。アニメーションGIFとかではなく、600x480pxの画像を横に任意枚数並べたものをゲージ70%未満・70%以上の2種類縦に並べたものです(つまりnフレームの場合(600*n)x960px)。

こだわりのある譜面パッケージとかだと独自背景を使ってるようですね。

背景アニメーションの傾き方を変える・再生速度を変える

背景アニメーションを独自のものにした場合、再生速度を変えたいことがあると思います。

例えば背景アニメーションを「雪(snow)」にした場合、譜面ファイル(.ksh)をメモ帳で開くと以下のようになっています。

※追記(2019/1/3):
v1.67以降のエディタから「/」区切りではなく「;」(半角セミコロン)区切りで指定するよう仕様が変更されています。ご注意下さい。

layer=snow;1100;1

~~半角スラッシュ(/)区切り~~ 半角セミコロン(;)区切りになっていることがわかります。左から画像の名前(またはファイル名)、再生1周にかける時間(ミリ秒)、アニメーションの傾き方の設定となっています。

再生1周にかける時間を変えることで、スピードを変更することができます。
雪背景では1100なので、1.1秒で1周します。大きくすれば遅くなり、小さくすれば速くなります。ちなみにマイナスにすれば逆再生されます(雪が上がっていく…)。

アニメーションの傾き方の値は0〜3の値で指定します(デフォルトは3)。
0を基準に、以下の規則に従って計算してください。

・レーンの傾きと一緒にアニメーションも傾けたい場合: +1
・回転と一緒にアニメーションも回転させたい場合: +2

雪背景では1なので、アニメーションは傾くけど回転だけはしないということになります。

なんでここだけセミコロンじゃなくスラッシュ区切りにしたのかと、今でも後悔しています(このせいでここだけディレクトリの区切り文字の「/」が使えなくなった)。上述のv1.67での仕様変更によりこの問題は解決されました。

判定タイミングだけじゃなく画面の表示タイミングも一緒にずらす

ゲーム内のOPTIONで変更できるのは、コントローラーなどからの入力の遅延を修正するためのものなので、判定のタイミングしか変更されないよう工夫されています。

しかし、画面にも遅延がある場合(TV画面など)やPC側の問題で音声再生が遅れるといった場合には入力タイミングだけでなく画面のタイミングも修正する必要がある場合があります。

その場合は、config.iniを編集します。

「inputdelay=」と書かれた行があるので、これを0にします。

inputdelay=0

その上で、もともと「inputdelay=」の行に書かれていた判定調整の値を「globaloffset=」の行に書いてください。

globaloffset=(もともとinputdelayに書いていた数値)

例えば「inputdelay=5」だったなら「inputdelay=0」に変更した上でglobaloffsetを「globaloffset=5」にします。
こうすることで、プレイ時に譜面のoffset(曲の再生タイミング)を変更した場合と同じように譜面をずらすことができ、結果的に画面もずれることになります。

ただし、画面とともに音声エフェクト(ロングFXで鳴るもの)のタイミングもずれるので、使う場合は以下の行を足して音声エフェクトをずらすことをオススメします。

soundfx_delay=(globaloffsetに指定したものを-1倍した数値)

例えば「globaloffset=5」にしたなら「soundfx_delay=-5」です。
こうすることで、音声エフェクトのタイミングが治ります。

ただし、ずらし幅が大きいと直角音や効果音付きチップFXオブジェクトの音のずれが気になると思います。以下の行を足せばノーツを押した/押していないに関わらず、効果音が正しいタイミングで自動的に鳴るようになります。

auto_play_se=1

これで割と快適です。
ほんとはOPTIONで変えられるようにすべきだけど、判定タイミング調整が2つあると混乱を生みそうなので入れられていません…

Windowsを使わずにLinux上でプレイしたりすると77msも音声タイミングがずれるようだったので、私は「globaloffset=77」「soundfx_delay=-77」「auto_play_se=1」にして、それとは別に判定調整を「inputdelay=4」にしています…

↓redditにこの(ひどい)仕様に気づいてる人がいた

Comment
byu/Proioxis4 from discussion
inkshootmania

あるフォルダ内の曲の判定タイミングを全曲ずらしたりする(conf.ini)

判定調整毎回どっちかにずれてる人っていますよね(ステマニあるある)。

songsディレクトリ内のフォルダ(「K-Shoot MANIA」とか)内に「conf.ini」というファイルを作ると、曲の判定を譜面ファイルをいじらず一括でずらしたりできます。

conf.iniの内容は、例えば以下のように書くことができます。

offset=10

これで譜面ファイルで指定されたタイミングより判定を10ms遅くずらしてくれます。

音量調整毎回でかい人っていますよね(ステマニあるある)。
conf.iniに「volume=」という行を追加すると、音量も一括調整できます。

volume=80

これで譜面ファイルで指定された音量の80%の音量になってくれます。

ところで話は変わるけど、譜面パッケージとかでスコアツイートにハッシュタグ付けて欲しかったりしますよね。
conf.iniに「tweet_option=」という行を入れると、スコアツイートにハッシュタグとかURLとかをデフォルトで後ろに付けたりもできます。

tweet_option=#SF2018

お気に入りフォルダに自由なフォルダ名を付けたい

選曲画面でSTARTボタン(Enterキー)を長押しすると、お気に入りを登録できます。ただ、デフォルトでは「Favorite1」「Favorite2」などのフォルダ名になってしまい、ジャンルとか難易度とかで分けたいときにわかりにくいです。

その場合は、songsフォルダ内に「Favorite1.fav」などがあるので、「高難易度.fav」とかに変えればフォルダ名が「高難易度」になってくれます。

ただ、お気に入りへの新規追加はゲーム内からできなくなるので、その場合は適宜ファイル名を戻すか、favファイルをメモ帳などで編集するようにしてください(面倒臭そう)。

サブフォルダ名の表示を変更したい/消したい

songsフォルダ内のフォルダ(「K-Shoot MANIA」など)の中に「foldername.csv」というファイルを作成することで、そのフォルダ内のサブフォルダの表示名を変更したり、サブフォルダの表示を消したりすることができます。

foldername.csvは以下の形式で記述します。複数行入れれば複数指定できます。

(元のサブフォルダ名),(変更後のサブフォルダ表示名)

例えば海外版Windowsは日本語ファイル名に対応していないので、フォルダ名自体は「subfolder1」とした上で、

subfolder1,サブフォルダ1

などと指定すれば海外環境でもサブフォルダ名を日本語表示できます。ただし、csvファイルの文字コードは必ずUTF-8(BOM付き)で保存してください(Excelを使って作成すると問答無用でShift-JISになるので注意)。

全サブフォルダを対象にする場合、元のサブフォルダ名には「*」を指定できます。また、変更後のサブフォルダ表示名は「""」と指定すればサブフォルダの見出しを非表示にできます。

つまり、以下のように指定すればサブフォルダ名の見出しをすべて非表示にできます。

*,""

このテクニックはSF2016でも使われているようです。
これを応用することで、All表示やお気に入りでABC順をフォルダ名変更によって乱すことなくパッケージ内での曲の順序を変えることができます(サブフォルダの実際の名前を順番の数字にし、foldername.csvを「*,""」にする、など)。

譜面のある部分だけゲージの重みを変えたい

※追記(2019/6/3): この機能は今後廃止される可能性が高いので非推奨です

譜面の一部だけ、ゲージが増えやすく＆ゲージが減りやすくすることができます。
譜面のある部分だけ重要度が増す形になります。

chiprate=2x
longrate=2x
laserrate=2x

デフォルトは「1x」で、他に「2x」と「3x」を選ぶことができます。譜面の途中で変更することが可能です(特定のノーツに対してではなく、その行以降すべてのノーツに適用されます)。

「2x」にした場合、ゲージの増え方が2倍、減り方が1.5倍になります。
「3x」にした場合、ゲージの増え方が3倍、減り方が2倍になります。

ただしTOTAL値の自動算出にも影響するので、TOTAL値を固定していない場合は譜面全体のゲージ増減もあわせて変わります。
あくまで特定の部分だけ2倍にしたいといった場合の用途にのみ使えると思います。

もともとINPUT GATEの『-if- 扉のその向こう側へ』の譜面でオートプレイ時に背景がぴったりのタイミングで変わるようにするためのゲージ調整用に実装したのですが、ミスって配信前にkshファイルから記述が消えちゃったようでした。
同じくINPUT GATEの『Happycore☆Tightcore』のIN譜面が難しすぎるとのことで緩和のためにこっそり入れられていますが、ゲージが減りやすくもなるのであまり緩和になっていない説が…

曲名やアーティスト名に画像を使う

曲名やアーティスト名には実は画像を使うことができます。使用する場合は、譜面ファイル(.ksh)をメモ帳などで開いた上で、以下のように行を追加してください。
画像を追加しても、テキストで書かれた曲名やアーティスト名は消さないよう注意してください。

title=タイトル
title_img=(画像ファイル名).png
artist=アーティスト名
artist_img=(画像ファイル名).png

基本的に黒背景に白い文字で入れてください。色を使った場合でもグレースケールに変換された上で処理されます。

INPUT GATEの『Mou Nè Yo』を追加する際、当時譜面ファイルがUTF-8に対応していなかったため「è」を入れることができず、これを解決するために実装しました。『Mou Nè Yo』では200x50pxのJPEG形式の画像として「mouneyo_title.jpg」が入れられています。

StepMania用譜面を遊ぶ

K-Shoot Editorは地味にステマニ用譜面ファイル(.sm)を開くことができます。

「ファイル」→「開く」からファイル選択ダイアログを出し、ファイルの種類を「StepMania譜面ファイル(*.sm)」に変更すれば選択できます。

開くとどの難易度を変換するか順番に聞かれ、StepMania譜面を開くことができます。

ショートノーツはチップBT、ホールドノーツはロングFXに変換されます。
譜面停止も一応変換できますが、計算が正確でないのか、譜面停止がある譜面ではタイミングがずれることが多く、プレイできない場合が多いです。

ぜひDDRマットを繋いで足で踏みたい時にでもどうぞ(2回目)。

プログラムのこと、DTMのこととか

KSON形式とは？

Q&A

Q1. 同名の.kshファイルと.ksonファイルを両方配置した場合はどうなりますか？

Q2. KSON形式では、インターネットランキングの譜面ハッシュ値はどのように計算されますか？

Q3. 過去の譜面を再配布する場合、KSON形式に変換して配布した方が良いのですか？

Q4. 新機能を使っていない場合、KSH形式とKSON形式のどちらを使うべきでしょうか？

KSON形式・KSH形式の相互変換の制約について

KSH(旧)→KSON(新)形式の変換

KSON(新)→KSH(旧)形式の変換

次世代譜面形式「kson」への移行

動作安定性の圧倒的向上

譜面管理、ハイスコア管理、コースモードの改善

LASERノーツの判定改善

エディタ機能の改善

開発当時はね…

不幸な事実

"スキン"の台頭

結論

症状

解決策

症状

解決方法

補足

インストール手順

補足: プロキシ越しでのExtensionのインストール

補足: プロキシ越しでのExtensionのインストールがうまく行かない場合の対処法(オフラインインストール)

一応デフォルトで3種類配色が用意されているが…

「default」

「classic」

「podo」

オレオレ改良版配色

解決策

細かい注意点

picload命令の第2引数も使いたい場合(2019/1/2追記)

チップBTオブジェクトにDDR風の色を付ける

プレイヤー別にハイスコアを分ける

譜面動画作成用の連番png出力をする

選曲画面で譜面が入っているフォルダ名を表示する

エディタで使えるエフェクトの種類を追加する(ユーザー定義エフェクト)

レーンの拡大(視点変更)を一瞬で変化させる

譜面内でレーンを横に移動させる(zoom_side)

プレイ背景を自分で用意した画像に差し替える

背景アニメーションの傾き方を変える・再生速度を変える

判定タイミングだけじゃなく画面の表示タイミングも一緒にずらす

あるフォルダ内の曲の判定タイミングを全曲ずらしたりする(conf.ini)

お気に入りフォルダに自由なフォルダ名を付けたい

サブフォルダ名の表示を変更したい/消したい

譜面のある部分だけゲージの重みを変えたい

曲名やアーティスト名に画像を使う

StepMania用譜面を遊ぶ

Author Profile

スポンサーリンク

カテゴリー

検索

最近の投稿

リンク

人気の記事