New PgcEdit help file [Archive]

blutach

27th January 2009, 00:44

wiseant

27th January 2009, 04:06

Greatly appreciated - thank you

Wombler

27th January 2009, 09:23

In preparation of version 9.2 being released soon, the help file has been updated (after 4 years!).

Please download it here (http://www.digital-digest.com/~blutach/PgcEdit_Manual.zip). Unzip it and pop it in the "Doc" subfolder of your PgcEdit folder.

In version 9.2, you will be able to call Help with Ctrl-Shift-H

Thanks to r0lZ for this excellent program and to Wombler for his fine work, on graphics in particular. Also, many thanks to mpucoder for his permission to reproduce some of his information in the appendices.

Regards

Thanks Blu!

I've said this to you privately on a number of occasions but it really is a genuine pleasure working with you and I've been glad to be a part of this.

As they say in Aussieland good onya mate! :cool:

Thanks also to the guys on this forum for their thanks. Much appreciated.

Wombler

r0lZ

27th January 2009, 10:31

A big thank also from me!

Wombler

27th January 2009, 11:17

@blutach

I've just downloaded this to have a look at here.

Some of the small icons for the menu sections no longer work and are now displayed as black squares.

Specifically the Preview, DVD, PGC & Scratchbook menus.

Very easily fixed no doubt.

Wombler

blutach

27th January 2009, 14:21

Hmmm - they look alright to me. ANyone else got problems seeing the icons in the PgcEdit's menus section?

Remember, you'll need to unblock it from the properties sheet for things to display (to get round the DEP thingo).

Regards

Wombler

27th January 2009, 15:11

I've already unblocked it and it still displays as per the attached.

Weird the way it's only certain icons though.

9337

Wombler

M_Knox

27th January 2009, 20:23

When I open the help file, Internet Explorer asks me to install Turkish language support for the help file to be displayed correctly (I cancel this message and the help file is displayed correctly). I looked inside the CHM and found out, that it has "iso-8859-3" encoding. Are you using any of the South European characters?

M_Knox

27th January 2009, 20:48

Wombler

27th January 2009, 20:48

The original was done up in Microsoft Word which I set for UK English.

When we'd reached a certain stage Blutach split it up into separate sections and compiled it as the CHM file.

So as far as the compiled version goes I've no idea but there's no reason I'm aware of for it to be using any strange characters.

I've re-downloaded the file now I'm at home and it works fine here so I'm still uncertain as to what's causing this.

Maybe it's just an issue with my machine in work. :confused:

Wombler

Wombler

27th January 2009, 20:55

@blutach
I found out, that the icons that fail to display correctly on Wombler's system are full pictures, i.e. they do not contain transparent pixels. All the other icons contain at least one transparent pixel. I don't have a slightest idea why it is so, though.

Interesting.

I'm only after checking them to see if the colour depth or anything else I could see was different but I'd never have thought of that one.

Can't think what difference that would make though and they're all prepared in the same software with the same techniques.

Maybe they've been inserted slightly differently or something.

I don't have the software to check this but Blutach can probably track this down.

Wombler

M_Knox

27th January 2009, 21:30

Wombler

27th January 2009, 21:43

That's great, thanks.

I see you've added transparent pixels.

Unfortunately I won't be able to test it until tomorrow though as they both work fine here, but I'll report back then.

Wombler

blutach

27th January 2009, 22:03

Many thanks to both of you for your help in tracking down this problem.

Wombler, if there needs to be changes to those little icons, please email me.

@M_Knox, no there are no South European characters. It is as Wombler said. Are you suggesting that I change the headers to 8859-1? BTW: Both your test CHMs work fine here.

Regards

r0lZ

27th January 2009, 22:06

So as far as the compiled version goes I've no idea but there's no reason I'm aware of for it to be using any strange characters.Maybe that arrows in the menu labels that my system cannot display correctly? I've reported that problem on the beta forum. At a specific stage during the development of the manual, I've also been told to install the support for another language, but I haven't paid attention to that.
However, I see now, on my new clean WinXP installation, that the arrows are displayed correctly, and I have not installed the Turkish language support!

[EDIT] I forgot to say that I have no problem with the icons, against on my new XP system. (I haven't tried on my old system, as it takes ages to boot.)

Wombler

27th January 2009, 22:23

Wombler, if there needs to be changes to those little icons, please email me.

Will do.

If M_Knox's versions work then it's something that's extremely easily fixed.

Although to be honest I can't for the life of me fathom why the lack of transparency could cause any problems but it's the only difference we can find so who knows.

Wombler

blutach

27th January 2009, 22:27

I'm glad about the arrows! It seems your reinstall has gone well r0lZ! I know that's a big task.

Thanks to everyone for their feedback.

Regards

Wombler

27th January 2009, 22:33

Maybe that arrows in the menu labels that my system cannot display correctly? I've reported that problem on the beta forum. At a specific stage during the development of the manual, I've also been told to install the support for another language, but I haven't paid attention to that.
However, I see now, on my new clean WinXP installation, that the arrows are displayed correctly, and I have not installed the Turkish language support!

Hmmm the South European character set contains mainly accented characters and is used in Turkish.

Seems like too much of a coincidence to me although r0lZ's problem may be caused by the headers.

Here are the various character set details.

http://czyborra.com/charsets/iso8859.html

Wombler

M_Knox

28th January 2009, 01:15

@M_Knox, no there are no South European characters. It is as Wombler said. Are you suggesting that I change the headers to 8859-1?

I just bursted through all the HTML files and did not find any special character that needed iso-8859-3 charset - that means you can safely change headers to iso-8859-1

To clarify things - I'm using Windows 2000 PL at home, and it was complaining about the Turkish language support missing. On my business laptop I have Windows XP and it does not complain :)

blutach

28th January 2009, 04:55

That's probably it - I'm on XP, too. I'll change the headers though and re-upload. I've also added a bit of text to a couple of pages for the web version, which I am keen to have in the compile.

Thanks for your feedback.

A new file has been uploaded - please use the link in post 1.

Regards

Wombler

28th January 2009, 09:06

@Wombler,

I prepared a small test: http://members.elysium.pl/morris/misc/PgcEdit_help_file_icon_test.rar

One CHM is compiled with original icons taken from PgcEdit_help file. The other one is with corrected icons.

That is really bizarre.

I've figured out what's wrong but I don't know what's causing it.

For some reason it's displaying the mask over the top of the icon instead of the other way around (see attached - most obvious on the chain icon).

Any ideas?

9343

Wombler

M_Knox

28th January 2009, 15:33

Yeah, strange. Maybe the best option would be to convert those icons to PNG? :) I'll have a look at it at home.

Wombler

28th January 2009, 19:02

Yeah, strange. Maybe the best option would be to convert those icons to PNG? :) I'll have a look at it at home.

