<divclass="headertitle"><divclass="title">ImageInfo Struct Reference<divclass="ingroups"><aclass="el"href="group__MediaTypes.html">Media type classification</a></div></div></div>
</div><!--header-->
<divclass="contents">
<p>High-level summary of an opened Aaru image containing metadata and media characteristics.
<trclass="memdesc:abca8e73a9655d810e6d30d36c3ab54d7"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Size of the image payload in bytes (excludes headers/metadata) <br/></td></tr>
<trclass="memdesc:aac1ac48f57afd415467cd6f13f01644b"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Size of each logical sector in bytes (512, 2048, 2352, 4096, etc.) <br/></td></tr>
<trclass="memdesc:adce978941d9900c8c05e620df67f8c5c"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Image format version string (NUL-terminated, e.g., "6.0") <br/></td></tr>
<trclass="memdesc:aaea8b3a14fc03f9a4b045318160b7f54"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Name of application that created the image (NUL-terminated) <br/></td></tr>
<trclass="memdesc:aebf7783c46e640a8e7d0192ba2843e9a"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Version of the creating application (NUL-terminated) <br/></td></tr>
<trclass="memdesc:a76611d5087e0a9fd4d329fac7c9ec3f3"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Media type identifier (see <aclass="el"href="#a76611d5087e0a9fd4d329fac7c9ec3f3">MediaType</a> enum; 0=Unknown) <br/></td></tr>
<trclass="memdesc:a7ed25efcf8cec55d6609b83bcd17b2d0"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Media type for sidecar generation (internal archival use) <br/></td></tr>
<divclass="textblock"><p>High-level summary of an opened Aaru image containing metadata and media characteristics. </p>
<p>This structure aggregates essential information extracted from an Aaru format image file, providing callers with a comprehensive view of the imaged media without requiring access to internal image structures. All fields are read-only from the caller's perspective and reflect the state at the time the image was created or last modified.</p>
<p><b><aclass="el"href="group__MediaTypes.html#ga1499e9f8a76cb81b43b7a4b0dbe7e44a"title="Enumerates every recognized media / cartridge / optical / tape / card / disk format.">MediaType</a></b> (uint32_t):</p><ul>
<li>Numeric identifier from the <aclass="el"href="#a76611d5087e0a9fd4d329fac7c9ec3f3">MediaType</a> enumeration representing the physical/logical media.</li>
<li>Stable across versions; safe to persist and compare.</li>
<li>Usage: Cast to <code><aclass="el"href="group__MediaTypes.html#ga1499e9f8a76cb81b43b7a4b0dbe7e44a"title="Enumerates every recognized media / cartridge / optical / tape / card / disk format.">MediaType</a></code> enum for switch/case logic; always include default/Unknown handling.</li>
</ul>
<p><b>MetadataMediaType</b> (uint8_t):</p><ul>
<li>Internal identifier used for sidecar/metadata generation (METS/CICM/ALTO compatibility).</li>
<li>Not directly useful for most callers; primarily for serialization/archival workflows.</li>
</ul>
<dlclass="section user"><dt>Invariants and Constraints:</dt><dd><ul>
<li>All pointer-like char arrays are guaranteed NUL-terminated and safe for string functions.</li>
<li>Sectors > 0 and SectorSize > 0 for structurally valid images.</li>
<li>Timestamps may be 0 or negative; consumers must validate before using.</li>
<li><aclass="el"href="group__MediaTypes.html#ga1499e9f8a76cb81b43b7a4b0dbe7e44a"title="Enumerates every recognized media / cartridge / optical / tape / card / disk format.">MediaType</a> range corresponds to <aclass="el"href="#a76611d5087e0a9fd4d329fac7c9ec3f3">MediaType</a> enum; out-of-range values are possible for future extensions.</li>
<li>Struct contents are stable after retrieval; safe for concurrent reads.</li>
<li>Do not cache <aclass="el"href="structImageInfo.html"title="High-level summary of an opened Aaru image containing metadata and media characteristics.">ImageInfo</a> across context operations that may invalidate it (e.g., re-opening).</li>
<li>Field layout is ABI-stable; new fields append to end in future versions.</li>
<li>Reordering or removing fields constitutes a major version break.</li>
<li>Linter suppressions acknowledge intentionally large field count for completeness. </li>
</ul>
</dd></dl>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00869">869</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<p>Name of application that created the image (NUL-terminated) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00877">877</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, and <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>.</p>
<p>Version of the creating application (NUL-terminated) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00878">878</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, and <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>.</p>
<p>Image creation timestamp (Windows FILETIME: 100ns since 1601-01-01 UTC) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00879">879</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, and <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>.</p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00871">871</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="optical_8c_source.html#l00392">aaruf_set_tracks()</a>, and <aclass="el"href="optical_8c_source.html#l00111">process_tracks_block()</a>.</p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00872">872</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="optical_8c_source.html#l00392">aaruf_set_tracks()</a>, and <aclass="el"href="optical_8c_source.html#l00111">process_tracks_block()</a>.</p>
<p>Size of the image payload in bytes (excludes headers/metadata) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00873">873</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>, <aclass="el"href="blocks_2metadata_8c_source.html#l00470">process_aaru_metadata_json_block()</a>, <aclass="el"href="blocks_2metadata_8c_source.html#l00306">process_cicm_block()</a>, <aclass="el"href="data_8c_source.html#l00071">process_data_block()</a>, <aclass="el"href="ddt__v1_8c_source.html#l00085">process_ddt_v1()</a>, <aclass="el"href="ddt__v2_8c_source.html#l00096">process_ddt_v2()</a>, <aclass="el"href="blocks_2metadata_8c_source.html#l00246">process_geometry_block()</a>, <aclass="el"href="blocks_2metadata_8c_source.html#l00035">process_metadata_block()</a>, <aclass="el"href="tape_8c_source.html#l00126">process_tape_files_block()</a>, <aclass="el"href="tape_8c_source.html#l00346">process_tape_partitions_block()</a>, and <aclass="el"href="optical_8c_source.html#l00111">process_tracks_block()</a>.</p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00880">880</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, and <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>.</p>
<p>Media type identifier (see <aclass="el"href="#a76611d5087e0a9fd4d329fac7c9ec3f3">MediaType</a> enum; 0=Unknown) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00881">881</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>, <aclass="el"href="read_8c_source.html#l00826">aaruf_read_sector_long()</a>, <aclass="el"href="write_8c_source.html#l00098">aaruf_write_sector()</a>, <aclass="el"href="write_8c_source.html#l00532">aaruf_write_sector_long()</a>, and <aclass="el"href="close_8c_source.html#l01508">write_sector_subchannel()</a>.</p>
<p>Media type for sidecar generation (internal archival use) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00882">882</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<p>Total count of addressable logical sectors/blocks. </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00874">874</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<p>Size of each logical sector in bytes (512, 2048, 2352, 4096, etc.) </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00875">875</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>, <aclass="el"href="read_8c_source.html#l00253">aaruf_read_sector()</a>, and <aclass="el"href="data_8c_source.html#l00071">process_data_block()</a>.</p>
<p>Image format version string (NUL-terminated, e.g., "6.0") </p>
<pclass="definition">Definition at line <aclass="el"href="aaru_8h_source.html#l00876">876</a> of file <aclass="el"href="aaru_8h_source.html">aaru.h</a>.</p>
<pclass="reference">Referenced by <aclass="el"href="create_8c_source.html#l00279">aaruf_create()</a>, and <aclass="el"href="open_8c_source.html#l00125">aaruf_open()</a>.</p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<liclass="footer">Generated by <ahref="https://www.doxygen.org/index.html"><imgclass="footer"src="doxygen.svg"width="104"height="31"alt="doxygen"/></a> 1.14.0 </li>