目次 - API(機能別) - 2Dレンダリング - SDL_CreateTextureFromSurface

SDL_CreateTextureFromSurface

サーフェイスからテクスチャを生成する

構文

SDL_Texture* SDL_CreateTextureFromSurface(SDL_Renderer* renderer, SDL_Surface* surface)

引数

rendererレンダリングコンテキスト
surfaceテクスチャで使うピクセルデータを持つSDL_Surface

戻り値

成功のとき生成されたテクスチャ, 失敗のときNULLを戻す. SDL_GetError()で詳細を知ることができる.

サンプルコード

    /* OpenGLのテクスチャとして使うために
       各ピクセルがR,G,B,A順の32bitサーフェイスを生成する */
    SDL_Surface *surface;
    Uint32 rmask, gmask, bmask, amask;

    /* SDLはピクセルを32bitの値として解釈する.
       よって, マスクはマシンのエンディアン(バイト順)に依存する */
#if SDL_BYTEORDER == SDL_BIG_ENDIAN
    rmask = 0xff000000;
    gmask = 0x00ff0000;
    bmask = 0x0000ff00;
    amask = 0x000000ff;
#else
    rmask = 0x000000ff;
    gmask = 0x0000ff00;
    bmask = 0x00ff0000;
    amask = 0xff000000;
#endif

    surface = SDL_CreateRGBSurface(0, width, height, 32,
                                   rmask, gmask, bmask, amask);
    if (surface == NULL) {
        fprintf(stderr, "CreateRGBSurface 失敗: %s¥n", SDL_GetError());
        exit(1);
    }

    SDL_Texture *texture = SDL_CreateTextureFromSurface(renderer, surface);
    
    if (texture == NULL) {
        fprintf(stderr, "CreateTextureFromSurface 失敗: %s¥n", SDL_GetError());
        exit(1);
    }
    
    SDL_FreeSurface(surface);
    surface = NULL;

詳細

この関数はサーフェイスを修正/解放しない.

このテクスチャのSDL_TextureAccessヒントはSDL_TEXTUREACCESS_STATICである.

生成されるテクスチャのピクセル形式はサーフェイスのピクセル形式とは異なる場合がある. テクスチャのピクセル形式はSDL_QueryTexture()で得ることができる.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_CreateTexture
SDL_DestroyTexture
SDL_QueryTexture

SDL Wikiへのリンク

SDL_CreateTextureFromSurface - SDL Wiki