翔星 Be ランド日記

警告・情報一覧ウィンドウ

歌詞ファイル更新時動作の改善

自動でレイアウトを設定

新字幕アクション「上下スライド」

その他

「表示開始時刻」と「表示終了時刻」

「表示開始時刻」と「表示時間」

曲の先頭と末尾からの時刻

曲の末尾の表示時間

更新履歴

フォント設定テンプレート

レイアウト設定テンプレート

プロジェクトテンプレート

MP4 エンコード

二重縁取り

新アクション

良いところ（メリット）

悪いところ（デメリット）

総評

機能比較表

更新履歴

～6 時間以下	16.7 %
6 時間超　～ 1 日以下	16.7 %
1 日超　　～ 3 日以下	41.7 %
3 日超　　～	25.0 %

メールは土日や夜に来ることもあるので、認定作業は割といつでもやっているようです。

関連記事

• シンプルなコンテキストメニュー
• 左クリックでもオープンするコンテキストメニュー
• テキストボックスデフォルトのコンテキストメニューを非表示にする
• リストボックスのアイテムのみ右クリックでオープンするコンテキストメニュー
• 動的に状態を制御するコンテキストメニュー
• 動的にアイテム数を制御するコンテキストメニュー

シンプルなコンテキストメニュー

<Label Content="シンプルなコンテキストメニュー：右クリックでオープンする（左クリックではオープンしない）" >
<Label.ContextMenu>
    <ContextMenu>
        <MenuItem Header="シンプルラベルメニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="シンプルラベルメニュー 1" />     
  （省略...）
        </MenuItem>
    </ContextMenu>
</Label.ContextMenu>
</Label>

左クリックでもオープンするコンテキストメニュー

<Button Name="ButtonLeftSample" Content="左クリックでもオープンするコンテキストメニュー（コントロールのイベントを捕捉してオープンする）" Margin="0,10,0,0" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="Click">
        <behaviors:ChangePropertyAction TargetObject="{Binding ContextMenu, ElementName=ButtonLeftSample}" PropertyName="IsOpen" Value="True"/>
        <behaviors:ChangePropertyAction TargetObject="{Binding ContextMenu, ElementName=ButtonLeftSample}" PropertyName="PlacementTarget" Value="{Binding ElementName=ButtonLeftSample, Mode=OneWay}"/>
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Button.ContextMenu>
    <ContextMenu >
        <MenuItem Header="左クリックメニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="左クリックメニュー 1" />
        <MenuItem Header="左クリックメニュー 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="左クリックメニュー 2" />
    </ContextMenu>
</Button.ContextMenu>
</Button>

テキストボックスデフォルトのコンテキストメニューを非表示にする

<TextBox Width="100" Text="非表示" VerticalAlignment="Center" ContextMenu="{x:Null}" />

リストボックスのアイテムのみ右クリックでオープンするコンテキストメニュー

<ListBox ItemsSource="{Binding NarrowListBoxItems}" Width="290" >
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem" >
            <Setter Property="Tag" Value="{Binding RelativeSource={RelativeSource AncestorType=Window}, Path=DataContext}"/>
            <Setter Property="ContextMenu">
                <Setter.Value>
                    <ContextMenu DataContext="{Binding Path=PlacementTarget.Tag, RelativeSource={RelativeSource Self}}">
                        <MenuItem Header="アイテムのみ ListBox メニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="アイテムのみ ListBox メニュー 1" />
                        <MenuItem Header="アイテムのみ ListBox メニュー 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="アイテムのみ ListBox メニュー 2" />
                    </ContextMenu>
                </Setter.Value>
            </Setter>
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

動的に状態を制御するコンテキストメニュー

<Label Content="動的に状態を制御するコンテキストメニュー" Margin="0,10,0,0" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="ContextMenuOpening">
        <l:LivetCallMethodAction MethodName="PrepareDynamicStateContextMenu" MethodTarget="{Binding}" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Label.ContextMenu>
    <ContextMenu>
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 1" />
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 2" IsEnabled="{Binding IsDynamicStateMenuItemEnabled}" />
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 3" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 3" Visibility="{Binding DynamicStateMenuItemVisibility}"/>
    </ContextMenu>
</Label.ContextMenu>
</Label>

動的にアイテム数を制御するコンテキストメニュー

<Label Content="動的にアイテム数を制御するコンテキストメニュー" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="ContextMenuOpening">
        <l:LivetCallMethodAction MethodName="PrepareDynamicItemsContextMenu" MethodTarget="{Binding}" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Label.ContextMenu>
    <ContextMenu ItemsSource="{Binding DynamicMenuItems}" />
</Label.ContextMenu>
</Label>

（補足）

本記事は、以前の記事を時代に合わせて改訂したものです。

使用するパッケージ

Microsoft.EntityFrameworkCore.Sqlite のインストール

テーブル構造定義クラスの作成

フィールド名	型	NULL	備考
test_id	整数	不可	連番、主キー
test_name	文字列	不可	氏名、インデックス作成、ユニーク制約
test_height	浮動小数	可	身長

[Table("t_test")]
[Index(nameof(Name), IsUnique = true)]
internal class TTestData
{
    // ID
    [Key]
    [Column("test_id")]
    public Int32 Id { get; set; }

    // 氏名
    [Column("test_name")]
    public String Name { get; set; } = String.Empty;

    // 身長
    [Column("test_height")]
    public Double? Height { get; set; }
}

コンテキストクラスの作成

internal class TestContext : DbContext
{
    // テストテーブル
    public DbSet<TTestData> TestData { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        SqliteConnectionStringBuilder stringBuilder = new()
        {
            DataSource = "Test.sqlite3",
        };
        using SqliteConnection sqliteConnection = new(stringBuilder.ToString());
        optionsBuilder.UseSqlite(sqliteConnection);
    }
}

データベースファイルの作成

using TestContext testContext = new();
testContext.Database.EnsureCreated();

レコードの挿入

testContext.TestData.Add(new TTestData { Name = "Fukada Kyoko" });
testContext.TestData.Add(new TTestData { Name = "Eda Ha", Height = 159.0 });
testContext.SaveChanges();

Add() した時点では実際にはデータベースファイルには追加されず、SaveChanges() でまとめて追加されます。

文字列で SQL を記述する必要がないため、タイプミスによるエラーが発生せず、また、Visual Studio の各種サジェストによる支援も受けられます。確実・簡単にデータベースを操作できます。

レコードの検索

IQueryable<TTestData> queryResult = testContext.TestData.Where(x => x.Name == "Eda Ha" || x.Height < 150.0).OrderBy(x => x.Height);

Where(x => x.Name.Contains("a"))

Where(x => x.Name.Contains("a", StringComparison.OrdinalIgnoreCase))

Where(x => EF.Functions.Like(x.Name, $"%a%"))

レコードの削除

