Zoom Patch File: Difference between revisions

From evolulution-plugins
Jump to navigation Jump to search
← Older edit
VisualWikitext
No edit summary
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 5: Line 5:


It varies in size according to comments len and number of parameters but typically it's 736 bytes long.
It varies in size according to comments len and number of parameters but typically it's 736 bytes long.
ZPTC header Offset Size


(bytes)
{| class="wikitable"
Field Purpose
|+ZPTC header
0x00 4 id "PTCF" (50, 54, 43, 46) in ASCII; these four bytes constitute the magic number.
!Offset!!Size<br />(bytes)!!Field!!Purpose
0x04 4 patchDataSize contains the size of the patch data in bytes (rest of the patch file is 0 padded)
|-
0x08 4 gen possible zptc header file version (at this time it's 1)
|0x00||4||id||"PTCF" (50, 54, 43, 46) in ASCII; these four bytes constitute the magic number.
0x0c 4 efSize contains the current number of available (and usable) effects boxes (see effectIdX fields below) in current patch. this number can be increased by adding or removing new effects (up to 9 maximum effects), this number is not affected if setting the effect box to unused (or empty) on the zoom unit.
|-
0x10 8 supportRegion for now value it's 1 - possibly something related to Zoom internals
|0x04||4||patchDataSize||contains the size of the patch data in bytes (rest of the patch file is 0 padded)
0x18 2 reserved reserved for future use
|-
0x1a 10 patchName contains the patch name (maximum 10 chars)
|0x08||4||gen||possible zptc header file version (at this time it's 1)
0x24 4 effectId0 contains numeric id of effect 0
|-
|0x0c||4||efSize||contains the current number of available (and usable) effects boxes (see effectIdX fields below) in current patch. this number can be increased by adding or removing new effects (up to 9 maximum effects), this number is not affected if setting the effect box to unused (or empty) on the zoom unit.
|-
|0x10||8||supportRegion||for now value it's 1 - possibly something related to Zoom internals
|-
|0x18||2||reserved||reserved for future use
|-
|0x1a||10||patchName||contains the patch name (maximum 10 chars)
|-
|0x24||4||effectId0||contains numeric id of effect 0


Some examples are:
Some examples are:
Line 33: Line 41:


In order to lookup zoom effect store id probably best course is to test all possibilities and rely on local FS existence test.
In order to lookup zoom effect store id probably best course is to test all possibilities and rely on local FS existence test.
0x28 4 effectId1 contains numeric id of effect 1
|-
0x2c 4 effectId2 contains numeric id of effect 2
|0x28||4||effectId1||contains numeric id of effect 1
... ... ... ...
|-
[0x44] [4] [effectId8] [contains numeric id of effect 8]
|0x2c||4||effectId2||contains numeric id of effect 2
|-
|...||...||...||...
|-
|[0x44]||[4]||[effectId8]||[contains numeric id of effect 8]
|}


{| class="wikitable"
{| class="wikitable"
|+Patch comments (Japanese)
|+Patch comments (Japanese)
! Offset!!Size(bytes)!!Field!!Purpose
! Offset!!Size<br />(bytes)!!Field!!Purpose
|-
|-
|0x00||4||sectionId||"TXJ1" ( 54, 58, 4A, 31) in ASCII; these four bytes constitute the section magic number
|0x00||4||sectionId||"TXJ1" ( 54, 58, 4A, 31) in ASCII; these four bytes constitute the section magic number
Line 51: Line 64:
{| class="wikitable"
{| class="wikitable"
|+Patch comments (English)
|+Patch comments (English)
!Offset!!Size (bytes)!!Field!!Purpose
!Offset!!Size<br />(bytes)!!Field!!Purpose
|-
|-
|0x00||4||sectionId||"TXE1" ( 54, 58, 45, 31) in ASCII; these four bytes constitute the section magic number
|0x00||4||sectionId||"TXE1" ( 54, 58, 45, 31) in ASCII; these four bytes constitute the section magic number
Line 60: Line 73:
|}
|}


Effects Database (EDTB) header
{| class="wikitable"
|+Effects Database (EDTB) header
|-
|-
! Offset !! Size !! Field !! Purpose
! Offset !! Size !! Field !! Purpose

Latest revision as of 21:54, 27 September 2021

Zoom Patch (ZPTC) file is the patch file used in Zoom Guitar Pedals. It is used mainly in N series like g5N, G3N, B3N.

It can hold maximum 9 effects, including double sized effects (amplifiers or combo effect units like reverb and delay).

It varies in size according to comments len and number of parameters but typically it's 736 bytes long.

ZPTC header
Offset Size
(bytes)		 Field Purpose
0x00 4 id "PTCF" (50, 54, 43, 46) in ASCII; these four bytes constitute the magic number.
0x04 4 patchDataSize contains the size of the patch data in bytes (rest of the patch file is 0 padded)
0x08 4 gen possible zptc header file version (at this time it's 1)
0x0c 4 efSize contains the current number of available (and usable) effects boxes (see effectIdX fields below) in current patch. this number can be increased by adding or removing new effects (up to 9 maximum effects), this number is not affected if setting the effect box to unused (or empty) on the zoom unit.
0x10 8 supportRegion for now value it's 1 - possibly something related to Zoom internals
0x18 2 reserved reserved for future use
0x1a 10 patchName contains the patch name (maximum 10 chars)
0x24 4 effectId0 contains numeric id of effect 0

Some examples are:

80 00 00 04 which maps to id 0x04000080 (ORG_120) from zoom effects store

Note: 0x4000080 is a double case spaced effect so it will consume 2 effectsId spaces.

The second effectId value will be 01 00 00 00.

40 00 00 01 which maps to id 0x1000040 (ZNR) from zoom effects store

Unfortunately ZOOM managed to screw up completely this mapping so right now there isn't a clear picture

of how mapping is done some effects are bound to 0x0number while others to 0xnumber, others have hex parts (A,B,C,D) in upper case (eg. 0x080000A0) some in lowercase (0x400001a)

In order to lookup zoom effect store id probably best course is to test all possibilities and rely on local FS existence test.

0x28 4 effectId1 contains numeric id of effect 1
0x2c 4 effectId2 contains numeric id of effect 2
... ... ... ...
[0x44] [4] [effectId8] [contains numeric id of effect 8]
Patch comments (Japanese)
Offset Size
(bytes)		 Field Purpose
0x00 4 sectionId "TXJ1" ( 54, 58, 4A, 31) in ASCII; these four bytes constitute the section magic number
0x04 4 commentSize size of comment string
0x08 commentSize comment comment text in Japanese
Patch comments (English)
Offset Size
(bytes)		 Field Purpose
0x00 4 sectionId "TXE1" ( 54, 58, 45, 31) in ASCII; these four bytes constitute the section magic number
0x04 4 commentSize size of comment string
0x08 commentSize comment comment text in English
Effects Database (EDTB) header
Offset Size Field Purpose
0x00 4 sectionId "EDTB" ( 45, 44 , 54, 42) in ASCII
0x04 4 dbSize size of the database
0x08 4 effectId effect Id (packed)
0x0c 4 field1 field 1 (packed)

EID = effect ID *2

p1 = effect parameter 1

p2 = effect parameter 2

p3 = effect parameter 3

p4 = effect parameter 4

0 1 2 3
EID byte 0 + enable parameter EID byte 1 EID byte 2 EID byte 3 +p1 byte 0
0x010 4 field2 field 2 (packed)
4 5 6 7
p1 byte 1 p2 byte 0 p2 byte 1 + p3 byte 0 p3 byte 1
0x014 4 field3 field 3 (packed)
8 9 10 11
p3 + p4 p4 00 00
... ... ... ...

Note: It's rather un clear at this time how parameters are indexed.

Some effects have some parameters 0-indexed others start from 1.

Also there are 'option' parameters which are actually an enum of options

(eg. on/off, slow/fast, stack/combo, gtrin/efxin)

Patch parameters
Offset Size Field Purpose
0x00 4 sectionId "PPRM" (50, 50, 52, 4D) in ASCII
0x04 4 sectionSize size of the section
0x08 7 unknown unknown data (zeroes)
0x10 2 patchVolume ranging from 0 to 120. volume level formula is: (second byte &

0x3f) * 2 + first byte >> 6

eg: 80 79 decodes to level: 115

0x12 2 unknown unknown data
Retrieved from "http://gnome.eu.org/index.php?title=Zoom_Patch_File&oldid=97"