1.1 Binary file API/DisplayTest.exe has changed
2.1 Binary file API/iMONDisplay.dll has changed
3.1 Binary file API/iMONDisplay.lib has changed
4.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
4.2 +++ b/API/iMONDisplayAPI.h Sun Apr 14 22:50:40 2013 +0200
4.3 @@ -0,0 +1,162 @@
4.4 +#ifndef __IMON_DISPLAY_API_H__
4.5 +#define __IMON_DISPLAY_API_H__
4.6 +
4.7 +////////////////////////////////////
4.8 +// includes
4.9 +/** iMONDisplayDefines.h
4.10 +This header file defines several enumerations. Open this file and check the definition and usage of enumerations and structures*/
4.11 +#include "iMONDisplayDefines.h"
4.12 +
4.13 +#ifdef IMON_DISPLAY_API_EXPORT
4.14 +#define IMONDSPAPI __declspec(dllexport)
4.15 +#else
4.16 +#define IMONDSPAPI __declspec(dllimport)
4.17 +#endif
4.18 +
4.19 +#ifdef __cplusplus
4.20 +extern "C"
4.21 +{
4.22 +#endif //__cplusplus
4.23 +
4.24 + /////////////////////////////////////
4.25 + ///// Interfaces
4.26 + /**DSPResult IMON_Display_Init(HWND hwndNoti, UINT uMsgNotification)
4.27 + @brief This function should be called to use other functions in iMON Display API.\n
4.28 + When the caller application calls this function, API tries to request Display Plug-in Mode to iMON.
4.29 + @param [in] hwndNoti API will send/post message to this handle.
4.30 + @param [in] uMsgNotification API will send/post message to hwndNoti with this message identifier.
4.31 + @return This function will return one of DSPResult enumeration value.\n
4.32 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_INVALIDARG or DSP_E_OUTOFMEMORY can be returned when error occurs.*/
4.33 + IMONDSPAPI DSPResult IMON_Display_Init(HWND hwndNoti, UINT uMsgNotification);
4.34 +
4.35 + /**DSPResult IMON_Display_Uninit()
4.36 + @brief This function should be called when the caller application need not use this API any more.\n
4.37 + If this function call is missed, iMON can't display other information.\n
4.38 + @return This function will return one of DSPResult enumeration value.\n
4.39 + DSP_SUCCEEDED will be returned if succeeded.*/
4.40 + IMONDSPAPI DSPResult IMON_Display_Uninit();
4.41 +
4.42 + /**DSPResult IMON_Display_IsInited()
4.43 + @brief This function can be used when the caller application wants to know if API is initialized.\n
4.44 + @return This function will return one of DSPResult enumeration value.\n
4.45 + If API is initialized, this call will return DSP_S_INITED. Otherwise DSP_S_NOT_INITED will be returned.*/
4.46 + IMONDSPAPI DSPResult IMON_Display_IsInited();
4.47 +
4.48 + /**DSPResult IMON_Display_IsPluginModeEnabled()
4.49 + @brief This function can be used when the caller application wants to know if API can control iMON display.\n
4.50 + @return This function will return one of DSPResult enumeration value.\n
4.51 + If API can control iMON display, this call will return DSP_S_IN_PLUGIN_MODE. Otherwise DSP_S_NOT_IN_PLUGIN_MODE will be returned.*/
4.52 + IMONDSPAPI DSPResult IMON_Display_IsPluginModeEnabled();
4.53 +
4.54 +
4.55 + /**DSPResult IMON_Display_SetVfdText(LPCTSTR lpsz1stLine, LPCTSTR lpsz2ndLine)
4.56 + @brief This function can be used when the caller application wants to display text data on VFD module.\n
4.57 + @param [in] lpsz1stLine This string data will be displayed on the 1st line of VFD module.\n
4.58 + It doesn't support multi-byte character and if string data is longer than 16 characters, it displays 16 characters from the first.\n
4.59 + @param [in] lpsz2ndLine This string data will be displayed on the 2nd line of VFD module.\n
4.60 + It doesn't support multi-byte character and if string data is longer than 16 characters, it displays 16 characters from the first.\n
4.61 + @return This function will return one of DSPResult enumeration value.\n
4.62 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_POINTER, DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.63 + IMONDSPAPI DSPResult IMON_Display_SetVfdText(LPCTSTR lpsz1stLine, LPCTSTR lpsz2ndLine);
4.64 +
4.65 + /**DSPResult IMON_Display_SetVfdEqData(PDSPEQDATA pEqData)
4.66 + @brief This function can be used when the caller application wants to display equalizer data on VFD module.\n
4.67 + @param [in] pEqData Pointer of DSPEQDATA structure. The caller application should fill this structure with the equalizer data for 16 bands.\n
4.68 + @return This function will return one of DSPResult enumeration value.\n
4.69 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_POINTER, DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.70 + IMONDSPAPI DSPResult IMON_Display_SetVfdEqData(PDSPEQDATA pEqData);
4.71 +
4.72 +
4.73 + /**DSPResult IMON_Display_SetLcdText(LPCTSTR lpszText)
4.74 + @brief This function can be used when the caller application wants to display text data on LCD module.\n
4.75 + @param [in] lpszText This string data will be displayed on the LCD module.\n
4.76 + It supports multi-byte character and if string data is longer than display area, it will start to scroll.\n
4.77 + When text scrolling is finished, API will notify it with DSPNotifyCode enumeration value, DSPNM_LCD_TEXT_SCROLL_DONE.\n
4.78 + @return This function will return one of DSPResult enumeration value.\n
4.79 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_POINTER, DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.80 + IMONDSPAPI DSPResult IMON_Display_SetLcdText(LPCTSTR lpszText);
4.81 +
4.82 + /**DSPResult IMON_Display_SetLcdEqData(PDSPEQDATA pEqDataL, PDSPEQDATA pEqDataR)
4.83 + @brief This function can be used when the caller application wants to display equalizer data on LCD module.\n
4.84 + @param [in] pEqDataL Pointer of DSPEQDATA structure. This parameter represents equalizer data of left channel.\n
4.85 + The caller application should fill this structure with the equalizer data of left channel for 16 bands.\n
4.86 + @param [in] pEqDataR Pointer of DSPEQDATA structure. This parameter represents equalizer data of right channel.\n
4.87 + The caller application should fill this structure with the equalizer data of right channel for 16 bands.\n
4.88 + @return This function will return one of DSPResult enumeration value.\n
4.89 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_POINTER, DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.90 + IMONDSPAPI DSPResult IMON_Display_SetLcdEqData(PDSPEQDATA pEqDataL, PDSPEQDATA pEqDataR);
4.91 +
4.92 +
4.93 + /**DSPResult IMON_Display_SetLcdAllIcons(BOOL bOn)
4.94 + @brief This function can be used when the caller application wants to turn on/off all icons on LCD module.\n
4.95 + @param [in] bOn If this value is TRUE, iMON will turn on all icons. Otherwise, iMON will turn off all icons.\n
4.96 + @return This function will return one of DSPResult enumeration value.\n
4.97 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.98 + IMONDSPAPI DSPResult IMON_Display_SetLcdAllIcons(BOOL bOn);
4.99 +
4.100 + /**DSPResult IMON_Display_SetLcdOrangeIcon(BYTE btIconData1, BYTE btIconData2)
4.101 + @brief This function can be used when the caller application wants to turn on/off orange shaped disk icons on the upper left part of LCD module.\n
4.102 + Disk icons consist of 8 pieces of orange and orange peel.\n
4.103 + @param [in] btIconData1 Each bit represents one of icons shaped the piece of orange.\n
4.104 + MSB is used for the piece placed on top and the remaining bits are for the piece placed in CCW from top.\n
4.105 + @param [in] btIconData2 MSB represents the orange peel shaped icon. Other bits are not used.\n
4.106 + @return This function will return one of DSPResult enumeration value.\n
4.107 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.108 + IMONDSPAPI DSPResult IMON_Display_SetLcdOrangeIcon(BYTE btIconData1, BYTE btIconData2);
4.109 +
4.110 + /**DSPResult IMON_Display_SetLcdMediaTypeIcon(BYTE btIconData)
4.111 + @brief This function can be used when the caller application wants to turn on/off media type icons on the upper part of LCD module.\n
4.112 + @param [in] btIconData Each bit represents one of media type icons. From MSB each bit represents MUSIC, MOVIE, PHOTO, CD/DVD, TV, WEBCASTING and NEWS/WEATHER icon.\n
4.113 + @return This function will return one of DSPResult enumeration value.\n
4.114 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.115 + IMONDSPAPI DSPResult IMON_Display_SetLcdMediaTypeIcon(BYTE btIconData);
4.116 +
4.117 + /**DSPResult IMON_Display_SetLcdSpeakerIcon(BYTE btIconData1, BYTE btIconData2)
4.118 + @brief This function can be used when the caller application wants to turn on/off speaker icons on the upper right part of LCD module.\n
4.119 + @param [in] btIconData1 Each bit represents one of speaker icons.\nFrom MSB each bit represents L, C, R, SL, LFE, SR, RL and SPDIF icon.
4.120 + @param [in] btIconData2 MSB represents RR icon. Other bits are not used.\n
4.121 + @return This function will return one of DSPResult enumeration value.\n
4.122 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.123 + IMONDSPAPI DSPResult IMON_Display_SetLcdSpeakerIcon(BYTE btIconData1, BYTE btIconData2);
4.124 +
4.125 + /**DSPResult IMON_Display_SetLcdVideoCodecIcon(BYTE btIconData)
4.126 + @brief This function can be used when the caller application wants to turn on/off codec icons for video file on the lower part of LCD module.\n
4.127 + @param [in] btIconData Each bit represents one of video codec icons. From MSB each bit represents MPG, DIVX, XVID, WMV, MPG, AC3, DTS and WMA icon.\n
4.128 + @return This function will return one of DSPResult enumeration value.\n
4.129 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.130 + IMONDSPAPI DSPResult IMON_Display_SetLcdVideoCodecIcon(BYTE btIconData);
4.131 +
4.132 + /**DSPResult IMON_Display_SetLcdAudioCodecIcon(BYTE btIconData)
4.133 + @brief This function can be used when the caller application wants to turn on/off codec icons for audio file on the lower part of LCD module.\n
4.134 + @param [in] btIconData Each bit represents one of audio codec icons. From MSB each bit represents MP3, OGG, WMA and WAV icon.\n
4.135 + @return This function will return one of DSPResult enumeration value.\n
4.136 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.137 + IMONDSPAPI DSPResult IMON_Display_SetLcdAudioCodecIcon(BYTE btIconData);
4.138 +
4.139 + /**DSPResult IMON_Display_SetLcdAspectRatioIcon(BYTE btIconData)
4.140 + @brief This function can be used when the caller application wants to turn on/off aspect ratio icons on the lower right part of LCD module.\n
4.141 + @param [in] btIconData Each bit represents one of aspect ratio icons. From MSB each bit represents SRC, FIT, TV, HDTV, SCR1 and SCR2 icon.\n
4.142 + @return This function will return one of DSPResult enumeration value.\n
4.143 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.144 + IMONDSPAPI DSPResult IMON_Display_SetLcdAspectRatioIcon(BYTE btIconData);
4.145 +
4.146 + /**DSPResult IMON_Display_SetLcdEtcIcon(BYTE btIconData)
4.147 + @brief This function can be used when the caller application wants to turn on/off icons on the lower left part of LCD module.\n
4.148 + @param [in] btIconData Each bit represents icon. From MSB each bit represents REPEAT, SHUFFLE, ALARM, REC, VOL and TIME icon.\n
4.149 + @return This function will return one of DSPResult enumeration value.\n
4.150 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.151 + IMONDSPAPI DSPResult IMON_Display_SetLcdEtcIcon(BYTE btIconData);
4.152 +
4.153 + /**DSPResult IMON_Display_SetLcdProgress(int nCurPos, int nTotal)
4.154 + @brief This function can be used when the caller application wants to display progress bar on the upper and lower left part of text area of LCD module.\n
4.155 + @param [in] nCurPos It represents the current position of progress bar.\n
4.156 + @param [in] nTotal It represents the total length of progress bar.\n
4.157 + @return This function will return one of DSPResult enumeration value.\n
4.158 + DSP_SUCCEEDED will be returned if succeeded. DSP_E_NOT_INITED or DSP_E_FAIL can be returned if failed.*/
4.159 + IMONDSPAPI DSPResult IMON_Display_SetLcdProgress(int nCurPos, int nTotal);
4.160 +
4.161 +#ifdef __cplusplus
4.162 +}
4.163 +#endif //__cplusplus
4.164 +
4.165 +#endif //__IMON_DISPLAY_API_H__
4.166 \ No newline at end of file
5.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
5.2 +++ b/API/iMONDisplayDefines.h Sun Apr 14 22:50:40 2013 +0200
5.3 @@ -0,0 +1,114 @@
5.4 +#ifndef __IMON_DISPLAY_API_DEFINES_H__
5.5 +#define __IMON_DISPLAY_API_DEFINES_H__
5.6 +
5.7 +//////////////////////////////////////////////////
5.8 +//////////////////////////////////////////////////
5.9 +// Enumerations
5.10 +
5.11 +/**DSPResult
5.12 +@brief These enumeration values represent the returned result for iMON Display API function calls.\n
5.13 + All iMON Display API function calls return one of this result values.\n
5.14 + For meaning of each result, refer the comment of each line below*/
5.15 +enum DSPResult
5.16 +{
5.17 + DSP_SUCCEEDED = 0, //// Function Call Succeeded Without Error
5.18 + DSP_E_FAIL, //// Unspecified Failure
5.19 + DSP_E_OUTOFMEMORY, //// Failed to Allocate Necessary Memory
5.20 + DSP_E_INVALIDARG, //// One or More Arguments Are Not Valid
5.21 + DSP_E_NOT_INITED, //// API is Not Initialized
5.22 + DSP_E_POINTER, //// Pointer is Not Valid
5.23 +
5.24 + DSP_S_INITED = 0x1000, //// API is Initialized
5.25 + DSP_S_NOT_INITED, //// API is Not Initialized
5.26 + DSP_S_IN_PLUGIN_MODE, //// API Can Control iMON Display (Display Plug-in Mode)
5.27 + DSP_S_NOT_IN_PLUGIN_MODE, //// API Can't Control iMON Display
5.28 +};
5.29 +
5.30 +
5.31 +/**DSPNInitResult
5.32 +@brief These enumeration values represent the result status for requesting Display Plug-in Mode to iMON.\n
5.33 + iMON Display API notifies one of this result values to the caller application after requesting Display Plug-in Mode to iMON.\n
5.34 + For more information, refer the comment of each line below*/
5.35 +enum DSPNInitResult
5.36 +{
5.37 + DSPN_SUCCEEDED = 0, //// Display Plug-in Mode is Initialized Successfully
5.38 + DSPN_ERR_IN_USED = 0x0100, //// Display Plug-in is Already Used by Other Application
5.39 + DSPN_ERR_HW_DISCONNECTED, //// iMON HW is Not Connected
5.40 + DSPN_ERR_NOT_SUPPORTED_HW, //// The Connected iMON HW doesn't Support Display Plug-in
5.41 + DSPN_ERR_PLUGIN_DISABLED, //// Display Plug-in Mode Option is Disabled
5.42 + DSPN_ERR_IMON_NO_REPLY, //// The Latest iMON is Not Installed or iMON Not Running
5.43 + DSPN_ERR_UNKNOWN = 0x0200, //// Unknown Failure
5.44 +};
5.45 +
5.46 +
5.47 +/**DSPType
5.48 +@brief These enumeration values represent display type.\n
5.49 + Currently iMON Display API supports VFD and LCD products.*/
5.50 +enum DSPType
5.51 +{
5.52 + DSPN_DSP_NONE = 0,
5.53 + DSPN_DSP_VFD = 0x01, //// VFD products
5.54 + DSPN_DSP_LCD = 0x02, //// LCD products
5.55 +};
5.56 +
5.57 +
5.58 +/**DSPNotifyCode
5.59 +@brief These enumeration values represent the notification codes.\n
5.60 + iMON Display API will send or post message to the caller application.\n
5.61 + The caller application should assign the message and the winodw handle to receivce message with IMON_Display_Init fucntion.\n
5.62 + These enumeration values are used with WPARAM parameter of the message.\n
5.63 + For more information, see the explanation of each notification code below*/
5.64 +enum DSPNotifyCode
5.65 +{
5.66 + /**DSPNM_PLUGIN_SUCCEED
5.67 + @brief When API succeeds to get the control for the display, API will post caller-specified message with DSPNM_PLUGIN_SUCCEED as WPARAM parameter.\n
5.68 + LPARAM represents DSPType. This value can be 0x01 (VFD), 0x02 (LCD) or 0x03 (VFD+LCD).*/
5.69 + DSPNM_PLUGIN_SUCCEED = 0,
5.70 +
5.71 + /**DSPNM_PLUGIN_FAILED
5.72 + @brief When API fails to get the control for the display, API will post caller-specified message with DSPNM_PLUGIN_FAILED as WPARAM parameter.\n
5.73 + LPARAM represents error code with DSPNResult.*/
5.74 + DSPNM_PLUGIN_FAILED,
5.75 +
5.76 + /**DSPNM_IMON_RESTARTED
5.77 + @brief When iMON starts, API will post caller-specified message with DSPNM_IMON_RESTARTED as WPARAM parameter.\n
5.78 + LPARAM represents DSPType. This value can be 0 (No Display), 0x01 (VFD), 0x02 (LCD) or 0x03 (VFD+LCD).*/
5.79 + DSPNM_IMON_RESTARTED,
5.80 +
5.81 + /**DSPNM_IMON_CLOSED
5.82 + @brief When iMON closed, API will post caller-specified message with DSPNM_IMON_CLOSED as WPARAM parameter.\n
5.83 + LPARAM is not used.*/
5.84 + DSPNM_IMON_CLOSED,
5.85 +
5.86 + /**DSPNM_HW_CONNECTED
5.87 + @brief When iMON HW newly connected, API will post caller-specified message with DSPNM_HW_CONNECTED as WPARAM parameter.\n
5.88 + LPARAM represents DSPType. This value can be 0 (No Display), 0x01 (VFD), 0x02 (LCD) or 0x03 (VFD+LCD).*/
5.89 + DSPNM_HW_CONNECTED,
5.90 +
5.91 + /**DSPNM_HW_DISCONNECTED
5.92 + @brief When iMON HW disconnected, API will post caller-specified message with DSPNM_HW_DISCONNECTED as WPARAM parameter.\n
5.93 + LPARAM is DSPNResult value, DSPN_ERR_HW_DISCONNECTED.*/
5.94 + DSPNM_HW_DISCONNECTED,
5.95 +
5.96 +
5.97 + /**DSPNM_LCD_TEXT_SCROLL_DONE
5.98 + @brief When iMON LCD finishes scrolling Text, API will post caller-specified message with DSPNM_LCD_TEXT_SCROLL_DONE as WPARAM parameter.\n
5.99 + The caller application may need to know when text scroll is finished, for sending next text.\n
5.100 + LPARAM is not used.*/
5.101 + DSPNM_LCD_TEXT_SCROLL_DONE = 0x1000,
5.102 +};
5.103 +
5.104 +//////////////////////////////////////////////////
5.105 +//////////////////////////////////////////////////
5.106 +// Structure
5.107 +
5.108 +/**DspEqData
5.109 +@brief This structure contains Equalizer data for 16 bands.
5.110 +@param BandData It represents Equalizer data for 16 bands. Its range is from 0 to 100.*/
5.111 +typedef struct DspEqData
5.112 +{
5.113 + int BandData[16];
5.114 +
5.115 +} DSPEQDATA, *PDSPEQDATA;
5.116 +
5.117 +#endif //__IMON_DISPLAY_API_DEFINES_H__
5.118 \ No newline at end of file
6.1 --- a/iMONDisplayApiSample/DisplayTest/DisplayTest.vcproj Sun Apr 14 22:40:46 2013 +0200
6.2 +++ b/iMONDisplayApiSample/DisplayTest/DisplayTest.vcproj Sun Apr 14 22:50:40 2013 +0200
6.3 @@ -185,7 +185,7 @@
6.4 </References>
6.5 <Files>
6.6 <Filter
6.7 - Name="소스 파일"
6.8 + Name="Sources"
6.9 Filter="cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx"
6.10 UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}"
6.11 >
6.12 @@ -219,7 +219,7 @@
6.13 </File>
6.14 </Filter>
6.15 <Filter
6.16 - Name="헤더 파일"
6.17 + Name="Includes"
6.18 Filter="h;hpp;hxx;hm;inl;inc;xsd"
6.19 UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}"
6.20 >
6.21 @@ -241,7 +241,7 @@
6.22 </File>
6.23 </Filter>
6.24 <Filter
6.25 - Name="리소스 파일"
6.26 + Name="Resources"
6.27 Filter="rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav"
6.28 UniqueIdentifier="{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}"
6.29 >