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

D2D1Vec3Length

関数
三次元ベクトルの長さを算出する。
DLLd2d1.dll呼出規約winapi

シグネチャ

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

FLOAT D2D1Vec3Length(
    FLOAT x,
    FLOAT y,
    FLOAT z
);

パラメーター

名前方向説明
xFLOATin3次元ベクトルのX成分。
yFLOATin3次元ベクトルのY成分。
zFLOATin3次元ベクトルのZ成分。

戻り値の型: FLOAT

各言語での呼び出し定義

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

FLOAT D2D1Vec3Length(
    FLOAT x,
    FLOAT y,
    FLOAT z
);
[DllImport("d2d1.dll", ExactSpelling = true)]
static extern float D2D1Vec3Length(
    float x,   // FLOAT
    float y,   // FLOAT
    float z   // FLOAT
);
<DllImport("d2d1.dll", ExactSpelling:=True)>
Public Shared Function D2D1Vec3Length(
    x As Single,   ' FLOAT
    y As Single,   ' FLOAT
    z As Single   ' FLOAT
) As Single
End Function
' x : FLOAT
' y : FLOAT
' z : FLOAT
Declare PtrSafe Function D2D1Vec3Length Lib "d2d1" ( _
    ByVal x As Single, _
    ByVal y As Single, _
    ByVal z As Single) As Single
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

D2D1Vec3Length = ctypes.windll.d2d1.D2D1Vec3Length
D2D1Vec3Length.restype = ctypes.c_float
D2D1Vec3Length.argtypes = [
    ctypes.c_float,  # x : FLOAT
    ctypes.c_float,  # y : FLOAT
    ctypes.c_float,  # z : FLOAT
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('d2d1.dll')
D2D1Vec3Length = Fiddle::Function.new(
  lib['D2D1Vec3Length'],
  [
    Fiddle::TYPE_FLOAT,  # x : FLOAT
    Fiddle::TYPE_FLOAT,  # y : FLOAT
    Fiddle::TYPE_FLOAT,  # z : FLOAT
  ],
  Fiddle::TYPE_FLOAT)
#[link(name = "d2d1")]
extern "system" {
    fn D2D1Vec3Length(
        x: f32,  // FLOAT
        y: f32,  // FLOAT
        z: f32  // FLOAT
    ) -> f32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("d2d1.dll")]
public static extern float D2D1Vec3Length(float x, float y, float z);
"@
$api = Add-Type -MemberDefinition $sig -Name 'd2d1_D2D1Vec3Length' -Namespace Win32 -PassThru
# $api::D2D1Vec3Length(x, y, z)
#uselib "d2d1.dll"
#func global D2D1Vec3Length "D2D1Vec3Length" float, float, float
; D2D1Vec3Length x, y, z   ; 戻り値は stat
; x : FLOAT -> "float"
; y : FLOAT -> "float"
; z : FLOAT -> "float"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "d2d1.dll"
#cfunc global D2D1Vec3Length "D2D1Vec3Length" float, float, float
; res = D2D1Vec3Length(x, y, z)
; x : FLOAT -> "float"
; y : FLOAT -> "float"
; z : FLOAT -> "float"
; FLOAT D2D1Vec3Length(FLOAT x, FLOAT y, FLOAT z)
#uselib "d2d1.dll"
#cfunc global D2D1Vec3Length "D2D1Vec3Length" float, float, float
; res = D2D1Vec3Length(x, y, z)
; x : FLOAT -> "float"
; y : FLOAT -> "float"
; z : FLOAT -> "float"
import (
	"math"
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	d2d1 = windows.NewLazySystemDLL("d2d1.dll")
	procD2D1Vec3Length = d2d1.NewProc("D2D1Vec3Length")
)

// x (FLOAT), y (FLOAT), z (FLOAT)
r1, _, err := procD2D1Vec3Length.Call(
	uintptr(math.Float32bits(x)),
	uintptr(math.Float32bits(y)),
	uintptr(math.Float32bits(z)),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // FLOAT
// 注意: float/double 引数は proc.Call では XMM レジスタに渡せません。
// windows.SyscallN(proc.Addr(), math.Float64bits(x), ...) もしくは cgo を使用してください。
function D2D1Vec3Length(
  x: Single;   // FLOAT
  y: Single;   // FLOAT
  z: Single   // FLOAT
): Single; stdcall;
  external 'd2d1.dll' name 'D2D1Vec3Length';
result := DllCall("d2d1\D2D1Vec3Length"
    , "Float", x   ; FLOAT
    , "Float", y   ; FLOAT
    , "Float", z   ; FLOAT
    , "Float")   ; return: FLOAT
●D2D1Vec3Length(x, y, z) = DLL("d2d1.dll", "float D2D1Vec3Length(float, float, float)")
# 呼び出し: D2D1Vec3Length(x, y, z)
# x : FLOAT -> "float"
# y : FLOAT -> "float"
# z : FLOAT -> "float"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "d2d1" fn D2D1Vec3Length(
    x: f32, // FLOAT
    y: f32, // FLOAT
    z: f32 // FLOAT
) callconv(std.os.windows.WINAPI) f32;
proc D2D1Vec3Length(
    x: float32,  # FLOAT
    y: float32,  # FLOAT
    z: float32  # FLOAT
): float32 {.importc: "D2D1Vec3Length", stdcall, dynlib: "d2d1.dll".}
pragma(lib, "d2d1");
extern(Windows)
float D2D1Vec3Length(
    float x,   // FLOAT
    float y,   // FLOAT
    float z   // FLOAT
);
ccall((:D2D1Vec3Length, "d2d1.dll"), stdcall, Float32,
      (Float32, Float32, Float32),
      x, y, z)
# x : FLOAT -> Float32
# y : FLOAT -> Float32
# z : FLOAT -> Float32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
float D2D1Vec3Length(
    float x,
    float y,
    float z);
]]
local d2d1 = ffi.load("d2d1")
-- d2d1.D2D1Vec3Length(x, y, z)
-- x : FLOAT
-- y : FLOAT
-- z : FLOAT
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('d2d1.dll');
const D2D1Vec3Length = lib.func('__stdcall', 'D2D1Vec3Length', 'float', ['float', 'float', 'float']);
// D2D1Vec3Length(x, y, z)
// x : FLOAT -> 'float'
// y : FLOAT -> 'float'
// z : FLOAT -> 'float'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("d2d1.dll", {
  D2D1Vec3Length: { parameters: ["f32", "f32", "f32"], result: "f32" },
});
// lib.symbols.D2D1Vec3Length(x, y, z)
// x : FLOAT -> "f32"
// y : FLOAT -> "f32"
// z : FLOAT -> "f32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
float D2D1Vec3Length(
    float x,
    float y,
    float z);