IQueryable<TTestData> queryResult = testContext.TestData.Where(x => x.Height == null || x.Height < 150.0);
testContext.TestData.RemoveRange(queryResult);
testContext.SaveChanges();

レコードの更新

サンプルコードについて

インメモリデータベース

ジャーナルモード

更新履歴

状況整理

解決方法

【注意】

本記事の解決方法は情報が古くなりました。

新しい解決方法については、こちらをご覧ください。

備忘として以下を残しておきます。

資産ファイル '～\obj\wappublish\win-x64\project.assets.json' が見つかりません。

  "targets": {
    "net6.0-windows10.0.19041": {},
    "net6.0-windows10.0.19041/win-x64": {}
  },

事前準備

アプリのインストール

PS> CD 目的のフォルダーパス

PS> .\Install.ps

起動

関連リンク

アプリ更新編　目次

更新版アプリのパッケージ作成

更新申請

申請ページが更新したページだけ「更新済み」となるので、そのまま「Microsoft Store に提出」ボタンをクリックすれば、更新版を申請できます。

ストアからの更新

所感

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

関連記事

ストア配布編　目次

申請

システム要件もそれっぽいのを入れておきます。





作成したアプリパッケージ（パッケージプロジェクトフォルダーの中の AppPackages フォルダーにある msixupload ファイル）をドラッグ＆ドロップしてアップロードします。

デバイスファミリの利用可否のところで、どの Windows で使えるかを指定します。今回はノーマルな Windows のみにしておきました。








申請オプションは特に変更しなくて大丈夫です（タイミングを遅らせることもできます）。

認定待ち

コラム：認定作業は平日のみか？

ストアからのダウンロード

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

関連記事

更新履歴

アプリ作成編　目次

準備

（メモ）

非 UWP アプリを UWP 風にしてストア配布できるようにする仕組みを Desktop Bridge と呼ぶようです。

Desktop Bridge のやり方はいくつかあり、昔は Desktop App Converter(DAC) を使っていましたが、その後継が MSIX Packaging Tools のようです。

WPF アプリ作成

    <Grid>
        <Label Content="Ver 1" FontSize="50" HorizontalAlignment="Center" VerticalAlignment="Center" />
    </Grid>

高 DPI 対応宣言

ソリューションエクスプローラーのプロジェクトを右クリックし、［追加 → 新しい項目］を選びます。

  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
    </windowsSettings>
  </application>

64 ビット設定

MSIX パッケージプロジェクトの追加

ロゴの作成

アプリケーション名の予約（簡単な方法）

（補足）
こちらは Visual Studio から簡単に予約する方法です。

パッケージ名にこだわりたい場合は次節をご覧ください。

アプリケーション名の予約（パッケージ名にこだわる方法）

MSIX パッケージ作成

パッケージの検証

C:\Users\（管理者ユーザー）\AppData\Local\Microsoft\AppCertKit\ValidationResult.htm

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

更新履歴

開発者登録編　目次

メモ：なぜ Microsoft Store？

必要なもの

パートナー登録

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

大まかな手順

STEP 1：XAML 作成

STEP 2：動的読み込み

注意点

xmlns:vm="clr-namespace:TestXamlReader.ViewModels"

xmlns:vm="clr-namespace:TestXamlReader.ViewModels;assembly=TestXamlReader"

（補足）

別のプロジェクトで、assembly を指定するとビルド時に MC3074 エラー「タグ 'XXX' は、XML 名前空間 'clr-namespace:YYY;assembly=ZZZ' にありません。」が発生したことがあった。

対処方法が分からず、xaml 上では assembly を指定せず、実行時に文字列置換で assembly 指定を追加することで凌いだことがある。

xmlns:dd="urn:gong-wpf-dragdrop"

xmlns:dd="clr-namespace:GongSolutions.Wpf.DragDrop;assembly=GongSolutions.Wpf.DragDrop"

await SomeAsync();

～Async() の中ではひたすら Task.Run() すれば UI はフリーズしないが、他の async を呼ぶために async にしている場合は、その他のコードが重くないか考える必要がある。

ActualWidth はバインドできない

Livet で楽ちん

<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="SizeChanged">
        <l:WindowSetStateToSourceAction Source="{Binding ActualHeight, Mode=TwoWay}" Property="ActualHeight" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>

今回はビヘイビアについて少し考えてみるのが目的なので、ActualWidth についてビヘイビアを自作する。

ビヘイビアで ActualWidth をバインド可能にする

public static readonly DependencyProperty ActualWidthProperty =
        DependencyProperty.Register(nameof(ActualWidth), typeof(Double), typeof(WindowBindingSupportBehavior),
        new FrameworkPropertyMetadata(0.0, FrameworkPropertyMetadataOptions.BindsTwoWayByDefault));

public Double ActualWidth
{
    get => (Double)GetValue(ActualWidthProperty);
    set => SetValue(ActualWidthProperty, value);
}

DependencyProperty.Register() の第二引数で変数の型、第三引数でビヘイビアクラスを指定する。第四引数の FrameworkPropertyMetadata 内でプロパティーのデフォルト値を指定する。

依存プロパティー登録により ActualWidth のバインドが可能となったので、次は、ActualWidth の値を更新して有用な値にするところ。

ビヘイビアで IsActive をバインド可能にする

private static void SourceIsActiveChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    if ((obj is not WindowBindingSupportBehavior thisObject) || thisObject.AssociatedObject == null)
    {
        return;
    }

    if ((Boolean)args.NewValue)
    {
        thisObject.AssociatedObject.Activate();
    }
}

処理速度の結論

そもそも

• AutoResetEvent……スレッドをシグナル状態になるまで待機させる。単一の待ちスレッドが解放された後、自動的にリセットされる。
• CountdownEvent……スレッドをカウントダウンが 0 になるまで待機させる。複数のスレッドからのシグナルで 1 つ以上のスレッドのブロックを解除できる。
  

とあるので、待機させる側と待機する側のスレッド数は、AutoResetEvent は 1 対 1、CountdownEvent は複数対複数、ということになる。

速度比較

まとめ

自分のプロジェクトだとそこまで頻繁に同期するわけではなく（数分間で 1 万回程度、つまり 20 ミリ秒程度の差異）、速度差は誤差程度なので、安心感のある AutoResetEvent を使い続けるかもしれない。

対象のフレームワーク

NETSDK1137 警告

NETSDK1137 Microsoft.NET.Sdk.WindowsDesktop SDK を使用する必要はなくなりました。
ルート プロジェクト要素の SDK 属性を 'Microsoft.NET.Sdk' に変更することをご検討ください。

単一ファイルの作成

<IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>

<DebugType>embedded</DebugType>

	フォーム ゆかりすたー Ver 7.51	WPF / コードビハインド ゆかりすたー METEOR Ver 1.50	WPF / MVVM ゆかりすたー METEOR Ver 2.02
