3.4 BCAP_CONFIG 구조체

BCL의 동영상 인코딩 설정을 위한 구조체 입니다. 이 구조체는 파일 형식, 비디오 속성, 오디오 속성 등의 정보를 포함합니다.

참고 : BCapConfigPreset()함수를 사용하여 간편하게 BCAP_CONFIG 구조체를 설정할 수도 있습니다. (section 3.5 참고)

struct BCAP_CONFIG
{
    // 기본 설정 
    INT   FileType;              // 저장될 파일의 타입(F_AVI)
  
    // 비디오 설정 
    INT   VideoSizeW;            // 비디오 가로크기 
    INT   VideoSizeH;            // 비디오 세로크기 
    FLOAT VideoFPS;              // 초당 프레임 수 
    
    DWORD VideoCodec;            // 비디오 코덱(FOURCC) 
    INT   VideoRateControl;      // CBR, VBR 
    INT   VideoKBitrate;         // 10k ~ 50000k (VBR일때는 이값은 무시) 
    INT   VideoQuality;          // 30 ~ 100     (CBR일때는 이값은 무시) 
    INT   VideoKeyframeInterval; // 0 ~ 1000 frames
  
    // 오디오 설정 
    INT   AudioChannels;         // 1: mono, 2:stereo 
    INT   AudioSampleRate;       // 샘플레이트 
    
    INT   AudioCodec;            // 오디오 코덱(Wave Tag) 
    INT   AudioRateControl;      // CBR, VBR 
    INT   AudioKBitrate;         // 32k ~ 320k 
    INT   AudioQuality;          // 30 ~ 100 
  
    // 로고 설정
    WCHAR LogoPath[MAX_PATH];    // 로고 파일 경로 (32bit png)
    INT   LogoAlpha;             // 로고 투명도 [0 ~ 100]%
    INT   LogoPosX;              // 로고 가로 위치 [0 ~ 100]%
    INT   LogoPosY;              // 로고 세로 위치 [0 ~ 100]%
    INT   LogoSizeW;             // 로고 가로 크기 [0 ~ 999]%
    INT   LogoSizeH;             // 로고 세로 위치 [0 ~ 999]%

    // 녹화 자동 종료 설정
    INT   AutoCompleteType;      // 녹화 자동 완료 방식
    INT   AutoCompleteValue;     // 녹화 자동 완료 변수(초 or MB)

    // 기타
    RECT  CaptureRect;           // 캡처 대상 영역
    
    BOOL  IncludeCursor;         // 녹화된 영상에 마우스 커서도 포함시킬지 여부 결정
    BOOL  AdjustAudioMixer;      // 원활한 소리 캡처를 위해 오디오 믹서 설정을 
                                 // 자동으로 변경할지 여부 결정(스테레오 믹스 조절)
    BOOL  SaveAudioTracksAsWav;  // 오디오 트랙을 WAV 파일로 저장하기
};

INT FileType
저장될 파일의 형식을 지정합니다. 현재는 AVI 형식(F_AVI)만 지원합니다.
INT VideoSizeW
비디오 픽셀 단위 가로 크기를 지정합니다. 0으로 지정할 경우 축소/확대 없이 원본크기를 그대로 사용합니다. -1로 지정할 경우 원본크기의 1/2로 가로 크기를 지정합니다.

주의 : 가로 크기를 0 이나 -1로 설정할 경우 세로크기도 동일한 값으로 설정해야 합니다.

범위 : -1 ~ 2560

기본값 : 0

INT VideoSizeH
비디오 픽셀 단위 세로 크기를 지정합니다. 0으로 지정할 경우 축소/확대 없이 원본크기를 그대로 사용합니다. -1로 지정할 경우 원본크기의 1/2로 가로 크기를 지정합니다.

주의 : 가로 크기를 0이나 -1로 설정할 경우 세로크기도 동일한 값으로 설정해야 합니다.

범위 : -1 ~ 1600

기본값 : 0

