Skip to content
/ canon_cr3 Public

Describing the Canon CR3 fileformat from Canon M50 / EOS R / SX70 HS / EOS RP...

License

GPL-3.0 license
286 stars 37 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

lclevy/canon_cr3

BranchesTags

Repository files navigation

Describing the Canon Raw v3 (CR3) file format

version: 20sep2024

by Laurent Clévy (@Lorenzo2472)

Wanted samples:
  • R1 raw/dpraw/heif
Contributors:
Thanks for samples to:
  • Mark McClelland for EOS R samples (www.instagram.com/mcclellandphoto)
  • Kostiantyn for M6 Mark II roll sample
  • Aaron Seilis for R5 samples (raw, craw, dpraw)
  • Mathias / Matze for R5 samples (jpeg, heif, craw, raw)
  • Gordon Laing / Cameralabs for R6 (heif)
  • Väinö Leppänen for R6 (craw, heif)
  • piratenpanda for R5 dust samples (heif, raw, version 3)
  • Kitor for R dust samples
  • oguruma1218 for a lot of R3 raw and craw !
  • medemander for R7 heif, dualpixel and raw+hdr
  • pdejl (https://github.com/pdejl) for R8 raw, craw, dp, heif
  • John Baro for R3 heif, raw and craw
  • Stephan Wesemeyer for R6 Mark II samples (raw/craw/dpraw/heif/burst)
  • https://github.com/piratenpanda for R5 Mark II raw/craw/heif/burst/dust

Table of contents

Introduction

The Canon CR3 format is based the ISO Base Media File Format (ISO/IEC 14496-12), with custom tags, and the Canon 'crx' codec: a mix of JPEG-LS (Rice-Golomb + RLE coding) and JPEG-2000 (LeGall 5/3 DWT + quantification). Some tags contains TIFF structures : IFDs, Makernotes.

Phil Harvey, the author of ExifTool, already identified some custom TIFF tags: Canon CR3 tags

Canon Raw v2 is described here: http://lclevy.free.fr/cr2/ and Canon CRW here: https://sno.phy.queensu.ca/~phil/exiftool/canon_raw.html

The CR3 file format and its new CRX codec support both lossless 'raw' and lossy 'craw' compressions. CR2, the TIFF based format is no more used by the M50 or EOSR, even with lossless 'raw' compression.

The CRX codec has been reverse engineered by Alexey Danilchenko, implemented in FastRawViewer 1.5.1 and source code was released in october 2019, see https://github.com/LibRaw/LibRaw/blob/master/src/decoders/crx.cpp

'craw' means 'compact raw'. The CR3 format also supports dual pixel pictures, sequence of images ("roll" created using Raw burst mode) and movie (CRM).

Roll files (CSI_*.CR3) can contains up to 70 pictures (from M6 Mark II, G7X Mark II). Extracted pictures have encoding type 3, likely YCrCb format and 10 bits (see https://github.com/LibRaw/LibRaw/blob/master/src/decoders/crx.cpp#L1710). Using Sony BSI sensor.

Starting with 1DX Mark III, Canon is using an additional file format to store 10 bits HDR pictures : HEIF, see https://github.com/lclevy/canon_cr3/blob/master/heif.md. CR3 can also store HDR images (with HEVC), see HDR section below.

The overall structure of a CR3 picture file is (dimensions are for EOS R):

  • 'moov' container
    • uuid=85c0b687 820f 11e0 8111 f4ce462b6a48
      • track1 = full size jpeg (6000x4000)
      • track2 = small definition raw image (1624x1080)
      • track3 = high definition raw image (6888x4546)
      • track4 = Canon Timed Metadata
      • track5 = dual pixel picture (delta?, 6888x4546)
  • uuid=be7acfcb 97a9 42e8 9c71 999491e3afac (xpacket data)
  • uuid=eaf42b5e 1c98 4b88 b9fb b7dc406e4d16 (preview data, jpeg 1620x1080)
    • PRVW, jpeg picture
  • uuid=5766b829 bb6a 47c5 bcfb 8b9f2260d06d (in roll)
    • CMTA
  • mdat (main data)
    • picture(s) from track1
    • picture(s) from track2
    • picture(s) from track3
    • Canon Timed Metadata
    • picture(s) from track5 (dual pixel)
  • uuid=210f1687 9149 11e4 8111 00242131fce4 (optional data, in roll)
    • CNOP

The Cinema Raw Light file format with extension .crm, also uses the crx codec.

Cimena Raw Movie (CRM)

Cinema Raw Light (from C200) file format is very similar to CR3, and also uses the crx codec. CNCV value is 'CanonCRM0001/02.09.00/00.00.00'

> python parse_cr3.py -v 2 A003C013_170923CU_CANON.CRM
filesize 0x21a36e70
00000:ftyp: major_brand=b'crx ', minor_version=1, [b'crx ', b'isom'] x18)
00018:moov: (0x4120) 00020:  uuid: b'85c0b687820f11e08111f4ce462b6a48' (0x2a80) 
00038:    CNCV: b'CanonCRM0001/02.09.00/00.00.00' (0x26)
0005e:   b'CCTP' b'000000000000000000000001000000184343445400000000' 0x2c)
0003a:      b'CCDT' b'00000000000000000000000000000001' (0x18)
...

See http://learn.usa.canon.com/resources/articles/2017/eos-c200-post-production-brief.shtml