Yeah I'd already considered that but Blutach wanted to replace the contents window icons with the custom ones and I wasn't sure if you could do that with PNGs.

After a lot of tests I think I've found the problem though.

It seems to be a bug in IE 6 which most of our machines in work are still running. :rolleyes:

I'll have it upgraded and see if that cures it.

Wombler

M_Knox

28th January 2009, 21:30

I've prepared another test. Please view it before upgrading your IE6 :)
http://members.elysium.pl/morris/misc/menu_new2.rar

Wombler

28th January 2009, 22:05

Will do.

I'll test it first thing tomorrow.

Thanks.

Wombler

blutach

29th January 2009, 01:01

Glad to know it's not a problem with the help file itself :)

Regards

Wombler

29th January 2009, 09:12

I've prepared another test. Please view it before upgrading your IE6 :)
http://members.elysium.pl/morris/misc/menu_new2.rar

Excellent, that works!

What exactly did you do?

Wombler

M_Knox

29th January 2009, 09:40

I modified the color table in the icons' bitmaps - I moved the black color (0x000000) to the first position in the color table. I came up with this idea when I noticed, that all the other icons, although not using black pixels, had the black color on the first position in the color table. A bit of hexeditor work :)

Wombler

29th January 2009, 10:16

That's a brilliant piece of detective work.

Thanks for that!

