Win32 API 日本語リファレンス
ホームGraphics.OpenGL › glPixelMapusv

glPixelMapusv

関数
ピクセル転送用の符号なし短整数カラーマップを設定する。
DLLOPENGL32.dll呼出規約winapi

シグネチャ

// OPENGL32.dll
#include <windows.h>

void glPixelMapusv(
    DWORD map,
    INT mapsize,
    const WORD* values
);

パラメーター

名前方向説明
mapDWORDin設定するピクセルマップの種類。GL_PIXEL_MAP_I_TO_Iなどを指定する。
mapsizeINTinマップの要素数。1以上の整数で指定する。
valuesWORD*inマップ値を保持する符号なし短整数配列へのポインタ。

戻り値の型: void

公式ドキュメント

glPixelMapusv 関数は、ピクセル転送マップを設定します。

戻り値

この関数は値を返しません。

解説(Remarks)

glPixelMap 関数は、glCopyPixelsglCopyTexImage1DglCopyTexImage2DglCopyTexSubImage1DglCopyTexSubImage2DglDrawPixelsglReadPixelsglTexImage1DglTexImage2DglTexSubImage1DglTexSubImage2D が使用する変換テーブル(マップ)を設定します。これらのマップの使い方は glPixelTransfer のトピックで詳しく説明されており、一部はピクセルおよびテクスチャイメージ関連コマンドのトピックでも説明されています。本トピックでは、マップの指定方法のみを説明します。

map パラメーターはシンボリックなマップ名で、設定対象となる 10 種類のマップのいずれかを示します。mapsize パラメーターはマップ内のエントリ数を指定し、valuesmapsize 個のマップ値からなる配列へのポインターです。

マップのエントリは、単精度浮動小数点数、unsigned short 整数、または unsigned long 整数として指定できます。色成分の値を格納するマップ(GL_PIXEL_MAP_I_TO_IGL_PIXEL_MAP_S_TO_S 以外のすべて)は、仮数部と指数部のサイズが未規定の浮動小数点形式で値を保持します。glPixelMapfv で指定された浮動小数点値は、これらのマップの内部浮動小数点形式に直接変換され、その後 [0,1] の範囲にクランプされます。glPixelMapusv および glPixelMapuiv で指定された符号なし整数値は、表現可能な最大の整数が 1.0 に、0 が 0.0 に対応するように線形に変換されます。

インデックスを格納するマップ、すなわち GL_PIXEL_MAP_I_TO_IGL_PIXEL_MAP_S_TO_S は、小数点以下のビット数が未規定の固定小数点形式で値を保持します。glPixelMapfv で指定された浮動小数点値は、これらのマップの内部固定小数点形式に直接変換されます。glPixelMapusv および glPixelMapuiv で指定された符号なし整数値は、小数点以下がすべて 0 である整数値を指定します。

次の表に、各マップの初期サイズと初期値を示します。カラーインデックスまたはステンシルインデックスでインデックス付けされるマップは、ある n について mapsize = 2 ^ n でなければならず、そうでない場合の結果は未定義です。各マップに許容される最大サイズは実装に依存し、引数 GL_MAX_PIXEL_MAP_TABLE を指定して glGet を呼び出すことで取得できます。この単一の最大値はすべてのマップに適用され、少なくとも 32 です。

マップ ルックアップインデックス ルックアップ値 初期サイズ 初期値
GL_PIXEL_MAP_I_TO_I カラーインデックス カラーインデックス 1 0.0
GL_PIXEL_MAP_S_TO_S ステンシルインデックス ステンシルインデックス 1 0.0
GL_PIXEL_MAP_I_TO_R カラーインデックス R 1 0.0
GL_PIXEL_MAP_I_TO_G カラーインデックス G 1 0.0
GL_PIXEL_MAP_I_TO_B カラーインデックス B 1 0.0
GL_PIXEL_MAP_I_TO_A カラーインデックス A 1 0.0
GL_PIXEL_MAP_R_TO_R R R 1 0.0
GL_PIXEL_MAP_G_TO_G G G 1 0.0
GL_PIXEL_MAP_B_TO_B B B 1 0.0
GL_PIXEL_MAP_A_TO_A A A 1 0.0

glPixelMap に関連する情報は、次の関数で取得できます。

引数 GL_PIXEL_MAP_I_TO_I_SIZE を指定した glGet

引数 GL_PIXEL_MAP_S_TO_S_SIZE を指定した glGet

引数 GL_PIXEL_MAP_I_TO_R_SIZE を指定した glGet

引数 GL_PIXEL_MAP_I_TO_G_SIZE を指定した glGet