CR3 file Structure

  • ftyp: File Type Box

  • moov : container box whose sub‐boxes define the metadata for a presentation

    • uuid = 85c0b687 820f 11e0 8111 f4ce462b6a48

      • CNCV (Canon Compressor Version). "CanonCR3_001/00.09.00/00.00.00"

      • CCTP (Canon Compressor Table Pointers?).

        • CCDT (?, 16 bytes).

          00000000 00000010 00000000 00000001 (flags and index ?)

        • CCDT (?, 16 bytes).

          00000000 00000001 00000000 00000002

        • CCDT (?, 16 bytes).

          00000000 00000000 00000000 00000003

      • CTBO (Canon Trak b Offsets?)

      • free

      • CMT1 (Canon Metadata in TIFF format, Exif IFD0)

      • CMT2 (Canon Metadata in TIFF format, Exif ExifIFD)

      • CMT3 (Canon Metadata in TIFF format, Canon Makernotes)

      • CMT4 (Canon Metadata in TIFF format, Exif GPS IFD)

      • THMB (Thumbnail image in jpeg format)

        • size=160x120

    • mvhd (Movie Header)

    • trak (Track, embedded jpeg)

      • tkhd (Track Header)

      • mdia (Media)

        • mdhd (Media Header)
        • hdlr (Handler, type='vide')
        • minf (Media Information container)

          • vmhd (Video Media Header)

          • dinf (Data information box)

            • dref (Data Reference box)

          • stbl (Sample table box)

            • stsd (Sample descriptions, codec types, init...)

              • CRAW (size=0x70)
                • W=6000, H=4000, D=24bit
                • JPEG (size=0xc)
                • free

            • stts (decoding, time-to-sample)

            • stsc (sample-to-chunk, partial data offset info)

            • stsz (sample sizes, framing)

              size of jpeg picture #1 in mdat

            • free

            • co64 : pointer to picture #1 inside mdat

    • trak (sd crx)

      • tkhd
      • mdia
        • mdhd
        • hdlr (type='vide')
        • minf
          • vmhd
          • dinf
            • dref
          • stbl
            • stsd
              • CRAW (size=0xd4)
                • W=1624, H=1080, BitDepth=24
                • CMP1 (size=0x3c)
                • CDI1 (size=0x34)
                  • IAD1 (size=0x28)
                • free
            • stts
            • stsc
            • stsz : size of picture #2 in mdat
            • free
            • co64 : pointer to picture #2 in mdat

    • trak (hd image in crx)

      • tkhd
      • mdia
        • mdhd
        • hdlr (type='vide')
        • minf
          • vmhd
          • dinf
            • dref
          • stbl
            • stsd
              • CRAW (size=0xe4)
                • W=6288, H=4056, bitDepth=24
                • CMP1 (size=0x3c)
                • CDI1 (size=0x44)
                  • IAD1 (size=0x38)
                • free
            • stts
            • stsc
            • stsz : size of picture #3 in mdat
            • free
            • co64 : pointer to picture #3 in mdat

    • trak (metadata at end of mdat)

      • tkhd
      • mdia
        • mdhd
        • hdlr (type='meta')
        • minf
          • nmhd
          • dinf
            • dref
          • stbl
            • stsd
              • CTMD (size=0x4c)
            • stts
            • stsc
            • stsz : size of metadata in mdat
            • free
            • co64 : pointer to metadata in mdat

  • uuid = be7acfcb 97a9 42e8 9c71 999491e3afac (xpacket data)

  • uuid = eaf42b5e 1c98 4b88 b9fb b7dc406e4d16 (preview data)

    • PRVW
      • jpeg (1620x1080)

  • mdat (main data)

    • picture #1 (6000x4000, jpeg)

    • picture #2 (1624x1080, crx preview)

    • picture #3 ( 6888x4056, crx main image)

    • Canon Timed Metadata, CTMD tags below

    • picture #5 (6888x4056, dual pixel delta image)

parse_cr3.py

This experimental tool allows to:

  • parse Canon Raw v3, and CR2 file structure
  • display TIFF tags and Canon Timed Metadata content
  • for each roll:
    • extract the jpeg pictures: THMB, PRVW and "mdat"
    • extract the sd, hd and dual pictures from 'mdat'
      • display first 32 bytes of each image subparts (both 'raw'/lossless and 'craw'/lossy)

Examples of output here

You can also use Exiftool to get detailed analysis, for example using these options:

exiftool.exe -a -U -H -v4 -b image.cr3

-a : allow duplicates, -U : unknown binary tags, -H : tag ID in hex, -b : metadata in binary format, -v4 : verbose level 4

Canon tags description

values are in big endian

THMB (Thumbnail)

from uuid = 85c0b687 820f 11e0 8111 f4ce462b6a48

Offset type size content
0 long 1 size of this tag
4 char 4 "THMB"
8 byte 1 likely version, value=0 or 1
9 bytes 3 likely flags, value = 0

for version 0:

Offset type size content
12/0xc short 1 width (160)
14/0xe short 1 height (120)
16/0x10 long 1 jpeg image size (jpeg_size)
20/0x14 short 1 unknown, value = 1
22/0x16 short 1 unknown, value = 0
24/0x18 byte[] stored at offset 16 jpeg_data = ffd8ffdb...ffd9
24+jpeg_size byte[] ? padding to next 4 bytes?
long 1 ?

for version 1:

Offset type size content
12/0xc short 1 width (160)
14/0xe short 1 height (120)
16/0x10 long 1 jpeg image size (jpeg_size)

CNCV

likely CaNon Codec Version

Offset type size content
0 long 1 size of this tag. 0x26
4 char 4 "CNCV"
8 char 30 version string

Observed values for version string:

  • "CanonHEIF001/11.00.01/00.00.00" for R10 FW 1.0.1, R8 FW 1.0.0, R50, R6 Mark II and R7 FW 1.0.1
  • "CanonHEIF001/10.00.01/00.00.00" for R6 FW 1.2.0 (with b'miaf' and b'MiHA'), R3 1.4.1
  • "CanonHEIF001/10.00.00/00.00.00" for HEIF of 1DX Mark III, R5 and R6 FW 1.0
  • "CanonCR3_003/00.11.00/00.00.00" for R7 FW 1.0.1 (raw+HDR), R50 (raw+hdr)
  • "CanonCR3_003/00.10.00/00.00.00" for R6 (craw with HDR preview), R5 (craw HDR, FW 1.2.0), R3 craw/raw, R5 MArk II raw/craw
  • "CanonCR3_002/00.10.00/00.00.00" for 1DX Mark III (craw w/ HDR FW 1.0) and R5 (craw/craw HDR FW 1.0)
  • "CanonCR3_001/00.11.00/00.00.00" for R7 (raw, craw and dualpixel), R10 (raw and dualp with FW 1.0.1), R50 (craw, raw), R6 Mark II (raw, dpraw and craw FW 1.2.0) and R8 (FW 1.0.0 raw and craw)
  • "CanonCR3_001/00.10.00/00.00.00" for 1DX Mark III (raw/craw FW 1.0) , EOS R5 (raw), R5m2 (craw), R1 (craw) and R6 (craw/raw)
  • "CanonCR3_001/01.09.00/01.00.00" for raw burst mode roll (containing several pictures in burst mode)
  • "CanonCR3_001/01.09.00/00.00.00" for SX70 HS, G5 Mark II and G7 Mark III
  • "CanonCR3_001/00.09.00/00.00.00" for EOS R, EOS RP, M50, 250D, 90D, M6 Mark II, M200, M50m2 and 250D, R100 (raw/craw)
  • "CanonCRM0001/02.09.00/00.00.00" for CRM movies

CCTP

size=0x5c for 3 CCDT lines, 0x74 for 4 lines (dual pixel).

Offset type size content
0 long 1 size of this tag
4 char 4 "CCTP". Canon CR3 trak pointers?
8 long 1 0
12 long 1 1
16 long 1 number of CCDT lines. 3, or 4 for dual pixel

3 CCDT lines are included.

CCDT

Offset type size content
0 long 1 size of this tag. 0x18
4 char 4 "CCDT". Canon CR3 definition of tracks ?
8 longlong 1 image type? 0x10, 1 or 0
16 long 1 0 or 1 for dual pixel
20 long 1 Trak index. 1, 2, 3 or 5

type values:

  • 2 for trak#1 (JPEG_BIG)
  • 1 for trak#2 (CRX_SMALL)
  • 0 for trak#3 (CRX_BIG)
  • 4 for trak#5 dual pixel second image (CRX_DUAL)

CTBO

Offset type size content
0 long 1 size of this tag. 0x5c
4 char 4 "CTBO". Canon tracks base offsets ?
8 long 1 number of records. 4 or 5.

for each records (20 bytes):

Offset type size content
0 long 1 index (first is 1)
4 longlong 1 offset
12 longlong 1 size

Records are:

  1. xpacket
  2. preview
  3. mdat (main data)
  4. ? size and offset are 0
  5. uuid: b'5766b829bb6a47c5bcfb8b9f2260d06d', containing CMTA

(using canon_eos_m50_02.cr3)

