PhotoImportSidecar Class

Definition

Namespace:

Windows.Media.Import

Represents a sidecar file or a sibling file to a PhotoImportItem.

public ref class PhotoImportSidecar sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PhotoImportSidecar final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PhotoImportSidecar

Public NotInheritable Class PhotoImportSidecar

Inheritance

Object Platform::Object IInspectable PhotoImportSidecar

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Get an instance of this class by accessing the PhotoImportItem.Sibling property or the PhotoImportItem.Sidecars property.

A Sidecar is a file that is not a JPEG nor a RAW file, nor a LRV file in the item is a video, that shares the same base-name as the main file it refers to, but with a different file extension. Sidecars can contain additional metadata (.XMP), a thumbnail (.THM), an audio annotation (.WAV) or possibly any other additional data, such as for example a GPS track alongside a video file, in the form of a text file containing NMEA sentences. As an example, a JPEG file named DSC_0001.JPG might have a DSC_0001.WAV audio annotation. The correlation can be done on the path + base name. The timestamps of sidecars may be similar or identical to the timestamp of the main files, however, in case of .XMP sidecars (metadata) and possibly others, it is conceivable that the sidecar has been edited, say to rate the image, at a later point in time. There may be more than one sidecar for any given file, for example a thumbnail, an audio annotation, and an XMP metadata sidecar, all attached to the same file.

For photos, a sibling is the RAW file associated with a matching JPEG file produced by digital cameras set to RAW+JPEG shooting mode, where the camera produces two distinct files for every picture taken. The Windows.Media.Import APIs considers the JPEG file to be the main item of the pair, and the RAW to be the sibling.

For video, a sibling is a low-resolution version of the main video, for example .mp4 + .lrv pairs. The Windows.Media.Import APIs considers the .MP4 to be the main item of the pair, and the low-resolution version to be the sibling.

There can be at most one sibling attached to a given importable item.

Properties

Date	Gets the date of the sidecar or sibling file.
Name	Gets the name of the sidecar or sibling file.
SizeInBytes	Gets the size of the sidecar or sibling file, in bytes.