保守容易性指数	82	84	86
サイクロマティック複雑度	3888	3933	4480
継承の深さ	7	9	9
クラス結合	431	466	465
コード行	12498	9685	9333

保守容易性指数

	元の WPF / MVVM	コントロール削除
保守容易性指数	91	91
サイクロマティック複雑度	1	1
継承の深さ	9	9
クラス結合	7	2
コード行	2	2

サイクロマティック複雑度

継承の深さ

クラス結合

コード行

まとめ

ViewModel から直接 View を参照してしまう

<i:EventTrigger EventName="ContentRendered">
    <l:LivetCallMethodAction MethodTarget="{Binding}" MethodName="Initialize"/>
    <l:LivetCallMethodAction MethodTarget="{Binding}" MethodName="Initialize2" MethodParameter="{Binding ElementName=MyWindow}"/>
</i:EventTrigger>

public void Initialize2(Object oParam)
{
    Debug.WriteLine("Initialize2() param type: " + oParam?.GetType().ToString());
}

WPF のほうが良いところ

• UI コントロールのフロー配置
• テーマで見た目を変えられる
• データと UI の分離と関連付け
• データグリッドがスマート
• 動画系の機能が強化されている

フォームのほうが良いところ

• UI コントールの配置が簡単・速い
• 非ビジュアルコントロールもマウスで配置可能
• 基本的な機能がきちんと揃っている
• マイナーな機能も結構揃ってる
• 勉強量が WPF より少なくて済む
• 日本語の情報が豊富
• WPF は英語含めても情報が見当たらない

まとめ

• まとめ
• 追記：MVVM について
• 蛇足：個人的な好み

UI コントロールのフロー配置

テーマで見た目を変えられる

データと UI の分離と関連付け

データグリッドがスマート

動画系の機能が強化されている

UI コントールの配置が簡単・速い

非ビジュアルコントロールもマウスで配置可能

基本的な機能がきちんと揃っている

マイナーな機能も結構揃ってる

勉強量が WPF より少なくて済む

日本語の情報が豊富

WPF では 1 つのことをやるために C# でコードを書くやり方と XAML でコードを書くやり方の 2 通りの実装方法があるが、片方しか掲載されていないこともしばしば。

WPF は英語含めても情報が見当たらない

まとめ

追記：MVVM について

蛇足：個人的な好み

使い方

const String EXTENDED_LENGTH_PATH_PREFIX = @"\\?\";
String aPath = EXTENDED_LENGTH_PATH_PREFIX + @"C:\Tmp\とても長いパス\123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789A123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890B\1234567890123456789Z\1234567890123456789Y\VeryVeryLongPath";
MessageBox.Show("Len: " + aPath.Length.ToString() + "\nExists: " + Directory.Exists(aPath).ToString());

互換性

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5"/>
  </startup>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false;Switch.System.IO.BlockLongPaths=false"/>
  </runtime>
</configuration>