C, "d2d1.dll");
// $ffi->D2D1Vec3Length(x, y, z);
// x : FLOAT
// y : FLOAT
// z : FLOAT
// 構造体/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 D2d1 extends StdCallLibrary {
    D2d1 INSTANCE = Native.load("d2d1", D2d1.class);
    float D2D1Vec3Length(
        float x,   // FLOAT
        float y,   // FLOAT
        float z   // FLOAT
    );
}
@[Link("d2d1")]
lib Libd2d1
  fun D2D1Vec3Length = D2D1Vec3Length(
    x : Float32,   # FLOAT
    y : Float32,   # FLOAT
    z : Float32   # FLOAT
  ) : Float32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef D2D1Vec3LengthNative = Float Function(Float, Float, Float);
typedef D2D1Vec3LengthDart = double Function(double, double, double);
final D2D1Vec3Length = DynamicLibrary.open('d2d1.dll')
    .lookupFunction<D2D1Vec3LengthNative, D2D1Vec3LengthDart>('D2D1Vec3Length');
// x : FLOAT -> Float
// y : FLOAT -> Float
// z : FLOAT -> Float
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function D2D1Vec3Length(
  x: Single;   // FLOAT
  y: Single;   // FLOAT
  z: Single   // FLOAT
): Single; stdcall;
  external 'd2d1.dll' name 'D2D1Vec3Length';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "D2D1Vec3Length"
  c_D2D1Vec3Length :: CFloat -> CFloat -> CFloat -> IO CFloat
-- x : FLOAT -> CFloat
-- y : FLOAT -> CFloat
-- z : FLOAT -> CFloat
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let d2d1vec3length =
  foreign "D2D1Vec3Length"
    (float @-> float @-> float @-> returning float)
(* x : FLOAT -> float *)
(* y : FLOAT -> float *)
(* z : FLOAT -> float *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library d2d1 (t "d2d1.dll"))
(cffi:use-foreign-library d2d1)

(cffi:defcfun ("D2D1Vec3Length" d2-d1-vec3-length :convention :stdcall) :float
  (x :float)   ; FLOAT
  (y :float)   ; FLOAT
  (z :float))   ; FLOAT
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $D2D1Vec3Length = Win32::API::More->new('d2d1',
    'float D2D1Vec3Length(float x, float y, float z)');
# my $ret = $D2D1Vec3Length->Call($x, $y, $z);
# x : FLOAT -> float
# y : FLOAT -> float
# z : FLOAT -> float
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。