LangPeeker - Revision history

Geep: /* Downloads */ Add link to license

2025-04-15T19:38:14Z

Downloads: Add link to license

← Older revision		Revision as of 19:38, 15 April 2025
Line 120:		Line 120:
	* Exe and associated .Net DLLs: [https://drive.google.com/file/d/1TeCaKzczn8y8MFIOlO9JXPz04BueznU8/view?usp=sharing langpeeker_exe_and_dlls.zip]. See also "Platform and Install" above.		* Exe and associated .Net DLLs: [https://drive.google.com/file/d/1TeCaKzczn8y8MFIOlO9JXPz04BueznU8/view?usp=sharing langpeeker_exe_and_dlls.zip]. See also "Platform and Install" above.
	* Source as VS project: [https://drive.google.com/file/d/12a7a2NrZXACvclGrARBJd5xy0X5ssvKR/view?usp=sharing langpeeker_source_project.zip]		* Source as VS project: [https://drive.google.com/file/d/12a7a2NrZXACvclGrARBJd5xy0X5ssvKR/view?usp=sharing langpeeker_source_project.zip]
			* Open source license for these: [https://drive.google.com/file/d/1mAhag1TtYT9stQiT2rQbtkPIBreB18-H/view?usp=sharing LICENSE.txt]

	== See Also ==		== See Also ==

Geep: /* Functionality */

2025-04-13T01:20:04Z

Functionality

← Older revision		Revision as of 01:20, 13 April 2025
Line 100:		Line 100:
	==== Functionality ====		==== Functionality ====
	* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).		* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
	* Unlike [[Gen Lang Programs]] and [[~~i18n~~.pl]], LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.		* Unlike [[Gen Lang Programs]] and [[I18N.pl]], LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
	* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.		* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

Geep: /* See Also */ added, & template

2025-04-13T01:17:34Z

Geep: /* Downloads */ Add links

2025-04-13T01:02:19Z

Downloads: Add links

← Older revision		Revision as of 01:02, 13 April 2025
Line 1:		Line 1:
	~~[PAGE UNDER CONSTRUCTION]~~
	''by Geep, 2025''		''by Geep, 2025''
	== Introduction ==		== Introduction ==
Line 97:		Line 96:
	* A WinForms app like this is Windows-specific. [Geep sez: Anyone else is welcome to explore a similar app for Linux. Or provide similar functionality within DR.]		* A WinForms app like this is Windows-specific. [Geep sez: Anyone else is welcome to explore a similar app for Linux. Or provide similar functionality within DR.]
	* This was built with .Net Framework 4.8; if your Windows install was done from 2019 on, you should have this already, and be able to run this app, with codepage conversions succeeding. (The app could have been built with the latest successor to .Net Framework and .Net Core, e.g., .Net 9, but then it might require you to install a newer version of .Net, with little advantage for this app.)		* This was built with .Net Framework 4.8; if your Windows install was done from 2019 on, you should have this already, and be able to run this app, with codepage conversions succeeding. (The app could have been built with the latest successor to .Net Framework and .Net Core, e.g., .Net 9, but then it might require you to install a newer version of .Net, with little advantage for this app.)
	* LangPeeker is distributed as a zip file, without installer. After download and unzip, copy the folder (with both LangPeeker.exe and various .Net dlls) to your desired location. Run the .exe, and maybe pin to your taskbar.		* LangPeeker is distributed as a zip file, without installer. After download and unzip into a folder, copy the folder (with both LangPeeker.exe and various .Net dlls) to your desired location. Run the .exe, and maybe pin to your taskbar.

	==== Functionality ====		==== Functionality ====
Line 118:		Line 117:

	== Downloads ==		== Downloads ==
	[~~TO DO][TECH PROBLEMS DELAYING RELEASE~~]		Version 1.0
			* Exe and associated .Net DLLs: [https://drive.google.com/file/d/1TeCaKzczn8y8MFIOlO9JXPz04BueznU8/view?usp=sharing langpeeker_exe_and_dlls.zip]. See also "Platform and Install" above.
	[~~SEE ALSO TO DO~~]		* Source as VS project: [https://drive.google.com/file/d/12a7a2NrZXACvclGrARBJd5xy0X5ssvKR/view?usp=sharing langpeeker_source_project.zip]

			== See Also ==
			[TO DO]
	[TEMPLATE TO DO]		[TEMPLATE TO DO]

Geep: /* Known Limitations */ revised

2025-04-12T23:34:43Z

Known Limitations: revised

← Older revision		Revision as of 23:34, 12 April 2025
Line 93:		Line 93:
	Settings are saved as Properties, structured during development through the VS IDE, and stored in its own MS-specific format in the Properties/Settings.settings xml file.		Settings are saved as Properties, structured during development through the VS IDE, and stored in its own MS-specific format in the Properties/Settings.settings xml file.
	=== Known Limitations ===		=== Known Limitations ===
			==== Platform and Install ====
	* This was developed under Windows 11 with .Net Framework 4.8 and Visual Studio Community 2022.		* This was developed under Windows 11 with .Net Framework 4.8 and Visual Studio Community 2022.
	* WinForms is Windows-specific. [Geep sez: Anyone else is welcome to explore a similar app for Linux. Or provide similar functionality within DR.]		* A WinForms app like this is Windows-specific. [Geep sez: Anyone else is welcome to explore a similar app for Linux. Or provide similar functionality within DR.]
	* ~~A reasonably modern version~~ .Net Framework ~~needs~~ to ~~be present on your machine~~. ~~Installation of that is beyond~~ the ~~scope here~~. ~~If your machine has only early versions~~ of .Net, ~~codepage conversions will fail~~.		* This was built with .Net Framework 4.8; if your Windows install was done from 2019 on, you should have this already, and be able to run this app, with codepage conversions succeeding. (The app could have been built with the latest successor to .Net Framework and .Net Core, e.g., .Net 9, but then it might require you to install a newer version of .Net, with little advantage for this app.)
	* LangPeeker is distributed as a zip file, without installer. After download and unzip, copy the folder (with both LangPeeker.exe and various .Net dlls) to your desired location. Run the .exe, and maybe pin to your taskbar.		* LangPeeker is distributed as a zip file, without installer. After download and unzip, copy the folder (with both LangPeeker.exe and various .Net dlls) to your desired location. Run the .exe, and maybe pin to your taskbar.

			==== Functionality ====
	* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).		* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
	* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.		* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
	* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.		* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

	~~One can imagine additional capabilities:~~		==== Imagined Additional Capabilities ====
	''[Geep notes: There are no plans for these features at this time; some require substantial work. Will a demand for them develop?]''		''[Geep notes: There are no plans for these features at this time; some require substantial work. Will a demand for them develop?]''

Line 112:		Line 114:
	* and of course editing.		* and of course editing.

	~~Additional~~ comments ~~about internal structure may be found~~ in the source code.		==== Internal Structure ====
			See comments in the source code.

	== Downloads ==		== Downloads ==

Geep: /* Known Limitations */ indicate just works with Windows

2025-04-12T20:52:19Z

Known Limitations: indicate just works with Windows

← Older revision		Revision as of 20:52, 12 April 2025
Line 2:		Line 2:
	''by Geep, 2025''		''by Geep, 2025''
	== Introduction ==		== Introduction ==
	LangPeeker is a standalone Windows utility program, to help fast deciphering of TDM localizations. You can use it to quickly lookup international-language information about specific #str_<id> strings used in an internationalized FM of interest and/or base TDM (e.g., menus). It could be helpful for a developer reviewing in DR an existing, unfamiliar FM that offers localization.		LangPeeker is a standalone Windows-desktop utility program, to help fast deciphering of TDM localizations. You can use it to quickly lookup international-language information about specific #str_<id> strings used in an internationalized FM of interest and/or base TDM (e.g., menus). It could be helpful for a developer reviewing in DR an existing, unfamiliar FM that offers localization.

	LangPeeker is a viewer, i.e., no editing. It presents 3 tab panes:		LangPeeker is a viewer, i.e., no editing. It presents 3 tab panes:
Line 94:		Line 94:
	=== Known Limitations ===		=== Known Limitations ===

	* This was developed under Windows 11 with .Net 4.8 and Visual Studio Community 2022. ~~Suitability for other op~~-~~sys is unknown~~. [Geep sez: Anyone else is welcome to explore ~~possibilities~~ for Linux. Or provide similar functionality within DR.]		* This was developed under Windows 11 with .Net Framework 4.8 and Visual Studio Community 2022.
			* WinForms is Windows-specific. [Geep sez: Anyone else is welcome to explore a similar app for Linux. Or provide similar functionality within DR.]
	* A reasonably modern version .Net Framework needs to be present on your machine. Installation of that is beyond the scope here. If your machine has only early versions of .Net, codepage conversions will fail.		* A reasonably modern version .Net Framework needs to be present on your machine. Installation of that is beyond the scope here. If your machine has only early versions of .Net, codepage conversions will fail.
	* ~~This~~ is distributed as a zip file, without installer. After download and unzip, copy the folder (with both .exe and various dlls) to your desired location.		* LangPeeker is distributed as a zip file, without installer. After download and unzip, copy the folder (with both LangPeeker.exe and various .Net dlls) to your desired location. Run the .exe, and maybe pin to your taskbar.
	* The zip file contains both LangPeeker.exe and ~~LangPeeker.dll. If Windows is~~ your ~~op-sys, run the .exe. For other op-sys (e.g., Linux with .Net installed), in theory [NOT TESTED!] you can run the program from the command line with:~~

	~~dotnet langpeeker~~.~~dll~~
	* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).		* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
	* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.		* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
Line 117:		Line 115:

	== Downloads ==		== Downloads ==
	[TO DO]		[TO DO][TECH PROBLEMS DELAYING RELEASE]

	[SEE ALSO TO DO]		[SEE ALSO TO DO]

	[TEMPLATE TO DO]		[TEMPLATE TO DO]

Geep: /* Known Limitations */

2025-04-08T21:49:39Z

Known Limitations

← Older revision		Revision as of 21:49, 8 April 2025
Line 94:		Line 94:
	=== Known Limitations ===		=== Known Limitations ===

	* Windows-~~specific~~. [Geep sez: Anyone else is welcome to explore possibilities for Linux. Or provide similar functionality within DR.]		* This was developed under Windows 11 with .Net 4.8 and Visual Studio Community 2022. Suitability for other op-sys is unknown. [Geep sez: Anyone else is welcome to explore possibilities for Linux. Or provide similar functionality within DR.]
	* If your machine has only early versions of .Net, codepage conversions will fail.		* A reasonably modern version .Net Framework needs to be present on your machine. Installation of that is beyond the scope here. If your machine has only early versions of .Net, codepage conversions will fail.
			* This is distributed as a zip file, without installer. After download and unzip, copy the folder (with both .exe and various dlls) to your desired location.
			* The zip file contains both LangPeeker.exe and LangPeeker.dll. If Windows is your op-sys, run the .exe. For other op-sys (e.g., Linux with .Net installed), in theory [NOT TESTED!] you can run the program from the command line with:

			dotnet langpeeker.dll
	* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).		* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
	* Unlike [[Gen Lang Programs]], LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.		* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
	* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.		* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

Line 111:		Line 115:

	Additional comments about internal structure may be found in the source code.		Additional comments about internal structure may be found in the source code.

	== Downloads ==		== Downloads ==
	[TO DO]		[TO DO]

Geep: Add images, related tweaks

2025-04-06T16:27:35Z

Add images, related tweaks

← Older revision		Revision as of 16:27, 6 April 2025
Line 20:		Line 20:
	When configuring LangPeeker for a new project, start with the "Settings" tab page, and fill in one or (as in Figure 1) both of the "Folder" fields.		When configuring LangPeeker for a new project, start with the "Settings" tab page, and fill in one or (as in Figure 1) both of the "Folder" fields.

	[~~Figure 1]~~		[[File:Langpeeker settings.jpg\|frame\|none\|'''Figure 1.''' "Settings" with both Folder fields filled in and the checkboxes set. After that, the "Apply and Test" button was pressed, resulting in the popup dialog shown.]]

	Figure 1. "Settings" with both Folder fields filled in and the checkboxes set. After that, the "Apply and Test" button was pressed, resulting in the popup dialog shown.

	If you touch the info icon to the right of the "FM Folder" field, you'll see this text:		If you touch the info icon to the right of the "FM Folder" field, you'll see this text:
Line 71:		Line 69:

	== Search ==		== Search ==
	[~~Fig~~. 2]		[[File:Langpeeker search.jpg\|frame\|none\|'''Figure 2.''' A typical successful search, with English results, for the configuration given in Figure 1. The author of the FM's content string in this case has included some explicit linebreaks (as "\n"; one actually starts the string). These will be treated as linebreaks in the "Contents as Multiple Lines..." pane. But one resulting line was still too long to view except with horizontal scrolling, so "Word Wrap..." was momentarily turned on.]]

	Figure 2. A typical successful search, with English results, for the configuration given in Figure 1. The author of the FM's content string in this case has included some explicit linebreaks (as \n; one actually starts the string). These will be treated as linebreaks in the "~~Multiline~~..." ~~Results~~ pane. But one resulting line was still too long to view except with horizontal scrolling, so "Word ~~wrap~~..." was momentarily turned on.
	=== Search Term Entry and Language Choice ===		=== Search Term Entry and Language Choice ===
	Suppose you are examining some aspect of an FM in DR or a text editor, and you start to encounter some #str_<id>s. You can configure LangPeeker for that FM (if not already done). Then, copy/paste or type a given #str_<id> into LangPeeker's search field, followed by <Enter>. Use the "Language" pull-down to choose among all the TDM-supported languages, keeping in mind for FMs, available translations are quite limited.		Suppose you are examining some aspect of an FM in DR or a text editor, and you start to encounter some #str_<id>s. You can configure LangPeeker for that FM (if not already done). Then, copy/paste or type a given #str_<id> into LangPeeker's search field, followed by <Enter>. Use the "Language" pull-down to choose among all the TDM-supported languages, keeping in mind for FMs, available translations are quite limited.
Line 84:		Line 80:
	For a given language, the matching text line in a .lang file is shown, broken up into 3 fields. The "within" field says which file was the source. If not found, that field will say so, and all other fields will be blank.		For a given language, the matching text line in a .lang file is shown, broken up into 3 fields. The "within" field says which file was the source. If not found, that field will say so, and all other fields will be blank.
	== Coverage ==		== Coverage ==
	[~~Fig~~. 3].		[[File:Langpeeker coverage.jpg\|frame\|none\|'''Figure 3.''' The "Coverage" page, for the configuration given in Figure 1. While the TDM base provides a full set of language files (e.g., for menus), this FM provides only English and German files.]]

	~~Figure 3. The "Coverage" page, for the configuration given in Figure 1. While the TDM base provides a full set of language files (e.g., for menus), this FM provides only English and German files.~~		Given what you configured in Settings, this page gives a quick view of what language resources are available. Two of the data columns simply reflect what you would see if you looked within the relevant file directories. The other two data columns indicate what you would know if there was an all.lang file and you surveyed [language] headings within it.

	Given what you configured in Settings, this page gives a quick view of what language resources are available. Two of the data columns ~~present~~ what you would see if you looked within the relevant file directories. The other two data columns ~~present~~ what you know if there was an all.lang file and you surveyed [language] headings within it.

	In addition, where redundant data sources are available, symbols indicate which source will be consulted and which ignored.		In addition, where redundant data sources are available, symbols indicate which source will be consulted and which ignored.
Line 106:		Line 100:
	* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.		* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

	One can imagine additional capabilities ~~if there was~~ a demand for them ~~(with lots more work to implement), e.g.:~~		One can imagine additional capabilities:
			''[Geep notes: There are no plans for these features at this time; some require substantial work. Will a demand for them develop?]''

	* visually indicate in Search's "Language" dropdown what languages are not available.		* visually indicate in Search's "Language" dropdown what languages are not available.
Line 118:		Line 113:
	== Downloads ==		== Downloads ==
	[TO DO]		[TO DO]

	[SEE ALSO TO DO]		[SEE ALSO TO DO]

	[TEMPLATE TO DO]		[TEMPLATE TO DO]

Geep: article created

2025-04-06T02:54:03Z

article created

New page

[PAGE UNDER CONSTRUCTION]
''by Geep, 2025''
== Introduction ==
LangPeeker is a standalone Windows utility program, to help fast deciphering of TDM localizations. You can use it to quickly lookup international-language information about specific #str_<id> strings used in an internationalized FM of interest and/or base TDM (e.g., menus). It could be helpful for a developer reviewing in DR an existing, unfamiliar FM that offers localization.

LangPeeker is a viewer, i.e., no editing. It presents 3 tab panes:

* Search
* Settings
* Coverage

When first used, you go to "Settings" and enter paths to the current FM and/or TDM installation. You may validate these by an "Apply and Test" button, which reports what language files are available to be searched. You get a brief popup report for English, plus an update to the full story for all possible languages under "Coverage".

Then at "Search", you enter a search term, with a language of immediate interest (like "English") selected. Most often, the search term is a specific #str_<id>, and you have constrained the search to just look among #str_<id> values for a match. It's easy to swap languages to see comparable results.

The results are broken into fields, with the string "Contents" field (of most interest) viewable in several forms.

== Settings ==

When configuring LangPeeker for a new project, start with the "Settings" tab page, and fill in one or (as in Figure 1) both of the "Folder" fields.

[Figure 1]

Figure 1. "Settings" with both Folder fields filled in and the checkboxes set. After that, the "Apply and Test" button was pressed, resulting in the popup dialog shown.

If you touch the info icon to the right of the "FM Folder" field, you'll see this text:

- Typically holds full path to <tdm_installed>\fms\<fm>
- Folder should contain <fm>_l10n.pk4 and/or
unpackaged dev project. (If both, pk4 is ignored.)
- LangPeeker will then look in /strings/fm/ for *.lang files.
- For instance, an 'English' search would consult english.lang or
the [English] section within all.lang
- If you're just working on TDM base strings, leave this field empty,
or set it here but skip it by unchecking Search tab's 'FM data'.

Similarly, the info icon for "TDM Folder" gives:

- Typically holds full path to <tdm_installed>
- Folder should contain either tdm_base01.pk4 or
unpackaged equivalent. (If both, pk4 is ignored.)
- LangPeeker will then look in /strings/ for *.lang files.
- For instance, an 'English' search would consult english.lang or
the [English] section of all.lang
- If you're just working on FM strings, leave this field empty,
or set it here but skip it by unchecking Search tab's 'TDM data'.
- But be aware that some FMs reference TDM base strings.

Additional checkboxes are:

* "Search FM before TDM". If you specify both an FM and TDM Folder path, this controls which is searched first.
* "As a data source, prefer all.lang over <languages>.lang".

To support its menu system, the TDM base distribution offers both UTF8 file all.lang, and a full set of <language>.lang files (of various codepage encodings). These two sources are largely redundant, so, '''when both are present''', you must choose which one to search. Considerations are:

* All.lang is considered the "master source", from which the <language>.lang files are generated.
* All.lang is already in UTF8 form, so no conversion is needed.
* Optional comments are more present in all.lang (a 2-edged sword).
* <languages>.lang is what the game actually uses (with a few characters remapped at runtime)

The same considerations could apply to an FM with localizations, but it is rare at this time for the FM's all.lang file to be distributed.

To ensure app consistency and correctness:

* Any changes to the checkboxes, and to a Folder field selected by its "Browse" dialog, will be applied immediately.
* Any change to a Folder field by editing or cut/paste will be applied either when you hit <Enter> or do "Apply and Test".

Generally, this update process will be quiet unless a problem is detected. On the other hand, using "Apply and Test" - whose 'apply' is sometimes harmlessly redundant - pops up additional information, revealing how an 'English' search would be processed. An example is shown in the Figure.

Paths and checkboxes under "Settings" are remembered across sessions (unlike constraints on the "Search" page). Each folder field offers a history of up to 5 recent paths.

== Search ==
[Fig. 2]

Figure 2. A typical successful search, with English results, for the configuration given in Figure 1. The author of the FM's content string in this case has included some explicit linebreaks (as \n; one actually starts the string). These will be treated as linebreaks in the "Multiline..." Results pane. But one resulting line was still too long to view except with horizontal scrolling, so "Word wrap..." was momentarily turned on.
=== Search Term Entry and Language Choice ===
Suppose you are examining some aspect of an FM in DR or a text editor, and you start to encounter some #str_<id>s. You can configure LangPeeker for that FM (if not already done). Then, copy/paste or type a given #str_<id> into LangPeeker's search field, followed by <Enter>. Use the "Language" pull-down to choose among all the TDM-supported languages, keeping in mind for FMs, available translations are quite limited.

=== Search Checkbox Constraints ===
Usually, you'll want to match only against the #str_<id> field in underlying *.lang files. But you can configure your search to include the string "Contents" field. You might do that if you remember a unique phrase from playing the game, and would like to determine its #str_<id>. The results found will then vary by language. For completeness, the "Comment" field (e.g., a line in all.lang that has "//...") can also be searched.

If in Settings you established both the FM and TDM Folders, you could, for a specific search, quickly limit it to just one or the other, with the Search checkboxes "FM Data" and "TDM Base Data".
=== Results ===
For a given language, the matching text line in a .lang file is shown, broken up into 3 fields. The "within" field says which file was the source. If not found, that field will say so, and all other fields will be blank.
== Coverage ==
[Fig. 3].

Figure 3. The "Coverage" page, for the configuration given in Figure 1. While the TDM base provides a full set of language files (e.g., for menus), this FM provides only English and German files.

Given what you configured in Settings, this page gives a quick view of what language resources are available. Two of the data columns present what you would see if you looked within the relevant file directories. The other two data columns present what you know if there was an all.lang file and you surveyed [language] headings within it.

In addition, where redundant data sources are available, symbols indicate which source will be consulted and which ignored.
== Implementation Notes ==
=== Framework ===
This was rapid-prototyped in Visual Studio Community 2022 as a standard MS WinForms app, written in C#, and using .Net libraries.
=== Conversion of Data to UTF8 ===
Search results are shown in UTF8 format. This is the native format for all.lang, so no conversion is needed for data drawn from there. Data from other <language>.lang files are not in UTF8, but in various codepages, mostly iso-8859-x, as detailed elsewhere. The facilities of modern .Net are used to convert to UTF8 after file read.
=== Persistence ===
Settings are saved as Properties, structured during development through the VS IDE, and stored in its own MS-specific format in the Properties/Settings.settings xml file.
=== Known Limitations ===

* Windows-specific. [Geep sez: Anyone else is welcome to explore possibilities for Linux. Or provide similar functionality within DR.]
* If your machine has only early versions of .Net, codepage conversions will fail.
* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
* Unlike [[Gen Lang Programs]], LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

One can imagine additional capabilities if there was a demand for them (with lots more work to implement), e.g.:

* visually indicate in Search's "Language" dropdown what languages are not available.
* for a given #str_<id>, show where it is used, not just defined.
* have Coverage show, out of items needing translation for a given language, the percent completed.
* have some method of stepping through the needing-translation items.
* during results display, perhaps incorporate some smarts related to the actual TDM bitmap font that deploys the string.
* and of course editing.

Additional comments about internal structure may be found in the source code.
== Downloads ==
[TO DO]
[SEE ALSO TO DO]
[TEMPLATE TO DO]

← Older revision		Revision as of 01:17, 13 April 2025
Line 1:		Line 1:
	''by Geep, 2025''		''by Geep, May, 2025''
	== Introduction ==		== Introduction ==
	LangPeeker is a standalone Windows-desktop utility program, to help fast deciphering of TDM localizations. You can use it to quickly lookup international-language information about specific #str_<id> strings used in an internationalized FM of interest and/or base TDM (e.g., menus). It could be helpful for a developer reviewing in DR an existing, unfamiliar FM that offers localization.		LangPeeker is a standalone Windows-desktop utility program, to help fast deciphering of TDM localizations. You can use it to quickly lookup international-language information about specific #str_<id> strings used in an internationalized FM of interest and/or base TDM (e.g., menus). It could be helpful for a developer reviewing in DR an existing, unfamiliar FM that offers localization.
Line 100:		Line 100:
	==== Functionality ====		==== Functionality ====
	* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).		* Because LangPeeker is oriented towards unique search terms, only the first hit is found; there is no "Next" button (or internals to handle such).
	* Unlike [[Gen Lang Programs]] and i18n.pl, LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.		* Unlike [[Gen Lang Programs]] and [[i18n.pl]], LangPeeker does not do a file pre-scan to remove potentially multiline comments of the form /* ... */. This may lead to an occasional false hit.
	* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.		* LangPeeker uses standardized conversions, which represent precisely what is in the .lang files, but neglects TDM-code remappings of a few characters.

Line 122:		Line 122:

	== See Also ==		== See Also ==
	[~~TO DO~~]		* [[Internationalization]]
	[~~TEMPLATE TO DO~~]		* [[Gen Lang Programs]]
			* [[I18N.pl]]

			{{editing}}