XM7/XM7dash/XM7LP Internationalization DLLs (English Version)

Version 1.4 Level 13
2013-07-08  by Ben.JP


0. DISCLAIMER:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.


1. COPYRIGHT WARNING

In order to execute XM7/XM7dash/XM7LP, ROM data of FM-7 series/FM-8 are required.
The ROM data SHALL BE extracted from the USERS' OWN real FM-7 series/FM-8 machines.
Be carefull, if you do not have any real machines, you cannot use XM7/XM7dash/XM7LP.


2. Supported Versions:

  XM7     : V3.4L60 / V2.9L60 / V1.1L60 (latest) (*)
  XM7dash : V1.2L16 (latest) (*)
  XM7LP   : V3.4L60LP00 / V2.9L60LP00 / V1.1L60LP00 (latest) (*)

  * The Level No. of this DLL source code does NOT correspond to that of the original XM7.
    (as of V1.4L00.)

  (*) Information about "latest / not latest" is as of 2013-07-08.


3. How to Install:

  Put a DLL for the corresponding version / application into the directory
  in which XM7/XM7dash/XM7LP (.EXE) is installed.


4. How to Compile:

  A. Create some working directory and cd there.

  B. Uncompress this archive file into that directory.

  C. Copy
         xm7.h
         w32_res.h
         resource  (whole the directory)
     from the working directory of XM7/XM7dash/XM7LP source code.

  D. Arrange the compilation environment which is the same as that of
     XM7/XM7dash/XM7LP source code.
     - Set path to Borland C++, etc.

  E. Edit Makefile (if necessary).
     - Implement JSUB
     and so on.

  F. Make.
     - Specify the kind of target application and of the target version
       as the #define parameters of the make command.

    make -DTARGET_APP=app -DTARGET_VER=ver

    ex.)
    C> make -DTARGET_APP=XM7 -DTARGET_VER=V3	 # Create a DLL for XM7 V3
    C> make -DTARGET_APP=XM7LP -DTARGET_VER=V2	 # Create a DLL for XM7LP V2
    C> make -DTARGET_APP=XM7dash -DTARGET_VER=V1 # Create a DLL for XM7dash V1
    C> make -DTARGET_APP=XM7 -DTARGET_VER=V2T	 # Create a DLL for XM7 V2-V2

    * If no parameters are specified, a DLL for XM7 V1 is created.

  G. If no problems are found, a DLL named XM7V#EN.dll is created.
     (# is the number of the target version.
      For example, it is for V3 if #=3. #=2T for V2-V2.)


5. How to Create DLLs Other Than English Language:

  A. Replace messages in w32_res.rc included in this archive
     or in the original XM7 source code with the ones of the same meaning
     written in the target language.
     - Also change the fonts
	#define	FONTNAME	"Tahoma"
	#define	FONTSIZE	8
       if necessary.

  B. Replace
        CODEPAGE_ID = 1252
     in Makefile
     with the Codepage ID of the target language.
     For example:
         ANSI Latin-1 (Western European Langueages) = 1252,
         OEM US (English) = 437, OEM JP (SHIFT-JIS) = 932,
         Unicode (UTF-8) = 65001.
     Refer to
         http://msdn.microsoft.com/en-us/library/ee719641(PROT.10).aspx
     for detail.

  C. Replace
        LANGUAGE LANG_ENGLISH, 0x01
     in w32_res.rc (there are several numbers)
     with the LANGUAGE identifier of the target language.
     Refer to
         http://support.microsoft.com/kb/89866/EN-US
     for detail.

  D. Compile as explained in 4. above,
     and a DLL for the target language is created.
     If your Windows is not a Japanese version,
     or the "default language setting" is not Japanese,
     the language messages implemented in the DLL are shown.


6. How to Contact:

  Comment to the GUESTBOOK of the HP below for any questions, etc.

  - Ben.JP HomePage:
    http://motor.geocities.jp/a160_1930/FM-7/XM7_DLL/


7. Acknowledgement:

  - Spacial thanks to Mr. "Ryu Takegami", the author of XM7,
    and to Mr. "Toma", the author of XM7dash.
    Toma-san helped me with merging XM7dash resource code with XM7/XM7LP ones.
    Ryu-san evaluated thoroughly my beta-versions before the release.
    As of V1.2 L52a, he created a STUB file for compiling and executing the DLL.
    Without their help, this DLL could not be released.
    Thanks a lot, Ryu-san, Toma-san!

  - Spacial thanks to Anna Wu for translating XM7 messages into English
    and for kindly allowing me to use the result freely.
    That became quite a supportive reference to my own translation.


[EOF]