Wombler

blutach

29th January 2009, 13:43

OK, the manual has been updated with the icons from M-Knox's New_menu2 files.

Please re-download the zip from the link in post 1 and test (including the icon's on PgcEdit's Menu's subsidiary pages).

If all is well, this will be bundled in version 9.2

Regards

Wombler

29th January 2009, 15:06

It's working fine here now Les so looks like we're all set.

Wombler

M_Knox

29th January 2009, 20:30

Hmmm, the manual's front page says "PgcEdit version 9.2, January 2009". r0lZ, you gotta hurry! :D :D

r0lZ

29th January 2009, 21:06

I know. It contains some info related to the next version.
I'm working on it...

blutach

29th January 2009, 22:26

It's the manual that is dated January 2009, not necessarily the program :)

Regards

Wombler

29th January 2009, 22:57

We could always change it to February though. :D:D

Wombler

blutach

29th January 2009, 23:26

Don't worry, the versions will soon overtake us again, Wombler. :)

Regards

Wombler

29th January 2009, 23:53

Yeah hopefully it won't take us four years to update it the next time though. :D:D:D

Wombler

jinjin_jp

22nd February 2009, 14:48

I can't see manual file.

Is there anything wrong in my method ?

I click first "HELP", and next click "Documentation". The there is opened chm file, but there is shown 'The navigation to the Web page was canceled' (actually in Japanese).

I moved "PgcEdit_Manual.chm" to "doc" folder from PgcEdit installation folder, but it was not resolved.

I put the files of the HTML version in "doc" folder in the PgcEdit installation folder, but it was not resolved.

Regards.

Wombler

22nd February 2009, 21:43

@ jinjin_jp,

The CHM file should be placed in the same directory as the PgcEdit.exe file.

This is where PgcEdit checks for the help file.

Wombler

jinjin_jp

22nd February 2009, 23:46

@ jinjin_jp,

The CHM file should be placed in the same directory as the PgcEdit.exe file.

This is where PgcEdit checks for the help file.

Wombler

Thanks for the res.

At first, the CHM file is placed in the same directory as the PgcEdit.exe file.
I moved it, because I can't it see and foud the explanation like below.

How about ?
The compiled HTML documentation file for Windows (PgcEdit_Manual.chm) is included in the PgcEdit_v9.2_winexe.zip file, but not in the Linux archive. You can also download it separately here or here. To install it, create a directory "doc" in your PgcEdit installation folder, and copy the CHM file in that directory. This way, PgcEdit will be able to access it from its Help menu.
in http://forum.doom9.org/showthread.php?t=145037

The documentation files should be placed within a "doc" folder in the PgcEdit installation folder. This way, you will be able to launch the documentation from PgcEdit's Help -> Documentation menu.
Under Windows, if a file called PgcEdit_Manual.chm is found in the doc folder, it is used.
in PgcEdit's homepage.

Regards.

ron spencer

22nd February 2009, 23:53

it will work even if not in doc folder....mine does

r0lZ

23rd February 2009, 01:07

Yes, PgcEdit searches the doc files in the installation folder and in the doc sub-folder. It searches for PgcEdit_Manual.chm and PgcEdit_Manual.htm.

Jinjin, do you have foreign (non-ASCII) characters in the path of the PgcEdit installation folder? That could explain the problem, as Tcl/Tk has trouble with non-standard characters in the path names. If it's the case, try to move the whole PgcEdit folder in C:\, and see if that solves the problem.

blutach

23rd February 2009, 16:00

jinjin - please read post 1 in this thread. You must unblock the file from its properties. While DEP is active on the file (it is marked as blocked), all calls to the internet from the CHM will be blocked and you will get that sort of message.

To get rid of DEP automatically, you can put Doom9, PgcEdit's homepage etc in your Trusted Sites zone.

Regards

jinjin_jp

23rd February 2009, 18:07

@blutach

Thanks for the res.
Sorry, I mistook to notice about "unblock the file from its properties".
After doing as you say, it is rersolved.:thanks:

@r0lZ

Thanks for the res.
The reason was my mistake to read explanation.

Regards.