SetUseBackCulling

ポリゴンのバックカリングを使用するかどうかを設定する

SetUseBackCulling Flag

int Flag : バックカリングを行うかどうかのフラグ
( TRUE:行う  FALSE:行わない( 初期設定 ) )

(プラグイン / モジュール : DxLibW)

解説

DrawTriangle3D, DrawSphere3D, DrawCapsule3D, DrawCone3D, DrawPolygon3D, DrawPolygonIndexed3D でポリゴンを描画する際にバックカリングを行うかどうかを設定します。


バックカリングとは裏面になっているポリゴンを書かない処理のことです。

例えば DrawSphere3D 関数で球を描画する場合、
球の画面の方を向いていない面は常に画面の方を向いている面に隠れて画面には表示されないことになりますが、
バックカリングを行わない場合は必ず隠れることが分かっている面も画面への描画処理が行われるのでその分描画負荷が高くなります。

このような場合にバックカリングを行うようにすると画面に対して後ろを向いている面を描画しない( カリング )ようになるので、
裏面の描画負荷のぶん処理が高速になります。

因みに裏面かどうかは、ポリゴンを画面に映した際のポリゴンを形成する3頂点を頂点の指定順にスクリーン座標をなぞった場合に、
右回りになっているか左回りになっているかで判断します。( 左回りの場合に裏面だと判断され、カリングが有効な場合はカリングされます )

DrawPolygon3DDrawPolygonIndexed3D で直接頂点を扱ってポリゴンを描画する場合にバックカリングを使用する場合には形成するポリゴンの向きを意識する必要がありますので注意してください。


尚、この関数の設定はモデルの描画には影響を与えません。
( モデルはデフォルトではバックカリングONになっていて、
ツール上でメッシュ単位でカリングを行うかどうかを設定することができます )

戻り値:
  0:成功

関連項目

GetUseBackCullingポリゴンカリングモードを取得する(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib その他
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs