雪降る中、キャラを歩かせるシーンは既にプログラム的には完成している。
＋
『コケさせて』 → 完成しているプログラムに手を加える事になる。
＋
『コケさせる』 という事自体に大した意味が認められない。
↓
メリット・デメリットを考えると却下だ。そんな無駄な事でプログラム変更するなんてアホ。

• Introduction　『用語』
  
  • 「閑話」
    

    「今回は無駄話でもしてみます」 というフリに対して
    「閑話以外を扱ったことがあるのか？」 と返されると応えに窮するもの。

  • 「ダイレクトメール」
    

    個人情報が記載された郵送物を受取人の承諾無く送りつける嫌がらせ行為。
    発見次第廃棄すべき害物。だが、個人情報が記されているため手軽に廃棄し辛く、廃棄が後回しになる。
    そして、大掃除の時等にヒィヒィ言いながら比良すら破り捨てる作業のために時間を浪費してしまうもの。

  • 「日本ユニセフ」
    

    国際連合児童基金（ユニセフ）の日本支部…
    では無いのだが、日本ユニセフへ集められた寄付金から 25 億円を投じて建てたビルを都内一等地に有し、ユニセフの日本における窓口として活動している財団法人。

• Chapter 1　『寄付依頼』
  

  1月程前、日本ユニセフから寄付を嘆願するダイレクトメールが届く。
  俺の寄付によって貧困に喘ぐ子供達を助ける事ができるらしい。
  …だが、余剰金は親類の会社運転資金と相殺されていく運命にある俺にはそんな余裕は無い。
  忸怩たる思いではあるが、期待に応える事は困難だ…

• Chapter 2　『個人情報』
  

  ダイレクトメールから個人情報が記載部分を破棄する作業に取り掛かる。
  
  
  
  個人情報の雨嵐に見舞われる。
  破り捨てるのを諦め、焼き尽そうとも考る。
  だが、室内でそんな行動に及んでスプリンクラー大ハッスルなんて状況になったら笑えない。
  もちろんシュレッダーなんて無いので、ヒィヒィ言いながらも手作業で破り捨てる事態となる。

• Chapter 3　『住所』
  

  俺は、一見さん、若しくは信用が無い相手に住所を提示する場合、簡略化した記載をする。
  具体例を挙げると
  「○丁目◇番地□□□ △△マンション ▽▽▽号」
  と記載すべきトコを
  「○-◇-□□□-▽▽▽」
  という感じにである。何となく気分でこうしている。
  ※ この記載でも正確に宅配物を届けてくれる運送関係者方には謝辞御礼

• Chapter 4　『宛て名』
  

  日本ユニセフから届いたダイレクトメールの宛先
  
  「○-◇-□□□-▽▽▽」となっている。
  何処かの低脳が流出させた個人情報を名簿業者から購入したのだろう。

• Chapter 5　『信用』
  

  ＞日本ユニセフ様
  現在はダイレクトメールによって効果が上がっているとの事だが、他の方法は無いものか？

  • 業者から個人情報を買い取るために、寄付金から運用されるお金
  • ダイレクトメールを作成・送信するために、寄付金から運用されるお金
  • ダイレクトメールという手法が生み出す”ユニセフ”への悪印象

  自ら（というより親的存在であるUNICEF）の身（信用）を削って対価を得ているのでは？
  と危惧してしまう。

• Chapter 6　『結』
  

  個人情報が載ったダイレクトメールは止めて！破棄するのがメンドイの…

#include <fstream>
#include <iterator>
#include <vector>
using namespace std;
#include <cassert>

#include <windows.h>
#pragma comment(lib, "winmm.lib") // for timeGetTime()
#include "apng.h"
#pragma comment(lib, "apng.lib")

static void dib_blt(const BITMAPINFOHEADER* dst_h, unsigned char* dst_bits, int dst_x, int dst_y, int width, int height, const BITMAPINFOHEADER* src_h, const unsigned char* src_bits, int src_x, int src_y, bool blend);
static void alphablend(HDC dst, int x, int y, int width, int height, HDC src, int src_x, int src_y, bool blend);

static void dib_fill(const BITMAPINFOHEADER* dst_h, unsigned char* dst_bits, unsigned int dst_x, unsigned int dst_y, unsigned int width, unsigned int height, COLORREF color) {
    assert(dst_h->biBitCount == 24 || dst_h->biBitCount == 32);
    assert(dst_h->biHeight >= 0);
    assert(dst_x + width <= dst_h->biWidth && dst_y + height <= dst_h->biHeight);
    // 4 byte 境界を考慮して 1 ライン辺りの byte 数を求める
    const int rowbytes = ((dst_h->biBitCount * dst_h->biWidth + 31) >> 5) << 2;
    // byte per pixel を求める
    const int pixelbytes = dst_h->biBitCount >> 3;
    // (dst_x, dst_y + height - 1) 位置へ移動
    dst_bits += rowbytes * (dst_h->biHeight - (dst_y + height)) + pixelbytes * dst_x;
    // 1st ラインを指定色で fill
    const unsigned char bgra[4] = { GetBValue(color), GetGValue(color), GetRValue(color), unsigned char((color >> 24) & 0xff) };
    for (unsigned int x=0; x < width; ++x) {
        memcpy(&dst_bits[pixelbytes * x], bgra, pixelbytes);
    }
    // 1st ラインのデータを 2nd ライン以降にコピー
    const int copybytes = pixelbytes * width;
    for (unsigned int y=1; y < height; ++y) {
        memcpy(&dst_bits[rowbytes * y], dst_bits, copybytes);
    }
}

