ホーム › Graphics.OpenGL › gluTessCallback
gluTessCallback
関数テッセレーション時に呼ばれるコールバック関数を設定する。
シグネチャ
// GLU32.dll
#include <windows.h>
void gluTessCallback(
GLUtesselator* tess,
DWORD which,
INT_PTR fn
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| tess | GLUtesselator* | inout | 対象のテッセレータオブジェクトへのポインタ。 |
| which | DWORD | in | 登録するコールバック種別。GLU_TESS_VERTEXなど。 |
| fn | INT_PTR | in | コールバック関数へのポインタ。NULLで解除。 |
戻り値の型: void
公式ドキュメント
gluTessCallback 関数は、テセレーションオブジェクトのコールバックを定義します。
戻り値
この関数は値を返しません。
解説(Remarks)
gluTessCallback を使用して、テセレーションオブジェクトが使用するコールバックを指定します。指定したコールバックが既に定義されている場合は、置き換えられます。fn が NULL の場合、既存のコールバックは未定義になります。
テセレーションオブジェクトは、これらのコールバックを使用して、指定したポリゴンがどのように三角形に分割されるかを伝えます。
各コールバックには、独自に定義できるポリゴンデータを伴うバージョンと伴わないバージョンの 2 つがあります。特定のコールバックについて両方のバージョンが指定された場合は、指定したポリゴンデータを伴うコールバックが使用されます。gluTessBeginPolygon の polygon_data パラメーターは、gluTessBeginPolygon を呼び出したときに指定されたポインターのコピーです。
有効なコールバックは次のとおりです。
| コールバック | 説明 |
|---|---|
| GLU_TESS_BEGIN | GLU_TESS_BEGIN コールバックは glBegin と同様に呼び出され、(三角形) プリミティブの開始を示します。この関数は GLenum 型の引数を 1 つ取ります。GLU_TESS_BOUNDARY_ONLY プロパティを GL_FALSE に設定した場合、引数には GL_TRIANGLE_FAN、GL_TRIANGLE_STRIP、GL_TRIANGLES のいずれかが設定されます。GLU_TESS_BOUNDARY_ONLY プロパティを GL_TRUE に設定した場合、引数には GL_LINE_LOOP が設定されます。このコールバックの関数プロトタイプは次のとおりです: voidbegin (GLenumtype); |
| GLU_TESS_BEGIN_DATA | GLU_TESS_BEGIN_DATA は GLU_TESS_BEGIN コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voidbeginData (GLenumtype, void * polygon_data); |
| GLU_TESS_EDGE_FLAG | GLU_TESS_EDGE_FLAG コールバックは glEdgeFlag と同様のものです。この関数は、どのエッジがポリゴンの境界上にあるかを示すブール値のフラグを 1 つ取ります。フラグが GL_TRUE の場合、それ以降の各頂点は、ポリゴンの境界上にあるエッジ、つまり内部領域と外部領域を分けるエッジの始点になります。フラグが GL_FALSE の場合、それ以降の各頂点はポリゴンの内部にあるエッジの始点になります。GLU_TESS_EDGE_FLAG コールバックは、(定義されている場合) 最初の頂点コールバックが呼び出される前に呼び出されます。トライアングルファンとトライアングルストリップはエッジフラグをサポートしないため、エッジフラグコールバックが指定されている場合、begin コールバックが GL_TRIANGLE_FAN や GL_TRIANGLE_STRIP で呼び出されることはありません。代わりに、ファンとストリップは独立した三角形に変換されます。このコールバックの関数プロトタイプは次のとおりです: voidedgeFlag (GLbooleanflag); |
| GLU_TESS_EDGE_FLAG_DATA | GLU_TESS_EDGE_FLAG_DATA コールバックは GLU_TESS_EDGE_FLAG コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voidedgeFlagData (GLbooleanflag, void * polygon_data); |
| GLU_TESS_VERTEX | GLU_TESS_VERTEX コールバックは、begin コールバックと end コールバックの間に呼び出されます。これは glVertex と同様のもので、テセレーション処理によって作成された三角形の頂点を定義します。この関数は唯一の引数としてポインターを取ります。このポインターは、頂点を定義したときに渡した不透明なポインターと同一です (gluTessVertex を参照)。このコールバックの関数プロトタイプは次のとおりです: voidvertex (void * vertex_data); |
| GLU_TESS_VERTEX_DATA | GLU_TESS_VERTEX_DATA は GLU_TESS_VERTEX コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voidvertexData (void * vertex_data, void * polygon_data); |
| GLU_TESS_END | GLU_TESS_END コールバックは glEnd と同じ目的を果たします。プリミティブの終了を示し、引数は取りません。このコールバックの関数プロトタイプは次のとおりです: voidend (void); |
| GLU_TESS_END_DATA | GLU_TESS_END_DATA コールバックは GLU_TESS_END コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voidendData (void * polygon_data); |
| GLU_TESS_COMBINE | GLU_TESS_COMBINE コールバックは、テセレーションが交差を検出したときに新しい頂点を作成する場合や、特徴を統合する場合に呼び出されます。この関数は 4 つの引数を取ります。それぞれ Gldouble 型の 3 要素の配列。 4 つのポインターの配列。 それぞれ GLfloat 型の 4 要素の配列。 ポインターへのポインター。 このコールバックの関数プロトタイプは次のとおりです: voidcombine(GLdoublecoords[3], void * vertex_data[4], GLfloatweight[4], void **outData); 新しい頂点は、vertex_data に格納された最大 4 つの既存の頂点の線形結合として定義されます。線形結合の係数は weight で与えられ、これらの重みの合計は常に 1.0 になります。一部の重みが 0 であっても、すべての頂点ポインターは有効です。coords パラメーターは新しい頂点の位置を示します。 別の頂点を割り当て、vertex_data と weight を使用してパラメーターを補間し、新しい頂点のポインターを outData に返してください。このハンドルはレンダリングのコールバック時に渡されます。メモリーは gluTessEndPolygon を呼び出した後の適切なタイミングで解放してください。 たとえば、ポリゴンが 3 次元空間内の任意の平面上にあり、各頂点に色を関連付けている場合、GLU_TESS_COMBINE コールバックは次のようになります。 テセレーションが交差を検出した場合、GLU_TESS_COMBINE または GLU_TESS_COMBINE_DATA コールバック (後述) を定義し、NULL 以外のポインターを dataOut に書き込む必要があります。そうしないと GLU_TESS_NEED_COMBINE_CALLBACK エラーが発生し、出力は生成されません。(これは、テセレーションおよびレンダリング中に発生し得る唯一のエラーです。) |
| GLU_TESS_COMBINE_DATA | GLU_TESS_COMBINE_DATA コールバックは GLU_TESS_COMBINE コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voidcombineData (GLdoublecoords[3], void *vertex_data[4], GLfloatweight[4], void **outData, void * polygon_data); |
| GLU_TESS_ERROR | GLU_TESS_ERROR コールバックは、エラーが発生したときに呼び出されます。唯一の引数は GLenum 型で、発生した具体的なエラーを示し、次のいずれかが設定されます。GLU_TESS_MISSING_BEGIN_POLYGON GLU_TESS_MISSING_END_POLYGON GLU_TESS_MISSING_BEGIN_CONTOUR GLU_TESS_MISSING_END_CONTOUR GLU_TESS_COORD_TOO_LARGE GLU_TESS_NEED_COMBINE_CALLBACK これらのエラーを説明する文字列を取得するには、gluErrorString を呼び出します。このコールバックの関数プロトタイプは次のとおりです: voiderror (GLenumerrno); GLU ライブラリは、最初の 4 つのエラーについては、不足している呼び出しを挿入することで回復します。GLU_TESS_COORD_TOO_LARGE は、いずれかの頂点座標の絶対値があらかじめ定義された定数 GLU_TESS_MAX_COORD を超えたため、その値がクランプされたことを示します。(座標値は、2 つを乗算してもオーバーフローしない程度に小さくする必要があります。) GLU_TESS_NEED_COMBINE_CALLBACK は、入力データ内の 2 つのエッジ間の交差をテセレーションが検出したにもかかわらず、GLU_TESS_COMBINE または GLU_TESS_COMBINE_DATA コールバックが指定されていなかったことを示します。出力は生成されません。 |
| GLU_TESS_ERROR_DATA | GLU_TESS_ERROR_DATA コールバックは GLU_TESS_ERROR コールバックと同じですが、追加のポインター引数を取る点が異なります。このポインターは、gluTessBeginPolygon を呼び出したときに渡した不透明なポインターと同一です。このコールバックの関数プロトタイプは次のとおりです: voiderrorData (GLenumerrno, void * polygon_data); |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
各言語での呼び出し定義
// GLU32.dll
#include <windows.h>
void gluTessCallback(
GLUtesselator* tess,
DWORD which,
INT_PTR fn
);[DllImport("GLU32.dll", ExactSpelling = true)]
static extern void gluTessCallback(
ref IntPtr tess, // GLUtesselator* in/out
uint which, // DWORD
IntPtr fn // INT_PTR
);<DllImport("GLU32.dll", ExactSpelling:=True)>
Public Shared Sub gluTessCallback(
ByRef tess As IntPtr, ' GLUtesselator* in/out
which As UInteger, ' DWORD
fn As IntPtr ' INT_PTR
)
End Sub' tess : GLUtesselator* in/out
' which : DWORD
' fn : INT_PTR
Declare PtrSafe Sub gluTessCallback Lib "glu32" ( _
ByRef tess As LongPtr, _
ByVal which As Long, _
ByVal fn As LongPtr)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
gluTessCallback = ctypes.windll.glu32.gluTessCallback
gluTessCallback.restype = None
gluTessCallback.argtypes = [
ctypes.c_void_p, # tess : GLUtesselator* in/out
wintypes.DWORD, # which : DWORD
ctypes.c_ssize_t, # fn : INT_PTR
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('GLU32.dll')
gluTessCallback = Fiddle::Function.new(
lib['gluTessCallback'],
[
Fiddle::TYPE_VOIDP, # tess : GLUtesselator* in/out
-Fiddle::TYPE_INT, # which : DWORD
Fiddle::TYPE_INTPTR_T, # fn : INT_PTR
],
Fiddle::TYPE_VOID)#[link(name = "glu32")]
extern "system" {
fn gluTessCallback(
tess: *mut isize, // GLUtesselator* in/out
which: u32, // DWORD
fn: isize // INT_PTR
);
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("GLU32.dll")]
public static extern void gluTessCallback(ref IntPtr tess, uint which, IntPtr fn);
"@
$api = Add-Type -MemberDefinition $sig -Name 'GLU32_gluTessCallback' -Namespace Win32 -PassThru
# $api::gluTessCallback(tess, which, fn)#uselib "GLU32.dll"
#func global gluTessCallback "gluTessCallback" sptr, sptr, sptr
; gluTessCallback varptr(tess), which, fn
; tess : GLUtesselator* in/out -> "sptr"
; which : DWORD -> "sptr"
; fn : INT_PTR -> "sptr"出力引数:
#uselib "GLU32.dll" #func global gluTessCallback "gluTessCallback" var, int, sptr ; gluTessCallback tess, which, fn ; tess : GLUtesselator* in/out -> "var" ; which : DWORD -> "int" ; fn : INT_PTR -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "GLU32.dll" #func global gluTessCallback "gluTessCallback" sptr, int, sptr ; gluTessCallback varptr(tess), which, fn ; tess : GLUtesselator* in/out -> "sptr" ; which : DWORD -> "int" ; fn : INT_PTR -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; void gluTessCallback(GLUtesselator* tess, DWORD which, INT_PTR fn) #uselib "GLU32.dll" #func global gluTessCallback "gluTessCallback" var, int, intptr ; gluTessCallback tess, which, fn ; tess : GLUtesselator* in/out -> "var" ; which : DWORD -> "int" ; fn : INT_PTR -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; void gluTessCallback(GLUtesselator* tess, DWORD which, INT_PTR fn) #uselib "GLU32.dll" #func global gluTessCallback "gluTessCallback" intptr, int, intptr ; gluTessCallback varptr(tess), which, fn ; tess : GLUtesselator* in/out -> "intptr" ; which : DWORD -> "int" ; fn : INT_PTR -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
glu32 = windows.NewLazySystemDLL("GLU32.dll")
procgluTessCallback = glu32.NewProc("gluTessCallback")
)
// tess (GLUtesselator* in/out), which (DWORD), fn (INT_PTR)
r1, _, err := procgluTessCallback.Call(
uintptr(tess),
uintptr(which),
uintptr(fn),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // voidprocedure gluTessCallback(
tess: Pointer; // GLUtesselator* in/out
which: DWORD; // DWORD
fn: NativeInt // INT_PTR
); stdcall;
external 'GLU32.dll' name 'gluTessCallback';result := DllCall("GLU32\gluTessCallback"
, "Ptr", tess ; GLUtesselator* in/out
, "UInt", which ; DWORD
, "Ptr", fn ; INT_PTR
, "Int") ; return: void●gluTessCallback(tess, which, fn) = DLL("GLU32.dll", "int gluTessCallback(void*, dword, int)")
# 呼び出し: gluTessCallback(tess, which, fn)
# tess : GLUtesselator* in/out -> "void*"
# which : DWORD -> "dword"
# fn : INT_PTR -> "int"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "glu32" fn gluTessCallback(
tess: [*c]isize, // GLUtesselator* in/out
which: u32, // DWORD
fn: isize // INT_PTR
) callconv(std.os.windows.WINAPI) void;proc gluTessCallback(
tess: ptr int, # GLUtesselator* in/out
which: uint32, # DWORD
fn: int # INT_PTR
) {.importc: "gluTessCallback", stdcall, dynlib: "GLU32.dll".}pragma(lib, "glu32");
extern(Windows)
void gluTessCallback(
ptrdiff_t* tess, // GLUtesselator* in/out
uint which, // DWORD
ptrdiff_t fn // INT_PTR
);ccall((:gluTessCallback, "GLU32.dll"), stdcall, Cvoid,
(Ptr{Int}, UInt32, Int),
tess, which, fn)
# tess : GLUtesselator* in/out -> Ptr{Int}
# which : DWORD -> UInt32
# fn : INT_PTR -> Int
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
void gluTessCallback(
intptr_t* tess,
uint32_t which,
intptr_t fn);
]]
local glu32 = ffi.load("glu32")
-- glu32.gluTessCallback(tess, which, fn)
-- tess : GLUtesselator* in/out
-- which : DWORD
-- fn : INT_PTR
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('GLU32.dll');
const gluTessCallback = lib.func('__stdcall', 'gluTessCallback', 'void', ['intptr_t *', 'uint32_t', 'intptr_t']);
// gluTessCallback(tess, which, fn)
// tess : GLUtesselator* in/out -> 'intptr_t *'
// which : DWORD -> 'uint32_t'
// fn : INT_PTR -> 'intptr_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("GLU32.dll", {
gluTessCallback: { parameters: ["pointer", "u32", "isize"], result: "void" },
});
// lib.symbols.gluTessCallback(tess, which, fn)
// tess : GLUtesselator* in/out -> "pointer"
// which : DWORD -> "u32"
// fn : INT_PTR -> "isize"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
void gluTessCallback(
intptr_t* tess,
uint32_t which,
intptr_t fn);
C, "GLU32.dll");
// $ffi->gluTessCallback(tess, which, fn);
// tess : GLUtesselator* in/out
// which : DWORD
// fn : INT_PTR
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Glu32 extends StdCallLibrary {
Glu32 INSTANCE = Native.load("glu32", Glu32.class);
void gluTessCallback(
LongByReference tess, // GLUtesselator* in/out
int which, // DWORD
long fn // INT_PTR
);
}@[Link("glu32")]
lib LibGLU32
fun gluTessCallback = gluTessCallback(
tess : LibC::SSizeT*, # GLUtesselator* in/out
which : UInt32, # DWORD
fn : LibC::SSizeT # INT_PTR
) : Void
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef gluTessCallbackNative = Void Function(Pointer<IntPtr>, Uint32, IntPtr);
typedef gluTessCallbackDart = void Function(Pointer<IntPtr>, int, int);
final gluTessCallback = DynamicLibrary.open('GLU32.dll')
.lookupFunction<gluTessCallbackNative, gluTessCallbackDart>('gluTessCallback');
// tess : GLUtesselator* in/out -> Pointer<IntPtr>
// which : DWORD -> Uint32
// fn : INT_PTR -> IntPtr
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
procedure gluTessCallback(
tess: Pointer; // GLUtesselator* in/out
which: DWORD; // DWORD
fn: NativeInt // INT_PTR
); stdcall;
external 'GLU32.dll' name 'gluTessCallback';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "gluTessCallback"
c_gluTessCallback :: Ptr CIntPtr -> Word32 -> CIntPtr -> IO ()
-- tess : GLUtesselator* in/out -> Ptr CIntPtr
-- which : DWORD -> Word32
-- fn : INT_PTR -> CIntPtr
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let glutesscallback =
foreign "gluTessCallback"
((ptr intptr_t) @-> uint32_t @-> intptr_t @-> returning void)
(* tess : GLUtesselator* in/out -> (ptr intptr_t) *)
(* which : DWORD -> uint32_t *)
(* fn : INT_PTR -> intptr_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library glu32 (t "GLU32.dll"))
(cffi:use-foreign-library glu32)
(cffi:defcfun ("gluTessCallback" glu-tess-callback :convention :stdcall) :void
(tess :pointer) ; GLUtesselator* in/out
(which :uint32) ; DWORD
(fn :int64)) ; INT_PTR
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $gluTessCallback = Win32::API::More->new('GLU32',
'void gluTessCallback(LPVOID tess, DWORD which, LPARAM fn)');
# my $ret = $gluTessCallback->Call($tess, $which, $fn);
# tess : GLUtesselator* in/out -> LPVOID
# which : DWORD -> DWORD
# fn : INT_PTR -> LPARAM
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。