• Which the release of FS2020 we see an explosition of activity on the forun and of course we are very happy to see this. But having all questions about FS2020 in one forum becomes a bit messy. So therefore we would like to ask you all to use the following guidelines when posting your questions:

    • Tag FS2020 specific questions with the MSFS2020 tag.
    • Questions about making 3D assets can be posted in the 3D asset design forum. Either post them in the subforum of the modelling tool you use or in the general forum if they are general.
    • Questions about aircraft design can be posted in the Aircraft design forum
    • Questions about airport design can be posted in the FS2020 airport design forum. Once airport development tools have been updated for FS2020 you can post tool speciifc questions in the subforums of those tools as well of course.
    • Questions about terrain design can be posted in the FS2020 terrain design forum.
    • Questions about SimConnect can be posted in the SimConnect forum.

    Any other question that is not specific to an aspect of development or tool can be posted in the General chat forum.

    By following these guidelines we make sure that the forums remain easy to read for everybody and also that the right people can find your post to answer it.

CAT Manual in German

Bambi_007

Resource contributor
Messages
908
Country
germany
I have so many friends in german speaking areas.

They (and me) have some trouble to read (and understand ;-) ) english manuals.

Arno is it possible that we can have a german translated Manual.

I know that Helli ( a member of here and a friend of scruffyduck) has translated the manual for ADE. But where is Helli. I have never see them for a long time.

I´m willing to pay 25 euro for a translated CAT Manual.

Any help in sight?
 
Last edited:

scruffyduck

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
34,855
Country
unitedkingdom
Helli is alive and well and working on the German (and English) ADE 1.50 manuals ;)
 

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi,

My German is too bad to do a translation, but if any forum members wants to make a translation that's fine with me.
 

Bambi_007

Resource contributor
Messages
908
Country
germany
Thank you scruffyduck for your message that Helli is still alive.

I have send him a Forum Mail.

I Hope he recieved this.
 
Messages
2,192
Country
germany
I am still around and kicking :)

Jon (Scruffyduck) presently is in the final moves to release an update version of ADE and therefore I am again involved to bring both ADE-Manuals up to date.

I saw your request in my mail today and subsequently looked here. Let me see, what it is all about and I will get back to you.

servus

Helli
 

Bambi_007

Resource contributor
Messages
908
Country
germany
Oh my Dear Helli.

Nice To Meet You Again.

Well, do your work for scruffyduck and if you have time you made maybe a german manual of Cat.

You made our day.:eek:

I hang by the geman translation of Animation trigger.
Bewegungs Auslöser - thats right ?

Hihihi. What a scary word.
 
Messages
2,192
Country
germany
Arno

I have promised Sandra to provide a German version of your CAT Manual.
By now I am halfway through the translation and I realize that I might run into the same problem with translating word by word, which we all are so familiar with manuals translated from Japanese or Korean.