00000004 
00000001 0000000000006b88 0000000000010018 (offset and size of xpacket uuid)
00000002 0000000000016ba0 0000000000056d90 (offset and size of preview uuid)
00000003 000000000006d930 00000000025022b8 (offset and size of mdat)
00000004 0000000000000000 0000000000000000 ?

PRVW (Preview)

from uuid = eaf42b5e 1c98 4b88 b9fb b7dc406e4d16

size = 1620x1080

Offset type size content
0 long 1 size of this tag
4 char 4 "PRVW"
8 long 1 unknown, value = 0
12/0xc short 1 ? value = 1
14/0xe short 1 width (1620)
16/0x10 short 1 height (1080)
18/0x12 short 1 ? value = 1
20/0x14 long 1 jpeg_size
24/0x18 byte[] stored at offset 20 jpeg_data = ffd8ffdb...ffd9
24+jpeg_size byte[] ? padding to next 4 bytes?

CRAW

see also https://sno.phy.queensu.ca/~phil/exiftool/TagNames/QuickTime.html#ImageDesc

CRAW is derived from ISOBMFF SampleEntry box.

Offset type size content
0 long 1 size of this tag.
4 bytes 4 "CRAW"
8 byte[] 6 0. SampleEntry.reserved
12 ushort 1 1. SampleEntry.data_reference_index
16 bytes? 16? 0
32 short 1 width
34 short 1 height
36 short 2 0048 0000. XResolution. (72.0) in fixed point
40 short 2 0048 0000. YResolution. (72.0)
44 long? 1 0
48 short 1 1
50 bytes? 32? 0. CompressorName ?
82 short 1 bits depth. 24
84 short? 1 ffff. -1?
86 short 1 3. flags ? 3 for Jpeg, 1 for craw/raw
88 short 1 0 for jpeg. 1 for craw/raw

CRAW contains

  • either JPEG (jpeg). Size=0x3c
  • or CMP1 and CDI1 (raw) .

sizes:

  • 0x3c for jpeg
  • 0xd4 for small raw, because IAD1 size is 0x28
  • 0xe4 for big raw, because IAD1 size id 0x38

JPEG

Offset type size content
0 long 1 size of this tag. 0xc
4 char 4 "JPEG"
8 long 1 0

CMP1 (Compression?)

Thanks to Alexey Danilchenko for his contributions (bytes 10 to 36):

"In terms of CRX decoder this CMP1 is essentially image header for encoded image (exists for each image track). Decoder uses CMP1 data to decode image track."

Offset type size content
0 long 1 size of this tag. 0x3c
4 char 4 "CMP1"
8 short? 1 -1 ?
10 short 1 0x30 - size of the image header to follow
12 short 1 version - always 0x100 for current CR3 (major.minor version in bytes?)
14 bytes 2 00 00
16 long 1 image width
20 long 1 image height
24 long 1 tile width (image width /2 for big picture)
28 long 1 tile height
32 byte 1 bits per sample - usually 14
33 bits 4 number of planes - 4 for RGGB
33+4bits bits 4 CFA layout - only valid where number of planes > 1. 0:RGGB, 1:GRBG, 2:GBRG, 3:BGGR. Seen 1 for small, 0 for big (raw or craw)
34 bits 4 encoding type. Always 0 for raw and craw, 3 for raw extracted from roll burst
34+4bits bits 4 number of wavelet levels (set for wavelet compressed image). 0 for raw, 3 for craw
35 bit 1 1 = image has more than one tile horizontally (set for wavelet compressed image). Seen 1 for craw big, 0 otherwise
35+1bit bit 1 1 = image has more than one tile vertically (set for wavelet compressed image). Always 0
35+2bits bits 6 unused in current version - always 0
36 long 1 mdat track header size (mdat bitstream data starts following that header). raw small = 0x70, raw big = 0xd8, craw small = 0x220, craw big = 0x438
40 bit 1 1 = has extended header, has extended header size
40+1bit bits 7 ? 0
41 byte 1 ? 0
42 short 1 ? 0
44 bytes 16 ? plane count (4) times "01 01 00 00"
60 long 1 extended header size, only present and everything after if extended header bit set
64 bit 1 ? always seems to be 1
64+1bit bit 1 1 = has median bit depth
64+2bits bits 6 ? 0
65 byte 1 ? 0
66 short 1 ? 0
68 long 6 ? 6 items
92 byte 1 median bit depth, usually 14, only present if has median bit set. an alternative bit depth to use with type 3 encoding when combining intermediate buffers

CDI1 (Canon Dimensions?)

size = sizeof(IAD1) + 12

CDI1 is a ISOBMFF FullBox, containing other boxes

Offset type size content
0 long 1 size of this tag. 0x3c
4 char 4 "CDI1"
8 byte 1 FullBox Version
9 bytes[] 3 FullBox flags

IAD1 (Image Area Dimensions ?)

Size=0x28 for small picture, 0x38 for big picture. All values are in big endian

Offset type size content (EOS R full size) cropped image (x1.6)
0 short 1 0
2 short 1 0
4 short 1 image width (6888 with EOS R) 4352
6 short 1 image height (4546 with EOS R) 2850
8 short 1 1
10/0xa short 1 0 (small), 2 (big) = flag for sliced ?
12 short 1 1
14 short 1 0

Small image (1024x1080)

Offset type size content (no crop) cropped
16 short 1 1 3
18 short 1 0 0
20 short 1 width -4 (1620) 1622
22 short 1 height (1079) 1079
24 short 1 0 0
26 short 1 0 0
28 short 1 width -1 (1623) 1623
30 short 1 height -1 (1079) 1079

Big image (dimensions example is for EOS R)

Offset type size content (full size) cropped (x1.6)
16 short 1 crop left offset (sensorInfo[5]) = 156 164
18 short 1 crop top offset (sensorInfo[6]) = 158 158
20 short 1 crop right offset (sensorInfo[7]) = 6875 4339
22 short 1 crop bottom offset (sensorInfo[8]) = 4537 2841
24 short 1 left optical black left offset = 0
26 short 1 left optical black top offset = 0
28 short 1 left optical black right offset = 143 151
30 short 1 left optical black bottom offset = 4545 2849
32 short 1 top optical black left offset = 144 152
34 short 1 top optical black top offset = 0
36 short 1 top optical black right offset = 6887 4351
38 short 1 top optical black bottom offset = 45 45
40 short 1 active area left offset = 144 152
42 short 1 active area top offset = 46 46
44 short 1 active area right offset = 6887 4351
46 short 1 active area bottom offset = 4545 2849

Values are given as offsets (from zero), so you must + 1 if you want the amount of pixels.

active area is the rectangle containing valid pixel data. It has same meaning as ActiveArea DNG tag. These values sometimes are not accurate, especially in 1.6x crop files. The bottom or right offsets are sometimes few pixels overflowing the width/height of raw image. Maybe a glitch in the firmware.

crop is the rectangle for the recommended crop. The dimension is usually exactly the size of the official camera resolution and full size JPEGs.

CMTA (Canon Metadata in Tiff)

With roll CR3.

Tiff tag 0x4047, byteseq, size = 583576

unknown content

CNOP (Canon Optional data)

unknown content

CTMD (Canon Timed MetaData)

  1. Inside trak#4:

