                      CodeDiver  Ver.1.1Beta8 README

        Copyright(C) 2002-2005 Hiroaki Imazeki All rights reserved.


   * 1. Introduction
   * 2. About the Demo Version
   * 3. Legal Stuff
   * 4. Notes on Use
   * 5. Installation
   * 6. Usage
   * 7. Hint of a setup
   * 8. Limitations
   * 9. Developer Contact Information

1. Introduction

  CodeDiver is the program for PEG-NX60/70V which changes operation
  of an application program from the exterior using the extended 
  function of OS5. The following items can be set up. 
   - Font replacement in the field. 
   - The mask of a jog assistant function. 
   - The simple macro function at the time of application program starting. 
  Moreover, although a screen flickers, it is also possible to set up
  false wallpaper. 

  When a setup is changed, the application which becomes unstable also has
  operation and it may become the situation which carries out worst
  hard reset.@So you need to backup all data?using MSBackup or other apps
  before testing.

  * Although it was provisional, in Ver.1.1Beta1, the replacement of a font
    also of the device which applied tsPatch became possible.


2.About the Demo Version

   The programs in this package are being made available as shareware for $10.00. 
  You can try out this demo version for 30 days after CodeDiver, WPDiver, or
  FontDiver being initially installed in your PalmOS device. To continue using
  the program, please send payments through Handango.

   -> http://www.handango.com/


  Upon payment, the registration key will be made available for download.
  Upon installing this key in the PalmOS device, program restrictions will be
  removed. Registration status can be viewed in the CodeDiver  "About" screen.



 * Notice before payment.......
  The CodeDivver interrupts the internal process of PalmOS, and changes
  font sizes,wallpaper and etc.. So, there are some application that cannot
  work well with CodeDiver. And I have no assurance for working on the future
  PalmOSes and applications, too.


3. Legal Stuff

- All rights for the programs contained within this package belong to the  
  CodeDiver developer (Imazeki Hiroaki, imazeki@jade.dti.ne.jp)
- The programs contained within this package are to be distributed as 
  shareware.
- The developer bears no responsibility for any losses incurred with any 
  use or non-use of the programs contained within this package.  Furthermore, 
  the developer may not be required to resolve any issues that may surface.
- Send bug reports and requests to the developer by email.
- It is prohibited to alter anything in the PRC file.
- Consult beforehand with the developer before distributing the programs 
  contained in this package.
- Except for articles to be used in magazines, consult beforehand with the 
  developer before writing about this software .


4. Notes on Use

  - PEG-NX 60/70V,NZ90,TG50 and tsPatch applied device. 
  - However, there are the following restrictions by the model.
    - The function relevant to a virtual silk cannot be used in TG50.
    - The function relevant to a virtual silk JogAssistMask WPDiver FontDiver
      cannot be used in TG50.

5. Installation

 -Download the zip file from the link in bottom, and pick up "CodeDiverEng.prc"
  from the downloaded archive, then install it onto CLIE via HotSync or
  other method. 
  The only difference between "CodeDiverEng.prc" and "CodeDiver.prc" is 
  the language on the messages. Both have the equivalent functions except that.
 -When using the function of a virtual silk by TungstenT3, T3_DIA_Compatibility_prcs.zip needs to be introduced.
 -When you use a wallpaper function, please also unite and introduce 
  WPDiveEngr.prc. It is the program converted to the wallpaper for CodeDiver
  from JPEG file. In addition, the kinds of silk skin which can create a
  converter with Japanese and the English version differ. For example,
  the right data cannot be created if WPDiver.prc is introduced into
  an English word device. Please introduce in accordance with the language of OS. 
 -When you use the position display function on a screen which supports 
  macro creation, please introduce PointDisp.prc. 
 -FontDiver of J-OSFontTool folder is only for Japanese devices.
  The English device is not supporting. 
 -It is beforehand when using the skin change of WonderSilk.   
  Please carry out introduction and a setup of WonderSilk. About WonderSilk, 
  the information on the program and the newest in the following address is 
  exhibited. Please refer to here.

    -> http://www.maicca.com/

