| 1 | :h2 res=100085 id='PANEL_CRESOURCES'.
|
|---|
| 2 | Customizing FM&slash.2 Resources
|
|---|
| 3 | :p.Since FM&slash.2 is a GPL application&comma. anyone can build a private
|
|---|
| 4 | version of FM&slash.2 from source and modify the program as they choose&per.
|
|---|
| 5 | However&comma. if all one wants to do is replace icons&comma. bitmaps and
|
|---|
| 6 | text strings&comma. this is not required&per.
|
|---|
| 7 | The FM&slash.2 build system provides support for replacing resources without
|
|---|
| 8 | a full rebuild from source&per.
|
|---|
| 9 | :p.&eq.&eq. Prerequistes &eq.&eq.
|
|---|
| 10 | :p.You will need
|
|---|
| 11 | :p. &endash. a copy of the current FM&slash.2 sources
|
|---|
| 12 | .br
|
|---|
| 13 | &endash. a copy of the FM&slash.2 binary release
|
|---|
| 14 | .br
|
|---|
| 15 | &endash. a copy of the resource compiler&comma. RC&per.EXE
|
|---|
| 16 | .br
|
|---|
| 17 | &endash. a copy of the help compiler&comma. IPFC&per.EXE
|
|---|
| 18 | .br
|
|---|
| 19 | &endash. a copy of the exe compression tool&comma. LXLITE&per.EXE
|
|---|
| 20 | .br
|
|---|
| 21 | &endash. a subset of the Warp4 toolkit &numsign.include files
|
|---|
| 22 | :p.RC&per.EXE&comma. IPFC&per.EXE and the &numsign.include files are included in
|
|---|
| 23 | Warp4 Toolkit which comes with eCS or MCP&per.
|
|---|
| 24 | :p.Not all versions of RC&per.EXE are created equal&per. Currently&comma. the
|
|---|
| 25 | best version to use is&colon.
|
|---|
| 26 | :p. 12&endash.18&endash.97 6&colon.01 868&comma.000 0
|
|---|
| 27 | RC&per.EXE
|
|---|
| 28 | :p.which reports itself as&colon.
|
|---|
| 29 | :p. IBM RC &lpar.Resource Compiler&rpar. Version 5&per.00&per.002 Dec 18 1997
|
|---|
| 30 | :p.and it is available at&colon.
|
|---|
| 31 | :p.
|
|---|
| 32 | <.ftp&colon.&slash.&slash.ftp&per.software&per.ibm&per.com&slash.ps&slash.products&slash.warpzilla&slash.os2tk40rc&per.zip>.
|
|---|
| 33 | :p.You can get LXLITE&per.EXE at&colon.
|
|---|
| 34 | :p.
|
|---|
| 35 | <.http&colon.&slash.&slash.hobbes&per.nmsu&per.edu&slash.cgi&endash.bin&slash.h&endash.search?key&eq.lxlite&.pushbutton&eq.Search>.
|
|---|
| 36 | :p.It is recommended that you install the Warp4 toolkit&per. However&comma. if
|
|---|
| 37 | space is tight&comma. you only need to have RC&per.EXE&comma. IPFC&per.EXE and the
|
|---|
| 38 | following include files available&colon.
|
|---|
| 39 | :p. dirsize&per.h
|
|---|
| 40 | .br
|
|---|
| 41 | fm3&per.h
|
|---|
| 42 | .br
|
|---|
| 43 | fm3dlg&per.h
|
|---|
| 44 | .br
|
|---|
| 45 | fm3dll&per.h
|
|---|
| 46 | .br
|
|---|
| 47 | fm3dll2&per.h
|
|---|
| 48 | :p.&eq.&eq. What you can change &eq.&eq.
|
|---|
| 49 | :p.In general&comma. you can change any of the bitmaps or icons and you can make
|
|---|
| 50 | changes to the text strings in FM3DLL&per.STR&comma. FM3RES&per.RC or
|
|---|
| 51 | FM3RES&per.DLG&per. When making changes to text strings&comma. translate the &us.text
|
|---|
| 52 | only&us.&per. Do &us.not&us. reorder&comma. remove or create new lines in FM3DLL&per.STR&per.
|
|---|
| 53 | Do not modify the odd&endash.looking &percent.&percent.s&comma. &percent.&percent.lu&comma.
|
|---|
| 54 | etc&per. items in FM3DLL&per.STR&per. They are used by the formatted print routines&per.
|
|---|
| 55 | :p.When replacing icons&comma. make sure you provide an appropriate set of
|
|---|
| 56 | resolutions&per. When replacing bitmaps&comma. make sure you to size the bitmap
|
|---|
| 57 | to fit correctly in place of the original bitmap&per. You need to limit icons to 256 colors and 40x40 pixels&per.
|
|---|
| 58 | :p.Do not alter any other files&per. If you do not follow the above
|
|---|
| 59 | guidelines&comma. the resource update may fail or FM&slash.2 may refuse to run correctly&per.
|
|---|
| 60 | :p.&eq.&eq. Installation &eq.&eq.
|
|---|
| 61 | :p. &endash. Create a work directory&per.
|
|---|
| 62 | :p. &endash. Unzip the FM&slash.2 sources to this directory preserving
|
|---|
| 63 | the directory structure&per. The resulting tree will look like
|
|---|
| 64 | :p. &bxle.&bxh.&bxh.fm2&per.work
|
|---|
| 65 | .br
|
|---|
| 66 | &bxle.&bxh.&bxh.bitmaps
|
|---|
| 67 | .br
|
|---|
| 68 | &bxle.&bxh.&bxh.dll
|
|---|
| 69 | .br
|
|---|
| 70 | &bxv. &bxle.&bxh.&bxh.icons
|
|---|
| 71 | .br
|
|---|
| 72 | &bxv. &bxle.&bxh.&bxh.internal
|
|---|
| 73 | .br
|
|---|
| 74 | &bxv. &bxll.&bxh.&bxh.ipf
|
|---|
| 75 | .br
|
|---|
| 76 | &bxv. &bxll.&bxh.&bxh.bitmaps
|
|---|
| 77 | .br
|
|---|
| 78 | &bxll.&bxh.&bxh.icons
|
|---|
| 79 | :p. &endash. Unzip the FM&slash.2 binaries to the work directory&per.
|
|---|
| 80 | :p. &endash. Copy the DLLs from the the work directory to the dll subdirectory
|
|---|
| 81 | :p. &endash. Copy FM2RES&per.STR from the the work directory to the dll subdirectory
|
|---|
| 82 | :p.Alternatively&comma. you can use your installed FM&slash.2 binaries&per.
|
|---|
| 83 | :p. &endash. Copy the FM&slash.2 EXEs to the work directory
|
|---|
| 84 | :p. &endash. Copy the FM&slash.2 DLLs to the dll subdirectory
|
|---|
| 85 | :p. &endash. Copy FM2RES&per.STR to the dll subdirectory
|
|---|
| 86 | :p.&eq.&eq. Verification &eq.&eq.
|
|---|
| 87 | :p.To test your setup&comma. run&colon.
|
|---|
| 88 | :p. nmake res from the work directory&per. The makefile should run to completion without
|
|---|
| 89 | errors&per.
|
|---|
| 90 | :p.&eq.&eq. Customizing &eq.&eq.
|
|---|
| 91 | :p.To customize your copy of FM&slash.2
|
|---|
| 92 | :p. &endash. Edit the resources&comma. bitmaps and icons&comma. as needed&per.
|
|---|
| 93 | :p. &endash. Apply the updates to the EXEs and DLLs with nmake res
|
|---|
| 94 | :p. This will compile the resources&comma. decompress the the the EXEs and
|
|---|
| 95 | DLLs and apply the updated resources&per. The output of this process will be updated
|
|---|
| 96 | versions of one or more of the FM&slash.2 EXEs&comma. DLLs and FM3RES&per.STR&per.
|
|---|
| 97 | The nmake is efficient and only rebuilds the files with changed content&per.
|
|---|
| 98 | :p. &endash. Test your updates&colon.
|
|---|
| 99 | :p. set LIBPATHSTRICT&eq.T
|
|---|
| 100 | .br
|
|---|
| 101 | cd dll
|
|---|
| 102 | .br
|
|---|
| 103 | &per.&per.&bsl.fm3
|
|---|
| 104 | :p.LIBPATHSTRICT allows you to test the new FM&slash.2 version without shutting
|
|---|
| 105 | down the production version&per. When you are satisfied with your changes&comma. copy the updated executable
|
|---|
| 106 | files to your FM&slash.2 program directory and restart FM&slash.2&per. Some files may
|
|---|
| 107 | be locked&comma. so use the unlock&per.exe utility that comes with lxlite to allow the locked files
|
|---|
| 108 | to be overwritten&per. I recommend adding an unlock item to the commands
|
|---|
| 109 | menus&comma. so that you have it available from FM&slash.2&per.
|
|---|
| 110 | :p.&eq.&eq. Trouble Shooting &eq.&eq.
|
|---|
| 111 | :p.&endash.&endash. nmake does not rebuild the target &endash.&endash.
|
|---|
| 112 | :p.nmake depends on file timestamps to know what targets to rebuild&per. If you
|
|---|
| 113 | replace a file with an older version nmake may not do what you want it to&per.
|
|---|
| 114 | :p.One workaround is to use one of the available touch utilities&comma. to
|
|---|
| 115 | change the dependent file&apos.s timestamp&per.
|
|---|
| 116 | :p.If you do not want to change the file&apos.s timestamp&comma. use
|
|---|
| 117 | nmake &endash.a res to force all targets to be rebuilt&per.
|
|---|
| 118 |
|
|---|
| 119 |
|
|---|
| 120 |
|
|---|
