Help Add-in
#1
Posted 22 August 2005 - 01:42 AM
Displays a quick (and short) HelpText on each CP300 Function, Command and SystemVariable.
he just made some CASIO's work
http://www.classpad....php?id=228&cat=
#2
Posted 22 August 2005 - 09:52 AM
Documentation is currently limited. I think that more details should be given on each topic, together with some representative examples. For example, the function "judge" is currently documented as:
Fun: judge(e)
Returns True if e evaluates to true otherwise it returns false.
It will be nice if more information is given, e.g.:
If e cannot be evaluated to TRUE or FALSE, it returns "Undefined".
This function makes simplifications on its argument before judging. e can be any expression, but matrices cannot be compared.
>Examples:
judge(x^2-1=(x-1)(x+1)) returns TRUE
judge(x^3-1>x^3) returns FALSE
judge(x^3-1>x) returns Undefined
Of course, this needs a lot of work, but I'm sure that many ClassPad users (me included) will be happy to give a hand.
Furthermore, when using any ClassPad application the Help cannot be used directly: one must ruturn to the menu, then select the Help Add-In to get some help. The best implementation is to add the help ability in the OS, for example by a menu item in the System Menu (which is present in any application). However, this is Casio's responsibility, I don't think that the author can do that.
Nevertheless, this Add-In is extremely helpful.
ps1: A small remark: When opening a function or command list, the message "Reocrd %:" that appears should be corrected to "Record %:". A common mistake.
ps2: THE AUTOR JUST MADE SOME CASIO's WORK.
omegavirus said it already, and I totally agree. I just wanted to repeat it in capital letters. Does anyone in Casio hear this?
#3
Posted 25 August 2005 - 02:06 AM
#4
Posted 25 August 2005 - 08:14 AM
Unfortunately, the Add-In is still slow. It seems that the Function or Command index is rebuilded each time the user switches between them, or after finishing a search. Documentation is still very short, but better than nothing.
Unfortunately, ClassPad News in classpad.org does not say anything about this Add-In. The last news available is the "Free Cell" and an update for "Pyramid Solitaire". The Help Add-In is included in the "New Downloads" section, but I cannot see why two patience games are included in ClassPad News, while the Help Add-In is not. Furthermore, there is no "Utilities" section in the "Add-Ins downloads" (http://www.classpad....ories.php?cat=3). All Add-Ins are grouped in a single category named "Games". There you can find several Add-Ins which are not games, but utilities. In this category, you can also find the SpreadSheet, which is not an Add-In anymore, but part of the OS. It seems that people in Saltire are enjoying their vacations now...
#5
Posted 25 August 2005 - 05:47 PM
#6
Posted 25 August 2005 - 08:59 PM
Unfortunately, ClassPad News in classpad.org does not say anything about this Add-In. The last news available is the "Free Cell" and an update for "Pyramid Solitaire".
The "ClassPad News" section isn't designed to be a "New Downloads" section. It was designed to list important updates and news about the ClassPad. As with most calculators though, interesting news doesn't happen that often. Ricky (the web master for ClassPad.org) decided to try and add something (anything) every month or two so the section doesn't get too stale.
The next time Ricky updates classpad.org he might updated the main page to list new downloads somewhere.
The Help Add-In is included in the "New Downloads" section, but I cannot see why two patience games are included in ClassPad News, while the Help Add-In is not.
Again, News isn't new downloads. Ricky wanted to add something to the "News" section last month and this was the most recent thing he could find. Every time an add-in is added it won't be listed under "News".
Actually, there is a main section and one sub-section. The number of add-ins that are not games are small enough to fit on the main "add-in" section. Ricky added a "Games" sub-section because enough games had been created where it made sense.Furthermore, there is no "Utilities" section in the "Add-Ins downloads" . All Add-Ins are grouped in a single category named "Games". There you can find several Add-Ins which are not games, but utilities.
I suppose Ricky could create a dozen sub-categories for science, math, utilities, editors, and put one or two add-ins in each, but I'm sure then someone else would complain about this. If all the non-game add-ins fit in a single page I don't see a problem right now. The number of add-ins has grown a bit where it makes sense to split things up again soon.
Sue, it's part of the OS, but it is still an add-in too. If you don't have OS 2.0 you can download it. Anyway to just redirects you to Casio's classpad.net website. They still have it listed there, which is why classpad.org still has it listed.In this category, you can also find the SpreadSheet, which is not an Add-In anymore, but part of the OS.
Sure, it isn't a useful add-in given OS 2.0 and maybe it should be removed from the list, but I don't think it's hurting anyone right now.
No, we're just spending too much time posting on forums.It seems that people in Saltire are enjoying their vacations now...
I don't see anything out of date on ClassPad.org (with the exception of you'd like things designed differently ). ClassPad.org was designed so not to require too much work to maintain it, and I don't see any big problems with it. When Ricky has time he does try to update things a bit as needed. For example if the add-in section gets too big I'm sure he will sub-divide it.
#7
Posted 25 August 2005 - 09:07 PM
Actually, Saltire is a bit unique because they offer 4 weeks flex-time. You use these 4 weeks for vacation, sick time, personal days, etc... You can also carry over 2 weeks and end up with a full 6 weeks in a single year.About the vacations, I know that Saltire is a real Every-Month-Is-A-New-Vacation company. However, they work very hard on the ClassPad and they are all really good people. I am telling this honestly from my personal experience.
Of course I was at risk of loosing vacation time last year because I had almost 4 weeks left in December! This is why I've taken a bit more vacation time this year over previous years . Also, I normally don't take a lot of vacation time all at once. Instead I like to take lots of extended weekend trips.
Of course when you factor in the 50-60 hour work weeks and the fact that I tend to do some work even when I'm on vacation I suppose you might call me a workaholic. Then again, when you love what you do can you really call it work?
#8
Posted 26 August 2005 - 09:58 AM
Anyway, there is nothing wrong in vacations, we all need them. It should be obvious that I didn't wanted to offend anyone, I just wanted to make some suggestions.
PS: "Final Fantasy IX" is a game, so it shouldn't be present in the main "Basic" category, but in the sub-category "Games". Furthermore, "ToPolar" is a utility, so it should be moved in the "Utilities" sub-category.
#9 Guest_Martin Saurer_*
Posted 05 September 2005 - 09:36 AM
The performance problem is caused by the deletion of the entries of the keyword list. Filling the keyword list is much faster ??? Don't know why ???
Unfortunately on the ClassPad Emulator, all is working very fast, this makes the
development process not so easy (Compile ... Transfer to ClassPad ... Test ... and so on ...).
As soon as time permits I will investigate in this problem, and try to find a solution.
I will also add more help text with some examples. This is a lot of work, so please give me some time.
Anyway, I'm glad to hear, this AddIn is useful for you.
Cheers
Martin
#10
Posted 05 September 2005 - 10:29 AM
Good to know .I hear you ...
The developer should have all time he needs. It's easy to realize that there is a lot of work to do. Just let us know, whenever you release a new version of the help Add-In...The performance problem is caused by the deletion of the entries of the keyword list. Filling the keyword list is much faster ??? Don't know why ???
Unfortunately on the ClassPad Emulator, all is working very fast, this makes the
development process not so easy (Compile ... Transfer to ClassPad ... Test ... and so on ...).
As soon as time permits I will investigate in this problem, and try to find a solution.
I will also add more help text with some examples. This is a lot of work, so please give me some time.
Obviously, your Add-In is useful to every CP user. Keep up the good work!Anyway, I'm glad to hear, this AddIn is useful for you.
#11 Guest_Martin Saurer_*
Posted 07 September 2005 - 07:36 AM
- Performance should now be ok, I hope.
- Cancel in Find dialog should be ok.
- No more typing mistakes ...
Please let me know, what you think ...
More help text and examples, planned for one of the next releases ...
#12
Posted 07 September 2005 - 06:44 PM
Performance is now ok, and the Add-In becomes really useful. I think that it's time to add more help text and examples, as you 're planning.I just uploaded Version 1.4 of the CP300 Help Add-In.
One more thing may also be useful: to add some kind of "links", i.e., the ability to go from one help text to another. Example: Currently, the help text for "Cross" is:
Cmd: Cross
Graph/Plot Type for use in commands such as "StatGraph" etc.
Here, "StatGraph" should be a link, in the sense that tapping on it will lead to the help text for this command. A link may be written in boldface, as a sign that it is not normal text.
A "See also" field, with links to other relative help text, will be useful as well. Example: currently, the help text for colDim is:
Fun: colDim(e)
Returns the number of columns in a matix.
Apart from the fact that an example is needed here, it will be also useful to add something like:
See also: rowDim(e).
where "rowDim" will be a link.
A small typo: see the current help text for Clear_a_z. There is checked square instead of an apostrophe (') in the text.
#13 Guest_Martin Saurer_*
Posted 07 September 2005 - 07:15 PM
Performance is now ok, and the Add-In becomes really useful.
Thanks for your feedback.
Your request about a full help system with hyperlinks, etc. is far beyond that what this program should be (a Quick Reference ).
Anyway, to realize such a "full help system" is an interesting challenge. I will look what I can do ...
However, the next step will be some code cleanup.
As some people said in this forum, it's would be really useful, when help is available from within any application.
I don't know whether this could be done with the "normal" CP SDK, but I try to investigate ...
I hope Casio hear the requests from their users, and will implement a "full help system" in one of the next OS releases.
#14
Posted 07 September 2005 - 11:00 PM
It was just an idea. Your Add-In is still useful as it is now. Adding more help text and examples will make it a "must" for ever CP user.Your request about a full help system with hyperlinks, etc. is far beyond that what this program should be (a Quick Reference ).
Anyway, to realize such a "full help system" is an interesting challenge. I will look what I can do ...
I don't like C++, and I'm not using the SDK, but it seems that making an Add-In working in every CP application is such a universal problem.As some people said in this forum, it's would be really useful, when help is available from within any application. I don't know whether this could be done with the "normal" CP SDK, but I try to investigate ...
A lot of people are disappointed by the OS releses we have seen until now. I don't really hope that this will change in the future. I'm afraid that you will not see a "full help system" in a next OS release.I hope Casio hear the requests from their users, and will implement a "full help system" in one of the next OS releases.
#15
Posted 18 September 2005 - 07:08 PM
For example, the function inverse cosine is showed as cos^-1, but it would we good if the "-1" is showed as superscript.
So, here is how I would do: Just write "cos\xED\xFC" instead of cos^-1 (See ClassPad SDK Programming guide to see all character codes)
More example : E for EXP : "\xEE\x03"
pi : "\xEE\x04" ...
And you could add the hidden functions:
Here they are:
-insert(a,op,: op = 0 -> a+b
op = 1 -> a-b
op = 2 -> a*b
op = 3 -> a/b
op = 4 -> a^b
-element(List,index) Returns List[index] List must be only a variable name
-element(Mat,row,col) Returns Mat[row,col] Mat must be only a variable name
-completeSqr(Eq[,var]) Eq must be a formula of type ax?+bx+c Var is the variable (default is x)
I don't know what this returns...
-conicsForm(Eq,n) Eq is a conics equation and -1<n<1
I don't know what this returns too...
-Receive, Send and CheckNaturalNum: I didn't understand these functions yet
I often prefer putting PegBitmapButton's in the Toolbar, instead of PegTextButton's.
But it's your program...so it's your choice.
Bye!
#16
Posted 18 September 2005 - 07:14 PM
(ax?+bx+c) -form ----> (k(x+m)?+p) -form
#17 Guest_Martin Saurer_*
Posted 21 September 2005 - 07:03 PM
So, here is how I would do: Just write "cos\xED\xFC" instead of cos^-1 (See ClassPad SDK Programming guide to see all character codes)
More example : E for EXP : "\xEE\x03"
pi : "\xEE\x04" ...
Good point, but it seems I have to change the UI elements, because these ones I use cannot display such special characters.
Cheers ...
#18
Posted 21 September 2005 - 08:31 PM
What function are you using to display. All the ClassPad display functions should recognized these codes.Good point, but it seems I have to change the UI elements, because these ones I use cannot display such special characters.
Cheers ...
What do you see when you try to use these codes? If you see the explicit "\xEE\x03" then it's possible the string is incorrect.
#19 Guest_Guest_*
Posted 23 September 2005 - 04:19 PM
What function are you using to display. All the ClassPad display functions should recognized these codes.
What do you see when you try to use these codes? If you see the explicit "\xEE\x03" then it's possible the string is incorrect.
I'm currently using PegVertList, PegTextButton and PegEditBox UI elements.
These UI elements display the special characters as a "checked square".
#20
Posted 24 September 2005 - 04:06 PM
These should all display multi-byte characters correctly. Are you using a special font, or the built-in font? How are you defining the strings? Also, what codes are you using? The SDK help file has all the correct codes. You have to use both bytes of the multi-bytes characters. If you use the correct 2-byte codes in a string and you are using the built-in font it should display correctly.I'm currently using PegVertList, PegTextButton and PegEditBox UI elements.
These UI elements display the special characters as a "checked square".
#21 Guest_Martin Saurer_*
Posted 24 September 2005 - 07:38 PM
These should all display multi-byte characters correctly. Are you using a special font, or the built-in font? How are you defining the strings? Also, what codes are you using? The SDK help file has all the correct codes. You have to use both bytes of the multi-bytes characters. If you use the correct 2-byte codes in a string and you are using the built-in font it should display correctly.
OK, it seems I have to read the manual
As I have understand, the "Peg" classes (PegTextButton) use char or PEGCHAR pointers.
It seems they don't display these characters, if defined in a char array ???
I will look at this, as soon as time permits ...
#22 Guest_Martin Saurer_*
Posted 24 September 2005 - 07:40 PM
I'm not setting any special font, so I assume I'm using the built-in standard font.
#23
Posted 24 September 2005 - 09:48 PM
The multi-byte character codes are in the Programming guide on page 85...Forgot to say:
I'm not setting any special font, so I assume I'm using the built-in standard font.
http://www.cpsdk.com...mming Guide.pdf
#24 Guest_Martin Saurer_*
Posted 28 October 2005 - 02:03 PM
Help Version 1.5 now displays Classpad special characters correctly
Enjoy ...
0 user(s) are reading this topic
0 members, 0 guests, 0 anonymous users