6. Usage

 6-1. Activation
  Run hrFontMapper from home screen, and tap "ON" button.
  After reset the machine, hrFontMapper stays, and changes fonts on the 
  application you set.

 6-2. Deactivation
  Run hrFontMapper from home screen, and tap "OFF" button.
  After reset the machine, hrFontMapper stops working.

 6-3. Selecting the apps. 
   Please activate CodeDiver from CLIELauncher(home screen) or other
   launchers, and tap
   the "ADD"  button in the bottom of the window. Setting below items on the 
   following app. selection window.

   AppName:Application to work with CodeDiver. 

   Field Setting:
      The following items can be set up to the field. In addition, 
      it does not correspond to the field in tables, such as a DateBk. 

      stdFont    :Select the alternative font for "standard font."
      LargeFont  :Select the alternative font for "large font."
      Underline  :It specifies whether the underline of the field is
                  replaced. It acts only on two or more lines field. 
                  None -> Replacement is not performed. 
                  Norm -> A general dotted line 
                  Solid -> The solid line of the underline color
                           specified by UI setting.
                  Erase -> An underline is not displayed. 

   WallPaper     :according to the description in 6-4 prior.
   JOG Assist    :according to the description in 6-5 prior.
   VirtualSikl   :according to the description in 6-6 prior.
   StartupMacro  :according to the description in 6-7 prior.

   When you want to check the effect of setting changes soon, you can go 
   directly to the target application from the CodeDiver windows, without 
   going back to home screen.


   In addition, on the model which can rotate the direction of a screen,
   a setup can be added for every direction of a screen. It can be changed
   with the category button in the main screen upper part to which directions
   a setup is added.

   - Both -> It is a setup applied in every direction.
   - Portrait -> It is a setup applied when a screen is a portrait.
                 When a setup for Both and Portrait exists, a setup
                 for portraits is applied.
   - Landscape -> It is a setup applied when a screen is a landscape.
                  When a setup for Both and Landscape exists, a setup
                  for portraits is applied.

   * It is chosen at the time of application starting which setup is applied.
     Even when rotating a screen while application works, a setup chosen
     at the time of starting is continued.


 6-4.WallPaper
   If a wallpaper label is chosen, a setup about wallpaper can be performed.
   In addition, the wallpaper realized by CodeDiver is not normally displayed
   by the application, in order to write in a picture forcibly from
   the exterior. The following items can be set up in order to assist such
   a state. 


   WallPaper :Selection of ON comes to display wallpaper on the screen
             of an application. Nothing is displayed when wallpaper data
             is not being prepared. Please prepare data with reference to
             "6-8 . wallpaper conversion" in advance. 

   Refresh  :The interval which re-draws wallpaper is specified. 
             If "Full" is set up, although the rectangle erased by drawing
             operation of an application will be re-drawn at a short
             interval, load is high and operativity may be spoiled. This
             appears notably at the time of 16 bit color mode. Although
             the rectangle erased when "Half" was set up becomes remaining
             as it is for a while, the influence on operativity is
             suppressed low. "It is automatic" is set as "Half" and it is
             set as "Auto" except it at the time of 16 bit color. 

  Table    :When a picture is scrolled together by scroll operation of
            tables (title list of memoranda etc.), please set it as
           "Redraw" by it. The state where the picture in a table was
            removed is re-drawn at the time of this mode. However, when
            there is a part where the color of a picture and a character
            is the same, since it is not drawn, black etc. is not
            contained in the color of a picture and please make the portion. 

  Trim     :The blank which does not draw wallpaper to the screen upper
            and bottom sides is set up. For example, please always display a 
            clock etc. on the screen bottom part, and set it as an application
            to which wallpaper flickers. In addition, a numerical unit
            becomes a pixel (320x320 coordinates). 

  ForeColor:The character in the field and colors, such as various character
            sequences, are set up. When you set up the background of a black
            system, please adjust a color by this item. In addition,
            specification of black (r= 0x00, g= 0x00, b= 0x00) comes to use
            the standard color of a system. Moreover, priority is given to
            the color when application specifies the character color etc. 

  *About a conversion of wallpaper data, a 6-8. wallpaper conversion has
   description. 

 6-5.JOG Assist
   If JOG assistant panel is chosen, it can specify whether an assistant
  function is confirmed. Usually, although it is a setup which confirms
  assistance, if a mask is chosen, the mask of the jog operation of a system
  will be carried out. Moreover, if it checks in the back button owner
  effect, only the function about a back button will become system operation.
  Please specify it as the application which does not return to a home.   

 6-6.VirtualSilk
   If the panel for virtual silks is chosen, size change of form and the
  item of silk plug-in relation can be set up. 

  SizeChg        :It specifies whether it changes in size to application. 
          Force ->Rearrangement of layouts, such as a button, etc.
                 is performed compulsorily and it is made to operate like
                 a corresponding application to the application which does
                 not correspond to change of screen size. If this change
                 is performed to the application which has already
                 corresponded to size change, it will become the cause
                 by which a layout etc. collapses. 
         Set   ->Screen size at the time of starting and an end is
                 specified to the application corresponding to size change.
                 Since change of layouts, such as a button, does not perform
                 this size specification unlike "Force", if it is specified
                 as a non-corresponded application, a blank will occur in
                 the screen lower part. 
        OFF    ->Nothing is performed to application and the following setup
                 is not reflected, either. 
  StartedSize   :The size of the screen at the time of application starting
                 is specified. Specification of "same"operates nothing. 
  StopedSize    :The size of the screen at the time of application stoped
                 is specified. Specification of "same"operates nothing. 
  StartedPlugIn :Silk plug-in changed at the time of application starting
                 is specified. 
  StopedPlugIn  :It specifies whether it returns to silk plug-in which was
                 moving when an application started at the time of
                 an application stoped, or present plug-in is used as it is. 
  StartedWS     :WonderSilk skin changed at the time of application starting
                 is specified. 
  StopedWS      :It specifies whether it returns to WonderSilk skin which was
                 moving when an application started at the time of
                 an application stoped, or present WonderSilk skin is used as it is. 


 6-7.StartupMacro
  If a starting macroscopic panel is chosen, the simple broad view which
  can register two pen operations at the time of application starting can
  be set up. 

  StartupMacro:Macro operation at the time of application starting can
               be set up. A setup of "OFF" carries out the stripes of nothing. 
               If "ON" is set up, it will perform immediately at the time
               of application starting. If "Confirm" is set up, it can choose
               whether a broad view is performed at the time of application
               starting, or application is usually performed by operation. 

     Ope.n    :From a pop-up list, the operation which carries out an
               emurate is specified and a parameter is described. Operation
               will not be performed if it sets up "it is nothing." 
 
       Pen   :A pen tap is performed. However, a pen tap is not effective
              in all places. Although it is effective in a title bar or a
              button, it may not function on a table or the field. A parameter
              specifies coordinates and the starting point. Since it will not
              be influenced by the screen situation to carry out the tap of
              the screen lower part by the application which a screen expands
              and contracts if the lower left starting point is chosen, please
              use properly by the case. 

       Button :A button tap is performed. However, that in which a label
               does not exist like a graphic button cannot be specified.
               A parameter specifies the label of a button. 

   In addition, PointDisp.prc is enclosed in order to distinguish
   the coordinates of the button on a screen. Please start PointDisp.prc
   by DALuancher etc. after displaying the screen which wants to check
   coordinates. Since "***" is displayed on the screen upper left, please
   carry out the tap of the place which wants to check coordinates after
   that with a pen. X position, Y position from a screen, and Y position
   from under a screen are displayed. 

  * Macroscopic notes. 
    Operation is not based on the execution result of the operation before
    one, but performs operation 1 and operation 2 one by one. 
    For example, operation 2 is performed even if the button specified by
    operation 1 does not exist. 
    Moreover, operation cannot be performed to modal form (form as which
    the frame is usually displayed). 

 6-8.Wallpaper(Theme file) conversion 

   It can set up by the wallpaper data of CodeDiver creating a theme file
   from JPEG using a converter, and changing using DTChanger.  
  It is convertible by choosing "Convert WallPaper " from  the menu of 
  CodeDiver, or starting WPDiver from a home screen(CLIELauncher) etc. 
  Moreover, the silk skin data simultaneously aligned with wallpaper
  can also be created. 

  * Multi-volume correspondence is not carried out. When two or more
    volumes exist, the memory card inserted previously becomes effective.
 
  - Starting of a converter displays the list of JPEG files in /Palm/Images
    by the default. Moreover, the object of a list can be changed to
    the directories below /DCIM (for example, /DCIM/100MSDCF) by clicking
    a jog in the state where jog selection is not carried out, or choosing
    an upper right pop-up list.   

  - If a file to convert is found, the file will be chosen, and it is 
    "Convert". The tap of the button is carried out. 

  - Since a preview screen is displayed, while a pen adjusts a picture
    display, perform the rate of reduction, and various setup. 

  - The following items can be set up if the tap of the "Pref" button
    is carried out. 
     Conversion ->It can specify which (or both) shall be generated
                  between wallpaper and a silk skin. In addition, there
                  is no function to change a silk skin in CodeDiver and
                  a converter.please use TnSilkChanger. 
     Color     -> It can choose whether the data after creation is made
                  into 8 bit color or 16 bit color. In addition, although
                  data capacity increases when reproducing the color near
                  the original JPEG image, although it will be changed
                  somewhat finely by the function of OS if 8 bit color is
                  chosen, please choose 16 bit color. 
     ImagePos -> It can choose "a picture is always made to be settled
                 in a screen", "it arranging in a completely free position"
                 or, and "it arranging on a tile." Moreover, when picture
                 size is smaller than a screen, if the inside of a screen
                 is chosen, it will be arranged in the center. 
     Compress -> Usually, with "ON", although there is no problem, there
                 is a picture which does not have the compression processing
                 inside OS operation normally rarely. In such a case,
                 please turn "OFF." 
     Frame    -> The frame of a silk skin can be set up. 
                 Type1:Only graffiti area replaces a picture. 
                 Type2:A picture is replaced except a button, a character,
                       and a division line. 
                 Type3:Although it is a usual silk, it is the number of
                       colors. When having set it as 16Bit color, a picture
                       is transparent and it is visible. 
                 Line:A line expresses the position of a button or a
                       division line. 
                 None:A button etc. is disregarded only by the division line.
                      However, since a button etc. functions, it may be
                      able to use to enjoy a picture purely. 
    Comment   -> A comment can be added to a silk skin. 

  - If the tap of the "Efct" button is carried out, the effect over
    a picture can be specified. Now, transmissivity specification of
    the appointed color can be carried out, and it can carry out paint.
    In addition, it cannot undo about an effect. 

  - If the tap of the "start" button is carried out after completing
    a setup of an item, and specification of an effect, a conversion
    on wallpaper data and a silk skin will actually start. When silk skin
    creation is specified, the display about silk skin change is after
    a conversion end. When TnSilkChanger is already introduced, 
    please carry out the tap of "Change". 

   * Two or more conversion results can be held now from Ver11Beta3. Instead,
     new wallpaper is not displayed only by conversion work. It is necessary
     to change a theme using DTChanger (Display Theme Changer) currently
     exhibited separately.

 6-9.PIM Font
   If "PIM font" is chosen from the menu of CodeDiver, about the font of the
  DateBk,Address,ToDo and Memo carried as standard, a font can be set up per
  item apart from a setup for every above-mentioned application. 
  Only the case of changing the font of PIM since flickering of a font will
  not occur, if a setup is performed from this screen should use here. 
  In addition, this setup is reflected regardless of ON/OFF of  CodeDiver. 
  Moreover, if a setup of a font is changed on each application, a setup
  on CodeDiver will be canceled. In addition, in order to set up this item, 
  please start all applications at once. 

  * A setup may be effective against various replacement applications.
   In this case, please specify application individually, without performing
   this setup. 
  * Please specify a font from the setting screen of each application to
    return PIM font to a standard thing after trial employment period
    completion. 

 6-10.Uninstall
  It is NOT possible to delete CodeDiver when it's activated.
  Please stop CodeDiver according to the description in 6-2 prior to 
  deletion.


