Difference between revisions of "Debug Menu for Dev7Games"

From ScummVM :: Wiki
Jump to navigation Jump to search
m (renamed some things)
 
(13 intermediate revisions by the same user not shown)
Line 6: Line 6:
the options of the Debug Menu.
the options of the Debug Menu.


This for Version 1.2.0.0 and below
This for Version 1.2.0.0 and 1.1.0.0
You can also open the Debug Menu if the game was opened with -break and then at the top
You can also open the Debug Menu if the game was opened with -break and then at the top of the window where the Name of the Game is shown right click and the Debug Menu options should be displayed.
Adiboo3 / Adibou3 or how your game is called you ever run right click then the menu will appear


*How i find out which version i have?
*How i find out which version i have?
* Use [https://github.com/CrystalBen/DEV7/ LOADER7VC] for checking your version of LOADER7.exe just download LOADER7VC then run it and enter your Path of the EXE File, Then press Enter and you should get your version including the Description of the File
* Use [https://github.com/BJNFNE/DEV7/releases/tag/LOADER7VC LOADER7VC] for checking your version of LOADER7.exe just download LOADER7VC then run it and enter your Path of the EXE File, Then press Enter and you should get your version including the Description of the File


*With which Games is the Debug Menu working?
*With which Games is the Debug Menu working?
it should work with any DEV7 Game (Tested with Adibou 3 & Adi 5)
It works with any DEV7 Game, Note however that i can have slightly changes due to the Loader7.exe that you have, so first check which version your Loader7.exe is.


===Bitmaps Windows===
===Bitmaps Windows===
With Bitmaps Windows you can view the images that are in their own IMG format,
With Bitmaps Windows you can view the images that are in their own IMG format,
*File name shows the name of the file (IMG image).
* File name shows the name of the file (IMG image).
*idBmp shows the ID of the bitmap,
* idBmp shows the ID of the bitmap.
*OBC Name shows the name of the OBC,
* OBC Name shows the name of the OBC.
*Size displays a 5 digit number,
* Size displays the Filesize of the IMG in KB.
*Info shows the size of the image and also the bpp (usually this is 15A),
* Info shows the size of the image and also the bpp.
*attributes shows various "attributes" (RDO, RDWR, RDO+SHD(1), RDO+SHD(4), RDO+SHD(6), RDO+SHD(12),
* Atributtes decides which atributes are required for the IMG pictures.
*Time shows the time when the image was called up by the game. The hour comes first, then a colon, then the minute, then a colon again, then the second, and then again a colon where the millisecond is,
* Time shows the time when the image was called up by the game. The hour comes first, then a colon, then the minute, then a colon again, then the second, and then again a colon where the millisecond is. and if you open an image by double-clicking or by ticking it, you can display the xy armpit, and display the rgb numbers,
and if you open an image by double-clicking or by ticking it, you can display the xy armpit,
* Close all closes all Images,
and display the rgb numbers,
* Refresh to renew the Image list.
*Close all closes all Images,
* perdiodical views update can be checked for updating the views of the Images.
*Refresh to renew the Image list.
* If you open an Picture over the Menu and you left double click you can make the Background lighter.
*perdiodical views update can be checked for updating the views of the Images.
* If you open an Picture over the Menu and you right double click you can make the Background darker.


===Audio Channels===
===Audio Channels===
Line 53: Line 52:
In cursor everywhere only one ? displayed
In cursor everywhere only one ? displayed
Click cursor is everywhere just a ? displayed
Click cursor is everywhere just a ? displayed


===screen elements window===
===screen elements window===
With screen elements window you can display the icons of the blue bar and
* With screen elements window you can display the icons of the blue bar and
you can see the animations or you can see a still frame of the video such as Coktel Intro
* you can see the animations or you can see a still frame of the video such as Coktel Intro
idElem shows the ID of the element (SD_OBJECT / 3DWORLDWARP).
* idElem shows the ID of the element (SD_OBJECT / 3DWORLDWARP).
Type indicates that the type is bitmap and the {} brackets contain the ID of the bitmap
* Type indicates that the type is bitmap and the {} brackets contain the ID of the bitmap
State indicates whether the object is visible as a clickable object or as an environment
* State indicates whether the object is visible as a clickable object or as an environment
Visible (1) stands for an object which you can click on, which causes different animations
* Visible (1) stands for an object which you can click on, which causes different animations to be executed
to be executed
* Visible (2) represents the environment
Visible (2) represents the environment
* 3DWORLDWARP displays the image of the environment
3DWORLDWARP displays the image of the environment
* SD_OBJECT is an object which you can click on, which then causes different animations etc to be executed.
SD_OBJECT is an object which you can click on, which then causes different animations etc
* Z-order may stand for the Z-axle
to be executed
* Blend level are all unknown to 255 what this is used for
Z-order may stand for the Z-axle
* Bounding rect indicates the size of the bitmap
Blend level are all unknown to 255 what this is used for
* OBC name shows which OBC is currently required
Bounding rect indicates the size of the bitmap
* If you open a screen element by double-clicking on the name or by ticking it, you can see if the graphic is transparent
OBC name shows which OBC is currently required
* Displays the xy armpit and display the rgba numbers
and if you open a screen element by double-clicking on the name or by ticking it, you can see if the graphic is transparent
* if you open an Picture over the Menu and you left double click you can make the Background lighter.
and display the xy armpit and display the rgba numbers
* if you open an Picture over the Menu and you right double click you can make the Background darker.


===File monitoring===
===File monitoring===
Line 176: Line 174:


===Events window===
===Events window===
Events window
* This is showing you the Events of various Events.
Type is empty
* VMD
Info is empty
* Timer
Object is empty
* Network
OBC name is empty
* Mouse
* Keyboard
* Movie
* User mess
* CFS
 
* These can be all activated by enabling them over the Checkbox.


===Trace window===
===Trace window===
Line 190: Line 194:
*Time is showing you the current Time of the output.
*Time is showing you the current Time of the output.
*Over the Pause Button you can stop the recording of the Log
*Over the Pause Button you can stop the recording of the Log
*Over the Contiunue Button you can contiune the logging process
*Over the Continue Button you can contiune the logging process
*VM traces is for the Script parser.
*VM traces is for the Script parser.
*Log to file if you enable its the Output of the Trace window gets logged into Trace.txt (can be found in the Directory of the Game)
*Log to file if you enable its the Output of the Trace window gets logged into Trace.txt (can be found in the Directory of the Game)
Line 220: Line 224:
* Error Number also 4-digit numbers currently unknown what they are for.
* Error Number also 4-digit numbers currently unknown what they are for.


===Pictures===
===Preview===
[[File:Without zone.png|thumb]]
[[File:Without zone.png|thumb]]
[[File:With zone.png|thumb]]
[[File:With zone.png|thumb]]
Line 237: Line 241:
With Resource Window it can show use what he is currently using VMD / Timer. and that .OBC Section
With Resource Window it can show use what he is currently using VMD / Timer. and that .OBC Section
is telling you which OBC File the Game is currently using and the next thing is showing
is telling you which OBC File the Game is currently using and the next thing is showing
the name of the Picture and which .vmd file is currently used by the Game Engine VMD Files
the name of the Picture and which .vmd file is currently used by DEV7.


===File Monitoring===
===File Monitoring===
Line 267: Line 271:


===Event Window===
===Event Window===
* in the first  Section of Event you see a VMD: TIMER: or USER:
* in the first  Section of Event you see a VMD: TIMER: or USER:  
* secound Section of Event you see which File exactly the Game is using .OBC .vmd for the most part.
* secound Section of Event you see which File exactly the Game is using .OBC .vmd for the most part.
* and the next thing is unknown for what this is.
* and the next thing is unknown for what this is.

Latest revision as of 16:53, 27 June 2024

  • How to open the Menu?

This is for Version 1.3.0.0 To open the Debug Menu, start Adiboo3 or any Dev7Game with the shortcut containing -break now under Hidden icons in the bottom right the up arrow should be the sign of LOADER7.exe from the version 1.3.0.0 with the name DEV7VM Debug Windows, do a right click on it to show up the options of the Debug Menu.

This for Version 1.2.0.0 and 1.1.0.0 You can also open the Debug Menu if the game was opened with -break and then at the top of the window where the Name of the Game is shown right click and the Debug Menu options should be displayed.

  • How i find out which version i have?
  • Use LOADER7VC for checking your version of LOADER7.exe just download LOADER7VC then run it and enter your Path of the EXE File, Then press Enter and you should get your version including the Description of the File
  • With which Games is the Debug Menu working?

It works with any DEV7 Game, Note however that i can have slightly changes due to the Loader7.exe that you have, so first check which version your Loader7.exe is.

Bitmaps Windows

With Bitmaps Windows you can view the images that are in their own IMG format,

  • File name shows the name of the file (IMG image).
  • idBmp shows the ID of the bitmap.
  • OBC Name shows the name of the OBC.
  • Size displays the Filesize of the IMG in KB.
  • Info shows the size of the image and also the bpp.
  • Atributtes decides which atributes are required for the IMG pictures.
  • Time shows the time when the image was called up by the game. The hour comes first, then a colon, then the minute, then a colon again, then the second, and then again a colon where the millisecond is. and if you open an image by double-clicking or by ticking it, you can display the xy armpit, and display the rgb numbers,
  • Close all closes all Images,
  • Refresh to renew the Image list.
  • perdiodical views update can be checked for updating the views of the Images.
  • If you open an Picture over the Menu and you left double click you can make the Background lighter.
  • If you open an Picture over the Menu and you right double click you can make the Background darker.

Audio Channels

With Audio Channels you can see which VMD file is being played Use stands for what format is used Player or Other or VMD for the currently playing audio and OBC name is the Name of the obc file where the audio is located AS_ANIMSCRIPTPLAYER is executed when a song is played or a video is played from the TV or what is explained SD_PICTURE when sounds are played from an animation or when language files are played if e.g. Adiboo asks / says something ACA_READER when a task is explained (learning stations)

Zones Window

With Zones Window you can see a zone for each item by each icon or item which is marked green in the game idZone displays shows the ID of the zone Type shows in which region the zone is there are different (region, 3D object, bitmap mask) State indicates whether this zone is activated or deactivated. Enabled stands for activated and Disabled for deactivated Z-order may stand for the Z-axle Bounding rect shows the size of Region, Bitmap mask but not 3D object Visible rect shows 0,0 everywhere and size 800x600 OBC name shows SD_OBJECT, SCENE3D In cursor everywhere only one ? displayed Click cursor is everywhere just a ? displayed

screen elements window

  • With screen elements window you can display the icons of the blue bar and
  • you can see the animations or you can see a still frame of the video such as Coktel Intro
  • idElem shows the ID of the element (SD_OBJECT / 3DWORLDWARP).
  • Type indicates that the type is bitmap and the {} brackets contain the ID of the bitmap
  • State indicates whether the object is visible as a clickable object or as an environment
  • Visible (1) stands for an object which you can click on, which causes different animations to be executed
  • Visible (2) represents the environment
  • 3DWORLDWARP displays the image of the environment
  • SD_OBJECT is an object which you can click on, which then causes different animations etc to be executed.
  • Z-order may stand for the Z-axle
  • Blend level are all unknown to 255 what this is used for
  • Bounding rect indicates the size of the bitmap
  • OBC name shows which OBC is currently required
  • If you open a screen element by double-clicking on the name or by ticking it, you can see if the graphic is transparent
  • Displays the xy armpit and display the rgba numbers
  • if you open an Picture over the Menu and you left double click you can make the Background lighter.
  • if you open an Picture over the Menu and you right double click you can make the Background darker.

File monitoring

With File monitoring you can see which file the game is currently using Handle shows a 4-digit text made up of letters and numbers File name shows the location of the file Fashion indicates RD Last access shows the read speed in KB Rate shows the reading speed in KB but only what if you change the environment as an example Peak rate constantly displays a reading speed in KB In the second section

  1. is empty

File name is empty Request is empty Size is empty Result is empty OBC name is empty

Resources Window

With Resources Window you can do several things

Bitmaps (Resources Window / Resources)

  • Count for how many images are active
  • Max count how many images can be active at the same time
  • Created is unknown
  • Released is unknown

VMD (Resources Window / Resources)

  • Count how many animations are active
  • Max count how many animations can be active
  • Created is unknown
  • Released is unknown

Movie (Resources Window / Resources)

  • reacts to nothing
  • Count is not responding
  • Max count is not responding
  • Created is unknown
  • Released is unknown

Screen elements (Resources Window / Resources)

  • Count how many elements are active
  • Max count how many elements can be active
  • Created is unknown
  • Released is unknown
  • Hidden is unknown

Zones (Resources Window / Resources)

  • Count how many zones are active
  • Max count the maximum number of zones that can be active
  • Created is unknown
  • Released is unknown
  • Inactive how many are inactive

3D Mesh (Resources Window / Resources)

  • Count how many are active in the () brackets is how many kilobytes are used
  • Max count how many 3D mesh can be active
  • Created is unknown
  • Released is unknown

3D Materials (Resources Window / Resources) Count how many 3D Materials are active in the () brackets is how many Kiobyte is used

  • Max count how many 3D materials are allowed to be active in the () brackets is how many kilobytes are used sometimes.
  • Created is unknown
  • Released is unknown

View renders (Resources Window / Resources)

  • Count displays a 6 digit number that is always changing for what is unknown.
  • Frame rate shows the frame rate of the game
  • Peak rate shows the peak rate in fps

Screen refresh (Resources Window / Resources)

  • Count displays a 5 digit number that is always changing for what is unknown.
  • Frame rate shows the frame rate of the game
  • Peak rate shows the peak rate in fps
  • Enabled true (1) indicates it is enabled

Dispatch events (Resources Window / Resources)

  • Count is unknown

Free time (Resources Window / Resources)

  • Count is unknown

Timers (Resources Window / Resources)

  • Count shows how many timers are there
  • Max count shows how many timers exist
  • Created is unknown
  • Released is unknown
  • Running shows how many timers are currently running

Files (Resources Window / Resources)

  • Count shows how many files are currently being used
  • Max count shows the maximum number of files available
  • Opened shows how many files are currently open
  • Closed shows how many files are currently closed
  • Rate shows the transfer rate in seconds, usually in kilobytes
  • Peak rate shows kilobytes in seconds
  • Bytes read shows how many bytes are read in seconds

Audio channels (Resources Window / Resources)

  • Count how many audio files are currently being played
  • Max count the maximum number of audio files that can be played

Events window

  • This is showing you the Events of various Events.
  • VMD
  • Timer
  • Network
  • Mouse
  • Keyboard
  • Movie
  • User mess
  • CFS
  • These can be all activated by enabling them over the Checkbox.

Trace window

if for some reason the Information not automatically updated then click on CLEAR and hook all groups and then unhook it again then the Information should Update.

  • Trace window
  • Group it shows in which part of the Game you are.
  • Comment is showing up a Comment of the
  • Date is showing you the current Date of the output.
  • Time is showing you the current Time of the output.
  • Over the Pause Button you can stop the recording of the Log
  • Over the Continue Button you can contiune the logging process
  • VM traces is for the Script parser.
  • Log to file if you enable its the Output of the Trace window gets logged into Trace.txt (can be found in the Directory of the Game)
  • All groups is for if you enable it give you more Informations.

Info box setup window

Info box setup window Groups there, what can be entered cannot be confirmed

info box

info box can be activated by ticking it does not happen because probably no info box was set up via info box setup

Warning box can be activated by ticking but nothing happens

Show refresh frame

  • This Option is first useable if your LOADER7.exe is Version 1.3.0.0 otherwise you can activate it but it shows nothing in the left corner.

Show refresh frame Video access when this is activated a black message appears in the bottom left corner of the game where % screen written : XX.X (PK:XX.X) stands X stands for the numbers which are constantly changing automatically and gray squares are displayed Off screen access shows gray squares Off Shows no gray squares and also no black message with % screen written

Error Manager

The Error Manager starts if the the main ITK File is not found.

  • if you click on Debug a message appears Dev7 Editor not found.
  • Obc it shows which OBC file it wants to use.
  • Function there is displayed which function he wants to use.
  • PCode are 4 digit numbers displayed currently unknown what they are for.
  • Error Number also 4-digit numbers currently unknown what they are for.

Preview

Without zone.png
With zone.png

1.0.0.0 Debug Menu (to be completed)

This Documention is not finished yet. The Debug Menu of 1.0.0.0 has differences to the Debug Menu for 1.1.0.0 & 1.2.0.0 & 1.3.0.0, therefore the two are divided into two different categories

  • With which Games should the Debug Menu work?

It should work for any Game that uses version 1.0.0.0.

  • How i open the Debug Menu?

go to the loader7.exe and make a shortcut of the exe then add the parameter -break to that shortcut. and you can run the game the game will start in windowed mode, on the left corner of the game is a button named Windows click on it to open a list of options that can be used in the Debug Menu.

Resource Window

With Resource Window it can show use what he is currently using VMD / Timer. and that .OBC Section is telling you which OBC File the Game is currently using and the next thing is showing the name of the Picture and which .vmd file is currently used by DEV7.

File Monitoring

  • Access shows you which art of Access the Engine is currently doing with a STK File.
  • File this is showing from which STK File, the Game is reading the required Information from that STK File.
  • Bytes How many Bytes in the Secound the Game reads from the STK File.

Buttons

  • CLEAR is for Clearing the Log
  • PAUSE is for stopping to record the Log
  • CONTINUE is for Continue the Log

Checkboxes

  • OPEN if you uncheck OPEN it will be stopping to Log in the Section Access the Log for OPEN & if you check them again then the Log Process starts again
  • READ if you uncheck READ it will be stopping to Log in the Section Access the Log for READ & if you check them again then the Log Process starts again
  • WRITE if you uncheck WRITE it will be stopping to Log in the Section Access the Log for WRITE & if you check them again then the Log Process starts again
  • CLOSE if you uncheck CLOSE it will be stopping to Log in the Section Access the Log for CLOSE & if you check them again then the Log Process starts again
  • Top is for that when you go back to the Game that the Window of File Monitoring is still on the top of the Game and wont disapear until you uncheck Top again

Access

  • READ is when the Game reads something from a STK File to load a different Environment or any Application or load something else

Resource Window

On the Top you see 5 different Headers Resource, Released, Difference Alloc. Mem. (Kb), Max Difference, and Max Alloc. Mem. (Kb)

  • when you did a double click on Bmp a new Window appears in there you can see the .img files (Images).
  • from here its very similar to the Dev7 1.2.0.0 / 1.3.0.0 Games.
  • under File you can see which .stk Files the Games currently using.

Event Window

  • in the first Section of Event you see a VMD: TIMER: or USER:
  • secound Section of Event you see which File exactly the Game is using .OBC .vmd for the most part.
  • and the next thing is unknown for what this is.
  • New Picture also unknown.
  • The Checkboxes are for enable or disable the Log Recording for specfic Informations.
  • CLEAR is for clearing the Log.
  • CONTINUE is for continue the Logging.
  • PAUSE is pause the Logging process.