I dare to ask you (I know you don't have the time really) for some insight, since I scratched Gmax-modelling only on the surface and did not touch animation at all.

- you wrote "CAT allows you to change the animation in such a way that you can trigger it with a FS variable".

The variables used by the CAT interface I found also among those listed by you in the thread "Variables available in FS".
A few of them I found in the"Make MDL" SDK for FS9.

- Where are the other variables defined?
- How can a user define variables? (User Variable 1 to 5)

And my biggest question:
- How does CAT "interface" with the model (file), whose animation is going to be tweaked?
(do you somehow load the MDL-file into CAT, or do you somehow "connect" CAT with Gmax when the model is loaded there?)

Neither in the CAT manual nor in the CAT video tutorial this issue is mentioned. Probabely it is generally known but unfortunately not by me.

Your help Arno is highly appreciated (so is the help from anybody else!)

Helli
 

Bambi_007

Resource contributor
Messages
908
Country
germany
And my biggest question:
- How does CAT "interface" with the model (file), whose animation is going to be tweaked?
(do you somehow load the MDL-file into CAT, or do you somehow "connect" CAT with Gmax when the model is loaded there?)

Neither in the CAT manual nor in the CAT video tutorial this issue is mentioned. Probabely it is generally known but unfortunately not by me.

Your help Arno is highly appreciated (so is the help from anybody else!)

Helli

Huhu Helli,

CAT will make a new mdl File from the two asm files.

You load the .asm file into CAT when they need them, Arno mentioned that you never use the _0.asm to do that, but the two asm flies MUST stay together if you use CAT.

Afterwards when CAT has done his work you have three new files:
herethefilename_cat.asm
herethefilename_cat_0.asm
herethefilename_cat.mdl

Now I can make my bgl file with the CAT manipulated mdl.

I do it in this way:

I delete the two old asm files and the old mdl file - than copied the three new files to the xml file and then I remove the _cat from the filenames - now i have the files that i can use with the xml file to make my bgl file or i can get the mdl file to use it with the Library Maker.

---------------------------------------------------------------------

Zwischenablage82.jpg


Click on NEXT


Zwischenablage83.jpg


Click on Compile MDL


Zwischenablage84.jpg



Zwischenablage86.jpg
 
Last edited:

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

- Where are the other variables defined?
- How can a user define variables? (User Variable 1 to 5)

That thread you mentions give a good overview. They are not really defined in one place. Some come from the FS2000 SDK, from the BGLC_9 sources or some even from the FS98 SDK.

The user variables are 5 variables availble in FS that users can fill themselves from external tools/DLL files. For example the ActiGate module I made fills some of them. They can not be filled by the user with a user interface or so. So maybe the name is a bit misleading.

- How does CAT "interface" with the model (file), whose animation is going to be tweaked?

You load the ASM files that you can keep from the MakeMDL export process.

Btw, I am working on integrating CAT with ModelConverterX. That will change the interface quite a bit. Not sure when that will be ready though.
 
Messages
2,192
Country
germany
Arno

many many thanks for your notes.
The user variables are 5 variables availble in FS that users can fill themselves from external tools/DLL files. For example the ActiGate module I made fills some of them. They can not be filled by the user with a user interface or so. So maybe the name is a bit misleading.
I will translate this and use it in the manual

You load the ASM files that you can keep from the MakeMDL export process.
Oops! I saw that CAT does this. It escaped my attention since it happens as last step in CAT. I looked for it at the beginning

Btw, I am working on integrating CAT with ModelConverterX. That will change the interface quite a bit. Not sure when that will be ready though.
That shouldn't stop me to make that German manual, should it?

I have another question on the variables, but I'll put it in a separate posting

Helli
 
Messages
2,192
Country
germany
Use of Variables

Arno

I have a question, which is based on the fact, that in your list of variables in the thread "Variables available in FS" (http://www.fsdeveloper.com/forum/showthread.php?t=332) there are more variables than you make available in CAT.

- What if I insert a variable from the list - for instance "0389" (hour of the day GMT), which is not available from the rolldown-textline "Select Variable", directly (manually or copy/paste) into the input-line "Variable" ???

- Will CAT use it to tweak the ASM.file and will this be further convertible?

- What do you call "0389" => Code? Name? Index? Designator? Variable?
- What do you call "hour of the day GMT" => Name? Description? Variable?

(I plan to use a translation of your list in the German Manual
pfeif.gif
)

Helli
 

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

- What if I insert a variable from the list - for instance "0389" (hour of the day GMT), which is not available from the rolldown-textline "Select Variable", directly (manually or copy/paste) into the input-line "Variable" ???

You can use them. When you choose one from the list, you will see that the variable is inserted into the variable text box. But you can also type any value you want in there.

- What do you call "0389" => Code? Name? Index? Designator? Variable?

I would call that the variable. But technically speaking it is the memory offset where the value is stored.

- What do you call "hour of the day GMT" => Name? Description? Variable?

That's the description.
 
Messages
2,192
Country
germany
Many thanks Arno!!

I have one (hopefully) last question:

CAT offers 3 checks on the variables. One of them - you call it "Condition (mask)" - you treat in your Manual twice but rather short, too short for my understanding. It is:
For the animation condition and the animation trigger three types of conditions can be specified. You can check if......... certain bits of the value of a variable are set and...............
.and
you have the choice between checking if..............a variable matches a certain bitmask (condition mask) or................
Could you give me an example what this means or how it is done?

Forgive my insistance.

Helli
 

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

Let's see if I can explain this, those masks are a bit tricky :).

Let's assume we have a mask value of 1, bit wise that is 0001.

A variable value of 1 (bitwise 0001) would return true
A variable value of 2 (bitwise 0010) would return false
A variable value of 3 (bitwise 0011) would return true
A variable value of 4 (bitwise 0100) would return false
etc

So you don't compare if the values are the same, but only if the bits of the mask are set in the variable.
 
Messages
2,192
Country
germany
Arno

could you name me one or two of the variables in your list, where the values could be manipulated with this bitmasking method?

Addendum:
While writing the translation, I realize, that neither the English Manual not the Video Tutorial contain the two radio buttons "Apply to animation trigger" and ""Apply to animation", which are shown in the lower part of the CAT window of version 1.2.12.
I know how to translate them of course.
But - "when" in the process of defining the tweak do they come into action and "what " is applied with these selections?

Addendum 2: The mystery of the "h":
In the CAT input lines "Variable" all automatic entries end with an "h". In the variable list in the forum the variables are shown without "h".
Some values of the variables also have this "h" - you even point this out in the video tutorial. Many other values don't seem to to require the "h".
What is the mistery behind this?

Helli
 
Last edited:

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

could you name me one or two of the variables in your list, where the values could be manipulated with this bitmasking method?

One example is when using ActiGate to check if the parking brake is set or if it is raining. Another common example is animation timers. These often use a bitmask to get the right blinking frequency. But for conditional animations they are not used that often. The only case I used them is with the parking brake trigger when using ActiGate.

Addendum:
While writing the translation, I realize, that neither the English Manual not the Video Tutorial contain the two radio buttons "Apply to animation trigger" and ""Apply to animation", which are shown in the lower part of the CAT window of version 1.2.12.
I know how to translate them of course.
But - "when" in the process of defining the tweak do they come into action and "what " is applied with these selections?

That is indeed a function I added a bit later. The difference is where the animation condition is applied. If it is applied on the trigger it will affect all instances of the object, if applied on the animation it only affects the current instance.

So if you have placed multiple jetways for example, this might make a difference. You only want the one closest to you to respond.

(I hope my memory is right on the details of this one)

Addendum 2: The mystery of the "h":
In the CAT input lines "Variable" all automatic entries end with an "h". In the variable list in the forum the variables are shown without "h".
Some values of the variables also have this "h" - you even point this out in the video tutorial. Many other values don't seem to to require the "h".
What is the mistery behind this?

Simply said the h needs to be there in the end, because that tells BGLC_9 that the number is hexadecimal and not just decimal. But I can't remember what happens if you don't type the h. I am not sure if CAT will add it or not.
 
Messages
2,192
Country
germany
Thanks Arno for your information.

One example is when using ActiGate to check if the parking brake is set or if it is raining. Another common example is animation timers. These often use a bitmask to get the right blinking frequency. But for conditional animations they are not used that often. The only case I used them is with the parking brake trigger when using ActiGate.
Fair enough.
Still, do you by chance have an example of a suitable variable and a bitmask value, which has to be entered in the Value-window - like for the other two options you show in your video (which did not yet have the Bitmask option). This would make my explanation much better (and complete).

Helli
 

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

I can't really think of an example that would make sense. I think it is an option you would only use together with a module like ActiGate.
 
Messages
2,192
Country
germany
Well, here is it:
Abb. 1.jpg


It is available as PDF-file in the attachement.

Maybe Arno will put it into the Wiki. The average lifetime is longer there :D

If something is wrong with the text, please tell me here.
If something is wrong with CAT you better ask Arno

yours truely

Helli
 

Attachments

  • CAT Deutsches Handbuch.pdf
    694 KB · Views: 751
Last edited:

arno

Administrator
Staff member
FSDevConf team
Resource contributor
Messages
32,883
Country
netherlands
Hi Helli,

Thanks, I have added a link to the PDF in the CAT manual on the Wiki.
 
Top