ScnLib_SetWebcamResolution()

ScnLib_SetWebcamResolution()

标准版专业版超级版至尊版
C++ __declspec(dllimport) void __stdcall ScnLib_SetWebcamResolution(int nWidth, int nHeight);
C# [DllImport("ScnLib.dll")] public static extern void ScnLib_SetWebcamResolution(int Width, int Height);
Basic Public Declare Sub ScnLib_SetWebcamResolution Lib "ScnLib.dll" (ByVal Width As Int32, ByVal Height As Int32)
Delphi procedure ScnLib_SetWebcamResolution(Width: Integer; Height: Integer); stdcall; external 'ScnLib.dll';
  • 描述
    设置摄像头的首选分辨率。

  • 参数
    • Width [in]
      摄像头的宽度。设置为0以提示SDK自适应选择摄像头的分辨率。
    • Height [in]
      摄像头的高度。设置为0以提示SDK自适应选择摄像头的分辨率。
  • 返回值
    无。

  • 备注
    调用此函数来设置摄像头的首选分辨率。通常,摄像头支持多种分辨率(例如320x240、400x300、512x384、640x480、800x600、1024x768、1280x720、1920x1080等)、帧速率(例如5fps、10fps、15fps、20fps、30fps、60fps等)和帧格式(例如RGB、YUV、MJPEG、H.264、H.265等)。为用户提供这些众多选项组合来选择可能会令人困惑,可能导致糟糕的体验。因此,SDK通过自动选择合适的分辨率、fps和帧格式组合来简化此过程。

    默认情况下,WidthHeight都设置为0。这会提示SDK自适应选择摄像头的分辨率。在这种情况下,SDK会选择最接近或匹配摄像头视图大小的分辨率。例如,如果视图大小设置为320x240(SDK的默认值),SDK将选择320x240的分辨率(如果支持)。如果不支持,它将选择支持的最接近的分辨率,例如400x300。如果录制视频的帧速率设置为30fps(SDK的默认值),SDK将选择30fps的帧速率(如果支持)。如果不支持,它将选择支持的最接近的帧速率,例如20fps。SDK优先选择RGB帧格式,除非有更好的帧格式,如MJPEG、H.264或H.265可用。帧格式选择优先级顺序为MJPEG、H.264、H.265、RGB、YUV。

    如果您为WidthHeight或两者之一指定非零值,SDK将其视为您的首选分辨率,并选择支持的最接近的分辨率,而不考虑摄像头视图大小设置。这对于创建高分辨率的全摄像头视频特别有用。

    在仅摄像头录制模式下,摄像头视图大小等同于视频图像大小。对于带有摄像头小视图的屏幕录制模式,可以调用ScnLib_SetWebcamViewSize()设置摄像头视图大小。请记住,更高的摄像头分辨率会带来更清晰的视图,但会增加录制负担。要检测当前摄像头的实际分辨率,请调用ScnLib_GetWebcamResolution()

  • 参见
    ScnLib_PreviewWebcam()
    ScnLib_GetWebcamResolution()
    ScnLib_SetWebcamViewSize()

下载 SDK API 总览