Announcement

Collapse

Please use the Hentai ID thread for all hentai ID requests. Click me for link!

The Identification Thread is Here:

http://www.hongfire.com/forum/showthread.php/447081
See more
See less

AGTH - text extraction tool for games translation

Collapse
This is a sticky topic.
X
X
  • Filter
  • Time
  • Show
Clear All
new posts

  • AGTH - text extraction tool for games translation

    Current AGTH version: 2011.5.9

    Before asking something make sure you've read this first post, guides and searched in this thread.


    Related links

    AGTH home site: http://sites.google.com/site/agthook/

    Guide by mastress: http://blgames.proboards25.com/index...ead=1141106731

    Screenshot guide by fhc: http://www.hongfire.com/forum/showthread.php?t=59189

    Advanced AGTH Video Tutorials by Freaka: http://www.hongfire.com/forum/showthread.php?t=80401

    Itadaki (external toolset for adding furigana (reading) to kanji): http://www.hongfire.com/forum/showthread.php?t=75958

    Translation Aggregator (tool for querying many translation engines): http://www.hongfire.com/forum/showthread.php?t=94395



    AGTH general information

    AGTH is a tool for capturing text from running programs. Main purpose - extracting text from japanese games for translation.

    AGTH requires Windows 2000 or newer NT-based system, x64 and server variants are also supported. Recommended operation system - Windows 2003 and newer (yes, some features won't work on XP). With Vista/Win7 you would likely want to run AGTH with elevated rights or disable UAC.


    Running program under AGTH

    AGTH consists of hook module agth.dll and loader agth.exe.
    To load application - pass its name to agth.exe as command line argument.

    Example for running from shortcut:
    1) Create shortcut for game.
    2) Open properties of created shortcut. In "Target" field will be something like
    Code:
    "C:\Games\Maou no Musume-tachi\twins.exe"
    3) Append to the start of "Target" field full path to where you extracted AGTH, so it will be like
    Code:
    "C:\AGTH\agth.exe" "C:\Games\Maou no Musume-tachi\twins.exe"
    4) Make sure that "Start in" filed hasn't changed after you changed the "Target" and there is space between AGTH and game exe paths.
    5) Run game from this shortcut.


    Before name of game exe you can specify some options for AGTH. Each option must be separated by spaces from both sides.

    Example of running the same game but also automaticaly copy captured text to clipboard:
    Code:
    "C:\AGTH\agth.exe" /C "C:\Games\Maou no Musume-tachi\twins.exe"

    Working with loaded AGTH

    After load AGTH will create its window, where it will show captured text.

    AGTH separetes text into several 'text threads' based on 'context' (to avoid mess from mixing text of game, menu, title...).
    Displayed text thread could be chosen by drop-down list in the upper part of AGTH window. As game runs, new text threads could be found and added to list.

    If you close AGTH window it will not detach it's hook from the running applications, so if AGTH is started again it will continue to hook the text, hook options will be unchaged too.


    Additional features

    AGTH can try to correct locale of programs - useful for running japanese games with system locale set to non-japanese.

    /R option tries to correct locale the AGTH-way - minor visual glitches are possible, but overall program should run like started on system with specified locale.
    /L option works exactly as running program under AppLocale (also this option requires installed AppLocale).

    Both options can be used together.

    AGTH can be used just for fixing locale without any text hooking.
    Example of starting QuickATLAS with locale overriden to japanese (useful in case when you see only '?????' in it instead of characters):
    Code:
    C:\AGTH\agth.exe /L /NH "C:\Program Files\Atlas\QuickATLAS.exe"
    If you can't find useful text - try options /X3 and/or /V with loading by /P

    Recent changes

    2011.5.9
    • Added new type of user hook: Code.
    • Hardware hooks now also work on 32-bit XP SP3.
    • Improved /R override, now it should be able to run InnoSetup installers.
    • Added symbol '◇' to default filtering.
    • Removed user hook type: Hex.

    2011.4.21
    • Added support for LiveMaker engine.
    • Added support for IronGameSystem engine.
    • Updated KiriKiri support.
    • Updated RealLive support.

    2011.4.18
    • ASLR support, can be disabled with ':' at the end of user hook.
    • Improved /R override, just /R performs more aggressive process 'japanization' than /R411
    • Updated RealLive support.

    2011.4.16
    • Locale override support for Win7 (/R option).
    • Internal threading optimizations.
    Attached Files
    Last edited by Setx; 05-09-2011, 05:42 AM.

  • Originally posted by molitar
    Are you sure that your scroll lock key is on? The new keyboards don't have a scroll lock light
    o.O what kind of keyboard doesn't have a scroll lock light? weird...

    Comment


    • Futile Atlas translation?

      I tried playing Lamune with Atlas v11 and AGTH and found the translations to be horrible, is it just the way my atlas is set up or is that the best Atlas can do?
      ~アニメいつも~

      Comment


      • Danj2k many of the new multimedia keyboards do not have scroll lock keys. Especially since that key is pretty much an unused key anymore.

        Comment


        • LemonRumbler, you have to start some text in one of the other functions like GetGlyphOutlineW and feed some text into it by clicking on it in the game before userhookw thread shows up. Also sometimes the UserHookW shows up off the screen and you have to scroll down to it with the scroll key.

          Comment


          • Originally posted by Kattatsu
            I tried playing Lamune with Atlas v11 and AGTH and found the translations to be horrible, is it just the way my atlas is set up or is that the best Atlas can do?
            The translations by Atlas range from pretty good to ridiculous and can vary sentence from sentence. Still, you should be able to get the gist of a game's plot with it.

            Just make sure that all the Japanese characters you see in the game are being copied over to the Atlas clipboard. If not every character is being copied, you may need to choose a different Hooked set from the pull-down menu. In some games, changing the text appearance speed from slow to fast also works.
            Calvin: Here's another math problem I can't figure out. What's 9+4?
            Hobbes:
            Ooh. That's a tricky one. You have to use calculus and imaginary numbers for this.
            Calvin:
            IMAGINARY NUMBERS?!
            Hobbes:
            You know, eleventeen, thirty-twelve, and all those. It's a little confusing at first.

            Comment


            • Originally posted by LemonRuMBler
              Its not a "fuction" I have to select now is it?
              Er, yes, actually it is. You select it from the dropdown list box like you do with the other functions. That's where you should be seeing the UserHookW threads.

              Comment


              • LemonRumbler, you won't see it in the pull down UNTIL you have selected the glyphoutline and scrolled some text from the game.. It has to capture enough text from the game before the UserHookW shows up.

                Steps:
                1. Run AGTH
                2. Use scroll lock key
                3. Make sure GlyphOutline is selected
                4. Click on game to allow some text to be captured in AGTH
                5. Look to see if UserHookW has shown up yet or not. If not feed it some more text from the game. Look again.

                You have to follow the steps or AGTH can not capture enough text for it to be able to create the UserHook.

                Comment


                • molitar
                  You are wrong.

                  You should:
                  1) turn off ScrollLock
                  2) run AGTH
                  3) select thread like GetGlyphOutline
                  4) and only after that turn on ScrollLock.
                  5) get some more text and UserHook thread will appear

                  After appearing of UserHook status of ScrollLock doesn't matter.

                  LemonRuMBler
                  When you use '@address' ScrollLock is ignored and used address that you specified. That address must be correct for your game or you won't get any UserHook threads.
                  When you don't use '@address' - you can select needed basic text thread as described above.

                  Comment


                  • Setx - when trying to determine what /H parameters are necessary for a particular game, is it just a case of trial-and-error, or is there some method or procedure which can be followed? If it is necessary to use trial-and-error, what sort of range of values would you expect would be needed for the data_offset? 0x0 - 0xFF, or is the search space likely to be smaller (or larger) than that? Also, should data_offset values always be a multiple of 4, or are multiples of 2 possible as well?

                    Comment


                    • ^ Yea me too .. the userhook didnt appear to me when I tried with shuffle!
                      I get GetglyphoutlineA, multibytetowidechar and widechartomultibyte

                      Using getglyphoutline do produce the correct text but still atlas produce unconprehensible sentences, and it seems on longer sentences.. the earlier text was cut out ... .. I've used /C and /W only

                      Comment


                      • This is a very nice thread going on here... but I find it problematic to check each and every page for the new functions added to the program.. maybe you can edit your first post to include all of the functions? Oh, and I'm also having the same problem as ToxicKing.. anyone have any ideas on how to fix this?

                        Comment


                        • Originally posted by ToxicKing
                          ^ Yea me too .. the userhook didnt appear to me when I tried with shuffle!
                          I get GetglyphoutlineA, multibytetowidechar and widechartomultibyte

                          Using getglyphoutline do produce the correct text but still atlas produce unconprehensible sentences, and it seems on longer sentences.. the earlier text was cut out ... .. I've used /C and /W only
                          Since it's GetGlyphOutlineA you'd need to be using A with the /H switch instead of W, so your /H switch will be like /HA0#1 or something similar. The A means it is ASCII rather than "wide" characters which I would guess is why you're getting gibberish in ATLAS.

                          Comment


                          • Is the AGTH website down? Was going to go look at the compatibility list there and got Russia Newmail.

                            Currently playing: N/A | Currently seeking: My Requests
                            Co-leader of: HF-Bishoujo Games | Member of: (Unofficial) HF-Incest
                            My Resources: AGTH Tutorial and H Codes | Bishoujo Game Reviews

                            Comment


                            • Originally posted by mastress
                              Is the AGTH website down? Was going to go look at the compatibility list there and got Russia Newmail.
                              It does seem to be down. I think that compatibility list might be a bit out of date though; last time I looked at it it had Fate/stay night listed as not working.

                              Comment


                              • Agth program

                                Hello! the agth website seems to be down and im looking for the program to download i checked in hongfire but no luck, anyone knows where to get it?

                                Comment

                                Working...
                                X