7. Hint of a setup

  - Although there is CodeDiver if the font in the field is replaced, 
    what is the field? The field is a place for editing a sentence on
    a screen. For example, if it is the memo pad carried as standard, 
    the domain which can perform the input of a character on an edit screen
    will serve as the field. Moreover, it may be used for the place for
    in addition to this displaying a sentence. 

  - Is there any method of judging the field certainly? 
    There is no method which which application program is using the field
    or is judged certainly (however, if the program which displays
    the structure inside a program, for example, PRCExplorer etc., is used,
    it can judge by high probability). Therefore, please perform the same
    setup to actual application after specifying it as a memo pad from
    CodeDiver once and checking operation, when the sentence display or
    judgment using appearance to the field is difficult. 

  - I want to prevent the layout collapse by size change of a font as much
    as possible. 
    Since the font replacement by CodeDiver is limited to the field, there
    is little influence on a layout. However, the field may be used as
    substitution of a label and influence may be made as for it to this.
    In such a case, replacement of a standard font should change only a setup
    of a large font, without carrying out. Thus, by many applications, if it
    sets, since the font in the input field can be changed by setup, 
    "an actual display is it Small to specify large by setup of
     an application by setup of CodeDiver" will become possible of it. 


  - Although the font specified only once is replaced, it will divide in
    the font which is different immediately. 
    When specification of a replacement font is set to "Standar" or "Large",
    a font will replace in two stages. For example, if it is made the
    following setup, a large font will replace Small. 
    StdFont:Small
    LargeFont:Standard

  - If it is made to scroll by the memo pad, ToDo, etc., wallpaper will shift. 
    In the application which displays an item list, in order to make a part
    of screen scroll, such a phenomenon occurs. In this case, "Redraw" of
    a table is set up. 

  - If a back button is pushed in the address to which a selection time
    display will disappear the item of a schedule if wallpaper is set up,
    an item display will disappear. 
    The above-mentioned processing is generated in order not to perform
    the display which shows the selection range to the portion which is not
    a background color, when drawing the selection range in a table. In such
    a case, please set refreshment as "Half" and set a table as "Redraw" . 

  - I want to stop that a display of wallpaper flickers as much as possible. 

   If refreshment is set as "Full", re-drawing of wallpaper will be
   performd frequently. Since it may become the cause by which this flickers,
   please try "Half", when set as automatic "Auto" or "Full" .


  - If the mask of the JOG assistance is carried out, it cannot return to
    a home with a back button. 
    If the mask of all the assistant functions is carried out, in order
    for the function of a back button to also lose an effect, the above
    phenomena occur. In such a case, please attach a check to the back button
    owner effect. In addition, please perform the long aggressiveness
    of a back button to return also to a home, with the mask also of the back
    button carried out. Since the tap of the "home" of silk area will be
    carried out by this, it returns from every screen to a home screen. 

  - A wallpaper converter and McFile. 
    WPDiver can be assigned "Send" of McFile. By using this function,
    it is possible to convert JPEG file which is in arbitrary directories
    from McFile. Refer to the document of McFile for the detailed setting
    method. 