FLOAT VideoFPS
영상의 초당 프레임 수를 지정합니다. 보통 고화질 영상의 경우 30fps가 주로 사용됩니다. 320x240 정도로 영상이 작은 크기인 경우 15fps 정도의 값도 적당합니다.

참고 : 보통 극장용 영화는 24fps를 사용하며, NTSC TV의 경우 원래 인터레이스모드에서 30fps를(PAL의 경우는 25fps) 사용하도록 설계되었지만, 나중에 부가정보를 처리하기위해서 시그널의 일부를 다른 용도로 사용하면서 29.97fps가 NTSC의 표준이 되었습니다. 따라서, PC용 영상의 경우 굳이 29.97fPS를 사용할 필요는 없으며, 30fps가 적당한 값이라고 생각됩니다.

범위 : 10.0 fps ~ 120.0 fps

기본값 : 30.0 fps

DWORD VideoCodec
비디오 코덱(FOURCC)을 지정합니다. bandicap.h에 정의된 FOURCC_MPEG, FOURCC_MJPG 이나 FOURCC_MP4V 등을 사용하면 됩니다.

FOURCC_MPEG

MPEG1 코덱을 사용하여 영상을 인코딩 합니다. 이 코덱은 Windows 에서 기본으로 제공되지 않기 때문에 재생 및 편집 작업을 위해서는 반디캠컴퍼니에서 제공하는 코덱을 설치해야 합니다. 그러나 MJPG에 비해 동일 화질 대비 평균 3배 이상의 월등한 압축 성능을 보장합니다.

FOURCC_MJPG

Motion JPEG 코덱을 사용하여 영상을 인코딩 합니다. Motion JPEG으로 인코딩할 경우, 인코딩된 동영상은 시스템에 별도의 코덱이 설치되어 있지 않아도 미디어 플레이어나 동영상 편집프로그램에서 바로 읽어들일 수 있으므로, 홍보용 영상을 만들기 위해서 영상을 편집할때에 사용하면 좋습니다.

FOURCC_MP4V

MPEG4 코덱을 사용하여 영상을 인코딩 합니다. MJPEG에 비하여 동일화질 대비 파일의 크기가 작으므로 일반적인 동영상 캡처 작업에 적합합니다.

FOURCC_ARGB

ARGB(32bit DIB) 형식으로 영상을 저장 합니다. (ARGB는 무손실/무압축 데이터 형식입니다.) 알파 채널이 포함된 Surface를 캡처할 경우(DirectX9만 해당), 알파 정보도 함께 저장가능 합니다.

FOURCC_RGB24

RGB24(24bit DIB) 형식으로 영상을 저장 합니다. (RGB24는 무손실/무압축 데이터 형식입니다.)

FOURCC_YV12

YV12(12bit DIB) 형식으로 영상을 저장 합니다. (YV12는 손실/무압축 데이터 형식입니다.)

FOURCC_H264_APP

H.264 코덱을 사용하여 영상을 인코딩합니다. 하드웨어 가속 없이 CPU만 사용하여 인코딩합니다.

FOURCC_H264_APP

H.264 코덱을 사용하여 영상을 인코딩합니다. 인코딩시 AMD사의 APP 하드웨어 가속을 이용하며, IBandiCapture::IsSupportedVideoCodec() 에서 지원 여부를 검사할 수 있습니다. section 3.2.19

FOURCC_H264_SYNC

H.264 코덱을 사용하여 영상을 인코딩합니다. 인코딩시 Intel사의 QuickSync Video 하드웨어 가속을 이용하며, IBandiCapture::IsSupportedVideoCodec() 에서 지원 여부를 검사할 수 있습니다. section 3.2.19

FOURCC_H264_CUDA

H.264 코덱을 사용하여 영상을 인코딩합니다. 인코딩시 NVIDIA사의 CUDA 하드웨어 가속을 이용하며, IBandiCapture::IsSupportedVideoCodec() 에서 지원 여부를 검사할 수 있습니다. section 3.2.19

FOURCC_H264_NVEN

