mfcam_open_ex

任意フォーマット指定でカメラを開く

mfcam_open_ex p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12

p1=0~      : デバイスインデックス
p2         : 親 HWND
p3,p4,p5,p6: 表示位置 x,y,w,h
p7=0~      : 望む解像度 width (0=デフォルト)
p8=0~      : 望む解像度 height (0=デフォルト)
p9=0~      : 望む fps 分子 (0=デフォルト, 例 30)
p10=0~     : 望む fps 分母 (0=デフォルト, 例 1)
p11        : 取得解像度 width (out)
p12        : 取得解像度 height (out)

(プラグイン / モジュール : hspmfcam.dll)

解説

mfcam_open と同じだが、解像度と fps を指定して open できます。
内部では mfcam_format_get で得られる native フォーマット中、
desired_w/h/fps に最も近い type を選択 → 出力 RGB32 に変換します。

戻り値: ハンドル / -1 失敗

関連項目

mfcam_openカメラを開いて子ウィンドウにプレビュー表示(hspmfcam.dll)
mfcam_format_countカメラ対応フォーマット数(hspmfcam.dll)

情報

プラグイン / モジュールhspmfcam.dll
バージョン1.0
作成日2026-04-14
著作者IronHSP / hspmfcam
URLhttps://github.com/inovia/IronHSP
備考hspmfcam.dll は Microsoft Media Foundation (MF) を直接ラップして、
Webcam や仮想カメラ (OBS/NDI)、キャプチャカード (Magewell/Elgato/Blackmagic)
からの映像取り込み・録画を 1 行で行えるようにする C++ 製ヘルパ DLL です。

特徴:
- 内部で worker thread + child window を作成 (MFPlay と同じ方式)
- HSP main thread が title bar drag 等で停止しても映像は止まらない
- 最大 256 デバイスを同時に open 可能
- 自動デインターレース (キャプチャカードの 1080i 等にも対応)
- PNG/JPEG/BMP/GIF/TIFF スナップショット保存 (WIC)
- H.264/HEVC/WMV9/VP9/MJPG 録画 + AAC/WMA/FLAC/MP3 同時録音
- カメラプロパティ (明るさ/露出/フォーカス等) アクセス

HSP 側からは package/win32/common/iron_camera_mf.hsp を include して
iron_cam_* 系のラッパ命令で扱うのが推奨です (raw API は mfcam_* 系)。
タイプ拡張命令
グループhspmfcam ― open / close
対応環境
  • その他 : Win32 / Win64
hs ファイルhsphelp\hspmfcam.hs