| Both sides previous revision Previous revision Next revision | Previous revision |
| directory_dir2dat_guide [2021/12/31 19:59] – hiccup | directory_dir2dat_guide [2025/02/05 20:31] (current) – hiccup |
|---|
| ====== Directory Dir2Dat Guide ====== | ====== Directory Dir2Dat Guide ====== |
| | todo: document how to use RomVault for this, as that is a much better option - it represents directories using special <dir> tags. It lets you create dats by scanning the contents of the ROMRoot, and then right clicking the ROM root and choosing "Save full dat". You can also do the same using ToSort, but to do that you need to have a blank .dat in the DATRoot. |
| | |
| | |
| | ---- |
| | **Old guide** |
| | |
| | //This method should no longer be used, as it does not properly distinguish between empty files and folders.// |
| | |
| |
| If the "ROM" consists of of multiple directories, you will want to use the "dir2dat" function of [[https://mamedev.emulab.it/clrmamepro/|clrmamepro]] with the following settings in the "Options" section. | If the "ROM" consists of of multiple directories, you will want to use the "dir2dat" function of [[https://mamedev.emulab.it/clrmamepro/|clrmamepro]] with the following settings in the "Options" section. |
| You can test this setup is working correctly by hashing the contents of {{ :test_dir_structure.zip |this zip}} and comparing the datfile that clrmamepro creates with {{ :test_dir_structure.dat.zip |this pre-made datfile}} . Currently there is no solid solution for "directory hashing" that supports SHA256, so you can leave that hash type out. | You can test this setup is working correctly by hashing the contents of {{ :test_dir_structure.zip |this zip}} and comparing the datfile that clrmamepro creates with {{ :test_dir_structure.dat.zip |this pre-made datfile}} . Currently there is no solid solution for "directory hashing" that supports SHA256, so you can leave that hash type out. |
| |
| In the created datfile, directories, including empty ones, are represented as files with a size of "0" and a CRC32 of "-", and no other attributes. The filename is set as you would expect (e.g. "dirwithemptydir\emptydir2" for one of the directories in the example, except it will have "_" appended to it when clrmamepro is used on Windows, and "\_" when clrmamepro is used on Linux. | There will also be a top-level entry called "Default" with a single empty folder, which should be deleted, or noted as to be ignored. |