H.264 코덱을 사용하여 영상을 인코딩합니다. 인코딩시 NVIDIA사의 NVENC 하드웨어 인코더를 이용하며, IBandiCapture::IsSupportedVideoCodec() 에서 지원 여부를 검사할 수 있습니다. section 3.2.19

FOURCC_AUTO

현재 시스템에 적합한 최적의 코덱을 자동 선택합니다. IBandiCapture::GetSuggestedVideoCodec() 를 참고하세요. section 3.2.18

주의 : FOURCC_MJPG의 경우 비트레이트 제어 방식이 항상 VBR로 동작합니다. 즉, VideoRateControl 변수의 값을 무시합니다.

기본값 : FOURCC_AUTO

INT VideoRateControl
영상의 비트레이트 제어 방식을 지정합니다.

V_CBR

CBR(Constant Bitrate) 로 영상을 인코딩합니다. CBR방식은 영상의 내용에 상관없이 처음부터 끝까지 ‘VideoKBitrate’ 변수에 의해 지정된 비트레이트로 균등하게 인코딩하는 방식입니다.

V_VBR

VBR(Variable Bitrate) 로 영상을 인코딩합니다. VBR방식은 영상의 내용에 따라서 비트레이트를 가변적으로 할당합니다. 즉, ‘VideoQuality’ 변수에 의해 지정된 화질을 유지하며 인코딩할 수 있는 방식입니다.

예를 들자면, 영화에서 화면이 깜깜하고 소리만 나오는 장면이라던가, 화면의 움직임이 거의 없는 장면일 경우 정보량이 매우 적기 때문에 비트레이트를 적게 할당하여도 화면의 화질이 나쁘지 않습니다. 반대로, 액션장면에서는 정보량이 많기 때문에, 비트레이트를 많이 할당하지 않으면 화면에 깍두기 현상이 발생합니다. 일반적으로 VBR이 CBR보다 동일용량 대비 더 좋은 화질을 보장합니다만, 비트레이트가 영상의 내용에 따라서 변하므로 결과물의 크기를 예측하기 힘들다는 단점이 있습니다.

주의 : V_CBR 방식에서는 ‘VideoQuality’의 값이, V_VBR 방식에서는 ‘VideoKBitrate’의 값이 무시됩니다.

기본값 : V_VBR

INT VideoKBitrate
영상의 비트레이트값을 지정하며, 단위는 KBit 입니다. VideoRateControl가 V_CBR일 경우에만 유효하며, V_VBR일 경우 이 값은 무시됩니다.

범위 : 10 ~ 50000

기본값 : 1024

INT VideoQuality
영상의 화질을 지정합니다. VideoRateControl가 V_VBR일 경우에만 유효하며, V_CBR일 경우 이 값은 무시됩니다. 유효한 값의 범위는 1 부터 100까지 이며, 숫자가 높을수록 고화질을 의미합니다.

일반적으로 80전후의 값을 지정하면 고화질의 영상을 얻을수 있습니다. 화질을 100으로 설정할 경우 결과물의 크기가 지나치게 커질 수 있으므로 사용에 주의하셔야 하며, 고화질의 영상을 얻고자 할 경우 95정도의 값으로 설정하시기 바랍니다.

범위 : 1 ~ 100

기본값 : 90

INT VideoKeyframeInterval
영상의 키프레임 간격을 지정합니다. 지정된 값에 따라서 매 몇번째 비디오 프레임이 키프임이 될것인지를 결정합니다.

주의 : VideoCodec 이 FOURCC_MJPG 일 경우에는 이 값은 무시됩니다.

범위 : 1 ~ 1000

기본값 : 150

INT AudioChannels
오디오의 채널수를 지정합니다. 모노 출력을 사용할경우는 1, 스테레오 출력을 사용할 경우는 2를 사용합니다.

범위 : 1 ~ 2

기본값 : 2

INT AudioSampleRate
오디오 샘플레이트를 지정합니다. CD음질의 캡처를 원할 경우는 48K(48000)를 지정하고, WAVETAG_PCM 코덱 사용시 용량을 줄이고자 할때는 24K(24000)을 사용하면 적당합니다.