private Boolean GetClrVersionRegistryNumber(out Int32 oClrVersion)
{
    using (RegistryKey aKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\"))
    {
        if (aKey != null && aKey.GetValue("Release") != null)
        {
            oClrVersion = (Int32)aKey.GetValue("Release");
            return true;
        }
        else
        {
            oClrVersion = 0;
            return false;
        }
    }
}

private Boolean Is462()
{
    Int32 aClrVer;
    GetClrVersionRegistryNumber(out aClrVer);
    return aClrVer >= 394802;
}

private String ExtendPath(String oPath)
{
    // extended-length パスが使えない環境や、既に extended-length パスになっている場合はそのまま返る
    if (!Is462() || oPath.StartsWith(EXTENDED_LENGTH_PATH_PREFIX))
    {
        return oPath;
    }

    // extended-length パスにする
    // MAX_PATH 文字以上のフォルダー名をダイアログから取得した場合など、短いファイル名形式になっていることがあるため、
    // Path.GetFullPath() で長いファイル名形式に変換する
    return EXTENDED_LENGTH_PATH_PREFIX + Path.GetFullPath(oPath);
}

private void button1_Click(object sender, EventArgs e)
{
    try
    {
        String aPath = ExtendPath(@"C:\Tmp\短いパス");
        //String aPath = ExtendPath(@"C:\Tmp\とても長いパス\123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789A123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890B\1234567890123456789Z\1234567890123456789Y\VeryVeryLongPath");
        MessageBox.Show("4.6.2 or higher: " + Is462().ToString() + "\nLen: " + aPath.Length.ToString() + "\nExists: " + Directory.Exists(aPath).ToString());
    }
    catch (Exception oExcep)
    {
        MessageBox.Show(oExcep.Message);
    }
}

環境 1（メインマシン）

	現行（Ver 7.21 β）	新バージョン
ファイル名のみ検索可能となるまでの時間	-	15 秒
全属性で検索可能となるまでの時間	5 分 43 秒	5 分 06 秒

環境 2（LAVIE）

	現行（Ver 7.21 β）	新バージョン
ファイル名のみ検索可能となるまでの時間	-	13 秒
全属性で検索可能となるまでの時間	3 分 54 秒	4 分 16 秒

解説

カラオケ字幕付き動画を手軽に作れるツール「ニコカラメーカー」を活用して作成された動画の数が、750 を超えました。

501～750 番目のニコカラの中から、いくつかピックアップしてご紹介させていただきます。

すべての一覧は、以下のリンクからご覧になれます。

• ニコカラメーカーを活用して作成された動画の一覧

ニコカラメーカーを使用して作成した動画をニコニコ動画にアップロードした場合、ニコカラメーカー　簡易説明書動画をコンテンツツリーの親にご登録お願いします。上記リンクに反映されます。

アリスのお茶会 ～デキる女と(ry（Raildex さん）

東方ニコカラです。

ニコカラメーカーのインライングラフィックス機能を活用し、パート分けをアイコンで分かりやすく行っています。

NeGa/PoSi*ラブ/コール（ディレイドさん）

東方ニコカラです。

ディレイドさんの投稿ペースは速く、次々とニコカラを投稿されています。魂音泉さんや凋叶棕さんのニコカラが多いようです。

Bi☣hazard（饒速水琥白主さん）

UTAU 音源「気球音アイコ」5 周年で作曲された UTAU オリジナル曲のニコカラです。

英語歌詞ですが、ルビが振られているので分かりやすいです。

ふたりの点滅（しゅれんつさん）

CeVIO 黄咲愛里オリジナル曲のニコカラです。

動画の雰囲気に合わせた字幕配色になっています。

いちにちっ！(ver.Xmas)（徒者さん）

メドレーカラオケです。

徒者さんはニコカラ初挑戦とのことです。新しくニコカラを作り始めて下さる方が増えるのは嬉しいですね。

マグネット・ジョーに気をつけろ（Ottomo さん）

星屑スキャットのボカロカバー版のニコカラです。

Ottomo さんもニコカラ初挑戦とのことです。丸くて優しいフォントをセレクトされています。


これからもどんどんニコカラが増えていくのを楽しみにしています。

カラオケ字幕付き動画を手軽に作成できる「ニコカラメーカー」の今後のバージョンアップについて、見通しを整理しておきます。現時点でのものですので、今後変更の可能性は多いにあります。

2016/04/14 現在、ニコカラメーカーに頂いている要望等は 61 件で、そのうち、37 件は既に対応済みです。

今後検討が必要な大規模改修は、以下となります。

• 半透明字幕
• 複数歌詞ファイルの読み込み（パート分け）
• 歌詞のアニメーション
• ルビ入力
• 出力形式の多様化

半透明字幕

歌詞字幕や影などを透けるようにできる機能は、比較的近い将来に対応したいと考えています。

しかしながら、内部処理が複雑なので、実現できるかどうかはまだ不透明です。

複数歌詞ファイルの読み込み（パート分け）

デュエット曲などでは、歌詞ファイルをパートごとに分けて作成される方がいらっしゃいます。現時点では、歌詞ファイルを 1 つしか読み込めませんが、将来的には複数の歌詞ファイルを読み込めるようにしたいと考えています。

単に読み込めるというだけではなく、自動レイアウトもパートごとに分かれるようにする予定です。

歌詞のアニメーション

これについては、直近での対応予定はありません。一般的な商業カラオケではアニメーションしておらず、応用的な内容となるためです。

技術的にも困難が予想され、実現できるかどうか、かなり難しい状況です。

しかし、実現できれば楽しいニコカラが作れるようになりますので、将来的には検討したいです。

ルビ入力

現時点でのニコカラメーカーは歌詞ファイルに記載されているルビを読み込むのみですが、ニコカラメーカー上で直接ルビを編集できる機能について、比較的近い将来に対応したいと考えています。

出力形式の多様化

現時点でのニコカラメーカーは無圧縮 AVI のみ出力可能ですが、将来的には、多様なフォーマットで出力できるようにしたいと考えています。

しかし、技術的には困難が予想され、実現できるかどうかは現時点で不透明です。

ニコカラ（カラオケ字幕付き動画）を手軽に作れるフリーソフト「ニコカラメーカー」を開発している。

というのも、ニコカラを作ってみたいと思ってネットで調べてみたら、手順がものすごく難しそうで、それならツールを自作した方が楽なんじゃないか、と思ったからである。

現状、ニコカラは主に以下のような手順で作るらしい（サイトによって少しずつ違うのでイマイチわからないが）。［］内は各段階での成果物のファイル拡張子、【】内は代表的な使用ツール。

1. 素材（動画、タイムタグ付き歌詞ファイル）を揃える。　［.mp4 .txt］【RhythmicaLyrics】
2. タイムタグ付き歌詞ファイルを字幕に変換する。　［.ass］【txt2ass】
3. ルビを振る。　［.ass］【txt2ass】
4. 出来映えを確認する。　［.avi］【VirtualDubMod / Vobsub / TextSub】
5. ツールを行ったり来たりしながら 2～4 を繰り返す。保存のやり方を間違えるとデータが消えるらしい。
6. エンコードする。　［.mp4］【AviUtl】

特に、2～5 の繰り返しが鬼のように面倒くさそうな感じである。1 つのツールでできないので、注意しないと修正した時にデータの齟齬が発生したりするようだ。

また、どのサイトもエンコードに AviUtl を使うと書いてあったが、何か理由があるのだろうか。どうにも AviUtl は敷居が高くて踏み込めない。エンコードだけなら夏蓮根の方が親切丁寧で手っ取り早いと思うのだが。

そんなこんなで、開発中のニコカラメーカーは、2～5 の作業を簡単にできるようにする予定。

現在できているところまでで、サンプル的に動画を出力してみたのが、冒頭のスクリーンショット（クリックすると拡大する）。ニコカラっぽくなっていると思う。

ニコカラメーカーの動作の様子は、右の写真（まだ機能はほとんど実現できていないが……）。

今までのニコカラ作りのやり方だと、汎用ツールを使っているので、ニコカラには不要な機能まで山ほどあり、逆にそれが分かりづらさにつながっていると思う。ニコカラメーカーはシンプルにニコカラに特化したツールにしたい。エンコードも、たぶん夏蓮根でいけると思う。

ニコカラメーカーを使った新しいニコカラの作り方は、以下のような手順になるだろう。

1. 素材（動画、タイムタグ付き歌詞ファイル）を揃える。　［.mp4 .txt］【RhythmicaLyrics】
2. ルビを含めた字幕を、動作を確認しながら出力する。　［.avi］【ニコカラメーカー】
3. エンコードする。　［.mp4］【夏蓮根】

追記

• ニコカラメーカーを公開しました。
• 動画にまとめました。
  

• どの SQLite ライブラリを使うか？
• ADO.NET とは？
• System.Data.SQLite のインストール
• System.Data.SQLite の基本
• テーブル構造定義クラスの導入
• レコードの挿入
• レコードの検索
• レコードの削除
• サンプルコード
• サンプルコードアプリの使い方
• 参考資料
• 更新履歴

どの SQLite ライブラリを使うか？

C# で SQLite を使うための方法はいくつかあり、自分が把握している範囲では以下のようになる。

• C 言語用 DLL を P/Invoke で使う……本家本元の DLL を使い、従来型の文字列によるクエリでプログラミング。最新のライブラリを使える（本稿執筆時点で 3.9.2）。しかし、C 言語レベルの生産性しかなく、労多くして功少なしなので、どうしても最新のバージョンを使いたい時以外はお薦めしない。
• System.Data.SQLite……SQLite 本家による .NET 用ライブラリ。データベースを便利に使う ADO.NET に対応しており、生産性が向上。C 言語用 DLL よりは多少バージョンが古い（3.8.11.1 ベース）ものの、総合的に一番お薦め。
• Mono.Data.SqliteClient…….NET のオープン・クロスプラットフォーム実装である Mono プロジェクトが作成したライブラリ。ADO.NET 対応。文字コードが Unicode（恐らく UTF-16）と記載があるのが気になる（本家は UTF-8）。別途本家 C 言語用 DLL が必要な模様。
• csharp-sqlite……マネージドコードのみで作成されたライブラリ。ADO.NET 対応。2011 年で開発停止の模様。バージョンは 3.7.7.1。マネージドコードしか使えない制約がある場合に重宝しそう。
• sqlite-net……コンパクトなライブラリ。ADO.NET 非対応。できる限り実行ファイルサイズを小さくしたい場合に活躍しそう。2012 年あたりで開発が停止しているようだ。

以降では、System.Data.SQLite を使う。

ADO.NET とは？

System.Data.SQLite は ADO.NET に対応しているが、そもそも ADO.NET とは何か。ADO.NET の詳しい解説は @IT の記事などに記載があるが、プログラマーから見たメリットを三行で書くとすれば、

• エディタのコード補完で楽ちんかつ安全にクエリを書ける（LINQ）
• 設計時からデータ構造をビジュアル化できる（Entity Framework）
• 使うデータベース（SQLite/Oracle……）によらず同じコードを使い回せる

あたりになるのではと理解している。

これにより、C 言語で SQLite をいじるよりもはるかに効率的にデータベースプログラミングが行える。

なお、本稿では、LINQ は使うが Entity Framework は使わない。

System.Data.SQLite のインストール

インストールは非常に簡単である。ここでは、Visual Studio 2015 Community / .NET Framework 4.5 の環境で実行しているものとする。

1. Visual Studio を起動し、SQLite を使いたいプロジェクトを開く
2. メニューの［ツール｜NuGet パッケージマネージャー｜ソリューションの NuGet パッケージの管理］をクリック
3. 検索窓に「SQLite」と入力して SQLite パッケージを検索
4. 検索結果の System.Data.SQLite を選択して、インストールボタンをクリック。関連するライブラリも含めて自動でインストールが終わる

たったこれだけ。

以前は、NuGet をコマンドラインで使う必要があった時代もあったようだが、現在は GUI で使える。

NuGet の欠点は、プロジェクトごとにインストールの必要があるため（プロジェクトに最適なバージョンを選んでインストールしてくれる）、SQLite を使うプロジェクトが複数ある場合は、ディスクをどんどん消費していく。その場合は、ダミープロジェクトでインストールしたバイナリを使い回したり、手動でバイナリをダウンロードして共用するといいかもしれない。

System.Data.SQLite の基本

データベースファイル（*.db とか *.sqlite3 とか）を開くには、SQLiteConnection クラスを使う。

SQLiteConnection を new する際にパラメーターを文字列で渡すのだが、SQLiteConnectionStringBuilder というお助けクラスを使うと、パラメーター文字列をミスなく生成できる。

SQLiteConnectionStringBuilder aConnectionString = new SQLiteConnectionStringBuilder
{
    DataSource = @"R:\Test.db"
};
using (SQLiteConnection aConnection = new SQLiteConnection(aConnectionString.ToString()))
{
    aConnection.Open();

    // ここにデータベース処理コードを書く
}

従来型の文字列によるコマンドを発行したい場合は、SQLiteCommand クラスを使う。

using (SQLiteCommand aCmd = new SQLiteCommand(aConnection))
{
    aCmd.CommandText = "CREATE TABLE IF NOT EXISTS t_test (test_id INTEGER NOT NULL PRIMARY KEY, test_name NVARCHAR NOT NULL, test_height REAL);";
    aCmd.ExecuteNonQuery();
}

テーブル構造定義クラスの導入

データへのアクセスを簡単・分かりやすくするために、テーブル構造を定義するクラスを作成する。

簡易名簿テーブル「t_test」が以下のような構造になっているとする。

フィールド名	型	NULL	備考
test_id	INTEGER	不可	連番
test_name	NVARCHAR	不可	氏名
test_height	REAL	可	身長

この場合、テーブル構造定義クラスは以下のようになる。

[Table(Name = "t_test")]
public class TTestData
{
    // ID
    [Column(Name = "test_id", DbType = "INT", CanBeNull = false, IsPrimaryKey = true)]
    public Int32 Id { get; set; }

    // 氏名
    [Column(Name = "test_name", DbType = "NVARCHAR", CanBeNull = false, UpdateCheck = UpdateCheck.Never)]
    public String Name { get; set; }

    // 身長
    [Column(Name = "test_height", DbType = "REAL", CanBeNull = true)]
    public Double? Height { get; set; }
}

フィールドをプロパティーとして定義しているシンプルなクラスである。

CREATE TABLE で作成した際のテーブル情報に合わせて、クラスメンバーの属性を記述している。例えば ID フィールドであれば、Name = "test_id" でデータベース上のフィールド名、DbType = "INT" でデータ型、CanBeNull = false で NULL 不可であることを表している。

DbType の型について注意点が 2 つ。

• 整数型は DbType = "INT" とする。INTEGER ではエラーになる。
• 文字列型は DbType = "NVARCHAR" とする。TEXT ではエラーになる。
  

特に、文字列型を TEXT としてしまうと、原因が分かりづらいエラーが発生し、ハマることになる。

身長フィールドは、NULL を許可している。CanBeNull = true にすると共に、プロパティーの型を「Double?」というように「?」を付けて nullable にしている。

レコードの挿入

テーブル構造定義クラスを導入したことにより、データベースの取扱が非常に簡単になる。

レコードの挿入を行うコードは、以下のようになる。SQLiteCommand クラスを使わなくて済むので全然 SQL っぽくなく、普通のコードのように書ける。

using (DataContext aConText = new DataContext(aConnection))
{
    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    aTableTest.InsertOnSubmit(new TTestData { Id = 1, Name = "Fukada Kyoko" });
    aTableTest.InsertOnSubmit(new TTestData { Id = 2, Name = "Eda Ha", Height = 180.0 });
    aTableTest.InsertOnSubmit(new TTestData { Id = 3, Name = "Dan Gerou", Height = 150.5 });
    aTableTest.InsertOnSubmit(new TTestData { Id = 4, Name = "Baba Takashi" });
    aTableTest.InsertOnSubmit(new TTestData { Id = 5, Name = "Aikawa Ai", Height = 145.6 });
    aConText.SubmitChanges();
}

ID 1 や 4 では身長を設定していないので、データベース上 NULL として格納される。

レコードの検索

レコードの検索は LINQ to SQLite と呼ばれる手法で行う。ちょっと変わった書き方だが、エディタのコード補完が効くのでミスが減る。

using (DataContext aConText = new DataContext(aConnection))
{

    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aQueryResult =
            from x in aTableTest
            where x.Name == "Eda Ha" || x.Height < 150.0
            orderby x.Height
            select x;
    foreach(TTestData aData in aQueryResult)
    {
        Debug.WriteLine(aData.Name);
    }
}

from のところが SQL の発行に相当する部分。なんとなく SQL に似ているので、読めば理解はできると思う。

where x.Name.Contains("hoge")

のようにすれば良い。

レコードの削除

レコードを削除する場合、削除したいレコードを検索し、それを削除する、という流れになる。

検索については前節と同じで、その結果を、DeleteAllOnSubmit() メソッドにぶち込むだけ、とこれまた簡単。

using (DataContext aConText = new DataContext(aConnection))
{
    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aDelTargets =
            from x in aTableTest
            where 140 < x.Height && x.Height < 160
            select x;
    aTableTest.DeleteAllOnSubmit(aDelTargets);
    aConText.SubmitChanges();
}

サンプルコード

以上をまとめたものを、サンプルコードとして公開する。

• 公開場所……GitHub
• ライセンス……クリエイティブ・コモンズ・ライセンス（表示 2.1 日本）（第三者部分を除く）
• ビルド方法……別途 LinqUtils.cs が必要。詳細はリポジトリ内の TestLinqToSqlite_ReadMe_JPN.html 参照

サンプルコードアプリの使い方

なお、サンプルコードアプリにはジェネリックの欄もあるが、こちらについては「LINQ to SQLite で共通カラム部分をジェネリックで運用する」を参照。

参考資料

• ADO.NET基礎講座
• C#とEntity FrameworkでSQLiteを使う（Entity Framework実践編）
• 【C#】System.Data.SQLiteを使ってみる
• MonoBook：csharp-sqlite、sqlite-net
• C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）【改訂版】
  

更新履歴

※改訂版を公開しましたので、改訂版をご覧ください。

SQLite3 を C# で使いたくて、いろいろ試していたら、文字列の比較でエラーが発生。

やったことは、System.Data.SQLite（SQLite の公式 ADO.NET プロバイダー）をインストールし、LINQ to SQLite でデーターベースにアクセス。ソースコードはおよそ以下のような感じ。

    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aQueryResult =
            from x in aTableTest
            where x.Name == "Eda Ha"
            select x;

ここで、aContext は DataContext 型のインスタンス。TTestData は以下の定義。

[Table(Name = "t_test")]
public class TTestData
{
    // ID
    [Column(Name = "test_id", DbType = "INT", CanBeNull = false, IsPrimaryKey = true)]
    public Int32 Id { get; set; }

    // 氏名
    [Column(Name = "test_name", DbType = "TEXT", CanBeNull = false, UpdateCheck = UpdateCheck.Never)]
    public String Name { get; set; }
}

このようなコードを実行すると、IQueryable の結果を使う段階で、NotSupportedException が発生する。

    例外がスローされました: 'System.NotSupportedException' (System.Data.Linq.dll の中)
    追加情報:SQL Server では、NText、Text、Xml、または Image の各データ型の比較はハンドルされません。

where x.Name == "Eda Ha" の箇所が where x.ID == 1 のような数値型の比較だと例外は発生しない。

原因がわからずさんざん悩んだ。「SQL Server では～」のエラーメッセージで検索しても情報が見つからない。

結論としては、Name の DbType がまずかった。

DbType を NVARCHAR にして、CREATE TABLE する際の型も NVARCHAR にしたら、うまく動作するようになった。

どうやら、SQLite を .NET で使う場合は、文字列型は NVARCHAR にしないといけないようだ。

なお、エラーが発生した環境は、

• Visual Studio Community 2015
• .NET 4.5
• System.Data.SQLite 1.0.98.0（sqlite-netFx45-setup-x86-2012-1.0.98.0.exe）
  

関連記事

• C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）

Visual Studio (Visual C++) 2013 で作成したスタティックライブラリ（.lib）を、C++Builder XE3 のプロジェクトに組み込みたいのだが、無理のようだ。

VC は COFF というオブジェクトフォーマットを採用しており、一方で、C++Builder は OMF を採用している。このため、単純に、VC の .lib を C++Builder に組み込んでリンクしようとすると、

[ilink32 エラー] Error: '...\HOGE.LIB' には無効な OMF レコード (タイプ 0x21) が含まれています (COFF の可能性もあります)

というエラーとなってリンクできない。

形式が違うのなら変換すればいいじゃない、ということで、C++Builder に付属の coff2omf.exe を使おうとするものの、これは通常のスタティックライブラリを変換するためのツールではなく、インポートライブラリを変換するためのものなので、うまくいかない。

サードパーティーのツールはどうか。objconv を試してみた。

ojbconv -fomf in.lib out.lib

のようにして使ってみたものの、警告がたくさん表示された。結果の .lib を C++Builder に組み込むと、

[ilink32 エラー] Fatal: EXTDEF フィックスアップ インデックス (モジュール 'xxx_00.obj' 内) は無効です

というエラーになってうまくいかない。

DLL を使うしかないか……。

C++Builder は、様々なフォーマットの画像を扱うのも簡単だ。……が、まとまった情報が見つからなくて苦労したので、ここにまとめておく。動作確認は C++Builder XE3。

例として、JPEG 画像を背景画像として、その上に、BMP 画像と透過 PNG 画像を重ねる。合成結果を PNG 画像として保存する。

背景 JPEG	BMP	透過 PNG
	※Web 用に PNG に変換してあるが、元は BMP

準備として、ビットマップ形式以外の画像ファイルを読み書きしたい場合は、対応するヘッダをインクルードしておく。

#include <Jpeg.hpp>
#include <PNGImage.hpp>

ヘッダをインクルードしてしまえば、読み込みに関しては、画像フォーマットを気にせずに読み込めるようになる。書き込みは、対応する画像形式を扱うクラスに任せる。コードは以下。

void __fastcall TFormTest01::Button1Click(TObject *Sender)
{
    unique_ptr<TImage>        aImageMerge(new TImage(this));
    unique_ptr<TImage>        aImageBG(new TImage(this));
    unique_ptr<TImage>        aImage1(new TImage(this));
    unique_ptr<TImage>        aImage2(new TImage(this));
    unique_ptr<TPngImage>    aPng(new TPngImage());

    // 画像ロード
    aImageBG->AutoSize = true;
    aImageBG->Picture->LoadFromFile(L"R:\\TestBG.jpg");    // JPEG
    aImage1->AutoSize = true;
    aImage1->Picture->LoadFromFile(L"R:\\Test1.bmp");    // BMP
    aImage2->AutoSize = true;
    aImage2->Picture->LoadFromFile(L"R:\\Test2.png");    // PNG

    // 合成画像のサイズを背景画像に合わせる
    aImageMerge->Width = aImageBG->Width;
    aImageMerge->Height = aImageBG->Height;

    // 合成
    aImageMerge->Canvas->Draw(0, 0, aImageBG->Picture->Graphic);
    aImageMerge->Canvas->Draw(100, 200, aImage1->Picture->Graphic);
    aImageMerge->Canvas->Draw(300, 200, aImage2->Picture->Graphic);

    // PNG 保存
    aPng->Assign(aImageMerge->Picture->Graphic);
    aPng->SaveToFile(L"R:\\Result.png");
}

結果は右の画像のようになる。

シンプルなコードだが、透過もきちんと自動処理されている。

ポイントは、TImage を使うこと（ここでは動的生成しているが、もちろんフォームに貼り付けても良い）。TImage のローダーは、画像形式に関わらず読み込める。TBitmap を使うと PNG を読み込めなかった。

古いバージョンの C++Builder/Delphi だと、PNG の読み込みには TPngImage で画像の読み込みを行わなければならなかったようだが、現在は、TImage を使えば良い。

逆に、書き込みは、明示的に TPngImage を使っている。

aImageBG->Picture->SaveToFile(L"R:\\Result.png");

のように拡張子で自動的に PNG に変換してくれるかなーと期待したが、そんなことは無かった。

目次

• グループを作ろう！
• 自分の解答：STEP 1 グループ番号割り振り
• 自分の解答：STEP 2 結合
• 注意点
• ソースコードの抜粋
• 模範解答
• 感想

現役のエンジニア・企業がプログラミングの問題を出してくれる CodeIQ というサイトがある。問題を解くと、正解不正解の判定や、フィードバックなどを行ってくれる。ジャンルや言語などはさまざまある。

グループを作ろう！

今回は結城浩さんの「グループを作ろう！」という問題に挑戦してみた。アルゴリズムの問題で、プログラムを使って解いても使わずに解いても構わない。プログラムを使う場合、言語は何でも良い。解答（とコメントなど）を送ると、フィードバックをもらえる。

問題の概要は以下。

Bill=Billy
Mick=Michael
Billy=William
というように、同じ人物を表すニックネームのペアが 444 個与えられる。同じ名前をすべて連結し、
Bill=Billy=Will=William=Willie=Willy
Michael=Mick=Micky=Mike=Mikey
というようにグルーピングする。ただし、各行の順番および、同一行内の名前は ASCII 順に並べなければならない。

自分の解答：STEP 1 グループ番号割り振り

C++ でプログラムを組む前提で。

どうやってグループを寄せ集めていくかと考えたとき、グループ毎の配列（vector）を用意してしまう、というのは最初に思いつくが、さすがに効率が悪い（名前を読み込む度に、すべてのグループ配列を見て、すでにグループ化されているか調べる必要がある）。

漠然と、木を使えばできるのではないかとイメージしたが、残念ながら、木を簡単に実装する方法を思いつかなかった。

そこで代わりに、グループ番号を割り当てていく方法を採った（右はイメージ図）。

ペアの両辺を読み込み、それぞれの名前に既にグループ番号が割り当てられているか調べる。両辺とも未割り当てであれば、新しいグループ番号を割り振る。いずれかが割り当て済みであれば、もう片方に同じグループ番号を割り当てる。

両方とも割り当て済みで、かつ、違うグループ番号であれば、今までは別のグループとして扱ってきたが、実は同じグループであることが分かったということなので、片方のグループ番号をすべて書き換える。

名前→グループ番号の対応を格納するのは、STL の map を用いた。

自分の解答：STEP 2 結合

すべてグループ分けできたら、同じグループ同士を連結していく。string 型の vector を用意しておき、1 行に 1 グループを突っ込んでいく。

map を先頭から読み込んでいき、同じグループ番号の文字列が既に vector にあるか調べる。あれば、文字列の末尾に新しい名前を追加する。無ければ、新しい行の先頭に名前を追加する。

グループ番号と行番号の対応も、やはり map で覚えておく（……が、今から思えば、配列の方が高速だった）。

map を使うことにより。キーが自動的に ASCII 順になっているので、新しい行ができた時は、単純に配列の末尾に加えれば良く、ソートの必要は無い。また、1 つの行に名前を追加する際も、末尾に追加するだけで良く、ソートの必要は無い。

注意点

注意すべきはグループの統合で、最初はこれを見逃していた。できあがった解答を眺めていて偶然気づいた。グループ統合のコードを後から付け加えたので、これだけ異質な感じがする。

計算量は、入力のペア数を N として、グループ統合がなければ恐らく O(NlogN) だが、グループ統合があると最悪 O(N^2) になるのだろう。

ソースコードの抜粋

// グループ番号割り当て
while ( aInFile && getline(aInFile, aLine) ) {
    get_names(aLine, &aName1, &aName2);

    // 名前のペアをマップに登録していく
    p1 = aGroupMap.find(aName1);
    p2 = aGroupMap.find(aName2);
    if ( p1 == aGroupMap.end() && p2 == aGroupMap.end() ) {
        // 新規登録
        aGroupMap[aName1] = aGroupIndex;
        aGroupMap[aName2] = aGroupIndex;
        aGroupIndex++;
    } else if ( p1 != aGroupMap.end() && p2 == aGroupMap.end() ) {
        // aName1 が登録済み→aName2 を同じグループに登録
        aGroupMap[aName2] = p1->second;
    } else if ( p1 == aGroupMap.end() && p2 != aGroupMap.end() ) {
        // aName2 が登録済み→aName1 を同じグループに登録
        aGroupMap[aName1] = p2->second;
    } else {
        // 両方登録済み
        if ( p1->second != p2->second ) {
            // 違うグループとして登録されているのでグループを統合
            change_group(&aGroupMap, p1->second, p2->second);
        }
    }
}

// A=B=C=D というような結合行を作成していく
while ( aGItr != aGroupMap.end() ) {
    aRItr = aResultMap.find(aGItr->second);
    if ( aRItr == aResultMap.end() ) {
        // 新規に結果行に登録
        aResult[aResultIndex] = aGItr->first;
        aResultMap[aGItr->second] = aResultIndex;
        aResultIndex++;
    } else {
        // 既存の行に追加
        aResult[aRItr->second] += "="+aGItr->first;
    }
    aGItr++;
}

模範解答

模範解答では、やはりグルーピングに木を使っていた。

面白かったのは木の実装方法。木を map で実装していた（模範解答は perl と思われる言語で実装されていたので、実際には連想配列）。

map のキーに、葉っぱの名前を入れ、値に、根っこの名前を入れる。根っこの名前は、値を空文字列にでもしておく。

こうすることで、数回 map を探索すれば、一番根っこの名前にたどりつける。1 つの根っこから出てくる名前はみな同じグループで、グループの数だけ、根っこ（空文字列）があることになる。

木をこうやって実装するのは定石なのだろうか。シンプルでいいな。

木の良い点は、グループの結合が楽ちんなこと。2 つのグループの根っこのうち、片方の空文字列をやめて、もう片方の根っこの名前を入れるだけで良い。どんなにグループが巨大でも、1 つの書き換えで済む。

感想

単にグルーピングするだけというシンプルな問題なのに、やってみるといろいろ考えることがあって面白かった。Union Find アルゴリズムとか Union Find Tree データ構造などという問題らしい。

実装言語を問わないこともあり、いろんな解答があったと聞く。なかにはエクセルで解いた人もいるとか。

他の人がどんな解答をしているのか気になっているのだが、残念ながら、ググっても自分の解答を公開している人はほとんどいないようだ。

結城さんがせっかく公開 OK に設定してくれているのだから、自分の解答を公開する人が増えてくれればいいなと思う。

C++Builder は、ファイルの読み込みがとても簡単で、TStringList::LoadFromFile() により、文字コードを適切に処理して読み込んでくれる。

LoadFromFile() は見ただけで使い方が分かる。しかし、その親戚である、メモリからの読み込みを行う LoadFromStream() については、まとまった説明が見当たらなかったので試行錯誤。

で、以下が結果のコード。メモリに格納されている文字列を、文字コードを指定して TStringList に読み込む。

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    const char                  UTF8_STR[] = { 0xE6, 0x98, 0xA5 };
    unique_ptr<TMemoryStream>   aMemStream(new TMemoryStream());
    unique_ptr<TStringList>     aStrList(new TStringList());

    aMemStream->Write(UTF8_STR, 3);
    aMemStream->Seek(static_cast<long>(0), soBeginning);
    aStrList->LoadFromStream(aMemStream.get(), TEncoding::UTF8);
    ShowMessage(aStrList->Text);
}

UTF8_STR が文字列が格納されているメモリ領域。今回は定数にしてあるが、通常は、どこかから持ってきた内容を格納しているバッファになる。

TStringList::LoadFromStream() は、TStream 型（の派生クラス）からしかデータを読み出せない。メモリ領域をそのまま読むことはできないので、仲介役の TMemoryStream が必要になる。

TMemoryStream にメモリ領域の内容を書き込んでいるのが aMemStream->Write(UTF8_STR, 3); TMemoryStream にメモリ領域の内容を読み込むというイメージだったので、最初 Read() を使いそうになってしまったが、Write() なので注意。

Write() 後に、読み書き位置を先頭に戻しておく。

あとは、LoadFromStream() に TMemoryStream へのポインタを渡せば、文字列が読み込まれる。

文字コードの指定は、

• UTF-8……TEncoding::UTF8
• UNICODE（UTF-16）……TEncoding::Unicode
• 指定無し……自動判別

など。TEncoding についてはここが詳しい。

以上、コードを実行すると、メモリ領域から 3 バイトを読み取って、「春」を取得できる。

Delphi（および C++Builder の旧バージョン）で手軽に RS-232C（COM ポート）を使うためのコンポーネントに ComPort Library（TComPort）がある。C++Builder XE でも何とか動作したので、やり方を整理しておく。

【実行時パッケージの作成】

• すべてのプロジェクトを閉じた状態で、［ファイル→プロジェクトを開く］メニューにて、ComPort Library の Source フォルダにある CPortLibCB6.bpk（C++Builder 6 用）を開く。
• 自動的にプロジェクトが C++Builder XE 用に変換される。
• ビルド構成を Release にする（右側のプロジェクトマネージャーペインで選択）。
• メイクすると、CPortLibCB6.bpl ができあがる。
  

【設計時パッケージの作成】

• ［ファイル→プロジェクトを開く］メニューにて、DsgnCPortCB6.bpk を開く。
• 実行時パッケージと同様にメイクし、DsgnCPortCB6.bpl を得る。
  

【パッケージのインストール】

• CPortLibCB6.bpl を Windows のシステムライブラリフォルダ（Windows 7 64bit なら C:\Windows\SysWOW64）にコピーする。
• ［コンポーネント→パッケージのインストール］メニューにて、追加ボタンをクリックして DsgnCPortCB6.bpl を追加する。デフォルトにチェックを入れると毎回設定しなくて良いだろう。

【ComPort Library を利用するアプリケーションのメイク】

• ツールパレットペインに「CPortLib」タブが増えていて、その中の TComPort をフォームに貼り付ければ RS-232C にアクセスできるようになる。
• ［プロジェクト→オプション］メニューで、ディレクトリと条件定義→ライブラリパスに、CPortLibCB6.bpl/DsgnCPortCB6.bpl のパスを追加する。
• ［プロジェクト→オプション］メニューで、ディレクトリと条件定義→条件定義に DONT_USE_WINSPOOL_SETPORTA を追加する。
• winspool.h（include\windows\sdk 等にある）を開き、SetPortA/SetPortW を宣言している箇所を、#ifndef DONT_USE_WINSPOOL_SETPORTA～#endif で挟む
• CPort.hpp をインクルードする。
• CPort.hpp を開き、inline じゃない方の EComPort() の宣言 2 つをコメントアウトする。

以上でビルドができる。

≪参考≫

• http://wiltonsoftware.com/posts/view/borland-cport-multiple-declaration-and-unresolved-linker-setporta-function

ウィンドウの透明化・半透明化あれこれ。

元々は右のような普通の（不透明な）ウィンドウの透過度を、いくつかの方法で変化させてみる。

動作は Windows 7 (64bit) / C++Builder XE で行っているが、別の環境では別の動作になるかも。

* クライアント領域のみ透明化

クライアント領域のみを透明化させるには、フォームの TransparentColor/TransparentColorValue プロパティを使う。

void	TFormTest01::Test01()
{
	TransparentColor = true;
	TransparentColorValue = TColor(0x000001);
	Canvas->Brush->Color = TColor(0x000001);
	Canvas->FillRect(TRect(0, 0, 300, 300));
	Panel2->Color = TColor(0x000001);
}

TransparentColor プロパティを true にすることで透過モードとなり、フォーム上の TransparentColorValue プロパティで指定した色（コンポーネント同士の重なりに関係なく、指定した色で塗られている部分はすべて）が完全透過となる。半透明にすることはできない。

Windows API で言えば、SetLayeredWindowAttributes() を LWA_COLORKEY でコールした状態だと思われる。ただし、Windows API の場合、透過部分ではマウスイベント等を受け取れない（透明と言うよりはウィンドウに穴が空いて、背後のデスクトップ等にイベントが行く）ようだが、C++Builder の場合はイベントを受け取れる。

* ウィンドウ全体を半透明化

ウィンドウ全体を半透明にするには、フォームの AlphaBlend/AlphaBlendValue プロパティを使う。

void	TFormTest01::Test02()
{
	AlphaBlend = true;
	AlphaBlendValue = 128;
}

AlphaBlendValue = 0 で完全透明、AlphaBlendValue = 255 で完全不透明、その中間で半透明となる。

コンポーネントも含め、ウィンドウ内がすべて一律で透明になる。

Windows API で言えば、SetLayeredWindowAttributes() を LWA_ALPHA でコールした状態だと思われる。

* グラスフレーム（ガラス効果）の拡張

Windows Vista から導入された Aero において、グラスフレーム（タイトルバーのもやもやした半透明）をクライアント領域にまで広げるには、GlassFrame プロパティを使う。

void	TFormTest01::Test07()
{
	GlassFrame->Enabled = true;
	GlassFrame->SheetOfGlass = true;
}

GlassFrame->Enabled を true にするとグラスフレーム拡張モードとなり、GlassFrame->SheetOfGlass も true にすることで、クライアント領域全体でガラス効果を得られる。GlassFrame->SheetOfGlass を false にして、GlassFrame->Bottom などのプロパティで任意の範囲でガラス効果を得るようにすることもできる。

Windows API で言えば、Desktop Window Manager の DwmExtendFrameIntoClientArea() をコールした状態と思われる。