0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【DirectX11】【HLSL】カードを3Dで表示しよう

0
Last updated at Posted at 2026-11-11

3Dカードゲームのカードは、一見すると四角い画像を1枚貼るだけで済みそうに見えます。

ところが、手札を扇状に開く、ドラッグ中に傾ける、裏返して年号を見せるといった動きを入れようとすると、画面に正対したスプライトでは足りなくなります。

本記事では、歴史カードを年代順に並べるゲームChronoSortを題材に、カードを3Dモデルとして表示する方法を解説します。

メッシュの作り方、表裏へのテクスチャの貼り方、角丸の抜き方、前後関係の決め方を順に見ていきたいと思います。

カードの動きや補間については、次回以降の記事で扱います。

想定環境

  • Windows 11
  • Visual Studio 2022 / C++20
  • DirectX11 / HLSL
  • TsukinoEngine

前提知識

  • 頂点、UVの基本
  • HLSLのピクセルシェーダーの基本
  • ディファードレンダリングとシャドウマップの概要(下記の記事にて紹介)

完成形

卓の上にカードを並べた画面です。

手札の3枚も、列の1枚も、すべて3D空間に置かれた板です。

game.png

カードを置くと、空中で裏返って年号が現れます。

シェーダーでめくりの処理をしているわけではなく、板が実際に180度回っているだけです。

flip.gif

全体の構成

カード1枚を表示するために必要なものは、次の通りです。

要素 内容
メッシュ 全カードで共通の1個(板2枚)
テクスチャ カードごとに表と裏の2枚
マテリアル カードごとに表と裏の2個(.tmat)
シェーダー エンジン標準のGBufferとShadowMapのみ

カード専用のシェーダーはありません。カードらしさは、メッシュとテクスチャ側で作っています。

カードのメッシュ

板を2枚重ねる

カードのメッシュは、薄い間隔を空けて背中合わせにした板2枚だけです。

頂点は8個、三角形は4枚で、側面のポリゴンはありません。

カードの断面(横から見た図)
        +Y
         ^     Front (法線 +Y)
  ───────┼───────  y = +0.3
         │         厚み 0.6(間は空洞)
  ───────┼───────  y = -0.3
               Back (法線 -Y)

実際のcard.objはPythonのスクリプトで生成しています。

make_meshes.py
CARD_WIDTH = 64.0       # カード幅(512px の面に対応)
CARD_HEIGHT = 96.0      # カード高さ(768px の面に対応)
CARD_THICKNESS = 0.6    # 表と裏の間隔

def main():
    half_t = CARD_THICKNESS / 2
    front_pos, front_uv = quad_up(half_t, CARD_WIDTH / 2, CARD_HEIGHT / 2)
    # 裏面は下から見て正しく読めるよう U を反転し、巻き順も逆にする
    back_pos, back_uv = quad_up(-half_t, CARD_WIDTH / 2, CARD_HEIGHT / 2, flip_u=True)
    write_obj("card", [
        ("Front", front_pos, front_uv, (0, 1, 0), True),
        ("Back", back_pos, back_uv, (0, -1, 0), False),
    ])

カードの幅:高さを64:96にしておくことで、テクスチャの2:3と一致し、絵が歪まないようにしています。

厚み0.6はカードの大きさに対してごくわずかなので、ゲーム中の視点では側面が無いことは分かりません。

裏面だけUを反転する理由

裏面描画では、uv値のu(横方向)を反転します。

2枚の板はそれぞれ外側を向ける

Back(裏面)は下を向いた板なので、三角形の巻き順をFrontと逆にします。

PrefabではdoubleSidedをfalseにしているので、バックフェイスカリングが効き、見えるのは常に手前を向いている板だけになります。

裏返しはZ軸まわりの180度回転で行う

カードはXZ平面に寝ており、絵の上端は+Z側です。裏返しは次の回転で表現します。

CardFactory.cpp
hlslpp::quaternion RevealedRotation() {
    return hlslpp::quaternion::rotation_z(kPi);
}

絵の上下の軸(Z)を中心に回すので、裏返しても絵の上は上のままです。

そのためVは反転しなくて済みます。

左右だけは鏡像になるので U を反転する

Z軸まわりに回すとXが反転します。ここを何もしないと、裏面の文字が左右逆になります。そのためBackのUだけを1.0 - uにしています。

表と裏に別のテクスチャを貼る

年号は裏面の画像にしか入っていない

このゲームで一番大事なのがここです。

faces.png

左が手札で見える面、右がめくった後の面です。違いは年号の札だけです。 手札の面の画像には、年号のデータが最初から入っていません。

bake_cards.py
# 年号の札。表では伏せ、裏で明かす
draw.rounded_rectangle(YEAR_BOX, 14, fill=FRAME if reveal else (205, 190, 160), outline=GOLD, width=3)
label = card["yearLabel"] if reveal else "????"

文字もすべて画像に焼き込んでいます。理由は単純で、エンジンのFontComponentが画面のUI専用であり、3D空間の板に文字を描く仕組みが無いからです。

この構成にしたことで、めくるという処理は板を回すだけになりました。シェーダーに状態を渡す必要も、文字を重ねて描く必要もありません。

カードごとにマテリアルを差し替える

メッシュは全カードで1つなので、カードを生成するときにマテリアルだけを差し替えます。

CardFactory.cpp
// assimp は .obj を読むとき、.mtl のマテリアルより前に DefaultMaterial を 0 番に入れる。
// そのため .mtl に書いた順(Front, Back)は 1 番から始まる
constexpr size_t kFirstObjMaterialSlot = 1;

