Difference between revisions of "EPcompress leírás"

From Enterprise Wiki
Jump to: navigation, search
(Linkek)
(Linkek)
 
(69 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''epcompress [PARAMÉTEREK...] INFILE OUTFILE'''
+
=Parancssor, paraméterek=
  
=Paraméterek=
+
'''epcompress [PARAMÉTEREK...] INFILE[...] OUTFILE'''
  
'''-h, -help, --help''': Rövid leírást ír ki a program használatáról, és kilép.
+
'''Általános'''
  
'''--''': Minden további paraméter fájl név.
+
* '''-h | -help | --help''': Rövid leírást ír ki a program használatáról, és kilép.
 +
* '''--''': Minden további paraméter fájl név.
 +
* '''-x''': Tömörített fájl kicsomagolása.
 +
* '''-t''': Fájl(ok) tesztelése.
  
'''-x''': Tömörített fájl kicsomagolása.
+
'''Fájl formátum'''
  
'''-t''': Fájl(ok) tesztelése.
+
* '''-raw | -noraw''': EXOS fejlécek figyelmen kívül hagyása -raw esetén, az alapértelmezés -noraw. Támogatott EXOS modul típusok:
 +
** 05h: Új alkalmazói program (-m3), a mérete a szabványosnál nagyobb is lehet, kicsomagolva a 3. lapot is használhatja
 +
** 06h: Abszolút rendszerbővítő (-m3)
 +
** 49h: [https://wiki.enterpriseforever.com/index.php?title=Epimgconv_le%C3%ADr%C3%A1s#Az_EPimgconv.2FIVIEW_form.C3.A1tum_le.C3.ADr.C3.A1sa IVIEW kép] (-m2 vagy -m3, a CVIEW bővítő azonban csak az -m2-t támogatja)
 +
* '''-m2 | -m3''': Formátum választása, az -m3 az alapértelmezett. Az -m2-t az emulátor használja snapshot fájlok és a ROM csomag tömörítésére, illetve IVIEW képeknél lehet hasznos, egyébként elavult és általában nem ajánlott a használata.
 +
* '''-a | -n''': Archívum készítése több fájlból -a esetén (-raw módot tételez fel), az alapértelmezés -n.
 +
* '''-V''': Több részre (volume) bontott bemeneti fájl, csak kicsomagolásnál és tesztelésnél.
 +
* '''-V <N>''': Tömörítésnél a kimenet N kilobájt méretű részekre bontása. N csak 4 többszöröse lehet.
  
'''-m0..m6''': Formátum választása, az -m5 (ZLib) helyett használható -mz is, az alapértelmezés -m2, illetve a bemeneti fájl alapján automatikusan választott, ha az lehetséges.
+
'''Önkicsomagoló programok paraméterei'''
  
'''-m6:ENCODING''': -m6 módban a kódolást definiálja, ami alapértelmezés szerint "FG0L,G,,12345678,0123456789ABCDEF".
+
* '''-borderfx | -noborderfx''': A keretcsíkozás engedélyezése vagy tiltása.
 +
* '''-cleanup | -nocleanup''': A lapozás és veremmutató EXOS-hoz hasonló beállítása.
  
'''-1 ... -9 | -X''': Gyorsabb vagy nagyobb hatásfokú tömörítés beállítása, az alapértelmezés 5. A nagyobb értékek egyes esetekben rosszabb fájl méretet is eredményezhetnek. -m0 és -mz formátumnál az -X nagyon lassú.
+
=Linkek=
  
'''-fast''': Gyors 4 szálú tömörítő használata, ez csak -raw -m2 és -mz módban lehetséges, és fix paramétereket tételez fel. Az ep128emu snapshot és PNG fájl mentésekor használja.
+
[https://github.com/istvan-v/ep128emu/releases/tag/2.0.11.2 EP128Emu, a csomag tartalmazza az EPcompress aktuális verzióját]
  
'''-raw | -noraw''': EXOS fejlécek figyelmen kívül hagyása -raw esetén, az alapértelmezés -noraw, amit azonban csak az -m0, -m2, és -m3 formátumok támogatnak.
+
[https://github.com/istvan-v/ep128emu/tree/master/util/epcompress/z80_asm Z80 assembly rutinok]
 
 
'''-a | -n''': Archívum készítése több fájlból -a esetén, az alapértelmezés -n.
 
 
 
'''-minlen <N>''': [https://en.wikipedia.org/wiki/LZ77_and_LZ78#LZ77 LZ77] minimális hosszúság 1 és 3 között, az alapértelmezés a formátum által támogatott legkisebb érték. A növelése rontja a fájl méretet, de gyorsítja a kicsomagolást.
 
 
 
'''-maxoffs <N>''': LZ77 maximális távolság (szótár méret). Alapértelmezés szerint a legnagyobb, amit a formátum szabványosan támogat, általában 64 kilobájt. Kivétel az -mz ([https://en.wikipedia.org/wiki/Zlib ZLib]) formátum, ahol 32768 bájt, nagyobb érték pedig nem szabványos bővítést engedélyez. Az -m1, -m2, és -m4 esetében a maximum 524288 bájt, amit a Z80 rutinok azonban nem támogatnak. A csökkentése rontja a tömörítés hatékonyságát, 1 bájt egyszerű [https://hu.wikipedia.org/wiki/Run-length_encoding RLE] eljárásnak felel meg. A távolság korlátozása hasznos lehet speciális esetben, például cirkuláris puffer használatakor.
 
 
 
'''-blocksize <N>''': Tömörítésnél fix blokk méret használata. Az alapértelmezés 0, ami optimális módon próbálja blokkokra bontani a bemeneti adatot, ha ezt a választott formátum lehetővé teszi (az -m3 és -m6 nem), a keresés mélysége függ az -1..-X paramétertől.
 
 
 
'''-V''': Több részre bontott bemeneti fájl, csak kicsomagolásnál és tesztelésnél.
 
 
 
'''-V <N>''': Tömörítésnél a kimenet N kilobájt méretű részekre bontása.
 
 
 
'''-borderfx | -noborderfx''': Önkicsomagoló programban a keretcsíkozás engedélyezése vagy tiltása.
 
 
 
'''-cleanup | -nocleanup''': Önkicsomagoló programban a lapozás és veremmutató EXOS-hoz hasonló beállítása.
 
  
=Linkek=
+
[https://github.com/istvan-v/ep128emu/tree/master/util/epcompress/src libepcompress forráskód (GPL), C++ programba építhető]
[https://github.com/istvan-v/ep128emu/releases EP128Emu, a csomag tartalmazza az EPcompress aktuális verzióját]
 
  
[https://github.com/istvan-v/ep128emu/tree/master/util/epcompress/z80_asm Z80 assembly rutinok]
+
[https://wiki.enterpriseforever.com/index.php?title=T%C3%B6m%C3%B6r%C3%ADtett_ROM_f%C3%A1jlrendszer_k%C3%A9sz%C3%ADt%C3%A9se_(ROM:_eszk%C3%B6z) Tömörített ROM fájlrendszer készítése (ROM: eszköz)]

Latest revision as of 11:35, 23 April 2019

Parancssor, paraméterek

epcompress [PARAMÉTEREK...] INFILE[...] OUTFILE

Általános

  • -h | -help | --help: Rövid leírást ír ki a program használatáról, és kilép.
  • --: Minden további paraméter fájl név.
  • -x: Tömörített fájl kicsomagolása.
  • -t: Fájl(ok) tesztelése.

Fájl formátum

  • -raw | -noraw: EXOS fejlécek figyelmen kívül hagyása -raw esetén, az alapértelmezés -noraw. Támogatott EXOS modul típusok:
    • 05h: Új alkalmazói program (-m3), a mérete a szabványosnál nagyobb is lehet, kicsomagolva a 3. lapot is használhatja
    • 06h: Abszolút rendszerbővítő (-m3)
    • 49h: IVIEW kép (-m2 vagy -m3, a CVIEW bővítő azonban csak az -m2-t támogatja)
  • -m2 | -m3: Formátum választása, az -m3 az alapértelmezett. Az -m2-t az emulátor használja snapshot fájlok és a ROM csomag tömörítésére, illetve IVIEW képeknél lehet hasznos, egyébként elavult és általában nem ajánlott a használata.
  • -a | -n: Archívum készítése több fájlból -a esetén (-raw módot tételez fel), az alapértelmezés -n.
  • -V: Több részre (volume) bontott bemeneti fájl, csak kicsomagolásnál és tesztelésnél.
  • -V <N>: Tömörítésnél a kimenet N kilobájt méretű részekre bontása. N csak 4 többszöröse lehet.

Önkicsomagoló programok paraméterei

  • -borderfx | -noborderfx: A keretcsíkozás engedélyezése vagy tiltása.
  • -cleanup | -nocleanup: A lapozás és veremmutató EXOS-hoz hasonló beállítása.

Linkek

EP128Emu, a csomag tartalmazza az EPcompress aktuális verzióját

Z80 assembly rutinok

libepcompress forráskód (GPL), C++ programba építhető

Tömörített ROM fájlrendszer készítése (ROM: eszköz)