引数 GL_PIXEL_MAP_I_TO_B_SIZE を指定した glGet

引数 GL_PIXEL_MAP_I_TO_A_SIZE を指定した glGet

引数 GL_PIXEL_MAP_R_TO_R_SIZE を指定した glGet

引数 GL_PIXEL_MAP_G_TO_G_SIZE を指定した glGet

引数 GL_PIXEL_MAP_B_TO_B_SIZE を指定した glGet

引数 GL_PIXEL_MAP_A_TO_A_SIZE を指定した glGet

引数 GL_MAX_PIXEL_MAP_TABLE を指定した glGet

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

各言語での呼び出し定義

// OPENGL32.dll
#include <windows.h>

void glPixelMapusv(
    DWORD map,
    INT mapsize,
    const WORD* values
);
[DllImport("OPENGL32.dll", ExactSpelling = true)]
static extern void glPixelMapusv(
    uint map,   // DWORD
    int mapsize,   // INT
    ref ushort values   // WORD*
);
<DllImport("OPENGL32.dll", ExactSpelling:=True)>
Public Shared Sub glPixelMapusv(
    map As UInteger,   ' DWORD
    mapsize As Integer,   ' INT
    ByRef values As UShort   ' WORD*
)
End Sub
' map : DWORD
' mapsize : INT
' values : WORD*
Declare PtrSafe Sub glPixelMapusv Lib "opengl32" ( _
    ByVal map As Long, _
    ByVal mapsize As Long, _
    ByRef values As Integer)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

glPixelMapusv = ctypes.windll.opengl32.glPixelMapusv
glPixelMapusv.restype = None
glPixelMapusv.argtypes = [
    wintypes.DWORD,  # map : DWORD
    ctypes.c_int,  # mapsize : INT
    ctypes.POINTER(ctypes.c_ushort),  # values : WORD*
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('OPENGL32.dll')
glPixelMapusv = Fiddle::Function.new(
  lib['glPixelMapusv'],
  [
    -Fiddle::TYPE_INT,  # map : DWORD
    Fiddle::TYPE_INT,  # mapsize : INT
    Fiddle::TYPE_VOIDP,  # values : WORD*
  ],
  Fiddle::TYPE_VOID)
#[link(name = "opengl32")]
extern "system" {
    fn glPixelMapusv(
        map: u32,  // DWORD
        mapsize: i32,  // INT
        values: *const u16  // WORD*
    );
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("OPENGL32.dll")]
public static extern void glPixelMapusv(uint map, int mapsize, ref ushort values);
"@
$api = Add-Type -MemberDefinition $sig -Name 'OPENGL32_glPixelMapusv' -Namespace Win32 -PassThru
# $api::glPixelMapusv(map, mapsize, values)
#uselib "OPENGL32.dll"
#func global glPixelMapusv "glPixelMapusv" sptr, sptr, sptr
; glPixelMapusv map, mapsize, varptr(values)
; map : DWORD -> "sptr"
; mapsize : INT -> "sptr"
; values : WORD* -> "sptr"
出力引数:
#uselib "OPENGL32.dll"
#func global glPixelMapusv "glPixelMapusv" int, int, var
; glPixelMapusv map, mapsize, values
; map : DWORD -> "int"
; mapsize : INT -> "int"
; values : WORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; void glPixelMapusv(DWORD map, INT mapsize, WORD* values)
#uselib "OPENGL32.dll"
#func global glPixelMapusv "glPixelMapusv" int, int, var
; glPixelMapusv map, mapsize, values
; map : DWORD -> "int"
; mapsize : INT -> "int"
; values : WORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	opengl32 = windows.NewLazySystemDLL("OPENGL32.dll")
	procglPixelMapusv = opengl32.NewProc("glPixelMapusv")
)

// map (DWORD), mapsize (INT), values (WORD*)
r1, _, err := procglPixelMapusv.Call(
	uintptr(map),
	uintptr(mapsize),
	uintptr(values),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // void
procedure glPixelMapusv(
  map: DWORD;   // DWORD
  mapsize: Integer;   // INT
  values: Pointer   // WORD*
); stdcall;
  external 'OPENGL32.dll' name 'glPixelMapusv';
result := DllCall("OPENGL32\glPixelMapusv"
    , "UInt", map   ; DWORD
    , "Int", mapsize   ; INT
    , "Ptr", values   ; WORD*
    , "Int")   ; return: void
●glPixelMapusv(map, mapsize, values) = DLL("OPENGL32.dll", "int glPixelMapusv(dword, int, void*)")
# 呼び出し: glPixelMapusv(map, mapsize, values)
# map : DWORD -> "dword"
# mapsize : INT -> "int"
# values : WORD* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "opengl32" fn glPixelMapusv(
    map: u32, // DWORD
    mapsize: i32, // INT
    values: [*c]u16 // WORD*
) callconv(std.os.windows.WINAPI) void;
proc glPixelMapusv(
    map: uint32,  # DWORD
    mapsize: int32,  # INT
    values: ptr uint16  # WORD*
) {.importc: "glPixelMapusv", stdcall, dynlib: "OPENGL32.dll".}
pragma(lib, "opengl32");
extern(Windows)
void glPixelMapusv(
    uint map,   // DWORD
    int mapsize,   // INT
    ushort* values   // WORD*
);
ccall((:glPixelMapusv, "OPENGL32.dll"), stdcall, Cvoid,
      (UInt32, Int32, Ptr{UInt16}),
      map, mapsize, values)