// カード固有の面を差し替える。AssetManager は同じパスを一度しか読まないので、毎回 Load してよい
const std::string facePrefix = std::string(kCardTextureDir) + card.id;
auto&             model      = registry.GetComponent<ModelComponent>(entity);
model.materials[kFirstObjMaterialSlot]     = m_assetManager.Load(Path(facePrefix + "_front.tmat"));
model.materials[kFirstObjMaterialSlot + 1] = m_assetManager.Load(Path(facePrefix + "_back.tmat"));

.tmatはエンジン独自のテキスト形式のマテリアルです。

sekigahara_back.tmat
ShadingModel = PBR
Roughness    = 0.6
Specular     = 0.3
AlphaCutoff  = 0.5
AlbedoMap    = ChronoSort/Assets/Textures/Cards/sekigahara_back.png

ここで注意が必要なのがkFirstObjMaterialSlotです。assimpは.objを読むと、.mtlのマテリアルより前にDefaultMaterialを0番へ挿入します。ここを見落として0番から差し替えると、表と裏のテクスチャが1つずつずれることになります。

Prefabのmaterialsが3要素あり、先頭が空になっているのもこのためです。

Prefabs/Board/Card/Model.json
"materials": [
    "",
    "",
    ""
]

Alpha Test / 角丸を抜く

カードの角丸はメッシュでは作っていません。板はただの長方形で、丸さはテクスチャのアルファだけが持っています。

bake_cards.py
def rounded_mask():
    mask = Image.new("L", (W, H), 0)
    ImageDraw.Draw(mask).rounded_rectangle((0, 0, W - 1, H - 1), CORNER, fill=255)
    return mask

描画時には、GBufferのピクセルシェーダーでclipします。

GBuffer.ps.hlsl
float4 albedoSample = albedoTexture.Sample(albedoSampler, input.uv);
clip(albedoSample.a - alphaCutoff);

左が通常、右がAlphaCutoffを0にした場合を拡大したものです。

clip_compare.png

右は角に四角い出っ張りが残っています。ここで破棄しておかないと、透明なはずのテクセルがG-Bufferと深度を書いてしまうことになります。

影も同じ形で抜く

clipをGBufferにだけ入れると、見た目は角丸なのに影だけが長方形になります。そのため、シャドウマップのパスでも同じ判定を行います。

ShadowMap.ps.hlsl
void PSMain(PSInput input)
{
    ClipDither(input.position.xy, motionFlags.y);

    if(alphaCutoff > 0.0f)
        clip(albedoTexture.Sample(albedoSampler, input.uv).a - alphaCutoff);
}

alphaCutoffが0の普通の物体はテクスチャを読まずに素通りするので、不透明な物体の影のコストは増えません。

ちなみに、半透明で角を透かす方法は使っていません。このエンジンではModelComponentのopacityを1未満にすると影が消えるため、形を抜くにはAlphaCutoffを使う必要があります。

描画順は座標で決まる

3Dのカードには、sortOrderのような描画順の仕組みはありません。前後関係は、実際の座標と深度テストだけで決まります。

PipelineFactory.cpp
case DepthMode::ReadWrite:
    desc.DepthEnable    = TRUE;
    desc.DepthWriteMask = D3D11_DEPTH_WRITE_MASK_ALL;
    desc.DepthFunc      = D3D11_COMPARISON_GREATER_EQUAL;
    break;

GREATER_EQUALになっているのはリバースZを使っているためです。

手札の位置は、次の式で決めています。

BoardLayout.cpp
position = hlslpp::float3(x,
                          t.handBaseY + static_cast<float>(index) * t.handStackStep,
                          t.handCenterZ - offset * offset * t.handArcDepth - static_cast<float>(index));

offsetは手札の中央からの距離です。Zにoffsetの2乗が入っているので、外側のカードほど手前に来ます。完成形の画面で、3枚のうち中央のカードが両隣の下に潜っているのはこのためです。

順序を管理するコードを書かなくても、実際に手前にあるカードが手前に見えるというのが、カードを3Dで扱う大きな利点だと思います。

Emissive / カードを光らせる

正解したときなどのカードの発光にも、専用のシェーダーは使っていません。エンティティごとにマテリアルの値を上書きするMaterialPropertyBlockComponentで、emissiveだけを差し替えています。

CardGlowSystem.cpp
strength = glow.intensity * (0.55f + 0.45f * std::sin(glow.time * glow.pulseSpeed));
// ...
block.emissive = glow.color * strength;

マテリアルのアセット自体は書き換えないので、同じ.tmatを別のエンティティが使っていても影響しません。

emissiveはG-BufferのR11G11B10_FLOATのターゲットに書き込まれるので、1.0を超えた分も潰れずに残ります。あとはBloom(閾値1.0)が明るい部分を拾って、光がにじんで見えるという流れです。

総括

  • カードは板2枚のメッシュで表現でき、全カードで共有できる
  • 裏面はUだけを反転し、巻き順を逆にする
  • 年号を裏面の画像にだけ焼き込むと、めくる処理は板の回転だけで済む
  • assimpで.objを読むとマテリアルの番号が1つずれる
  • 角丸はテクスチャのアルファで抜き、GBufferとシャドウマップで同じ判定をする
  • 前後関係は実際の座標と深度テストに任せられる

次回

次回は、カードを滑らかに動かすための補間を実装します。lerp(a, b, 0.1)がなぜフレームレートで速さが変わってしまうのか、というところから解説したいと思います。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?