BCM70012 Module

From LEXWiKi

(Difference between revisions)
Jump to: navigation, search
(New page: Category:AllowPages == DPC Module Spec == == The Sample code source you can download form == Source file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/DPC_release/Windows_base...)
Current revision (14:29, 25 February 2022) (edit) (undo)
(→The Sample code source you can download form)
 
(20 intermediate revisions not shown.)
Line 1: Line 1:
[[Category:AllowPages]]
[[Category:AllowPages]]
-
== DPC Module Spec ==
 
- 
== The Sample code source you can download form ==
== The Sample code source you can download form ==
-
Source file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/DPC_release/Windows_base/DPC_v2.7w_src.rar DPC_v2.7w_src.rar]
+
Source file:
-
Binary file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/DPC_release/Windows_base/DPC_v2.7w_bin.rar DPC_v2.7w_bin.rar]
+
<Google Drive> [https://drive.google.com/file/d/1AV2OqWmNN6uvW6uN9A2Jgmxla1ZVcsUW/view?usp=sharing BCM70012_Demo_Src]
-
== How to use the DEMO application ==
+
<FTP> [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/BCM70012/BCM70012_Demo_Src.zip BCM70012_Demo_Src]
-
[[Image:DPC_AP_1.jpg]]<br />
+
-
1. When double click "DPC v2.5w.exe",it will hide and show in the notification area.
 
-
[[Image:DPC_AP1.jpg]]<br />
+
Reference Document:
 +
 +
<Google Drive> [https://docs.google.com/document/d/1aI9DiWCaqHH4pw3PNregS11AvQ19zj-b/edit?usp=sharing&ouid=111648310704855777934&rtpof=true&sd=true BCMSDK.doc]
-
2. Frequency of panel selection
+
<FTP> [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/BCM70012/About%20BCMSDK.doc BCMSDK.doc]
-
3. Confirm the panel which selected
 
-
4. If you choose to save panel , you need not to select panel again next time.
+
The procedure should do before build the source file :
 +
 +
1. download and install the <Google Drive> [https://drive.google.com/file/d/1vxdCdL9G7xg6OHvqhNasqDR_N9-J9MVq/view?usp=sharing DXSDK] / <FTP> [ftp://ftp.lex.com.tw/Engineer/SoftSupport/Software_Developer%27s_Kit/Microsoft/DirectX%20SDK/dx90bsdk.exe DXSDK]
 +
 +
2. build the BaseClasses(both Debug and Release):
 +
the path : DXSDK\Samples\C++\DirectShow\BaseClasses
 +
 +
3. add the include file and library file in Tools -> Options -> Pprojects -> VC++ Directories:
 +
(Suppose DXSDK install in C:\)
 +
 +
Include files :
 +
C:\DXSDK\Include
 +
C:\DXSDK\Samples\C++\DirectShow\BaseClasses
 +
C:\DXSDK\Samples\C++\Common\Include
 +
 +
Library files :
 +
C:\DXSDK\Lib
 +
C:\DXSDK\Samples\C++\DirectShow\BaseClasses\Debug
 +
C:\DXSDK\Samples\C++\DirectShow\BaseClasses\Release
 +
 +
4. After build , should install the driver in the BCM70012_Demo_Bin.rar first. Adn then you can execute the AP which you build.
-
5. If you install DPC v2.7w , it will autorun when start Windows XP.
+
Binary file:
-
6. If you don't want to use DPC anymore , you can uninstall it.
+
<Google Drive> [https://drive.google.com/file/d/1v_goePR1b7RWNgRouhDkU_yA3d95Fri_/view?usp=sharing BCM70012_Demo_Bin]
-
7. Brightness control , you can choose : 10,20,30,40,50,60,70,80,90,100.
+
<FTP> [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/BCM70012/BCM70012_Demo_Bin.zip BCM70012_Demo_Bin]
-
8. Show the brightness data which you choose.
+
== How to use the DEMO application ==
 +
[[Image:BCM70012AP.jpg]]<br />
-
9. When click the LightOff button , the panel will become darkest.
 
-
10. Record mouse position for go to 50 when LightOff. If click the button , 13 will show , you can click anywhere which you want for light on.
+
1.Open the video file to play , the file will play automatically.
-
11. Record hotkey for go to 10 when LightOff. If click the button , The Record Hot Key window will show.
+
2.The button used to play the video.
-
12. When click minimized , DPC will hide and show in the notification area.
+
3.The button used to pause the video.
-
21. Reset the record of hot key and position.
+
4.The button used to stop the video.
 +
5.Full screen.
-
[[Image:DPC_AP_3.jpg]]<br />
+
6.To show the status of the video and you can pull the bar to change the video's play status.
-
13. The light on mouse position and hotkay can not use together , after you record hotkey , you can't use the position anymore.
+
7.Where the video play in.
-
[[Image:DPC_AP_4.jpg]]<br />
+
8.You can input the words. The words can show on the video such as 11.
-
14. First key of hotkey
+
9.Choose the speed of the word run on the video , the speed will be chang after press the Set button(10).
-
15. Second key of hotkey
+
10.Show the words.
-
16. Third key hotkey
+
== Sample code Introduction ==
-
17. Confirm the hotkey which you entered
+
1.Functions List:
 +
 +
SDK Initialize
 +
BCM_InitSDK Initializes the SDK
 +
BCM_SetViewPos Setting the video playing area
 +
BCM_SetNotifyWindow Setting the receive message window and code
 +
 +
Load Video File and controls
 +
BCM_LoadFile Load video file
 +
BCM_Run Begin playing the video file
 +
BCM_Pause Pause play
 +
BCM_Stop Stop play
 +
BCM_SetFullScreen Playing the video with FullScreen or Quit fullscreen
 +
 +
Slider bar:
 +
BCM_GetDuration Get the video length
 +
BCM_GetCurrentPosition Get the current playing position
 +
BCM_SetCurrentPosition Set the current play position
 +
 +
Scroll Text:
 +
BCM_SetScrollText Set scroll text contain
 +
BCM_SetScrollTextSpeed Set scroll text speed
 +
BCM_SetScrollTextAlignment Formats the scroll text style
 +
BCM_SetScrollTextColor Set scroll text color
 +
BCM_SetScrollTextAlpha Set scroll text alpha
 +
BCM_SetScrollTextFont Set scroll text format
 +
BCM_SetScrollTextDir Set text scrolls direction
 +
BCM_InsertScrollText Insert scroll text item
 +
BCM_SetItemText Change the text of a list view item
 +
BCM_ClearScrollTextItem Clean all the scroll text
 +
BCM_GetScrollTextCount Retrieves the number of strings
 +
BCM_DisplayScrollText Start show scroll text
 +
BCM_DisableVMRBitmap Disable Mixbitmap
 +
 +
Bitmap:
 +
BCM_LoadBitmap Load bitmap for display
 +
BCM_SetBitmapRect The area for bitmap displaying.
 +
BCM_SetBitmapAlpha Specifices the alpha blending value
 +
BCM_SetTransparent Set transparent color
 +
BCM_ShowBitmap Display the bitmap
 +
 +
AudioControl:
 +
BCM_GetVolume Retrieves the volume(amplitude) of the audio signal.
 +
BCM_SetVolume Sets the volume (amplitude) of the audio signal.
 +
BCM_GetAudioBalance Retrieves the balance for the audio signal.
 +
BCM_SetAudioBalance Sets the balance of the audio signal.
-
18. Show hotkey which you set.
+
Functions Reference:
-
 
+
2.Data Type:
-
19. Hotkey will show here.
+
-
 
+
2.1 The function return value
-
[[Image:DPC_AP_5.jpg]]<br />
+
Syntax:
-
 
+
BCM_SUCCEEDED 0x0000
-
20. If you want to exit DPC , you should click right button of mouse on the icon and choose exit.
+
BCM_FAILED 0x8000
 +
BCM_NODRIVER 0x8010
 +
//Video format is not supported.
 +
BCM_UNSUPPORTED_VIDEO_FORMAT 0x8101
 +
//Audio format is not supported.
 +
BCM_UNSUPPORTED_AUDIO_FORMAT 0x8102
 +
//File format is not supported.
 +
BCM_UNSUPPORTED_FILE_FORMAT 0x8104
 +
BCM_NOINITIALIZE 0xff00
 +
Description:
 +
The method returned code.
 +
 +
2.2 Whether use Hardware decorder
 +
Syntax:
 +
//Hardware Decorder
 +
BCM_HWDECODER 1
 +
//Software Decorder
 +
BCM_SWDECODER 2
 +
 +
2.3 DirectShow EventHandle
 +
Syntax:
 +
//The video file is playing finished
 +
BCM_EC_COMPLETE 0x1
 +
BCM_EC_USERABORT 0x2
 +
BCM_EC_ERRORABORT 0x3
 +
Description:
 +
Video’s status
 +
 +
2.4 ScrollText Directions:
 +
Syntax:
 +
BCM_ST_DIRECTION_LEFT 1
 +
Form right to left.
 +
BCM_ST_DIRECTION_RIGHT 2
 +
From left to right.
 +
BCM_ST_DIRECTION_UP 3
 +
From down to up.
 +
BCM_ST_DIRECTION_DOWN 4
 +
From up to down.
 +
//Sets text at the top of video screen
 +
BCM_ST_ALIGN_TOP 1
 +
//Sets text at the center of video screen
 +
BCM_ST_ALIGN_CENTER 2
 +
//Sets text at the bottom of video screen
 +
BCM_ST_ALIGN_BOTTOM 3
 +
//Sets text at the left of video screen
 +
BCM_ST_ALIGN_LEFT 4
 +
//Sets text at the right of video screen
 +
BCM_ST_ALIGN_RIGHT 5
-
== Sample code Introduction ==
+
3. Method
-
===Define SMBus regester===
+
-
#define SMBUSPORT 0x0500
+
-
#define HST_STS SMBUSPORT+0x00
+
-
#define HST_CNT SMBUSPORT+0x02
+
-
#define HST_CMD SMBUSPORT+0x03
+
-
#define XMIT_SLVA SMBUSPORT+0x04
+
-
#define HST_D0 SMBUSPORT+0x05
+
-
#define bSize 1
+
-
#define SADD 0xb0
+
-
#define PWMFeq 0x01
+
-
#define PWMDuty 0x02
+
-
 
+
-
===Set Frequency data===
+
-
DWORD dwPortVal;
+
-
bool bResult;
+
-
bResult = InitializeWinIo();
+
-
if (bResult){
+
3.1 Initializes the DirectShow environment
-
SetPortVal(HST_STS, 0xFE, bSize); //start
+
-
Sleep(20);
+
3.1.1 BCM_InitSDK
-
SetPortVal(XMIT_SLVA, SADD, bSize); //set
+
Syntax:
-
Sleep(20);
+
INT BCM_InitSDK();
-
SetPortVal(HST_CMD, PWMFeq, bSize); //set frequency
+
Parameters:
-
Sleep(20);
+
None
-
GetPortVal(HST_STS, &dwPortVal, bSize);
+
Return Value:
-
Sleep(20);
+
BCM_SUCCEEDED : Function succeeded.
-
dwPortVal = dwPortVal & 0x01;
+
BCM_FAILED : Function failed.
-
if (dwPortVal == 0){
+
BCM_NOINITIALIZE : Lack necessary devices.
-
SetPortVal(HST_D0, fvalue, bSize); //write data into frequency
+
Description:
-
Sleep(20);
+
This function initializes Com Environment.
-
SetPortVal(HST_CNT, 0x48, bSize); //stop
+
-
Sleep(20);
+
3.1.2 BCM_SetViewPos
-
ShutdownWinIo();
+
Syntax:
-
}
+
INT BCM_SetViewPos(HWND hWndMain,INT left,INT top,INT right,INT bottom)
-
else
+
Parameters:
-
ShutdownWinIo();
+
hWndMain : The window which used to display the video playing.
-
}
+
left,top,right,bottom : These parameters are for area which displays the video play.
-
ShutdownWinIo();
+
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function set the main window and the area for diaplay.
 +
 +
3.1.3 BCM_SetNotifyWindow
 +
Syntax:
 +
INT BCM_SetNotifyWindow(HWND hWnd,WPARAM msg,LPARAM lData)
 +
Parameters:
 +
hWnd : Handle to the window, or NULL to stop receiving event messages.
 +
msg : Window message to be passed as the notification.
 +
lData : Value to be passed as the lParam parameter for the msg message.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function set the window to receive event messages.
 +
 +
 +
3.2 The playing control:
 +
 +
3.2.1 BCM_Run
 +
Syntax:
 +
INT BCM_Run()
 +
Parameters:
 +
None
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function runs all the filters in the filter graph.
 +
 +
3.2.2 BCM_Pause
 +
Syntax:
 +
INT BCM_Pause()
 +
Parameters:
 +
None
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function pauses all the filters in the filter graph.
 +
 +
3.2.3 BCM_Stop
 +
Syntax:
 +
INT BCM_Stop()
 +
Parameters:
 +
None
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function stops the video play.
 +
 +
3.2.4 BCM_LoadFile
 +
Syntax:
 +
INT BCM_LoadFile(DECODER_TYPE type,LPCSTR szFile)
 +
Parameters:
 +
type : Query whether the graph filter renderer in Hardware D ecorder.
 +
szFile : This should specify the absolute path to a file on disk or the URL of a file to download.
 +
Return Value
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NODRIVER_BCM : No Broadcom Video Decorder.
 +
BCM_UNSUPPORTVIDEOFORMAT : Unsupport video decorder .
 +
BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder.
 +
Description:
 +
This function loads the video file and queries whether the graph filter uses Hardware Decorder.
 +
This method initializates the interface.It is not designed to load multiple files,and calls to this method after the first call will fail.
 +
 +
3.2.5 BCM_SetFullScreen
 +
Syntax:
 +
INT BCM_SetFullScreen(BOOL inEnable);
 +
Parameters:
 +
inEnable : Set the playing with fullscreen if the inEnable is true,else with normal model.
 +
Return Value
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function queries whether the video renderer is in full-screen mode.
 +
 +
 +
3.3 The SliderCtrl used
 +
 +
3.3.1 BCM_GetDuration
 +
Syntax:
 +
INT BCM_GetDuration(DOUBLE* outDuration)
 +
Paramerters:
 +
outDuration : Pointer to a variable that receives the duration, in units of the current time format.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function retrieves the duration of the stream at normal playback speed.Changing the playback rate does not affect the duration.
 +
 +
3.3.2 BCM_GetCurrentPosition
 +
Syntax:
 +
INT BCM_GetCurrentPosition(DOUBLE* outPosition);
 +
Parameters:
 +
outPosition : Pointer to a variable that receives the current position,in units of the current time format.
 +
Return Value
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function returns the current position that playback has reached.
 +
 +
3.3.3 BCM_SetCurrentPosition
 +
Syntax:
 +
INT BCM_SetCurrentPosition(DOUBLE inPosition);
 +
Parameters:
 +
inPosition : Offset of the play cursor,int bytes,from the beginning of the buffer.
 +
Return Value
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function sets the position of the play cursor,which is the point at which the next bytes of data is read from the buffer.
 +
 +
 +
3.4 The Scroll Text function
 +
 +
3.4.1 BCM_SetScrollText
 +
Syntax:
 +
INT BCM_SetScrollText(LPCSTR sText);
 +
Parameters:
 +
sText : Receive the scroll text content.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function receives the scroll text content.
 +
 +
3.4.2 BCM_SetScrollTextSpeed
 +
Syntax:
 +
INT BCM_SetScrollTextSpeed(DOUBLE dbSlider);
 +
Parameters:
 +
dbSlider : The scroll text moves the percent of display’s width or height.If dbSlider is 0 ,the scrollText will display by the middle of the display’s area.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
This function sets the speed of the scroll text moving.
 +
 +
3.4.3 BCM_SetScrollTextAlpha
 +
Syntax:
 +
INT BCM_SetScrollTextAlpha(INT alpha);
 +
Paramerters:
 +
alpha : An alpha transparency value to be used on the entire source bitmap.The default oxff(255)assumes that your image is opaque,and that you want to use per-pixel alpha only.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
The function sets the scroll text value of transparency.
 +
 +
3.4.4 BCM_SetScrollTextFont
 +
Syntax:
 +
INT BCM_SetScrollTextFont(HFONT& font);
 +
Paramerters:
 +
font : The new font format to be selected by GDI.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
An application can select a font into memory device contexts only and into only one memory device context at a time.
 +
 +
3.4.5 BCM_SetScrollTextColor
 +
Syntax:
 +
INT BCM_SetScrollTextColor(COLORREF color);
 +
Paramerters:
 +
color : Specifies the color of text as an RGB color value.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
The system will use this text color when writting text to this device context and also when converting bitmaps between color and monochrome device contexts.
 +
 +
3.4.6 BCM_InsertScrollText
 +
Syntax:
 +
INT BCM_InsertScrollText(LPCSTR insertItem);
 +
Paramerters:
 +
insertItem : Add a new string to the scroll text list.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Insert an item to scroll text.
 +
 +
3.4.7 BCM_GetScrollTextCount
 +
Syntax:
 +
INT BCM_GetScrollTextCount();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded.
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Retrieves the numbers of the scroll text.
 +
 +
3.4.8 BCM_GetItemText
 +
Syntax:
 +
INT BCM_GetItemText(INT nItem,LPCSTR& lpszText);
 +
Paramerters:
 +
nItem : The index of the item whose text is to be retrieved.
 +
lpszText : Pointer to a string that is to receive the item text.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Retrieves the text of a list view item.
 +
 +
3.4.9 BCM_SetItemText
 +
Syntax:
 +
INT BCM_SetItemText(INT nItem,LPCSTR lpszText)
 +
Paramerters:
 +
nItem : Index of the item whose text is to be set.
 +
lpszText : A string that contains the new item text.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Changes the text of a list view item.
 +
 +
3.4.10 BCM_ClearScrollTextItem
 +
Syntax:
 +
INT BCM_ClearScrollTextItem();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Clear all the scroll text.
 +
 +
3.4.11 BCM_SetScrollTextDir
 +
Syntax:
 +
INT BCM_SetScrollTextDir(UINT nFlags);
 +
Paramerters:
 +
nFlags : The direction of scroll text.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
The text scrolls direction.
 +
 +
3.4.12 BCM_DisplayScrollText
 +
Syntax:
 +
INT BCM_DisplayScrollText();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Start display text scroll.
 +
 +
3.4.13 BCM_DisableVMRBitmap
 +
Syntax:
 +
INT BCM_DisableVMRBitmap();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Disable text scroll .
 +
 +
3.4.14 BCM_SetScrollTextAlignment
 +
Syntax:
 +
INT BCM_SetScrollTextAlignment( UINT Vertical, UINT Horizontal );
 +
Paramerters:
 +
Vertical : The align style in the vertical direction.
 +
Horizontal : The align style in the horizontal direction .
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Formats the scroll text align style.
 +
 +
 +
3.5 The bitmap
 +
 +
3.5.1 BCM_LoadBitmap
 +
Syntax:
 +
INT BCM_LoadBitmap(LPCSTR filePath);
 +
Paramerters:
 +
filePath: A string that contains the name of the bitmap resource.
 +
Return Value:
 +
BCM_SUCCEEDED: Function succeeded
 +
BCM_FAILED: Function failed.
 +
BCM_NOINITIALIZE: Lack necessary devices.
 +
Description:
 +
Loads the bitmap resource named by filePath.
 +
 +
3.5.2 BCM_SetBitmapRect
 +
Syntax:
 +
INT BCM_SetBitmapRect(INT left,INT top,INT width,INT height);
 +
Paramerters:
 +
left : Specifies the logical x-coordinate of the upper-left corner of the destination rectangle.
 +
top : Specifies the logical y-coordinate of the upper-left corner of the destination rectangle.
 +
width : Specifies the width of the destination rectangle and source bitmap.
 +
height : Specifies the height of the destination rectangle and source bitmap.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
The area for bitmap display.
 +
 +
3.5.3 BCM_SetBitmapAlpha
 +
Syntax:
 +
INT BCM_SetBitmapAlpha();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Specifies the alpha blending value.
 +
 +
3.5.4 BCM_SetTransparent
 +
Syntax:
 +
INT BCM_SetTransparent(UINT color);
 +
Paramerters:
 +
color : The RGB color in the source bitmap to treat as transparent.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Call this member function to transfer a bit-block of the color data, which corresponds to a rectangle of pixels from the specified source device context, into a destination device context.
 +
 +
3.5.5 BCM_ShowBitmap
 +
Syntax:
 +
INT BCM_ShowBitmap();
 +
Paramerters:
 +
NULL;
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded
 +
BCM_FAILED : Function failed.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
Description:
 +
Display bitmap .
 +
 +
 +
3.6 Audio control
 +
 +
3.6.1 BCM_GetVolume
 +
Syntax:
 +
INT BCM_GetVolume( LONG* plVolume );
 +
Paramerters:
 +
plVolume : Returned value of the volume property (0 is slience, 100 is full).
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
 +
Description:
 +
Retrieves the volume (amplitude) of the audio signal.
 +
 +
3.6.2 BCM_SetVolume
 +
Syntax:
 +
INT BCM_SetVolume(LONG lVolume);
 +
Paramerters:
 +
lVolume: Value to which to set the volume property( 0 is slience, 100 is full).
 +
Return Value:
 +
BCM_SUCCEEDED: Function succeeded.
 +
BCM_NOINITIALIZE: Lack necessary devices.
 +
BCM_UNSUPPORTAUDIOFORMAT: Unsupport audio decorder format(or No audio device or not install audio driver).
 +
Description:
 +
Sets the volume(amplitude) of the audio signal.
 +
 +
3.6.3 BCM_GetAudioBalance
 +
Syntax:
 +
INT BCM_GetAudioBalance(LONG* plBalance);
 +
Paramerters:
 +
plBalance: Returned value of the balance property.0 is a neutral balance ,-50 left channel is full and right is slience, 50 right is full and left is slience.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
 +
Description:
 +
Retrieves the balance for the audio signal.
 +
 +
3.6.4 BCM_SetAudioBalance
 +
Syntax:
 +
INT BCM_SetAudioBalance(LONG inBalance)
 +
Paramerters:
 +
inBalance: Value to which to set the balance property. 0 is a neutral balance ,-50 right channel is full and left is slience, 50 right is full and left is slience.
 +
Return Value:
 +
BCM_SUCCEEDED : Function succeeded.
 +
BCM_NOINITIALIZE : Lack necessary devices.
 +
BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
 +
Description:
 +
Sets the balance of the audio signal.
-
===Set Duty data===
+
File Format:
-
UpdateData(TRUE);
+
1. MKV
-
DWORD dwPortVal;
+
2. MP4
-
bool bResult;
+
3. AVI
-
bResult = InitializeWinIo();
+
4. OGG/OGM
 +
5. MPEG TS
 +
6. WMV
 +
 +
Video Format:
 +
1. MEDIASUBTYPE_MPEG2_VIDEO
 +
2. MEDIASUBTYPE_MPEG1Video
 +
3. WVC1
 +
4. WMVA
 +
5. WMV3
 +
6. AVC1
 +
 +
Audio Format:
 +
Major type : MEDIATYPE_MPEG2_PES
 +
1. MEDIASSUBTYPE_DOLBY_AC3
 +
2. MEDIASUBTYPE_MPEG1AudioPayload
 +
3. MEDIASUBTYPE_MPEG2_AUDIO
 +
4. MEDIASUBTYPE_DVD_LPCM_AUDIO
 +
 +
Major type : MEDIATYPE_DVD_ENCRYPTED_PACK
 +
5. MEDIASSUBTYPE_DOLBY_AC3
 +
6. MEDIASUBTYPE_MPEG1AudioPayload
 +
7. MEDIASUBTYPE_MPEG2_AUDIO
 +
8. MEDIASUBTYPE_DVD_LPCM_AUDIO
-
if (bResult){
+
Major type : MEDIATYPE_Audio
-
SetPortVal(HST_STS, 0xFE, bSize); //start
+
9. MEDIASUBTYPE_DVD_LPCM_AUDIO
-
Sleep(20);
+
10. MEDIASUBTYPE_DOLBY_AC3
-
SetPortVal(XMIT_SLVA, SADD, bSize); //set
+
11. MEDIASUBTYPE_MPEG2_AUDIO
-
Sleep(20);
+
-
SetPortVal(HST_CMD, PWMDuty, bSize); //set duty
+
-
Sleep(20);
+
-
GetPortVal(HST_STS, &dwPortVal, bSize);
+
-
Sleep(20);
+
-
dwPortVal = dwPortVal & 0x01;
+
-
if (dwPortVal == 0){
+
-
if (inverter == false)
+
-
SetPortVal(HST_D0, dvalue * 10 , bSize); //write data into data
+
-
else if (inverter == true)
+
-
SetPortVal(HST_D0, (10 - dvalue) * 10 , bSize);
+
-
Sleep(20);
+
-
SetPortVal(HST_CNT, 0x48, bSize); //stop
+
-
Sleep(20);
+
-
ShutdownWinIo();
+
-
}
+
-
else
+
-
ShutdownWinIo();
+
-
}
+
-
ShutdownWinIo();
+

Current revision

The Sample code source you can download form

Source file:

<Google Drive> BCM70012_Demo_Src

<FTP> BCM70012_Demo_Src


Reference Document:

<Google Drive> BCMSDK.doc

<FTP> BCMSDK.doc 


The procedure should do before build the source file : 

1. download and install the <Google Drive> DXSDK / <FTP> DXSDK 

2. build the BaseClasses(both Debug and Release):
   the path : DXSDK\Samples\C++\DirectShow\BaseClasses

3. add the include file and library file in Tools -> Options -> Pprojects -> VC++ Directories:
   (Suppose DXSDK install in C:\)

   Include files :
      C:\DXSDK\Include
      C:\DXSDK\Samples\C++\DirectShow\BaseClasses
      C:\DXSDK\Samples\C++\Common\Include

   Library files : 
      C:\DXSDK\Lib
      C:\DXSDK\Samples\C++\DirectShow\BaseClasses\Debug
      C:\DXSDK\Samples\C++\DirectShow\BaseClasses\Release

4. After build , should install the driver in the BCM70012_Demo_Bin.rar first. Adn then you can execute the AP which you build.

Binary file:

<Google Drive> BCM70012_Demo_Bin

<FTP> BCM70012_Demo_Bin

How to use the DEMO application

Image:BCM70012AP.jpg


1.Open the video file to play , the file will play automatically.

2.The button used to play the video.

3.The button used to pause the video.

4.The button used to stop the video.

5.Full screen.

6.To show the status of the video and you can pull the bar to change the video's play status.

7.Where the video play in.

8.You can input the words. The words can show on the video such as 11.

9.Choose the speed of the word run on the video , the speed will be chang after press the Set button(10).

10.Show the words.

Sample code Introduction 

1.Functions List:

SDK Initialize	
BCM_InitSDK	            Initializes the SDK
BCM_SetViewPos	            Setting the video playing area
BCM_SetNotifyWindow	    Setting the receive message window and code

Load Video File and controls	
BCM_LoadFile	            Load video file 
BCM_Run                     Begin playing the video file
BCM_Pause	            Pause play
BCM_Stop	            Stop play
BCM_SetFullScreen	    Playing the video with FullScreen or Quit fullscreen

Slider bar:	
BCM_GetDuration             Get the video length
BCM_GetCurrentPosition      Get the current playing position
BCM_SetCurrentPosition	    Set the current play position

Scroll Text:	
BCM_SetScrollText	    Set scroll text contain
BCM_SetScrollTextSpeed      Set scroll text speed
BCM_SetScrollTextAlignment  Formats the scroll text style
BCM_SetScrollTextColor	    Set scroll text color
BCM_SetScrollTextAlpha	    Set scroll text alpha 
BCM_SetScrollTextFont	    Set scroll text format 
BCM_SetScrollTextDir	    Set text scrolls direction
BCM_InsertScrollText	    Insert scroll text item
BCM_SetItemText             Change the text of a list view item
BCM_ClearScrollTextItem     Clean all the scroll text
BCM_GetScrollTextCount	    Retrieves the number of strings
BCM_DisplayScrollText	    Start show scroll text
BCM_DisableVMRBitmap	    Disable Mixbitmap

Bitmap:	
BCM_LoadBitmap	            Load bitmap for display
BCM_SetBitmapRect	    The area for bitmap displaying.
BCM_SetBitmapAlpha	    Specifices the alpha blending value
BCM_SetTransparent	    Set transparent color
BCM_ShowBitmap	            Display the bitmap

AudioControl:	
BCM_GetVolume	            Retrieves the volume(amplitude) of the audio signal.
BCM_SetVolume	            Sets the volume (amplitude) of the audio signal.
BCM_GetAudioBalance	    Retrieves the balance for the audio signal.
BCM_SetAudioBalance	    Sets the balance of the audio signal.

Functions Reference:
2.Data Type:

2.1 The function return value
   Syntax: 
      BCM_SUCCEEDED	                 0x0000
      BCM_FAILED			 0x8000 
      BCM_NODRIVER			 0x8010
      //Video format is not supported.
      BCM_UNSUPPORTED_VIDEO_FORMAT	 0x8101
      //Audio format is not supported.
      BCM_UNSUPPORTED_AUDIO_FORMAT	 0x8102
      //File format is not supported.
      BCM_UNSUPPORTED_FILE_FORMAT	 0x8104
      BCM_NOINITIALIZE			 0xff00
   Description:
      The method returned code.

2.2 Whether use Hardware decorder
   Syntax:
      //Hardware Decorder 
      BCM_HWDECODER  		         1
      //Software Decorder
      BCM_SWDECODER 			 2

2.3 DirectShow EventHandle
   Syntax:
      //The video file is playing finished
      BCM_EC_COMPLETE			 0x1
      BCM_EC_USERABORT		         0x2
      BCM_EC_ERRORABORT                  0x3
   Description:
      Video’s status

2.4 ScrollText Directions:
   Syntax:
      BCM_ST_DIRECTION_LEFT		 1
       Form right to left.
      BCM_ST_DIRECTION_RIGHT		 2
       From left to right.
      BCM_ST_DIRECTION_UP		 3
       From down to up.
      BCM_ST_DIRECTION_DOWN              4
       From up to down.
      //Sets text at the top of video screen
      BCM_ST_ALIGN_TOP			 1
      //Sets text at the center of video screen 
      BCM_ST_ALIGN_CENTER		 2
      //Sets text at the bottom of video screen
      BCM_ST_ALIGN_BOTTOM		 3
      //Sets text at the left of video screen
      BCM_ST_ALIGN_LEFT                  4
      //Sets text at the right of video screen 
      BCM_ST_ALIGN_RIGHT		 5

3. Method

3.1 Initializes the DirectShow environment 

3.1.1 BCM_InitSDK
     Syntax:
        INT BCM_InitSDK();
     Parameters:
        None
     Return Value:
        BCM_SUCCEEDED : Function succeeded.
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function initializes Com Environment.

3.1.2 BCM_SetViewPos
     Syntax:
        INT BCM_SetViewPos(HWND hWndMain,INT left,INT top,INT right,INT bottom)
     Parameters:
        hWndMain : The window which used to display the video playing.
        left,top,right,bottom : These parameters are for area which displays the video play.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function set the main window and the area for diaplay.

3.1.3 BCM_SetNotifyWindow
     Syntax:
        INT BCM_SetNotifyWindow(HWND hWnd,WPARAM msg,LPARAM lData)
     Parameters:
        hWnd : Handle to the window, or NULL to stop receiving event messages. 
        msg : Window message to be passed as the notification. 
        lData : Value to be passed as the lParam parameter for the msg message. 
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function set the window to receive event messages.


3.2 The playing control:

3.2.1 BCM_Run
     Syntax:
        INT BCM_Run()
     Parameters:
        None
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function runs all the filters in the filter graph.

3.2.2 BCM_Pause
     Syntax:
        INT BCM_Pause()
     Parameters:
        None
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function pauses all the filters in the filter graph.

3.2.3 BCM_Stop
     Syntax:
        INT BCM_Stop()
     Parameters:
        None
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function stops the video play.

3.2.4 BCM_LoadFile
     Syntax:
        INT BCM_LoadFile(DECODER_TYPE type,LPCSTR szFile)
     Parameters:
        type : Query whether the graph filter renderer in Hardware D			ecorder.
        szFile : This should specify the absolute path to a file on disk or the URL of a file to download.
     Return Value
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NODRIVER_BCM : No Broadcom Video Decorder.
        BCM_UNSUPPORTVIDEOFORMAT : Unsupport video decorder .
        BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder.
     Description:
        This function loads the video file and queries whether the graph filter uses Hardware Decorder.
        This method initializates the interface.It is not designed to load multiple files,and calls to this method after the first call will fail.

3.2.5 BCM_SetFullScreen
     Syntax:
        INT BCM_SetFullScreen(BOOL inEnable);
     Parameters:
        inEnable : Set the playing with fullscreen if the inEnable is true,else with normal model.
     Return Value
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function queries whether the video renderer is in full-screen mode.
 

3.3 The SliderCtrl used

3.3.1 BCM_GetDuration
     Syntax:
        INT BCM_GetDuration(DOUBLE* outDuration)
     Paramerters:
        outDuration : Pointer to a variable that receives the duration, in units of the current time format.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function retrieves the duration of the stream at normal playback speed.Changing the playback rate does not affect the duration.

3.3.2 BCM_GetCurrentPosition
     Syntax:
        INT BCM_GetCurrentPosition(DOUBLE* outPosition);
     Parameters:
        outPosition : Pointer to a variable that receives the current position,in units of the current time format.
     Return Value
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function returns the current position that playback has reached.

3.3.3 BCM_SetCurrentPosition
     Syntax:
        INT BCM_SetCurrentPosition(DOUBLE inPosition);
     Parameters:
        inPosition : Offset of the play cursor,int bytes,from the beginning of the buffer.
     Return Value
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function sets the position of the play cursor,which is the point at which the next bytes of data is read from the buffer.


3.4 The Scroll Text function

3.4.1 BCM_SetScrollText
     Syntax:
        INT BCM_SetScrollText(LPCSTR sText);
     Parameters:
        sText : Receive the scroll text content.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function receives the scroll text content.

3.4.2 BCM_SetScrollTextSpeed
     Syntax:
        INT BCM_SetScrollTextSpeed(DOUBLE dbSlider);
     Parameters:
        dbSlider : The scroll text moves the percent of display’s width or height.If dbSlider is 0 ,the scrollText will display by the middle of the display’s area.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        This function sets the speed of the scroll text moving.

3.4.3 BCM_SetScrollTextAlpha
     Syntax:
        INT BCM_SetScrollTextAlpha(INT alpha);
     Paramerters:
        alpha : An alpha transparency value to be used on the entire source bitmap.The default oxff(255)assumes that your image is opaque,and that you want to use per-pixel alpha only.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        The function sets the scroll text value of transparency.

3.4.4 BCM_SetScrollTextFont
     Syntax:
        INT BCM_SetScrollTextFont(HFONT& font);
     Paramerters:
        font : The new font format to be selected by GDI.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        An application can select a font into memory device contexts only and into only one memory device context at a time.

3.4.5 BCM_SetScrollTextColor
     Syntax:
        INT BCM_SetScrollTextColor(COLORREF color);
     Paramerters:
        color : Specifies the color of text as an RGB color value.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        The system will use this text color when writting text to this device context and also when converting bitmaps between color and monochrome device contexts.

3.4.6 BCM_InsertScrollText
     Syntax:
        INT BCM_InsertScrollText(LPCSTR insertItem);
     Paramerters:
        insertItem : Add a new string to the scroll text list.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Insert an item to scroll text.

3.4.7 BCM_GetScrollTextCount
     Syntax:
        INT BCM_GetScrollTextCount();
     Paramerters:
        NULL;
     Return Value:
        BCM_SUCCEEDED : Function succeeded.
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Retrieves the numbers of the scroll text.

3.4.8 BCM_GetItemText
     Syntax:
        INT BCM_GetItemText(INT nItem,LPCSTR& lpszText);
     Paramerters:
        nItem : The index of the item whose text is to be retrieved.
        lpszText : Pointer to a string that is to receive the item text.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Retrieves the text of a list view item.

3.4.9 BCM_SetItemText
     Syntax:
        INT BCM_SetItemText(INT nItem,LPCSTR lpszText)
     Paramerters:
        nItem : Index of the item whose text is to be set.
        lpszText : A string that contains the new item text.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Changes the text of a list view item.

3.4.10 BCM_ClearScrollTextItem
      Syntax:
         INT BCM_ClearScrollTextItem();
      Paramerters:
         NULL;
      Return Value:
         BCM_SUCCEEDED : Function succeeded
         BCM_FAILED : Function failed.
         BCM_NOINITIALIZE : Lack necessary devices.
      Description:
         Clear all the scroll text.

3.4.11 BCM_SetScrollTextDir
      Syntax:
         INT BCM_SetScrollTextDir(UINT nFlags);
      Paramerters:
         nFlags : The direction of scroll text.
      Return Value:
         BCM_SUCCEEDED : Function succeeded
         BCM_FAILED : Function failed.
         BCM_NOINITIALIZE : Lack necessary devices.
      Description:
         The text scrolls direction.
 
3.4.12 BCM_DisplayScrollText
      Syntax:
         INT BCM_DisplayScrollText();
      Paramerters:
         NULL;
      Return Value:
         BCM_SUCCEEDED : Function succeeded
         BCM_FAILED : Function failed.
         BCM_NOINITIALIZE : Lack necessary devices.
      Description:
         Start display text scroll.

3.4.13 BCM_DisableVMRBitmap
      Syntax:
         INT BCM_DisableVMRBitmap();
      Paramerters:
         NULL;
      Return Value:
         BCM_SUCCEEDED : Function succeeded
         BCM_FAILED : Function failed.
         BCM_NOINITIALIZE : Lack necessary devices.
      Description:
         Disable text scroll .

3.4.14 BCM_SetScrollTextAlignment
      Syntax:
         INT BCM_SetScrollTextAlignment( UINT Vertical, UINT Horizontal );
      Paramerters:
         Vertical : The align style in the vertical direction.
         Horizontal : The align style in the horizontal direction .
      Return Value:
         BCM_SUCCEEDED : Function succeeded
         BCM_FAILED : Function failed.
         BCM_NOINITIALIZE : Lack necessary devices.
      Description:
         Formats the scroll text align style.


3.5 The bitmap 

3.5.1 BCM_LoadBitmap
     Syntax:
        INT BCM_LoadBitmap(LPCSTR filePath);
     Paramerters:
        filePath:		A string that contains the name of the bitmap resource.
     Return Value:
        BCM_SUCCEEDED:		Function succeeded
        BCM_FAILED:			Function failed.
        BCM_NOINITIALIZE:	Lack necessary devices.
     Description:
        Loads the bitmap resource named by filePath.

3.5.2 BCM_SetBitmapRect
     Syntax:
        INT BCM_SetBitmapRect(INT left,INT top,INT width,INT height);
     Paramerters:
        left : Specifies the logical x-coordinate of the upper-left corner of the destination rectangle.
        top : Specifies the logical y-coordinate of the upper-left corner of the destination rectangle.
        width : Specifies the width of the destination rectangle and source bitmap.
        height : Specifies the height of the destination rectangle and source bitmap.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        The area for bitmap display.

3.5.3 BCM_SetBitmapAlpha
     Syntax:
        INT BCM_SetBitmapAlpha();
     Paramerters:
        NULL;
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Specifies the alpha blending value.

3.5.4 BCM_SetTransparent
     Syntax:
        INT BCM_SetTransparent(UINT color);
     Paramerters:
        color : The RGB color in the source bitmap to treat as transparent.
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Call this member function to transfer a bit-block of the color data, which corresponds to a rectangle of pixels from the specified source device context, into a destination device context.

3.5.5 BCM_ShowBitmap
     Syntax:
        INT BCM_ShowBitmap();
     Paramerters:
        NULL;
     Return Value:
        BCM_SUCCEEDED : Function succeeded
        BCM_FAILED : Function failed.
        BCM_NOINITIALIZE : Lack necessary devices.
     Description:
        Display bitmap .


3.6 Audio control

3.6.1 BCM_GetVolume
     Syntax:
        INT BCM_GetVolume( LONG* plVolume );
     Paramerters:
        plVolume : Returned value of the volume property (0 is slience, 100 is full).
     Return Value:
        BCM_SUCCEEDED : Function succeeded.
        BCM_NOINITIALIZE : Lack necessary devices.
        BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
     Description:
        Retrieves the volume (amplitude) of the audio signal.

3.6.2 BCM_SetVolume 
     Syntax:
        INT BCM_SetVolume(LONG lVolume);
     Paramerters:
        lVolume:	Value to which to set the volume property( 0 is slience, 100 is full).
     Return Value:
        BCM_SUCCEEDED:		Function succeeded.
        BCM_NOINITIALIZE:	Lack necessary devices.
        BCM_UNSUPPORTAUDIOFORMAT:	Unsupport audio decorder format(or No audio device or not install audio driver).
     Description:
        Sets the volume(amplitude) of the audio signal.

3.6.3 BCM_GetAudioBalance
     Syntax:
        INT BCM_GetAudioBalance(LONG* plBalance);
     Paramerters:
        plBalance: Returned value of the balance property.0 is a neutral balance ,-50 left channel is full and right is slience, 50 right is full and left is slience.
     Return Value:
        BCM_SUCCEEDED : Function succeeded.
        BCM_NOINITIALIZE : Lack necessary devices.
        BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
     Description:
        Retrieves the balance for the audio signal.

3.6.4 BCM_SetAudioBalance
     Syntax:
        INT BCM_SetAudioBalance(LONG inBalance)
     Paramerters:
        inBalance: Value to which to set the balance property. 0 is a neutral balance ,-50 right channel is full and left is slience, 50 right is full and left is slience.
     Return Value:
        BCM_SUCCEEDED : Function succeeded.
        BCM_NOINITIALIZE : Lack necessary devices.
        BCM_UNSUPPORTAUDIOFORMAT : Unsupport audio decorder format(or No audio device or not install audio driver).
     Description:
        Sets the balance of the audio signal.

File Format:
1. MKV
2. MP4
3. AVI
4. OGG/OGM
5. MPEG TS
6. WMV

Video Format:
1. MEDIASUBTYPE_MPEG2_VIDEO 
2. MEDIASUBTYPE_MPEG1Video
3. WVC1
4. WMVA
5. WMV3
6. AVC1

Audio Format:
Major type : MEDIATYPE_MPEG2_PES
1. MEDIASSUBTYPE_DOLBY_AC3
2. MEDIASUBTYPE_MPEG1AudioPayload
3. MEDIASUBTYPE_MPEG2_AUDIO
4. MEDIASUBTYPE_DVD_LPCM_AUDIO

Major type : MEDIATYPE_DVD_ENCRYPTED_PACK
5. MEDIASSUBTYPE_DOLBY_AC3
6. MEDIASUBTYPE_MPEG1AudioPayload
7. MEDIASUBTYPE_MPEG2_AUDIO
8. MEDIASUBTYPE_DVD_LPCM_AUDIO

Major type : MEDIATYPE_Audio
9. MEDIASUBTYPE_DVD_LPCM_AUDIO
10. MEDIASUBTYPE_DOLBY_AC3
11. MEDIASUBTYPE_MPEG2_AUDIO
Retrieved from "http://tprd.info/lexwiki/index.php/BCM70012_Module"
Personal tools