Offset type size content
0 long 1 size of this tag. 0x4c
4 char 4 "CTMD"
8 long 1 0
12 long 1 1
16 long 1 number of CTMD records. example= 7
20 records[] stored at 16

For each record (size=8 bytes):

Offset type size content
0 short 1 unknown (issue #36, thanks DrCQ)
2 short 1 type. 1,3,4,5,7,8 or 9
4 long 1 size

  1. At end of mdat area:

Contribution by Phil Harvey

Each CTMD record has this format (little-endian byte order):
Offset type size content
0 long 1 record size (N)
4 short 1 record type (1,3,4,5,7,8 or 9)
6 byte 1 0 for non TIFF types, 1 for TIFF
7 byte 1 0 for non TIFF types, 1 for TIFF
8 short 1 1
10 short 1 unknown. value is 0 (types 1,3) or -1 (types 4,5,7,8,9)
12 byte[] N-12 payload
CTMD record type 1 payload (time stamp):
Offset type size content
0 short 1 unknown
2 short 1 year
4 byte 1 month
5 byte 1 day
6 byte 1 hour
7 byte 1 minute
8 byte 1 second
9 byte 1 1/100 seconds
10 byte[] 2 unknown
CTMD record type 3 payload (unknown):
Offset type size content
0 long 1 unknown. -1 if empty ?
CTMD record type 4 payload (focal-length info):
Offset type size content
0 short 1 focal length numerator
2 short 1 focal length denominator
4 byte[] 8 unknown
CTMD record type 5 payload (exposure info):
Offset type size content
0 short 1 F-number numerator
2 short 1 F-number denominator
4 short 1 exposure time numerator
6 short 1 exposure time denominator
8 long 1 ISO speed rating
12 byte[] 16 unknown
CTMD record type 7, 8 and 9 payload (Exif info):

This is a block of Exif records. Each Exif record has this format:

Offset type size content
0 long 1 record size (N)
4 long 1 tag ID (0x8769=ExifIFD, 0x927c=MakerNotes)
8 byte[] N-8 TIFF-format metadata

CMT3

tag 0x97 (Dust Delete Data)

M50 use version 1, see http://lclevy.free.fr/cr2/#ddd

tag 0x403f (Roll Info)

00740:    b'CMT3': (0xe70)
...
            0x000986 16447/0x403f     ulong(4)*3           3620/0xe24, 12 15 36

12 is tag length (4*3), 15 is the current picture (#16 in DPP), 36 is the number of images in the roll.

MDAT (main data)

The MDAT section contains 4 or 5 parts:

  1. a fullsize, lossy jpeg version of picture(s)
  2. a small version of picture(s) in raw or craw (1624x1080)
  3. a fullsize version, in raw or craw
  4. data for CTMD (Canon Time Metada)
  5. for dual pixel (delta?) picture(s), in raw or craw

mdat_picture1 (lossy jpeg)

>python parse_cr3.py -v 2 canon_eos_m50_02.cr3
...
06451:            CRAW: (0x70)
                    width=6000, height=4000
064ab:              b'JPEG' b'00000000' (0xc)
064b7:              b'free' b'0000' (0xa)
064c1:          b'stts' b'00000000000000010000000100000001' (0x18)
064d9:          b'stsc' b'0000000000000001000000010000000100000001' (0x1c)
064f5:          stsz: version=0, size=0x30d6ef, count=1 (0x14)
06509:          b'free' b'00000000000000' (0xf)
06518:          co64: version=0, size=6d940, count=1 (0x18)
...
extracting jpeg (trak0) 6000x4000 from mdat... offset=0x6d940, size=0x30d6ef

mdat_picture2 (crx codec)

this file is compressed lossless

>python parse_cr3.py canon_eos_m50_02.cr3
...
06635:            CRAW: (0xd4)
                    width=1624, height=1080
0668f:              CMP1: (0x3c)
066cb:              CDI1: (0x34)
066d7:                IAD1: (0x28)
066ff:              b'free' b'0000' (0xa)
06709:          b'stts' b'00000000000000010000000100000001' (0x18)
06721:          b'stsc' b'0000000000000001000000010000000100000001' (0x1c)
0673d:          stsz: version=0, size=0x1cbc40, count=1 (0x14)
06751:          b'free' b'00000000000000' (0xf)
06760:          co64: version=0, size=37b030, count=1 (0x18)
...
extracting SD crx (trak1) 1624x1080 from mdat... offset=0x37b030, size=0x1cbc40
ff01 001cbbd0 0
  ff02 0007b5c0 0 1 0 0000000
    ff03 0007b5c0 0 0 04 00001
      b'00000000002027a5000004000f03e0347565417b810ded0ef68019d59085af6a' (37b0a0)
  ff02 00070600 1 1 0 0000000
    ff03 00070600 0 0 04 00002
      b'00000000002028ff00000a6000680ccecfdd76905615eb87c07047a8e10bb5a4' (3f6660)
  ff02 00070640 2 1 0 0000000
    ff03 00070640 0 0 04 00006
      b'00000000002028d500000000004001800880baa0035a513e5a91891b50050ad5' (466c60)
  ff02 0006f9d0 3 1 0 0000000
    ff03 0006f9d0 0 0 04 00006
      b'0000000000202cab0000020002a2b7747063b83a27ff1625fb4d52b4c41823e5' (4d72a0)

mdat_picture3 (crx codec)

this file is compressed lossless

>python parse_cr3.py -v 2 canon_eos_m50_02.cr3
...
0687d:            CRAW: (0xe4)
                    width=6288, height=4056
068d7:              CMP1: (0x3c)
06913:              CDI1: (0x44)
0691f:                IAD1: (0x38)
06957:              b'free' b'0000' (0xa)
06961:          b'stts' b'00000000000000010000000100000001' (0x18)
06979:          b'stsc' b'0000000000000001000000010000000100000001' (0x1c)
06995:          stsz: version=0, size=0x201ef28, count=1 (0x14)
069a9:          b'free' b'00000000000000' (0xf)
069b8:          co64: version=0, size=546c70, count=1 (0x18)
...
extracting HD crx (trak2) 6288x4056 from mdat... offset=0x546c70, size=0x201ef28
ff01 00ff40b8 0
  ff02 00405528 0 1 0 0000000
    ff03 00405528 0 0 04 00006
      b'0000000000202e45000000000040039226003b15c982d276151ca7cef3aa0b22' (546d48)
  ff02 003fc8a8 1 1 0 0000000
    ff03 003fc8a8 0 0 04 00003
      b'0000000000202fbd000000000040016000000000e801b88ac3590cd6c022df4d' (94c270)
  ff02 003fc6e8 2 1 0 0000000
    ff03 003fc6e8 0 0 04 00005
      b'0000000000202f9d0000000002000000000a80110bf884163afc8d3d28f76fe1' (d48b18)
  ff02 003f5c00 3 1 0 0000000
    ff03 003f5c00 0 0 04 00000
      b'0000000000202f6100000000004003ae0000000062a9c1c8002b0471075d0a2d' (1145200)
ff01 0102ad98 1
  ff02 0040cb88 0 1 0 0000000
    ff03 0040cb88 0 0 04 00006
      b'0000000000202f6b0000000000a0064e819b8854c64481e72f454f50a3242ab2' (153ae00)
  ff02 0040eb50 1 1 0 0000000
    ff03 0040eb50 0 0 04 00006
      b'0000000000202feb00000000004003c20000000000800b68026fcbbd264dfba5' (1947988)
  ff02 0040ed48 2 1 0 0000000
    ff03 0040ed48 0 0 04 00002
      b'0000000000202fa10001c00001b0034367370ac4dec63b510ad0e2415a17c15f' (1d564d8)
  ff02 00400978 3 1 0 0000000
    ff03 00400978 0 0 04 00007
      b'00000000002031db000000000040062400000001b0005e43835fa07a05efb670' (2165220)

mdat_metadata (CTMD records)

size=0xa04c

0x2565b90:                    18000000 01000000    ................
0x2565ba0:  00010000 0000e207 02150c01 1c010000    ................
0x2565bb0:  10000000 03000000 00010000 ffffffff    ................
0x2565bc0:  18000000 04000000 0001ffff 2d000100    ............-...
0x2565bd0:  ffffffff ffffffff 28000000 05000000    ........(.......
0x2565be0:  0001ffff 3f000a00 01005000 00320000    ....?.....P..2..
....
0x256fbc0:  00000000 0002b006 00009800 94042600    ..............&.
0x256fbd0:  6d004d00 01000001 ff070100 00000100    m.M.............
0x256fbe0:  05000000 00000000                      ........

This is a block of CTMD (Canon Timed MetaData) records.

offset=0x2565b98, size=24, type=1: ctmd_timestamp(y=2018, mo=2, d=21, h=12, m=1, s=28, ms=1)
offset=0x2565bb0, size=16, type=3: b'100000000300000000010000ffffffff'
offset=0x2565bc0, size=24, type=4: ctmd_focal(num=45, denum=1)
offset=0x2565bd8, size=40, type=5: ctmd_exposure(f_num=63, f_denum=10, expo_num=1, expo_denum=80, iso=12800)

HDR

CR3 files storing HDR pictures contains HEVC data and metadata. Such files are created by 1DX Mark III.

"THMB" and "CRAW" entries contains Canon specific tags and HEVC metadata.

Example values are for 1DX Mark III.

HDR images in CR3 are stored in 4:2:2 sub-sampling and 10bits, based on 'hvcC' and 'pixi' content.

Canon HEVC like tags

CISZ

likelike "Canon Image SiZe". Inside THMB or CRAW metadata.

Offset type size content
0 long 1 size (0x14)
4 char[] 4 "CISZ"
8 byte 1 likely version
9 bytes 3 likely flags
12/0xc short 1 width ? (320 for THMB)
16/0x10 short 1 height ? (320 for THMB)

IMGD

IMaGe Data. Inside THMB or CRAW metadata.

Offset type size content
0 long 1 size (N bytes)
4 char[] 4 "IMGD"
8 long 1 inner size1 (N-12)
12 long 1 inner size2 (N-16)
16/0x10 bytes[] 1 height ? (x0140 for THMB)
16+inner size2 end of image data

GRID

Inside CRAW metadata. To describe number and size of tiles.

Offset type size content
0 long 1 size (0x18)
4 char[] 4 "GRID"
8 byte 1 likely version
9 bytes 3 likely flags
12/0xc long 1 number of tiles (4)
16/0x10 long 1 unknown, value is 0x00000101
20/0x14 short 1 width (5472)
22/0x16 short 1 height (3648)

For main CRAW image, GRID dimensions are 5472x3648 and CISZ dimensions are 2752x1856, likely for each of 4 tiles. But 2752 x 2 = 5504 (not 5472), and 1856 x 2 = 3712 (not 3648). This must be for black level measurement on the borders.

For THMB (thumbnail) image, THMB dimensions are 320x214, whereas CISZ dimensions are 320x320.

Standard HEVC tags

"pixi", "colr" and "hvcC" tags are used, see https://github.com/lclevy/canon_cr3/blob/master/heif.md and related ISO standards.

Example

python parse_cr3.py -v 1 93FG5559.CR3
filesize 0x17dbc58
00000:ftyp: major_brand=b'crx ', minor_version=1, [b'crx ', b'isom'] (0x18)
00018:moov: (0xacf0)
00020:  uuid: b'85c0b687820f11e08111f4ce462b6a48' (0xa310)
00038:    CNCV: b'CanonCR3_002/00.10.00/00.00.00' (0x26)
0005e:    b'CCTP' b'000000000000000100000003000000184343445400000000' (0x5c)
0003a:      b'CCDT' b'00000000000000200000000000000001' (0x18)
00052:      b'CCDT' b'00000000000000010000000000000002' (0x18)
0006a:      b'CCDT' b'00000000000000000000000000000003' (0x18)
000ba:    CTBO: (0x70)
            1    ad08   10018
            2   1ad20   66388
            3   811f0 175aa68
            4       0       0
            5       0       0
0012a:    b'free' b'000000000000' (0xe)
00138:    b'CMT1': (0x208)
00340:    b'CMT2': (0x608)
00948:    b'CMT3': (0x2608)
02f50:    b'CMT4': (0x808)
03758:    THMB: version=1, width=320, height=214, size=0x6bc0 (0x6bd8)
03770:      CISZ: v0 320x320
03784:      hvcC: (0xaf)
              v1 4 8000000 b'9d2000000000' lvl=60, seg=0 para=0 chrF=4:2:2 lum=10 chr=10, fr=0, f, n=3
                type=0xa0 n=1:len=0x16,
                type=0xa1 n=1:len=0x64,
                type=0xa2 n=1:len=0x7,
03833:      colr: b'nclx' 9 10 9 80
03846:      pixi: 3, 10 10 10
03856:      b'IMGD' b'00006ac000006abc2601ac18c0f9558525640207952fbd1c' (0x6acc)
0a330:  b'mvhd' b'00000000da72f103da72f103000000010000000100010000' (0x6c)
0a39c:  b'trak' b'0000005c746b686400000007da72f103da72f10300000001' (0x2f4)
0a3a4:    b'tkhd' b'00000007da72f103da72f103000000010000000000000001' (0x5c)
0a400:    b'mdia' b'000000206d64686400000000da72f103da72f10300000001' (0x290)
0a408:      b'mdhd' b'00000000da72f103da72f103000000010000000115c70000' (0x20)
0a428:      hdlr: b'vide' (0x21)
0a449:      b'minf' b'00000014766d686400000001000000000000000000000024' (0x247)
0a451:        b'vmhd' b'000000010000000000000000' (0x14)
0a465:        b'dinf' b'0000001c6472656600000000000000010000000c75726c20' (0x24)
0a46d:          b'dref' b'00000000000000010000000c75726c2000000001' (0x1c)
00010:            b'url ' b'00000001' (0xc)
0a489:        b'stbl' b'000001807374736400000000000000010000017043524157' (0x207)
0a491:          b'stsd' b'000000000000000100000170435241570000000000000001' (0x180)
00010:            CRAW: (0x170)
                    width=5472, height=3648, bits=24
0005a:              b'HEVC' b'000000010000001847524944000000000000000400000101' (0x10c)
0000c:                GRID: v0 n=4 5472x3648
00024:                CISZ: v0 2752x1856
00038:                hvcC: (0xb1)
                        v1 24 8000000 b'9d2000000000' lvl=153, seg=0 para=0 chrF=4:2:2 lum=10 chr=10, fr=0, f, n=3
                          type=0xa0 n=1:len=0x16,
                          type=0xa1 n=1:len=0x66,
                          type=0xa2 n=1:len=0x7,
000e9:                colr: b'nclx' 9 10 9 80
000fc:                pixi: 3, 10 10 10
00166:              b'free' b'0000' (0xa)
0a611:          b'stts' b'00000000000000010000000100000001' (0x18)
0a629:          b'stsc' b'0000000000000001000000010000000100000001' (0x1c)

CRX codec structures

update: the following is true codec version starting with "CanonCR3_001". With "CanonCR3_002", tile start with marker 0xff11, plane with 0xff12 and subband with 0xff13 (seen with 1DX Mark III craw).

Lossless compression (raw)

(using canon_eos_m50_02.cr3, by analysing hex data)

small picture 1624x1080 (preview in DPP)

picture data size = 0x1cbc40
 7b5c0 + 70600 + 70640 + 6f9d0 == 1cbbd0
crx header (size=0x6c +4)
0x37b030:  ff010008 001cbbd0 00000000             size after header is 0x1cbbd0
           ff020008 0007b5c0 08000000             plane#0, size is 7b5c0
           ff030008 0007b5c0 00200001             
           ff020008 00070600 18000000             plane#1
0x37b060:  ff030008 00070600 00200002 
           ff020008 00070640 28000000             plane#2
           ff030008 00070640 00200006 
           ff020008 0006f9d0 38000000             plane#3
0x37b090:  ff030008 0006f9d0 00200006             
           00000000                               <-- 4 bytes here
0x37b0a0:  00000000 002027a5 00000400 0f03e034    start of plane#0 (37b030+70) 
...
0x3f6650:  4f6c6b49 8492d816 083817c6 75908c00    
0x3f6660:  00000000 002028ff 00000a60 00680cce    37b0a0+7b5c0= 3f6660 (start of plane#1)
0x3f6670:  cfdd7690 5615eb87 c07047a8 e10bb5a4    
...
0x466c50:  a8417683 15413023 3427d483 0ee80000    
0x466c60:  00000000 002028d5 00000000 00400180    3f6660+70600= 466c60 (start of plane#2)
0x466c70:  0880baa0 035a513e 5a91891b 50050ad5    
...
0x4d7290:  e9ae1d2b 7739005b 6a900000 00000000    
0x4d72a0:  00000000 00202cab 00000200 02a2b774    466c60+70640= 4d72a0 (start of plane#3)
0x4d72b0:  7063b83a 27ff1625 fb4d52b4 c41823e5    4d72a0+6f9d0 = 546C70
...
0x546c60:  86bbe446 05c21456 bdbc0000 00000000    end of plane#3
0x546c70:  ff010008 00ff40b8 00000000 ff020008    4d72a0 + 6f9d0 = 546C70 = 37b030 + 70 + 1cbbd0

big picture 6888x4056

The first ff01 section is the left slice, the second one is the right slice. Inside each ff01 section, it seems the first ff02 is for red, the second and third for green, the 4th for blue: the bayer RGGB pattern.

picture data size = 0x201ef28
 405528 + 3fc8a8 + 3fc6e8 + 3f5c00 = ff40b8 (size of subpic#0, with 4 parts)
crx header (size=0xd8)
0x546c70:  ff010008 00ff40b8 00000000             
           ff020008 00405528 08000000             subpic#0.0, size=405528
           ff030008 00405528 00200006 
           ff020008 003fc8a8 18000000             1
0x546ca0:  ff030008 003fc8a8 00200003 
           ff020008 003fc6e8 28000000             2
           ff030008 003fc6e8 00200005 
           ff020008 003f5c00 38000000             3
0x546cd0:  ff030008 003f5c00 00200000

 40cb88 + 40eb50 + 40ed48 + 400978 = 102ad98
ff40b8 + 102ad98 = 201EE50 (+d8 = 201ef28)
0x546cda:  ff010008 0102ad98 00010000             102ad98 is size of subpic #1, with 4 parts
           ff020008 0040cb88 08000000             subpic#1.0, size=40cb88
           ff030008 0040cb88 00200006    
0x546d00:  ff020008 0040eb50 18000000             1
           ff030008 0040eb50 00200006 
           ff020008 0040ed48 28000000             2
           ff030008 0040ed48 00200002    
0x546d30:  ff020008 00400978 38000000             3
           ff030008 00400978 00200007           
           
0x546d48:  00000000 00202e45 00000000 00400392 26003b15. 546c70 + D8 = 546d48 (subpic#0.0)
...
0x94c260:  0aa2e833 1e531992 29880000 00000000    
0x94c270:  00000000 00202fbd 00000000 00400160    546d48 + 405528 = 94c270 (subpic#0.1)
0x94c280:  00000000 e801b88a c3590cd6 c022df4d    
...
0x153adf0:  11419c8e b2bfd253 391bfc04 4a709fe8    
0x153ae00:  00000000 00202f6b 00000000 00a0064e   546d48 + ff40b8 = 153ae00 (subpic#1.0)  
0x153ae10:  819b8854 c64481e7 2f454f50 a3242ab2    
...
0x1947970:  f4aa562c 85eb7223 44cc5405 1b8411b0    
0x1947980:  22800000 00000000 
                              00000000 00202feb   153ae00 + 40cb88 = 1947988 (subpic#1.1)
0x1947990:  00000000 004003c2 00000000 00800b68    
...
0x1d564c0:  4e418e60 561af160 20d8964b c866ac81    
0x1d564d0:  7e800000 00000000 
                              00000000 00202fa1   1947988 + 40eb50 = 1D564D8 (subpic#1.2)
0x1d564e0:  0001c000 01b00343 67370ac4 dec63b51    
...
0x2565b80:  f8dfd549 a2c4f792 ddc72efe 2c9a7435    
0x2565b90:  f8000000 00000000 
                              18000000 01000000    546d48 + ff40b8 + 102ad98 = 2565B98 (end of subpic#1.3)

Lossy compression (craw)

Lossy compression data always has 10 "ff03 parts" for one "ff02 part", and not only one like lossless.

extracting SD crx (trak1) 1624x1080 from mdat... offset=0x20ee31, size=0x85200
ff01 00084fe0 0
  ff02 00020328 0 1 0 0000000
    ff03 00001918 0 0 04 00006
      b'0000000000203ac318425ef6a542510989082c844a24481516268485b225d0a8' (20f051)
    ff03 00001538 1 0 04 00003
      b'00ef1e8849731d5028b2248b391413212c401b04595d7d65018054ad899137a8' (210969)
    ff03 000016b0 2 0 04 00006
      b'67ac484c922e025e55034962865cc8168e0b2636db2efa9341cb403a227bea08' (211ea1)
    ff03 00001610 3 0 04 00007
      b'01fde185a0795dd7b0d0906d0400e2a1272113c64072af1a0423259919531043' (213551)
    ff03 00003308 4 0 10 00005
      b'575d1afb5a4fdb3999ac9249a7a724dcdbe6c7ac550a8849158fa42a0a8f3f05' (214b61)
    ff03 000037f8 5 0 10 00000
      b'f65dfb9eddf5ebc65fda716792792f13236f93ab9d0da2a66fe4e37673ecc360' (217e69)
    ff03 00002a10 6 0 16 00004
      b'fdc31c95bc733fbcea678e9bdaf96ce7cf19361939cffb935c924eceb35c9cd9' (21b661)
    ff03 00006878 7 0 1a 00004
      b'faff6f8ff667774f2f87aaf3efb70f0f971dfb93fa4e1ff1e5ddefc3d5aaf4e7' (21e071)
    ff03 00007688 8 0 1a 00006
      b'ffd370f971feb3d5fb7cf9bd5cbabc5e2f470f7f272ede5efe3cb4de5d3d387c' (2248e9)
    ff03 00003408 9 0 20 00004
      b'fffffe50e39d0b80fce7d0be73aa736749784ffef5cdb85765fe99f00e45c238' (22bf71)
  ff02 00021928 1 1 0 0000000
    ff03 00001af0 0 0 04 00006
      b'000000000020394b00104132249729a435ef6b9ef72443204463319422958ac5' (22f379)
    ff03 00001678 1 0 04 00005
      b'0a6883f1002cd95ea0b644ff25597844d9312c0bcf70c05d7feb07285981cbda' (230e69)
...
extracting HD crx (trak2) 6288x4056 from mdat... offset=0x294031, size=0xadee70
ff01 0053a758 0
  ff02 0012bd60 0 1 0 0000000
    ff03 00009780 0 0 04 00001
      b'0000000000203bf754548c25d64922a4b02f9152a62bad34996ae57486444a97' (294469)
    ff03 00009440 1 0 04 00005
      b'24491267014147941584993c11f743c48190d21403e911b16dae44ab02b5ea90' (29dbe9)
    ff03 00009580 2 0 04 00001
      b'42dca2f8184a44d6d1e530f224d421705a691e92fe785962ddb421544d91f460' (2a7029)
    ff03 0000a018 3 0 04 00003
      b'900912b17668800484f28051f6da010f193d6404a64412f1d0844dfc0e49be80' (2b05a9)
    ff03 00019fb0 4 0 10 00007
      b'24fabde49a599f7d59e48636fbe277ea5656286792e77df97eafa71c477d3cca' (2ba5c1)
    ff03 00019f08 5 0 10 00007
      b'd9f7efb3cf7c5e6f657652dfb7678d72f4ef73efc8d8def9df9f6778f8d3abfd' (2d4571)
    ff03 00016fe0 6 0 16 00002
      b'cc9f39379d6e4bfeed9dbd799ae27c924e27e5f138cce3c712ffad993b713c92' (2ee479)
    ff03 00043de8 7 0 1a 00000
      b'e7fff83eaf83c4f5be27d3707cb794eae273fbdef774f7babc6e379374eb9f0f' (305459)
    ff03 00044458 8 0 1a 00000
      b'fcfe1e9ff3777fc1d3ee4f5791f13cee1f1cf37897376f77be5c5f8fd1e47e27' (349241)
    ff03 00032b30 9 0 20 00006
      b'fffffe3ef2d7e23e867873923fd2a7077e6af9b9f9a0fe101c357c2cff11ef88' (38d699)
  ff02 001564e8 1 1 0 0000000
    ff03 0000a450 0 0 04 00007
      b'0000000000203bfb8bd2e14b8d29ea1d4e44a5245288ae9e920897254d543eb2' (3c01c9)
    ff03 0000a2d0 1 0 04 00000
      b'856125e24305a8250d1d0264c962528c61815243203fca07638d24bc92ccff88' (3ca619)
    ff03 0000a1f8 2 0 04 00000
      b'02a0c6c90295148640ce38242da344a42a0301e08a590a38c3062183068550c0' (3d48e9)
    ff03 0000abc0 3 0 04 00007
      b'0b6a02013ba24444cda4ff15c8a0017662435a35c4ac22d088448825c03b68f1' (3deae1)
    ff03 0001cd60 4 0 10 00006
      b'933e6f6737f7d7a9ce79f8f59f2a9dfe273aebefeb3f6f9e526efc3d27e1d729' (3e96a1)
    ff03 0001cc00 5 0 10 00003
      b'5f7d5debeef9b6dffaefbdbbc25b7df25f3ddc6eb7977bb97dcd95b3e57f3939' (406401)
    ff03 00019928 6 0 16 00005
      b'5b3cf3f26faf69cfebd7f0ebac9ea9f89fa499e3e9d3a70ed3fcbae9e5cb8797' (423001)
    ff03 0004e3e8 7 0 1a 00002
      b'fffebfe778de6fc94f1ba5ddf13a7f0df02e5f96e02fdb3d1be03e21dcfd7b26' (43c929)
    ff03 0004eca0 8 0 1a 00003
      b'fff6ffd8e2f43defdf7dffa1f9ce9fcd779e2bc87e93c1725f3e739dae474fb5' (48ad11)
    ff03 0003cd00 9 0 20 00000
      b'ffffffffffe1001a04ae0d7019c13836b86e171dd8e35d1c1e6e2e2ead93e2dc' (4d99b1)
  ff02 001560b8 2 1 0 0000000
    ff03 0000a400 0 0 04 00007
      b'0000000000203bffd356922a9bf4a0553ed6a4bd0f21465d34b0b591935aa44b' (5166b1)
      ...     
ff01 005a42e0 1
  ff02 001479e8 0 1 0 0000000
    ff03 0000a6c8 0 0 04 00003
      b'0000000000203bfdd44e9d3c288938a1f5094259326591dc2649eb23146aa150' (7cebc1)
    ff03 000098b0 1 0 04 00004
      b'0ff9c1090abe0c55d1060a325080f4938299b388b2c489fcb24bd1449142ac0b' (7d9289)
    ff03 00009fe0 2 0 04 00005
      b'05690a9c062624c4b90ee18521e8504d3c0a5b49c06432052929ab4d03469621' (7e2b39)
    ff03 0000a548 3 0 04 00007
      b'091fb2004c9ca75277a32874ee547407af2919a012548cf82a4071ae9991243d' (7ecb19)
    ff03 0001ace0 4 0 10 00005
      b'cda4fa3a55764993accf73b267bbce4ce6431c9242542a33be670a8e4934d55b' (7f7061)
    ff03 0001bd28 5 0 10 00003
      b'ff34de7365b9c9e737fe5dce3e9738e2ebbfadf5591ab7cdbd4a772b8bf9f971' (811d41)
    ff03 00018610 6 0 16 00000
      b'6e72ee92b3d992ef9ebec9ffa4e3cf59c750d1b9fb71eb64e7ddc9bdbdf9f1c7' (82da69)
    ff03 00049ab8 7 0 1a 00005
      b'b93febfebfcf39be4fd0c9e6e178f8bb5fe6ee8e7f4b9feeecb8f07cba3f2f57' (846079)
    ff03 0004dbc8 8 0 1a 00002
      b'ffe5e9f0faffa7cde0f3ef373fafc4df1f5eebe6fe97b5c7c3f03ddf03b393f7' (88fb31)
    ff03 00038eb0 9 0 20 00004
      b'bfffffe6de6dff859cd1c6ffe4638c1f103feb8b844f859e7ee2fd59e82f0773' (8dd6f9)
  ff02 00171bc0 1 1 0 0000000
    ff03 0000b3d0 0 0 04 00007
      b'0000000000203bff49c50f29364bda42f24d315e94389f49344a0c34a53d284d' (9165a9)
    ff03 0000a4d8 1 0 04 00006
      b'9485285994031256284b80c2395024bd2692216f2f0d25fd852e45051e79b349' (921979)
    ...

Tile header format

Offset type size content (codec v1 / v2)
0 short 1 ff01 / ff11
2 short 1 8 (size) / 16
4 long 1 size of ff01 data. v1: One tile for small picture, two tiles for big picture
v2 : one tile for small and big pictures
8 bits 4 counter (0 to 1)

Plane header format

Offset in bytes type size content (v1 / v2)
0 short 1 ff02 / ff12
2 short 1 8 (size)
4 long 1 size of plane data. Sum of plane data equals size of parent tile
8 bits 4 counter (always 0 to 3). c for RGGB components
8+4bits bits 1 supportsPartial flag (f)
8+5bits bits 2 RoundedBits (x)

last long format is (in bits): ccccfxx0 00000000 00000000 00000000

Subband header format (LL3 HL3... HH1)

Offset type size content (v1 / v2)
0 short 1 ff03 / ff13
2 short 1 8 (size) / 16
4 long 1 size of subband data. Sum of subband data equals size of parent plane data
8 bits 4 counter (0 to 9 for lossy/craw, only one for lossless/raw). c
8+4bits bits 1 supportsPartial flag (f)
8+5bits bits 3+4+1 quantValue (3 right most bits of byte#8 + 5 left most bits of byte#9). x
9+5bits bits 3+16 19 bits value (3 right most bits of byte#9 + 16 bits at offset 10). Substracted to size at offset 4. Likely to compute exact meanful bits at end of the encoded stream, as size is rounded to 8 bits (observed values are 0 to 7). y

last long format is (in bits): ccccfxxx xxxxxyyy yyyyyyyy yyyyyyyy

Crx compression

Raw (lossless)

Lossless CR3 (and LL3) subbands are encoded using Golomb-Rice, Run length mode and Median Edge Detection prediction, similarly to JPEG-LS (ITU T.87). Crx uses Adaptive Golomb-Rice coding.

JPEG-LS:

https://github.com/lclevy/canon_cr3/blob/master/jpeg_ls_encoder.png

in Canon patent:

https://patentimages.storage.googleapis.com/31/86/a3/30120d794684a5/US20160323602A1-20161103-D00000.png

C-Raw (lossy)

Crx lossy type is close to JPEG-2000 : using Le Gall 5/3 wavelet transformation, which is lossless. Canon uses quantification (loss of information ) to compress better. DWT coefficients are then encoded using Adaptive Rice-Golomb and RLE, like in lossless mode.

This Canon patent https://patents.google.com/patent/US20160323602A1/en describes a 3 levels Wavelet transform and Adapting Rice encoding.

"FIG. 7A explains an example in which wavelet transform is executed three times. LL1, HL1, LH1, and HH1 represent the subbands of decomposition level 1, LL2, HL2, LH2, and HH2 represent the subbands of decomposition level 2, and LL3, HL3, LH3, and HH3 represent the subbands of decomposition level 3. Note that a transform target of wavelet transform from the second time is subband LL obtained by immediately preceding wavelet transform, so subbands LL1 and LL2 are omitted, and subband LL obtained by last wavelet transform remains. Also, the horizontal and vertical resolutions of, for example, HL2 are half those of HL1. Subband LH indicates a horizontal-direction frequency characteristic (a horizontal-direction component) of a local region to which wavelet transform is applied. Likewise, subband HL indicates a vertical-direction frequency characteristic (a vertical-direction component), and subband HH indicates an oblique-direction frequency characteristic (an oblique-direction component). Subband LL is a low-frequency component. An integer-type 5/3 filter is used in wavelet transform of this embodiment, but the present invention is not limited to this. It is also possible to use another wavelet transform filter such as a real-type 9/7 filter used in JPEG2000 (ISO/IEC15444|ITU-T T. 800) as an international standard. In addition, the processing unit of wavelet transform can be either a line or image."

Subband data (0xff03) of lossy CR3 are LL3, HL3, LH3, HH3, HL2, LH2, HH2, HL1, LH1 and HH1.

FIGS. 7A and 7B are views for explaining the concept of subband division by wavelet transform, and an example of a code to be generated

References

Cameras creating CR3 images

modelId name releaseDate sensorSize sensorType ImageProc
0x00000412 EOS M50 / Kiss M 04/2018 APS-C CMOS Digic 8
0x80000424 EOS R 5/09/2018 FF CMOS Digic 8
0x00000805 PowerShot SX70 HS 09/2018 1/2.3" BSI-CMOS Digic 8
0x80000433 EOS RP 14/02/2019 FF CMOS Digic 8
0x80000436 EOS Rebel SL3 / 250D / Kiss X10 04/2019 APS-C CMOS Digic 8
0x00000804 Powershot G5 X Mark II 07/2019 1" BSI-CMOS Digic 8
0x00000808 PowerShot G7 X Mark III 07/2019 1" BSI-CMOS Digic 8
0x00000811 EOS M6 Mark II 08/2019 APS-C CMOS Digic 8
0x80000437 EOS 90D 08/2019 APS-C CMOS Digic 8
0x00000812 EOS M200 09/2019 APS-C CMOS Digic 8
0x80000428 EOS 1DX Mark III 01/2020 FF CMOS Digic X
0x80000435 850D / T8i / Kiss X10i 02/2020 APS-C CMOS Digic 8
0x80000421 EOS R5 13/02/2020 FF CMOS DigicX
0x80000453 EOS R6 9/07/2020 FF CMOS DigicX
0x80000468 EOS M50 Mark II / Kiss M2 10/2020 APS-C CMOS Digic8
0x80000450 EOS R3 14/04/2021 FF BSI-CMOS DigicX
0x80000464 EOS R7 24/05/2022 APS-C CMOS DigicX
0x80000465 EOS R10 24/05/2022 APS-C CMOS DigicX
0x80000481 EOS R6 Mark II 2/11/2022 FF CMOS DigicX
0x80000487 EOS R8 8/02/2023 FF CMOS DigicX
0x80000480 EOS R50 8/02/2023 APS-C CMOS DigicX
0x80000498 EOS R100 24/05/2023 APS-C CMOS Digic8
0x80000495 EOS R1 19/07/2024 FF BSI-CMOS DigicX+Digic Accelerator
0x80000496 EOS R5 Mark II 19/07/2024 FF BSI-CMOS DigicX+Digic Accelerator

Samples

http://www.photographyblog.com, https://raw.pixls.us/data/Canon, https://www.dpreview.com, https://www.imaging-resource.com

CRM samples (from C200)

http://www.4kshooters.net/2017/10/04/canon-c200-raw-footage-workflow-free-samples-for-download/

About

Describing the Canon CR3 fileformat from Canon M50 / EOS R / SX70 HS / EOS RP...

Resources

Readme

License

GPL-3.0 license
Activity

Stars

286 stars

Watchers

31 watching

Forks

37 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 10

Languages