int wmain(int argc, wchar_t* argv[]) {
    if (argc != 2) {
        return 0;
    }
    // APNG をメモリ上に load
    ifstream fs(argv[1], ios_base::in | ios_base::binary);
    vector<char> apng((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());
    fs.close();
    
    // APNG のヘッダ情報取得
    apng_HEADER h;
    apng_get_header(&apng[0], apng.size(), &h);
    const bool alpha = ((h.color_type_ & apng_COLOR_MASK_ALPHA) || (h.valid_flags_ & apng_VALID_tRNS));
    
    // APNG仕様書 で云う "output buffer" 確保
    BITMAPINFOHEADER output_h = { 0 };
    output_h.biSize      = sizeof(output_h);
    output_h.biWidth     = h.width_;
    output_h.biHeight    = h.height_;
    output_h.biPlanes    = 1;
    output_h.biBitCount  = (alpha ? 32 : 24);
    output_h.biSizeImage = (((output_h.biBitCount * output_h.biWidth + 31) >> 5) << 2) * output_h.biHeight;
    unsigned char* output_bits;
    HBITMAP output = ::CreateDIBSection(NULL, reinterpret_cast<BITMAPINFO*>(&output_h), DIB_RGB_COLORS, reinterpret_cast<void**>(&output_bits), NULL, 0);

    HDC pdc = ::GetDC(NULL);
    HDC dc  = ::CreateCompatibleDC(pdc);
    HGDIOBJ oldbmp = ::SelectObject(dc, output);

    enum {
        APNG_DISPOSE_OP_NONE = 0,
        APNG_DISPOSE_OP_BACKGROUND,
        APNG_DISPOSE_OP_PREVIOUS,
        APNG_BLEND_OP_SOURCE = 0,
        APNG_BLEND_OP_OVER
    };
    // APNG仕様書 で云う "Fully transparent black" 定義
    const COLORREF fully_transparent_black = 0x00000000;

    //  output_buffer をクリア
    dib_fill(&output_h, output_bits, 0, 0, output_h.biWidth, output_h.biHeight, fully_transparent_black);

    std::vector<unsigned char> dib;
    std::vector<unsigned char> backup(output_h.biSizeImage);

    unsigned int cur_time = ::timeGetTime();
    for (unsigned int i=0; i < h.num_frames_; ++i) {
        dib.resize(apng_get_frame(&apng[0], apng.size(), i, NULL, 0, NULL));
        apng_FRAME f;
        apng_get_frame(&apng[0], apng.size(), i, &dib[0], dib.size(), &f);

        if (f.dispose_op_ == APNG_DISPOSE_OP_PREVIOUS) {
            memcpy(&backup[0], output_bits, output_h.biSizeImage);
        }

        BITMAPINFOHEADER* frame_h = reinterpret_cast<BITMAPINFOHEADER*>(&dib[0]);
        dib_blt(&output_h, output_bits, f.x_offset_, f.y_offset_, f.width_, f.height_, frame_h, &dib[0] + frame_h->biSize, 0, 0, (alpha && f.blend_op_ == APNG_BLEND_OP_OVER && i > 0));

        ::InvalidateRect(NULL, NULL, TRUE);

        alphablend(pdc, 100, 100, h.width_, h.height_, dc, 0, 0, alpha);

        switch (f.dispose_op_) {
            case APNG_DISPOSE_OP_BACKGROUND:
                // 今回フレーム合成した領域を”完全透過な黒”で塗潰し
                dib_fill(&output_h, output_bits, f.x_offset_, f.y_offset_, f.width_, f.height_, fully_transparent_black);
                break;
            case APNG_DISPOSE_OP_PREVIOUS:
                // 描画前の状態に戻す
                memcpy(output_bits, &backup[0], output_h.biSizeImage);
                break;
        }
        
        const int adjust = ::timeGetTime() - time;
        ::Sleep(::MulDiv(f.delay_num_, 1000, (f.delay_den_ == 0 ? 100 : f.delay_den_)) - adjust);
        time = ::timeGetTime();
    }
    ::SelectObject(dc, oldbmp);
    ::DeleteDC(dc);
    ::ReleaseDC(NULL, pdc);
    ::DeleteObject(output);
    return 0;
}

static void dib_blt(...);
static void alphablend(...);

static void dib_fill(const BITMAPINFOHEADER* dst_h, unsigned char* dst_bits,
    unsigned int dst_x, unsigned int dst_y, unsigned int width, unsigned int height, COLORREF color
) {
    ：
}

unsigned char* output_bits;
HBITMAP output = ::CreateDIBSection(NULL, reinterpret_cast<BITMAPINFO*>(&output_h), DIB_RGB_COLORS,
                     reinterpret_cast<void**>(&output_bits), NULL, 0);

dib.resize(apng_get_frame(&apng[0], apng.size(), i, NULL, 0, NULL));
apng_FRAME f;
apng_get_frame(&apng[0], apng.size(), i, &dib[0], dib.size(), &f);

if (f.dispose_op_ == APNG_DISPOSE_OP_PREVIOUS) {
    memcpy(&backup[0], output_bits, output_h.biSizeImage);
}

BITMAPINFOHEADER* frame_h = reinterpret_cast<BITMAPINFOHEADER*>(&dib[0]);
dib_blt(&output_h, output_bits, f.x_offset_, f.y_offset_, f.width_, f.height_,
    frame_h, &dib[0] + frame_h->biSize, 0, 0, (f.blend_op_ == APNG_BLEND_OP_OVER && i > 0 && alpha));

output_buf = RGBA(0, 0, 0, 0);
1st_frame  = RGBA(128, 128, 128, 128);
// APNG_BLEND_OP_SOURCE（そのまま上書き）
output_buf + 1st_frame = RGBA(128, 128, 128, 128);
// APNG_BLEND_OP_OVER（アルファ値反映）
output_buf + 1st_frame = RGBA(64, 64, 64, 64);

::InvalidateRect(NULL, NULL, TRUE);

alphablend(pdc, 100, 100, h.width_, h.height_, dc, 0, 0, alpha);

switch (f.dispose_op_) {
    case APNG_DISPOSE_OP_BACKGROUND:
        // 今回フレーム合成した領域を”完全透過な黒”で塗潰し
        dib_fill(&output_h, output_bits, f.x_offset_, f.y_offset_, f.width_, f.height_, fully_transparent_black);
        break;
    case APNG_DISPOSE_OP_PREVIOUS:
        // 描画前の状態に戻す
        memcpy(output_bits, &backup[0], output_h.biSizeImage);
        break;
}

const int adjust = ::timeGetTime() - time;
::Sleep(::MulDiv(f.delay_num_, 1000, (f.delay_den_ == 0 ? 100 : f.delay_den_)) - adjust);
time = ::timeGetTime();

output = alpha * foreground + (1-alpha) * background

alpha        = foreground.alpha / 255;
output.red   = alpha * foreground.red + (1.0 - alpha) * background.red;
output.green = alpha * foreground.green + (1.0 - alpha) * background.green;
output.blue  = alpha * foreground.blue + (1.0 - alpha) * background.blue;

Dst.Red   = Src.Red   + (1 - Src.Alpha) * Dst.Red
Dst.Green = Src.Green + (1 - Src.Alpha) * Dst.Green
Dst.Blue  = Src.Blue  + (1 - Src.Alpha) * Dst.Blue

output = alpha * foreground + (1 - alpha) * background

static void dib_blt(
    const BITMAPINFOHEADER* dst_h, unsigned char* dst_bits, int dst_x, int dst_y, int width, int height,
    const BITMAPINFOHEADER* src_h, const unsigned char* src_bits, int src_x, int src_y, bool blend
) {
    assert(dst_h->biBitCount == 24 || dst_h->biBitCount == 32);
    assert(src_h->biBitCount == 24 || src_h->biBitCount == 32);
    assert(dst_h->biHeight >= 0 && src_h->biHeight >= 0);
    // 転送幅が src より大きい場合修正
    width = min(width, src_h->biWidth);
    height = min(height, src_h->biHeight);
    // 転送先座標が-値の場合修正
    if (dst_x < 0) {
        width += dst_x;
        src_x += -dst_x;
        dst_x = 0;
    }
    if (dst_y < 0) {
        height += dst_y;
        src_y += -dst_y;
        dst_y = 0;
    }
    // 転送先が dst よりはみ出る場合修正
    width = min(width, dst_h->biWidth - dst_x);
    height = min(height, dst_h->biHeight - dst_y);
    // dst に影響が無い場合は抜ける
    if (width <= 0 || height <= 0 || dst_x >= dst_h->biWidth || dst_y >= dst_h->biHeight || src_x >= src_h->biWidth || src_y >= src_h->biHeight) {
        return;
    }
    // 4 byte 境界を考慮して 1 ライン辺りの byte 数を求める
    const int dst_rowbytes = ((dst_h->biBitCount * dst_h->biWidth + 31) >> 5) << 2;
    const int src_rowbytes = ((src_h->biBitCount * src_h->biWidth + 31) >> 5) << 2;
    // byte per pixel を求める
    const int dst_pixelbytes = dst_h->biBitCount >> 3;
    const int src_pixelbytes = src_h->biBitCount >> 3;
    // (dst_x, dst_y) 位置へ移動
    dst_bits += dst_rowbytes * (dst_h->biHeight - 1 - dst_y) + dst_pixelbytes * dst_x;
    // (src_x, src_y) 位置へ移動
    src_bits += src_rowbytes * (src_h->biHeight - 1 - src_y) + src_pixelbytes * src_x;
    // blt
    for (int y=0; y < height; ++y) {
        for (int x=0; x < width; ++x) {
            unsigned char*       dst = &dst_bits[dst_pixelbytes * x];
            const unsigned char* src = &src_bits[src_pixelbytes * x];
            if (blend && src_pixelbytes == 4) {
                // src にアルファチャンネルが存在
                const int B=0, G=1, R=2, A=3;
                dst[B] = dst[B] + (src[B] - dst[B]) * src[A] / 255;
                dst[G] = dst[G] + (src[G] - dst[G]) * src[A] / 255;
                dst[R] = dst[R] + (src[R] - dst[R]) * src[A] / 255;
                if (dst_pixelbytes == 4) {
                    // dst にアルファチャンネルが存在
                    dst[A] = dst[A] + (src[A] - dst[A]) * src[A] / 255;
                }
            }
            else {
                // そのまま上書き
                memcpy(dst, src, min(dst_pixelbytes, src_pixelbytes));
            }
        }
        // (dst_x, dst_y + (y + 1)) 位置へ移動
        dst_bits -= dst_rowbytes;
        // (src_x, src_y + (y + 1)) 位置へ移動
        src_bits -= src_rowbytes;
    }
}

static void alphablend(HDC dst, int x, int y, int width, int height, HDC src, int src_x, int src_y, bool blend) {
    if (blend) {
        DIBSECTION ds;
        if (::GetObject(::GetCurrentObject(src, OBJ_BITMAP), sizeof(ds), &ds) > 0 && ds.dsBm.bmBitsPixel == 32) {
            // src が DIBSECTION で alpha-channel が存在
            BITMAPINFOHEADER mem_h = { 0 };
            mem_h.biSize     = sizeof(mem_h);
            mem_h.biWidth    = width;
            mem_h.biHeight   = height;
            mem_h.biPlanes   = 1;
            mem_h.biBitCount = 32;
            unsigned char* mem_bits;
            // screen dc から直接 DIB を取得する方法を俺は知らない（dst==screen dc だった場合）のでメモリbitmapを介す
            HBITMAP bmp = ::CreateDIBSection(NULL, reinterpret_cast<BITMAPINFO*>(&mem_h), DIB_RGB_COLORS, reinterpret_cast<void**>(&mem_bits), NULL, 0);
            HDC     mem    = ::CreateCompatibleDC(dst);
            HGDIOBJ oldbmp = ::SelectObject(mem, bmp);
            // dst の対象領域内のデータを mem にコピー
            ::BitBlt(mem, 0, 0, width, height, dst, x, y, SRCCOPY);
            // mem に src を alphablending
            dib_blt(&mem_h, mem_bits, 0, 0, width, height, &ds.dsBmih, static_cast<unsigned char*>(ds.dsBm.bmBits), src_x, src_y, true);
            // mem を dst にコピー
            ::BitBlt(dst, x, y, width, height, mem, 0, 0, SRCCOPY);
            // lalala 後始末〜
            ::SelectObject(mem, oldbmp);
            ::DeleteDC(mem);
            ::DeleteObject(bmp);
            return;
        }
    }
    // alphablending せずそのままコピー
    ::BitBlt(dst, x, y, width, height, src, src_x, src_y, SRCCOPY);
}

int main() {
    :
//  BLENDFUNCTION bf;
//  bf.BlendOp             = AC_SRC_OVER;
//  bf.BlendFlags          = 0;
//  bf.SourceConstantAlpha = 0xff;
//  bf.AlphaFormat         = AC_SRC_ALPHA;
//  ::AlphaBlend(dst, x, y, width, height, src, 0, 0, width, height, bf);
    alphablend(dst, x, y, width, height, src, 0, 0, true);
    :
}

• 透過色・アルファチャンネルへの対応
• アニメーション

#include <vector>
#include <fstream>
#include <iterator>
using namespace std;
#include <cassert>

#include <windows.h>
#pragma comment(lib, "msimg32.lib") // for AlphaBlend()
#include "apng.h"
#pragma comment(lib, "apng.lib")

static void blend_to_screen(const void* dib, int x, int y) {
    const BITMAPINFOHEADER* bih = static_cast<const BITMAPINFOHEADER*>(dib);
    assert((bih->biBitCount == 24 || bih->biBitCount == 32) && bih->biCompression == BI_RGB);
    const SIZE size = { bih->biWidth, abs(bih->biHeight) };
    void* bits;
    HBITMAP bitmap = ::CreateDIBSection(NULL, static_cast<const BITMAPINFO*>(dib), DIB_RGB_COLORS, &bits, NULL, 0);
    if (bitmap != NULL) {
        memcpy(bits, static_cast<const unsigned char*>(dib) + bih->biSize, (((bih->biBitCount * size.cx + 31) >> 5) << 2) * size.cy);
        HDC pdc = ::GetDC(NULL);
        HDC dc  = ::CreateCompatibleDC(pdc);
        HGDIOBJ oldbmp = ::SelectObject(dc, bitmap);

        BLENDFUNCTION bf;
        bf.BlendOp             = AC_SRC_OVER;
        bf.BlendFlags          = 0;
        bf.SourceConstantAlpha = 0xff;
        bf.AlphaFormat         = (bih->biBitCount == 32 ? AC_SRC_ALPHA : 0);
        ::AlphaBlend(pdc, x, y, size.cx, size.cy, dc, 0, 0, size.cx, size.cy, bf);

        ::SelectObject(dc, oldbmp);
        ::DeleteDC(dc);
        ::ReleaseDC(NULL, pdc);
        ::DeleteObject(bitmap);
    }
}

int wmain(int argc, wchar_t* argv[]) {
    if (argc == 2) {
        ifstream fs(argv[1], ios_base::in | ios_base::binary);
        vector<char> apng((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());

        apng_HEADER h;
        apng_get_header(&apng[0], apng.size(), &h);

        std::vector<unsigned char> dib;
        if ((h.valid_flags_ & apng_HAVE_DEFIMG)) {
            dib.resize(apng_get_frame(&apng[0], apng.size(), 0xffffffff, NULL, 0, NULL));
            apng_get_frame(&apng[0], apng.size(), 0xffffffff, &dib[0], dib.size(), NULL);
            blend_to_screen(&dib[0], 0, 0);
            --h.num_frames_;
        }

        for (unsigned int i=0; i < h.num_frames_; ++i) {
            dib.resize(apng_get_frame(&apng[0], apng.size(), i, NULL, 0, NULL));
            apng_get_frame(&apng[0], apng.size(), i, &dib[0], dib.size(), NULL);
            blend_to_screen(&dib[0], 32 + 80 * (i & 0x07), 48 + 96 * (i / 8));
        }
    }
    return 0;
}

ifstream fs(argv[1], ios_base::in | ios_base::binary);
vector<char> apng((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());
apng_HEADER h;
apng_get_header(&apng[0], apng.size(), &h);

if ((h.valid_flags_ & apng_HAVE_DEFIMG)) {

dib.resize(apng_get_frame(&apng[0], apng.size(), 0xffffffff, NULL, 0, NULL));
apng_get_frame(&apng[0], apng.size(), 0xffffffff, &dib[0], dib.size(), NULL);

blend_to_screen(&dib[0], 0, 0);

for (unsigned int i=0; i < h.num_frames_; ++i) {
    dib.resize(apng_get_frame(&apng[0], apng.size(), i, NULL, 0, NULL));
    apng_get_frame(&apng[0], apng.size(), i, &dib[0], dib.size(), NULL);
    blend_to_screen(&dib[0], 32 + 80 * (i & 0x07), 48 + 96 * (i / 8));
}

HBITMAP bitmap = ::CreateDIBSection(NULL, static_cast<const BITMAPINFO*>(dib), DIB_RGB_COLORS, &bits, NULL, 0);
memcpy(bits, static_cast<const unsigned char*>(dib) + bih->biSize, (((bih->biBitCount * size.cx + 31) >> 5) << 2) * size.cy);

bf.SourceConstantAlpha = 0xff;
bf.AlphaFormat         = (bih->biBitCount == 32 ? AC_SRC_ALPHA : 0);
::AlphaBlend(pdc, x, y, size.cx, size.cy, dc, 0, 0, size.cx, size.cy, bf);

1. apng_file_create 関数でapngファイルハンドルを作成
2. apng_file_addframe 関数でフレームを登録
3. apng_closehandle 関数でapngファイルハンドルを開放して終了

#include <locale>
#include <iostream>
#include <iomanip>
#include <fstream>
#include <iterator>
#include <vector>
using namespace std;

#include <windows.h>
#include "apng.h"
#pragma comment(lib, "apng.lib")

static bool get_parameter(vector<wstring>& frames, wstring& output) {
    wcout << L"# Enter path of PNG file that is used for APNG's frame data." << endl;
          << L"001<";
    frames.clear();
    wstring path;
    while (getline(wcin, path) && !path.empty()) {
        frames.push_back(path);
        wcout << setw(3) << setfill(L'0') << frames.size() + 1 << L">";
    }
    output.clear();
    if (!frames.empty()) {
        wcout << endl << L"# Enter path of output APNG file." << endl << L">";
        getline(wcin, output);
    }
    return !output.empty();
}

int wmain() {
    wcout.imbue(locale(locale("japanese"), "C", locale::numeric));
    vector<wstring> frames;
    wstring output;
    if (get_parameter(frames, output)) {
        vector<wstring>::iterator it = frames.begin();

        ifstream fs(it->c_str(), ios_base::in | ios_base::binary);
        vector<char> png((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());
        fs.close();
        
        vector<char> dib(apng_get_frame(&png[0], png.size(), 0xffffffff, NULL, 0, NULL));
        apng_get_frame(&png[0], png.size(), 0xffffffff, &dib[0], dib.size(), NULL);

        const int wigth = reinterpret_cast<BITMAPINFOHEADER*>(&dib[0])->biWidth;
        const int height = reinterpret_cast<BITMAPINFOHEADER*>(&dib[0])->biHeight;
        void* file = apng_file_create(output.c_str(), frames.size(), 0, wigth, height, apng_RGB_24, NULL, 0, apng_VALID_ALPHA | apng_VALID_HICOMPRESS, NULL, NULL, NULL, 0);
        if (file != NULL) {
            apng_file_addframe(file, &dib[0], 0, 0, 500, 1000, 1, 0);
            for (++it; it != frames.end(); ++it) {
                fs.clear();
                png.erase(png.begin(), png.end());
                fs.open(it-<c_str(), ios_base::in | ios_base::binary);
                copy((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>(), back_inserter(png));
                fs.close();
                dib.resize(apng_get_frame(&png[0], png.size(), 0xffffffff, NULL, 0, NULL));
                apng_get_frame(&png[0], png.size(), 0xffffffff, &dib[0], dib.size(), NULL);
                apng_file_addframe(file, &dib[0], 0, 0, 500, 1000, 1, 0);
            }
            apng_closehandle(file);
        }
    }
    return 0;
}

if (get_parameter(frames, output)) {

vector<wstring>::iterator it = frames.begin();
ifstream fs(it->c_str(), ios_base::in | ios_base::binary);
vector<char> png((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());

vector<char> dib(apng_get_frame(&png[0], png.size(), 0xffffffff, NULL, 0, NULL));
apng_get_frame(&png[0], png.size(), 0xffffffff, &dib[0], dib.size(), NULL);

void* file = apng_file_create(output.c_str(), frames.size(), 0,
    wigth, height, apng_RGB_24, NULL, 0, apng_VALID_ALPHA | apng_VALID_HICOMPRESS,
    NULL, NULL, NULL, 0);

apng_file_addframe(file, &dib[0], 0, 0, 500, 1000, 1, 0);

for (++it; it != frames.end(); ++it) {
    :
}

apng_closehandle(file);

#include <locale>
#include <iostream>
#include <iomanip>
#include <vector>
#include <fstream>
#include <iterator>
using namespace std;

#include <windows.h>
#include "apng.h"
#pragma comment(lib, "apng.lib")

int wmain(int argc, wchar_t* argv[]) {
    if (argc == 2) {
        wcout.imbue(locale(locale("japanese"), "C", locale::numeric));
        wcout << argv[1] << endl;

        ifstream fs(argv[1], ios_base::in | ios_base::binary);
        vector<char> apng((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());

        apng_HEADER h;
        apng_get_header(&apng[0], apng.size(), &h);
        cout << "---- header ----" << endl;
        cout << "幅         :" << h.width_                   << endl
             << "高さ       :" << h.width_                   << endl
             << "bpp        :" << h.bit_depth_ * h.channels_ << endl
             << "再生回数   :" << h.num_plays_               << endl
             << "フレーム数 :" << h.num_frames_              << endl;
        if ((h.valid_flags_ & apng_HAVE_DEFIMG)) {
            cout << "※ デフォルトイメージを含んでいます。" << endl;
        }

        vector<apng_PALETTE> p(apng_get_palette(&apng[0], apng.size(), NULL, 0));
        if (!p.empty()) {
            apng_get_palette(&apng[0], apng.size(), &p[0], p.size());
            cout << "---- palette ----" << endl;
            for (size_t i=0; i < p.size(); ++i) {
                cout << setw(3) << setfill('0') << i + 1 << ' '
                     << "rgba("
                     << int(p[i].red_)   << ','
                     << int(p[i].green_) << ','
                     << int(p[i].blue_)  << ','
                     << int(p[i].alpha_)
                     << ")" << endl;
            }
        }

        vector<apng_FRAME> f(apng_get_framelist(&apng[0], apng.size(), NULL, 0));
        if (!f.empty()) {
            apng_get_framelist(&apng[0], apng.size(), &f[0], f.size());
            cout << "---- frames ----" << endl;
            for (size_t i=0; i < f.size(); ++i) {
                cout << setw(3) << setfill('0') << i + 1 << ' '
                     << f[i].x_offset_   << ',' << f[i].y_offset_  << ','
                     << f[i].width_      << ',' << f[i].height_    << ','
                     << f[i].delay_num_  << ',' << f[i].delay_den_ << ','
                     << int(f[i].dispose_op_) << ',' << int(f[i].blend_op_)
                     << endl;
            }
        }
    }
    return 0;
}

wcout.imbue(locale(locale("japanese"), "C", locale::numeric));

ifstream fs(argv[1], ios_base::in | ios_base::binary);
vector<char> apng((istreambuf_iterator<char>(fs)), istreambuf_iterator<char>());

apng_HEADER h;
apng_get_header(&apng[0], apng.size(), &h);

vector<apng_PALETTE> p(apng_get_palette(&apng[0], apng.size(), NULL, 0));
apng_get_palette(&apng[0], apng.size(), &p[0], p.size());

vector<apng_FRAME> f(apng_get_framelist(&apng[0], apng.size(), NULL, 0));
apng_get_framelist(&apng[0], apng.size(), &f[0], f.size());

int wmain(int argc, wchar_t* argv[]) {
    if (argc == 3 || argc == 4) {
        wcout.imbue(locale(locale("japanese"), "C", locale::numeric));
        wcout << L"input  : " << argv[1] << endl;
        wcout << L"outdir : " << argv[2] << endl;
        
        const wchar_t* const prefix = (argc == 4 ? argv[3] : L"");
        const int count = apng_split_frame(argv[1], argv[2], prefix);
        wcout << L"---- output files ----" << endl;
        for (int i=0; i < count; ++i) {
            wcout << prefix << setw(3) << setfill(L'0') << i + 1 << L".png" << endl;
        }
    }
    return 0;
}

const int count = apng_split_frame(argv[1], argv[2], prefix);

for (int i=0; i < count; ++i) {
    wcout << prefix << setw(3) << setfill(L'0') << i + 1 << L".png" << endl;
}

1. apng_view_ready 関数でapngビューハンドルを作成
2. apng_view_play 関数で再生開始
3. apng_closehandle 関数でapngビューハンドルを開放して終了

#include <windows.h>
#include "apng.h"
#pragma comment(lib, "apng.lib")

static int message_loop() {
    MSG message;
    while (GetMessage(&message, NULL, 0, 0) > 0) {
        TranslateMessage(&message);
        DispatchMessage(&message);
    }
    return message.wParam;
}

static int CALLBACK handler_proc(int code, void* parameter) {
    switch (code) {
        case apng_VIEW_DESTROY:
            PostQuitMessage(0);
            break;
    }
    return 0;
}

int wmain(int argc, wchar_t* argv[]) {
    if (argc == 2) {
        void* view = apng_view_ready(argv[1], NULL);
        if (view != NULL) {
            apng_view_handling_notification(view, handler_proc, NULL);
            apng_view_put_createparam(view, NULL, WS_OVERLAPPEDWINDOW, 0, CW_USEDEFAULT, CW_USEDEFAULT, -1, -1, NULL, GetSysColor(COLOR_WINDOW));
            apng_view_play(view);
            message_loop();
            apng_closehandle(view);
        }
    }
    return 0;
}

void* view = apng_view_ready(argv[1], NULL);

apng_view_handling_notification(view, handler_proc, NULL);

• APNG の再生が一巡した時（apng_VIEW_COMPLETE）
• apngレンダラウィンドウが閉じられようとした時（apng_VIEW_CLOSE）
• apngレンダラウィンドウが閉じられる時（apng_VIEW_DESTROY）

apng_view_put_createparam(view, NULL, WS_OVERLAPPEDWINDOW, 0, ...);

apng_view_play(view);

message_loop();

apng_closehandle(view);

using System;
using System.Runtime.InteropServices;

class sample {
    [DllImport("apng.dll", CharSet=CharSet.Unicode)]
    private extern static IntPtr apng_view_ready(string apng, IntPtr apng_view);
    [DllImport("apng.dll")]
    private extern static void apng_view_handling_notification(IntPtr apng_view, handling_notification_callback callback, IntPtr parameter);
    [DllImport("apng.dll")]
    private extern static int apng_view_play(IntPtr apng_view);
    [DllImport("apng.dll")]
    private extern static void apng_closehandle(IntPtr apng_handle);

    private delegate int handling_notification_callback(int code, IntPtr parameter);

    static void Main(string[] args) {
        if (args.Length == 1) {
            IntPtr view = apng_view_ready(args[0], IntPtr.Zero);
            if (view != IntPtr.Zero) {
                apng_view_handling_notification(view, new handling_notification_callback(handler_proc), IntPtr.Zero);
                apng_view_play(view);
                Windows.Forms.Application.Run();
                apng_closehandle(view);
            }
        }
    }
    private static int handler_proc(int code, IntPtr parameter) {
        switch (code) {
            case apng_VIEW_DESTROY:
                Windows.Forms.Application.ExitThread();
                break;
        }
        return 0;
    }
}

1. ツールを起動してみる
   おめでとう。
   
2. 「おめでとう」て何やねん…
   この果てしなく遠いAPNG坂を昇りはじめた君への餞の詞
   
3. 説明始めろや…
   じゃ、画面各部の説明を。画面イメージをどどん！
   
   
   • カラータイプ
     カラータイプでは色の管理方法と色の精度（色数）を指定します。
     前回記事の「色の扱い方」で書いた パレット、RGBカラー、Grayscale 云々っていう辺りの設定ですね。
     この３つの管理方法間の違い（特徴）についてさらっと解説しておきます。
     
     • パレット（index color - ?bpp）
       ○ データサイズ（ファイルサイズ）を抑えられます
       × 使える色数が少ないっす
       「画質になんか拘らない。256色使えれば十分だ！」という人向けの方法です。
     • RGBカラー（RGB color - ?bpp）
       ○ 画質最高。これだけの色数が使えれば画質劣化することなんかありえません
       × データサイズが大きくなるでしょうねぇ…
       「データサイズよりも画質優先」という人向けの方法です。
     • Grayscale（grayscale - ?bpp）
       ○ データサイズ抑えられまくり ＋ 画質最高！
       × グレイスケールイメージしか扱えません
       × 4bpp 以下の階調しか使用しない場合はα値を持つ事ができません（8bpp以上なら問題無し）
       名の通り、グレイスケール（白黒画像）に特化した管理方法です。
     
     
   • 透過設定
     GIF でお馴染みの一色完全透過や、PNG の売りであるαチャンネル情報の有効/無効を指定します。
     
     • 無し
       「いちからか？いちからせつめいしないとだめか？」
     • 透過色
       100%完全透過される色を一色指定します。
     • α値
       画像、若しくはパレットに設定されたα情報を使用して半透明処理を行います。
       
       PNG のα値についての解説もちょっと書いておこう
       
       • α値は 0（100%透過）〜 255 or 65535（0%透過＝100%不透過）で指定
       • カラータイプがRGBカラー、Grayscaleの画像はpixel単位でα値を持つ
       • カラータイプがパレットの画像は（パレットの）色単位でα値を持つ
       
       ※「透過色を有効にしつつαチャンネルも使っちゃうぜ！」なんて事はできません。共存不可です。
     
     
   • 再生回数
     「いちからか？いちからせつめい（ry」
     
     
   • 背景色
     透過、半透過された pixel と合成するために使用する背景の色を指定します。
     て事なんですが…実は APNG の再生過程に措いてはあまり意味はありません。
     何故なら、多くのケースでは『背景 == 背面にあるイメージ』であり、『背景 == 背景色で塗り潰した色』である事は皆無だからです。
     APNG の仕様でも「特に背景として使用するイメージが無いのなら背景色で塗り潰したイメージを背景として使えば良いよ」という扱いです。
     指定しても無視されるケースが多々だと思いますが指定したい人はヤっちゃってください。害は無いんで大丈夫。
     
     
   • ガンマ値
     APNG が自分のイメージ通り再現される環境下のスクリーンガンマ値を指定してください。
     俗に「Macなら 1.8。Windows では 2.2。」と云われるアレの事です。細かい事はググってください。
     
     
   • 標準画像
     通常、APNG に対応していないデコーダで APNG を表示した場合 1 フレーム目が静止画として表示されます。
     ですが、標準画像を指定時は 1 フレーム目の代わりに標準画像が静止画として表示されます。
     
     この画像なんか標準画像を上手く利用していますね。
     APNG 対応デコーダで表示した時は「Your browser does support Animated PNGs」と表示され、未対応デコーダの場合は「Your browser does not support Animated PNGs」と表示されます。
     ちなみに APNG 対応デコーダでアニメーション再生した場合、標準画像は無視して再生されます。
     
     
   • フレーム情報
     ここでアニメーションのコマに関する情報を指定していきます。
     
     • no、x、y、width、height
       「いちからか？いち（ry」
       …で済まそうと思ったのだけど書いて置かなければならない事があった。
       APNG の画像サイズについてなんですが、このサイズは標準画像指定時は標準画像、未指定時は 1 番目のフレーム画像と同じサイズとなります。
       そしてコレ重要なんですが、登録されるフレームは APNG のサイズからハみ出るような配置は不可です。
       具体的に云えば、x, y, width、height は
       
       • x >= 0　&　width > 0　&　x + width <= APNGの横幅
       • y >= 0　&　height > 0　&　y + height <= APNGの縦幅
       という条件を満たす値しか採る事ができません。
       GIF だと「GIF サイズを自由に指定可＆ハみ出てもｏｋ」と制限は緩かったのですが、APNG では厳しくなっています。
     • alpha
       対象フレーム画像がα情報を持っているかどうかの情報です。
       ”@”＝持っている。”x”＝否。です。
     • delay（待機時間）
       次フレーム表示までの待機時間（秒単位）です。APNG では分子と分母の値を指定する形で設定します。
       「分数が解らないヤツはカエレ」という APNG 開発陣の強い意志が示されています。（ヲイ
     • dispose_op（後始末）
       フレームを表示後、次のフレームを表示する際、今回のフレーム領域の内容をどうするか、を指定します。
       
       • そのまま残す（0）
         「いちから（ry」
       • 100%透過状態にする（1）
         APNG の背面にあるイメージ（背景）が視える状態にします。＝完全透過。
       • 描画前の状態に戻す（2）
         フレーム描画前の状態に戻します。所謂 Undo ですよアンドゥ。
     • blend_op（合成）
       これの説明が厄介なんだよな〜。ん〜本当に理解したい人はAPNG の仕様を読んで＾＾。
       日本語訳してくれている方のページを紹介しておく APNG仕様 日本語訳。
       
       図と読み手の察し能力に頼りきった解説も一応書いておくか。
       
       のような３つのフレームで構成されている極シンプル（全フレームが x=0、y=0、サイズ=APNGサイズ、dispose_op=0 で構成）な APNG があるとしましょう。
       簡潔に概要説明すると、始めは白で覆われているが再生が進むと徐々に背景が視えてくる感じの APNG です。
       では、黒で塗り潰されたイメージを背景と仮定して実際に色がどのように変化していくか観てみます。
       
       ハイ、こう為りま……イヤ！為らねぇ。為らん。為りゃしません。
       GIF と同じ方式だとこんな感じで処理されるんですが APNG はこう為らないんですよ奥さん。
       
       APNG ではこうなるんです。フレームと背景の合成が毎回行われるワケではないんです。
       見ての通り、まず APNG のフレーム間でイメージ合成が為されるんです。次に、合成されたイメージと初期背景とが合成され、画面に出力されるイメージが完成するのです。此処100%テストにでますね。
       
       え？「上の図では 1+2+3 とか書いてるのにまんま frame 3 と同じ値なんだけど…」だって。
       良いトコに気付いてくれました。
       ではさらに続けます。続けなければなりません。ややこしいです。
       上記で示した例では、フレーム間でイメージ合成がされる際、新フレームがそのまま上書きされて合成されています。
       実は APNG ではこのように完全上書きする方法の加えてもう一つ別アプローチが提供されています。
       
       ハイ、其処の人寝ない。早弁しない。窓の外見て呆けない。頑張って付いて来てください。
       
       やってる事は言葉にすると簡単です。
       フレーム間のイメージ合成段階に措いてもα値を反映しているだけです。
       壱の方法では背景と合成する段階でのみα値を反映するのですが、弐の方法ではフレーム間の合成段階でもα値を反映させるのです。
       実は俺もサッパリです。弐の方法を使いこなせる自信なんかありません。つーか使いこなせる猛者なんているんでしょうか。というかこの解釈で合っているんでしょうか？もしかして俺解釈してますか？
       
       と色々大変なので blend_op についてはなんとなく判った気になった程度で十分でしょう。
       
       ツールでは「そのまま上書き（0）」が壱に当たり、「画像α値を反映して合成（1）」が弐の方法になります。
       また透過設定でα値を選択していない場合、「画像α値を反映して合成」を指定すると APNG 保存処理時エラーになります。注意してください。

• 使用可能色数
  GIF は各フレームに 2, 4, 8, 16, 32, 64, 128, 256 の色数を使用できます。
  対して APNG は各フレームに 2, 4, 16, 256, 2^16, 2^24, 2^48 の色数を使用できます。
  色数を多く使用することは容量の増大に直結しますので、無闇矢鱈に多くの色を使用する事は愚行です。
  ですが昨今の状況から視ると、最大 256 色数しか使用できない GIF の制限は ”過去の遺物” という感が強いです。
  
• 色の扱い方
  GIF は パレット を用いて色を管理します。
  対する APNG は パレット に加えて RGBカラー、Grayscale といった管理方法が提供されています。
  RGBカラー、Grayscale は GIF には無いので差異点も糞もないので放置、今回は パレット に焦点を当てます。
  
  GIF、APNG 共に パレット を用いて色を管理できますが、GIF と APNG を比較した場合一点大きな違いが挙げられます。
  GIF では最大１個のグローバルカラーテーブルとｎ個のローカルカラーテーブルを使用して色の管理を行います。（各用語の解説は省略）
  この２種類のパレットの存在により、人夫々によって異なる
  「画質よりもデータ容量を少なくしたい」、「データ容量圧縮よりも美しくアニメーションさせたい」
  という風な相反する要望にも個別に対応できる仕様となっています。
  
  では、APNG はどうかというと…実は GIF でいうグローバルカラーテーブルを一つだけしか持てない仕様になっています。
  ローカルカラーテーブルを持つ事はできません。この点が GIF と大きく異なっています。
  これは「ローカルカラーテーブルを使わなければならない状況ならば大人しくRGBカラー（2^24色数以上）を使用しなさい」という事なんでしょう。
  
  ローカルカラーテーブルの存在は各フレームのデータの最適化を可能にします。が、反面、仕様を複雑にもします。
  実際、兄弟規格？である MNG 規格にはローカルカラーテーブルが存在します。
  つまり ”APNG にローカルカラーテーブルを組み込む事が技術的に難しかった” ワケでは無いのです。
  APNG の仕様開発者はローカルカラーテーブルの存在により仕様が複雑化する事のマイナス面を嫌ったのでしょう。
  
  そもそも APNG は ”MNG 規格の煩雑さ” に対する反発から生まれた規格です。
  ”規格の簡潔さ” を優先するのは正しい選択だと思います。
  
• 各フレームの形式
  APNG には「全フレームが同じ形式（色階調）で構成されていなければならない」という制限があります。
  GIF では「 1 フレーム目には 256 色使おう。2 フレーム目は 16 色で足りる。3 フレーム目は 64 色」という風に各フレーム個別に使用する色数を選ぶ事が可能です。
  ですが APNG ではソレは許されません。全てのフレームは同じ形式で構成されていなければいけません。
  これも、先に述べた ”規格の簡潔さ” を優先した結果でしょう。
  
• 透過／半透明
  APNG は半透明処理に対応した簡易アニメーション規格である。
  これが APNG の最大のセールスポイントだと俺は思っています。※ GIF と同じような一色のみの（完全）透過にも当然対応しています。
  この半透明を旨く使いこなす事ができれば（ソレが難しいんだけどね…）表現の質が大幅に向上できます。
  「半透明処理を行いながらアニメーションする事がそんな大した事なの？」
  と思った人は一度 APNG に触れる事をお勧めします。新たな価値観を…多分、恐らく、もしかすれば…得られるでしょう。
  

• 昨年末から現実世界が大忙し
• ２月一杯で現実世界の忙しさが落ち着く
• 購入してから１年以上playし続けてきた「Rance7」にもいい加減飽きてくる
• つまり暇
• 時間潰そう何しよう〜
• ふむ。Webページの更新でもするか
• …そういえば「APNGの変」からもうすぐ１年
• …APNG関連のプログラムを組んでみるか、と思いつつもうすぐ１年
• …現在の仕様書では俺解釈が必要になるから、と情報を待ちつつもうすぐ１年
• でも一年経っても進展皆無。仕様書のバージョンも 1.0 のまま
• こりゃダメだ。待つだけ無駄ポイ！俺解釈採用！
• で、何作る？ビューア？エディタ？
• そういえば「vista糞」でバグ直せって書いトキ乍「送るせにょう」のバグは放置しっ放しジャーマンだった
• キミに決めた。バグ修正＆APNG対応処理実装ケッテイ！
• 祝「＃ガラクタ更新」　←今ココ
• バグ修正だけで何回も更新依頼するのはvectorの人に悪いから公開後2週間バグが露見しなかったら依頼しよう
  → version 1.5.1 から前に進めず
  だったvectorの「送るせにょう」もついでに更新！
• 何となく「俺はやったよ」感に浸る
• それも束の間。バグ発生してヘル状態！！
• 更新する + no debug = バグ発生。当前の事
• 怠けてデバッグしない俺の責任でしかないな。プログラムのしきたりとか分かってない…
• やる気消滅
• 「Rance7」に戻る
• 2009年へ

• 実行ファイルサイズが 1000KB を超えてしまった
• v1.11.0 を中途半端な段階（実質的にはα ver）で「メドイ…」と言って出してしまったため萎え気味。
  例えば音声の含まれた swf ファイルを表示した後直ぐに他の画像ファイルを表示しても swf ファイルの音声は止まらず流れ続けるとか…
  html や swf を表示している時はエクスプローラと同じ様に専用メニューを表示するつもりだったけどメンドかったので止めてしまったとか…
• 「Picasa 2 良いなぁ」とか思っている