SCI Companion documentation

[Kawa]

No, no. Nothing "optional" about ChoiceTalker and PriorityTalker. Especially not PriorityTalker.

[troflip]

Really? Both those are only used in SQ5, so they're not exactly common.

[Kawa]

They're less than "optional". One of them is (IMHO) a mess to use, and the other is literally a talker with priority instead of -1 in its drawcel calls.

[troflip]

Ah, got it. Yeah, I was gonna combine PriorityTalker with Talker, but PriorityTalker does do a *bit* more than Talker, it also needs to manage the priority underbits. Still could do it though.

As for ChoiceTalker, it's not too bad. The usage looks like this:

Code: [Select]

(myChoiceTalker:normal(FALSE)
curNoun(N_DEVICE)
curVerb(V_TALK)
curCase(0)
)
       
(send gTestMessager:say(N_DEVICE V_TALK 0 0 0 110))

(switch (myChoiceTalker:whichSelect)
(case 1
// etc...
)
(case 2
// etc...
)
(case 3
// etc...
)
)


What does using QFG's Teller look like?

[Kawa]

As for ChoiceTalker, it's not too bad. The usage looks like this:

Okay, and how does one set up the choices?

What does using QFG's Teller look like?

I forgot

[troflip]

Okay, and how does one set up the choices?

The first in a sequence of messages is the title, and the remaining increasing sequence numbers are the options. e.g.

Code: [Select]

3 2 0 1 8 What things do you want to do?
3 2 0 2 8 Eat some food
3 2 0 3 8 Drink something
3 2 0 4 8 Get out of here.

The only weird thing is that you have to set curNoun/curVerb/curCase, and then repeat those numbers in the say call.

[Collector]

How about a repository for extra scripts? As long as they were documented or at least had a description of the function of each script they could be added as needed. That way the template could be kept as lean as possible.

[troflip]

Well that was kind of the idea. I was thinking of a subfolder under SCI Companion that could contain script files (and people could download more, if people come up with cool scripts). They'd be accessed by some "Add script" functionality in SCI Companion.

But... that's extra work, and I'm trying to ship

[troflip]

What does InsetWindow do?

[Kawa]

What does InsetWindow do?

It's like a BorderWindow but in instead of out. You'd think the inventory window'd use it but it doesn't -- it uses ScrollInsetWindow instead.

[troflip]

Lol, yeah, you would think it would use it.

It looks like it's like a BorderWindow, but in addition it has an interior border.

[Kawa]

It looks like it's like a BorderWindow, but in addition it has an interior border.

[troflip]

Zip file containing the documentation so far in case anyone's interested. Start at index.html.

[Kawa]

That's a good documentation. It might be nice in the part about messages to include that you can have director notes in your lines.

"(TO PLAYER, FUNNY/SEXY)Hey! I'll ask the questions around here."

According to ScummVM, these are "anything but a lowercase character or a digit," in parentheses. They may appear at any point in a line, and any extra whitespace after the ) is skipped.

Yeah, that does mean "(WHAT?)" may be mistaken for a stage direction, but "(Say WHAT?)" would not.

[troflip]

The things I have left to do are:

- Kernel functions
- All the compiler/language stuff

I'll probably just include and link directly to SCI Studio help for much of that. The compiler and language features are mostly the same. Then I'll just need to document the SCI1.1 kernels.

 It would be nice to have the "source" for Brian's html files, if there ever was any. That way I could possibly re-generate the html files and make it look like it fits in SCI Companion's documentation. But all I've been able to find is the .chm file (which I decompiled into html).