1# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild
2
3from pkg_resources import parse_version
4from kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO
5import struct
6
7
8if parse_version(ks_version) < parse_version('0.7'):
9    raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version))
10
11class Ico(KaitaiStruct):
12    """Microsoft Windows uses specific file format to store applications
13    icons - ICO. This is a container that contains one or more image
14    files (effectively, DIB parts of BMP files or full PNG files are
15    contained inside).
16
17    .. seealso::
18       Source - https://msdn.microsoft.com/en-us/library/ms997538.aspx
19    """
20    def __init__(self, _io, _parent=None, _root=None):
21        self._io = _io
22        self._parent = _parent
23        self._root = _root if _root else self
24        self._read()
25
26    def _read(self):
27        self.magic = self._io.ensure_fixed_contents(struct.pack('4b', 0, 0, 1, 0))
28        self.num_images = self._io.read_u2le()
29        self.images = [None] * (self.num_images)
30        for i in range(self.num_images):
31            self.images[i] = self._root.IconDirEntry(self._io, self, self._root)
32
33
34    class IconDirEntry(KaitaiStruct):
35        def __init__(self, _io, _parent=None, _root=None):
36            self._io = _io
37            self._parent = _parent
38            self._root = _root if _root else self
39            self._read()
40
41        def _read(self):
42            self.width = self._io.read_u1()
43            self.height = self._io.read_u1()
44            self.num_colors = self._io.read_u1()
45            self.reserved = self._io.ensure_fixed_contents(struct.pack('1b', 0))
46            self.num_planes = self._io.read_u2le()
47            self.bpp = self._io.read_u2le()
48            self.len_img = self._io.read_u4le()
49            self.ofs_img = self._io.read_u4le()
50
51        @property
52        def img(self):
53            """Raw image data. Use `is_png` to determine whether this is an
54            embedded PNG file (true) or a DIB bitmap (false) and call a
55            relevant parser, if needed to parse image data further.
56            """
57            if hasattr(self, '_m_img'):
58                return self._m_img if hasattr(self, '_m_img') else None
59
60            _pos = self._io.pos()
61            self._io.seek(self.ofs_img)
62            self._m_img = self._io.read_bytes(self.len_img)
63            self._io.seek(_pos)
64            return self._m_img if hasattr(self, '_m_img') else None
65
66        @property
67        def png_header(self):
68            """Pre-reads first 8 bytes of the image to determine if it's an
69            embedded PNG file.
70            """
71            if hasattr(self, '_m_png_header'):
72                return self._m_png_header if hasattr(self, '_m_png_header') else None
73
74            _pos = self._io.pos()
75            self._io.seek(self.ofs_img)
76            self._m_png_header = self._io.read_bytes(8)
77            self._io.seek(_pos)
78            return self._m_png_header if hasattr(self, '_m_png_header') else None
79
80        @property
81        def is_png(self):
82            """True if this image is in PNG format."""
83            if hasattr(self, '_m_is_png'):
84                return self._m_is_png if hasattr(self, '_m_is_png') else None
85
86            self._m_is_png = self.png_header == struct.pack('8b', -119, 80, 78, 71, 13, 10, 26, 10)
87            return self._m_is_png if hasattr(self, '_m_is_png') else None
88
89
90
91