8. Limitations

 - Some application doesn't work well with CodeDiver since it 
  interrupts the various internal process of PalmOS to replace fonts.
  So, Please don't use certain applications on hrFontMapper which has 
  scrambled screen or other incompatibilities.

  #Warning:
  It is the reason for the trouble that CodeDiver interrupts and change
  the PalmOS itself.
  So you don't send questions for the author of the application about this.

 - By the time a replacement setup of a font is reflected, delay may occur.
  For example, when scrolling is continued on a memo pad and it moves to
  another memorandum, it may be displayed with the font of a basis for
   a moment. 

 - A setup cannot be changed about "ARMNative application".
  It is excepted from the list of setting screens.
  (Examples HotSync and NetFront etc.)   

 - When StartedPlugIn is specified, re-drawing of silk area may occur
  mostly at the time of starting of an application, and an end. 

 - When changing screen size compulsorily, re-drawing may not be carried
  out if a screen is changed while the application works. It generates
  in many cases by the application which has drawn original parts and
  an original bitmap especially. 

 - Starting of the application set up by CodeDiver immediately after reset
  may not reflect a setup. This is because permanent residence of CodeDvier
  opens time not the time of reset but a little (about 2 seconds) and is
  performed. Therefore, please change an application for time after
  completing reset. Moreover, if it changes and returns to other applications
  even when a setup is not reflected first, it will come to be reflected
   normally. 

  - The wallpaper converter does not correspond to multi-volume. When two
   or more memory card (a memory stick, CF, etc.) is inserted simultaneously,
   the card inserted previously becomes effective.

 - Others
  There might be other unknown remaining issues.


9. Developer Contact Information

 To send email, please use:
    imazeki@jade.dti.ne.jp

 Email address and other information is available in the developer's home page:
    http://www.jade.dti.ne.jp/~imazeki/palm/