범위 : 8000 ~ 48000

기본값 : 44100

INT AudioCodec
오디오의 코덱 종류를 지정합니다. PCM 과 MP2 코덱을 선택할 수 있습니다.

WAVETAG_MP2

MP2(MPEG-1 Layer 2) 코덱으로 오디오 데이터를 저장합니다. 이 코덱은 Windows 에서 기본으로 제공되지 않기 때문에 재생 및 편집 작업을 위해서는 반디캠컴퍼니에서 제공하는 코덱을 설치해야 합니다.

WAVETAG_PCM

PCM 형식의 비압축 오디오 데이터로 저장합니다. 압축을 하지 않기 때문에 매우 큰 용량의 오디오 데이터를 저장해야 한다는 단점이 있습니다.

기본값 : WAVETAG_MP2

INT AudioRateControl
오디오의 비트레이트 결정방식을 지정합니다. 현재는 A_CBR 만 사용합니다.

기본값 : A_CBR

INT AudioKBitrate
오디오의 비트레이트를 지정하며 단위는 KBit 입니다. 이 설정은 WAVETAG_MP2 코덱 사용시에만 유효합니다.

기본값 : 192

INT AudioQuality
오디오 압축시 사용할 알고리즘의 품질을 지정합니다. 현재 이 값은 사용되지 않으며, 기본값은 30입니다.

기본값 : 30

WCHAR LogoPath[MAX_PATH]
출력할 로고파일(32bit-PNG)의 경로를 지정합니다. 이 값이 Null-String("\0")일 경우에는 로고가 출력되지 않습니다.

주의 : 로고파일은 알파채널이 포함된 32bit-PNG 포멧만 사용가능합니다.

기본값 : Null-String("\0")

INT LogoAlpha
출력될 로고의 투명도를 지정합니다. (0% : 불투명, 100% : 투명)

범위 : 0 ~ 100

기본값 : 100

INT LogoPosX
출력될 로고의 가로 위치를 지정합니다. (0% : 왼쪽, 50% : 중앙, 100% : 오른쪽)

범위 : 0 ~ 100

기본값 : 50

INT LogoPosY
출력될 로고의 세로 위치를 지정합니다. (0% : 위, 50% : 중앙, 100% : 아래)

범위 : 0 ~ 100

기본값 : 100

INT LogoSizeW
출력될 로고의 가로 크기를 지정합니다. (50% : 절반 크기, 100% : 원래 크기, 200% : 두배 크기)

범위 : 0 ~ 999

기본값 : 100

INT LogoSizeH
출력될 로고의 세로 크기를 지정합니다. (50% : 절반 크기, 100% : 원래 크기, 200% : 두배 크기)

범위 : 0 ~ 999

기본값 : 100

INT AutoCompleteType
녹화 자동 완료 방식을 지정합니다. (BY_NONE, BY_TIME, BY_SIZE)

기본값 : BY_NONE

INT AutoCompleteValue
녹화 자동 완료 변수를 지정합니다. (초 or MB)
RECT CaptureRect
캡처 대상의 특정 영역을 결정합니다. 녹화 대상이 되는 화면의 특정 부분만 녹화하고자 할 때 사용합니다.
BOOL IncludeCursor
녹화된 영상에 마우스 커서 이미지를 포함시킬지 여부를 결정합니다.
BOOL AdjustAudioMixer
원활한 소리 캡처를 위해 오디오 입력 믹서 설정을 자동으로 변경할지 여부를 결정합니다. 오디오 입력 믹서(스테레오 믹서 등등)를 활성화 시키고 볼륨값이 너무 작은 경우 적당한 값으로 조절해 줍니다.
BOOL SaveAudioTracksAsWav
오디오 트랙을 WAV 파일로 추가 저장할지 여부를 결정합니다.

Copyright(C) 2008-2017 Bandicam.com, https://www.bandicam.com
Bandi Capture Library 2.5.0.250 created : 2017-02-03 오후 3:34:51