# map : DWORD -> UInt32
# mapsize : INT -> Int32
# values : WORD* -> Ptr{UInt16}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
void glPixelMapusv(
    uint32_t map,
    int32_t mapsize,
    uint16_t* values);
]]
local opengl32 = ffi.load("opengl32")
-- opengl32.glPixelMapusv(map, mapsize, values)
-- map : DWORD
-- mapsize : INT
-- values : WORD*
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('OPENGL32.dll');
const glPixelMapusv = lib.func('__stdcall', 'glPixelMapusv', 'void', ['uint32_t', 'int32_t', 'uint16_t *']);
// glPixelMapusv(map, mapsize, values)
// map : DWORD -> 'uint32_t'
// mapsize : INT -> 'int32_t'
// values : WORD* -> 'uint16_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("OPENGL32.dll", {
  glPixelMapusv: { parameters: ["u32", "i32", "pointer"], result: "void" },
});
// lib.symbols.glPixelMapusv(map, mapsize, values)
// map : DWORD -> "u32"
// mapsize : INT -> "i32"
// values : WORD* -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
void glPixelMapusv(
    uint32_t map,
    int32_t mapsize,
    uint16_t* values);
C, "OPENGL32.dll");
// $ffi->glPixelMapusv(map, mapsize, values);
// map : DWORD
// mapsize : INT
// values : WORD*
// 構造体/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 Opengl32 extends StdCallLibrary {
    Opengl32 INSTANCE = Native.load("opengl32", Opengl32.class);
    void glPixelMapusv(
        int map,   // DWORD
        int mapsize,   // INT
        ShortByReference values   // WORD*
    );
}
@[Link("opengl32")]
lib LibOPENGL32
  fun glPixelMapusv = glPixelMapusv(
    map : UInt32,   # DWORD
    mapsize : Int32,   # INT
    values : UInt16*   # WORD*
  ) : Void
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef glPixelMapusvNative = Void Function(Uint32, Int32, Pointer<Uint16>);
typedef glPixelMapusvDart = void Function(int, int, Pointer<Uint16>);
final glPixelMapusv = DynamicLibrary.open('OPENGL32.dll')
    .lookupFunction<glPixelMapusvNative, glPixelMapusvDart>('glPixelMapusv');
// map : DWORD -> Uint32
// mapsize : INT -> Int32
// values : WORD* -> Pointer<Uint16>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
procedure glPixelMapusv(
  map: DWORD;   // DWORD
  mapsize: Integer;   // INT
  values: Pointer   // WORD*
); stdcall;
  external 'OPENGL32.dll' name 'glPixelMapusv';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "glPixelMapusv"
  c_glPixelMapusv :: Word32 -> Int32 -> Ptr Word16 -> IO ()
-- map : DWORD -> Word32
-- mapsize : INT -> Int32
-- values : WORD* -> Ptr Word16
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let glpixelmapusv =
  foreign "glPixelMapusv"
    (uint32_t @-> int32_t @-> (ptr uint16_t) @-> returning void)
(* map : DWORD -> uint32_t *)
(* mapsize : INT -> int32_t *)
(* values : WORD* -> (ptr uint16_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library opengl32 (t "OPENGL32.dll"))
(cffi:use-foreign-library opengl32)

(cffi:defcfun ("glPixelMapusv" gl-pixel-mapusv :convention :stdcall) :void
  (map :uint32)   ; DWORD
  (mapsize :int32)   ; INT
  (values :pointer))   ; WORD*
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $glPixelMapusv = Win32::API::More->new('OPENGL32',
    'void glPixelMapusv(DWORD map, int mapsize, LPVOID values)');
# my $ret = $glPixelMapusv->Call($map, $mapsize, $values);
# map : DWORD -> DWORD
# mapsize : INT -> int
# values : WORD* -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。