struct di_cta_colorimetry_block ¶

struct di_cta_colorimetry_block {
	/* Standard Definition Colorimetry based on IEC 61966-2-4 */
	 bool xvycc_601;
	/* High Definition Colorimetry based on IEC 61966-2-4 */
	 bool xvycc_709;
	/* Colorimetry based on IEC 61966-2-1/Amendment 1 */
	 bool sycc_601;
	/* Colorimetry based on IEC 61966-2-5, Annex A */
	 bool opycc_601;
	/* Colorimetry based on IEC 61966-2-5 */
	 bool oprgb;
	/* Colorimetry based on Rec. ITU-R BT.2020 Y'cC'bcC'rc */
	 bool bt2020_cycc;
	/* Colorimetry based on Rec. ITU-R BT.2020 Y'C'bC'r */
	 bool bt2020_ycc;
	/* Colorimetry based on Rec. ITU-R BT.2020 R'G'B' */
	 bool bt2020_rgb;
	/* Colorimetry based on SMPTE ST 2113 R'G'B' */
	 bool st2113_rgb;
	/* Colorimetry based on Rec. ITU-R BT.2100 ICtCp */
	 bool ictcp;
};

CTA colorimetry data block, defined in section 7.5.5.

struct di_cta_data_block ¶

struct di_cta_data_block;

CTA data block, defined in section 7.4.

struct di_cta_hdr_dynamic_metadata_block ¶

struct di_cta_hdr_dynamic_metadata_block {
	/* non-NULL if Dynamic Metadata Type 1 is supported. */
	const struct di_cta_hdr_dynamic_metadata_block_type1 *type1;
	/* non-NULL if Dynamic Metadata Type 2 is supported. */
	const struct di_cta_hdr_dynamic_metadata_block_type2 *type2;
	/* non-NULL if Dynamic Metadata Type 3 is supported. */
	const struct di_cta_hdr_dynamic_metadata_block_type3 *type3;
	/* non-NULL if Dynamic Metadata Type 4 is supported. */
	const struct di_cta_hdr_dynamic_metadata_block_type4 *type4;
	/* non-NULL if Dynamic Metadata Type 256 (0x0100) is supported. */
	const struct di_cta_hdr_dynamic_metadata_block_type256 *type256;
};

CTA HDR dynamic metadata block, defined in section 7.5.14.

struct di_cta_hdr_dynamic_metadata_block_type1 ¶

struct di_cta_hdr_dynamic_metadata_block_type1 {
	uint8_t type_1_hdr_metadata_version;
};

struct di_cta_hdr_dynamic_metadata_block_type2 ¶

struct di_cta_hdr_dynamic_metadata_block_type2 {
	uint8_t ts_103_433_spec_version;
	bool ts_103_433_1_capable;
	bool ts_103_433_2_capable;
	bool ts_103_433_3_capable;
};

struct di_cta_hdr_dynamic_metadata_block_type256 ¶

struct di_cta_hdr_dynamic_metadata_block_type256 {
	uint8_t graphics_overlay_flag_version;
};

struct di_cta_hdr_dynamic_metadata_block_type3 ¶

struct di_cta_hdr_dynamic_metadata_block_type3;

struct di_cta_hdr_dynamic_metadata_block_type4 ¶

struct di_cta_hdr_dynamic_metadata_block_type4 {
	uint8_t type_4_hdr_metadata_version;
};

struct di_cta_hdr_static_metadata_block ¶

struct di_cta_hdr_static_metadata_block {
	/* Desired content max luminance (cd/m²), zero if unset */
	float desired_content_max_luminance;
	/* Desired content max frame-average luminance (cd/m²), zero if unset */
	float desired_content_max_frame_avg_luminance;
	/* Desired content min luminance (cd/m²), zero if unset */
	float desired_content_min_luminance;
	/* Supported EOFTs */
	const struct di_cta_hdr_static_metadata_block_eotfs *eotfs;
	/* Supported descriptors */
	const struct di_cta_hdr_static_metadata_block_descriptors *descriptors;
};

CTA HDR static metadata block, defined in section 7.5.13.

struct di_cta_hdr_static_metadata_block_descriptors ¶

struct di_cta_hdr_static_metadata_block_descriptors {
	/* Static Metadata Type 1 */
	 bool type1;
};

Supported static metadata descriptors for a CTA HDR static metadata block.

struct di_cta_hdr_static_metadata_block_eotfs ¶

struct di_cta_hdr_static_metadata_block_eotfs {
	/* Traditional gamma - SDR luminance range */
	 bool traditional_sdr;
	/* Traditional gamma - HDR luminance range */
	 bool traditional_hdr;
	/* Perceptual Quantization (PQ) based on SMPTE ST 2084 */
	 bool pq;
	/* Hybrid Log-Gamma (HLG) based on Rec. ITU-R BT.2100 */
	 bool hlg;
};

Supported Electro-Optical Transfer Functions for a CTA HDR static metadata block.

struct di_cta_infoframe_block ¶

struct di_cta_infoframe_block {
	/* Number of Vendor-specific InfoFrames that can be received
	 * simultaneously */
	int num_simultaneous_vsifs;
	/* Supported InfoFrames. The array is NULL-terminated. */
	const struct di_cta_infoframe_descriptor **infoframes;
};

CTA InfoFrame processing, defined in section 7.5.9.

struct di_cta_infoframe_descriptor ¶

struct di_cta_infoframe_descriptor {
	/* Type of InfoFrame */
	enum di_cta_infoframe_type type;
};

CTA InfoFrame descriptor, defined in section 7.5.9.

struct di_cta_room_configuration ¶

struct di_cta_room_configuration {
	/* Present speakers */
	struct di_cta_speaker_allocation speakers;
	/* Total number of L-PCM channels */
	int speaker_count;
	/* All speakers are defined by Speaker Location Descriptors */
	 bool has_speaker_location_descriptors;
	/* Rectangular box that contains all of the components of interest
	 * centered on the Primary Listening Position.
	 * See 7.5.16.1 Room Coordinate System
	 * Only valid if any Speaker Location Descriptor has coordinates set. */
	int max_x; /* in dm */
	int max_y; /* in dm */
	int max_z; /* in dm */
	/* The position of the center of the display in normalized coordinates.
	 * Only valid if any Speaker Location Descriptor has coordinates set. */
	double display_x; /* normalized to max_x */
	double display_y; /* normalized to max_y */
	double display_z; /* normalized to max_z */
};

Room Configuration Data Block, defined in section 7.5.15.

struct di_cta_sad ¶

struct di_cta_sad {
	/* Format */
	enum di_cta_audio_format format;
	/* Maximum number of channels, zero if unset */
	int32_t max_channels;
	/* Supported sample rates */
	const struct di_cta_sad_sample_rates *supported_sample_rates;
	/* Maximum bitrate (kb/s), zero if unset */
	int32_t max_bitrate_kbs;
	/* Additional metadata for LPCM, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_LPCM or DI_CTA_AUDIO_FORMAT_LPCM_3D */
	const struct di_cta_sad_lpcm *lpcm;
	/* Additional metadata for MPEG-H 3D Audio, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_MPEGH_3D */
	const struct di_cta_sad_mpegh_3d *mpegh_3d;
	/* Additional metadata for MPEG4 AAC, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_MPEG4_HE_AAC or
	 * DI_CTA_AUDIO_FORMAT_MPEG4_HE_AAC_V2 or
	 * DI_CTA_AUDIO_FORMAT_MPEG4_AAC_LC or
	 * DI_CTA_AUDIO_FORMAT_MPEG4_HE_AAC_MPEG_SURROUND or
	 * DI_CTA_AUDIO_FORMAT_MPEG4_AAC_LC_MPEG_SURROUND */
	const struct di_cta_sad_mpeg_aac *mpeg_aac;
	/* Additional metadata for MPEG4 Surround, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_MPEG4_HE_AAC_MPEG_SURROUND or
	 * DI_CTA_AUDIO_FORMAT_MPEG4_AAC_LC_MPEG_SURROUND */
	const struct di_cta_sad_mpeg_surround *mpeg_surround;
	/* Additional metadata for MPEG4 AAC LC, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_MPEG4_AAC_LC */
	const struct di_cta_sad_mpeg_aac_le *mpeg_aac_le;
	/* Additional metadata for Enhanced AC-3, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_ENHANCED_AC3 */
	const struct di_cta_sad_enhanced_ac3 *enhanced_ac3;
	/* Additional metadata for Dolby MAT, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_MAT */
	const struct di_cta_sad_mat *mat;
	/* Additional metadata for WMA Pro, NULL unless format is
	 * DI_CTA_AUDIO_FORMAT_WMA_PRO */
	const struct di_cta_sad_wma_pro *wma_pro;
};

A CTA short audio descriptor (SAD), defined in section 7.5.2.

struct di_cta_sad_enhanced_ac3 ¶

struct di_cta_sad_enhanced_ac3 {
	bool supports_joint_object_coding;
	bool supports_joint_object_coding_ACMOD28;
};

struct di_cta_sad_lpcm ¶

struct di_cta_sad_lpcm {
	bool has_sample_size_24_bits; /* 24 bits */
	bool has_sample_size_20_bits; /* 20 bits */
	bool has_sample_size_16_bits; /* 16 bits */
};

struct di_cta_sad_mat ¶

struct di_cta_sad_mat {
	bool supports_object_audio_and_channel_based;
	bool requires_hash_calculation;
};

struct di_cta_sad_mpeg_aac ¶

struct di_cta_sad_mpeg_aac {
	/* True if AAC audio frame lengths of 960 samples is supported */
	 bool has_frame_length_960;
	/* True if AAC audio frame lengths of 1024 samples is supported */
	 bool has_frame_length_1024;
};

struct di_cta_sad_mpeg_aac_le ¶

struct di_cta_sad_mpeg_aac_le {
	/* True if Rec. ITU-R BS.2051 System H 22.2 multichannel sound is supported */
	 bool supports_multichannel_sound;
};

struct di_cta_sad_mpeg_surround ¶

struct di_cta_sad_mpeg_surround {
	/* MPEG Surround signaling */
	enum di_cta_sad_mpeg_surround_signaling signaling;
};

struct di_cta_sad_mpegh_3d ¶

struct di_cta_sad_mpegh_3d {
	/* Maximum supported MPEG-H 3D level, zero if unspecified */
	enum di_cta_sad_mpegh_3d_level level;
	/* True if MPEG-H 3D Audio Low Complexity Profile is supported */
	 bool low_complexity_profile;
	/* True if MPEG-H 3D Audio Baseline Profile is supported */
	 bool baseline_profile;
};

struct di_cta_sad_sample_rates ¶

struct di_cta_sad_sample_rates {
	bool has_192_khz; /* 192 kHz */
	bool has_176_4_khz; /* 176.4 kHz */
	bool has_96_khz; /* 96 kHz */
	bool has_88_2_khz; /* 88.2 kHz */
	bool has_48_khz; /* 48 kHz */
	bool has_44_1_khz; /* 44.1 kHz */
	bool has_32_khz; /* 32 kHz */
};

struct di_cta_sad_wma_pro ¶

struct di_cta_sad_wma_pro {
	int profile;
};

struct di_cta_speaker_alloc_block ¶

struct di_cta_speaker_alloc_block {
	/* Present speakers */
	struct di_cta_speaker_allocation speakers;
};

Speaker allocation data block (SADB), defined in section 7.5.3.

struct di_cta_speaker_allocation ¶

struct di_cta_speaker_allocation {
	bool flw_frw; /* FLw/FRw - Front Left/Right Wide */
	bool flc_frc; /* FLc/FRc - Front Left/Right of Center */
	bool bc; /* BC - Back Center */
	bool bl_br; /* BL/BR - Back Left/Right */
	bool fc; /* FC - Front Center */
	bool lfe1; /* LFE1 - Low Frequency Effects 1 */
	bool fl_fr; /* FL/FR - Front Left/Right */
	bool tpsil_tpsir; /* TpSiL/TpSiR - Top Side Left/Right */
	bool sil_sir; /* SiL/SiR - Side Left/Right */
	bool tpbc; /* TpBC - Top Back Center */
	bool lfe2; /* LFE2 - Low Frequency Effects 2 */
	bool ls_rs; /* LS/RS - Left/Right Surround*/
	bool tpfc; /* TpFC - Top Front Center */
	bool tpc; /* TpC - Top Center*/
	bool tpfl_tpfr; /* TpFL/TpFR - Top Front Left/Right */
	bool btfl_btfr; /* BtFL/BtFR - Bottom Front Left/Right */
	bool btfc; /* BtFC - Bottom Front Center */
	bool tpbl_tpbr; /* TpBL/TpBR - Top Back Left/Right */
};

Indicates which speakers are present. See figure 6 for the meaning of the fields.

struct di_cta_speaker_locations ¶

struct di_cta_speaker_locations {
	/* Index of the audio channel where the audio for the described speaker
	 * is to be transmitted. */
	int channel_index;
	/* If the channel shall be rendered on a speaker by the Sink. */
	 bool is_active;
	/* If the speaker has coordinates instead of a named speaker placement. */
	 bool has_coords;
	/* The position of the speaker in normalized coordinates. */
	double x, y, z;
	/* The named location of the speaker. Only valid if has_coords is false. */
	enum di_cta_speaker_placement speaker_id;
};

Speaker Location Data Block, defined in section 7.5.16.

struct di_cta_svd ¶

struct di_cta_svd {
	/* Video Identification Code (VIC) */
	uint8_t vic;
	/* Whether this is a native video format */
	 bool native;
};

A Short Video Descriptor (SVD).

struct di_cta_svr ¶

struct di_cta_svr {
	enum di_cta_svr_type type;
	/* A VIC if type is DI_CTA_SVR_TYPE_VIC */
	uint8_t vic;
	/* The index into DTDs in order of appearance if type is
	 * DI_CTA_SVR_TYPE_DTD_INDEX */
	uint8_t dtd_index;
	/* The index into T7VTDB and T10VTDB in order of appearance if type is
	 * DI_CTA_SVR_TYPE_T7T10VTDB */
	uint8_t t7_t10_vtdb_index;
};

Short Video Reference, defined in section 7.5.12.

struct di_cta_vesa_dddb ¶

struct di_cta_vesa_dddb {
	/* Interface type */
	enum di_cta_vesa_dddb_interface_type interface_type;
	/* Number of lanes/channels, zero if N/A */
	int32_t num_channels;
	/* Interface standard version and release number */
	int32_t interface_version, interface_release;
	/* Content protection support */
	enum di_cta_vesa_dddb_content_protection content_protection;
	/* Minimum and maximum clock frequency (in mega-hertz), zero if unset
	 * (ie. maximum and minimum as permitted under the appropriate interface
	 * specification or standard) */
	int32_t min_clock_freq_mhz, max_clock_freq_mhz;
	/* Device native pixel format, zero if unset */
	int32_t native_horiz_pixels, native_vert_pixels;
	/* Aspect ratio taken as long axis divided by short axis */
	float aspect_ratio;
	/* Default orientation */
	enum di_cta_vesa_dddb_default_orientation default_orientation;
	/* Rotation capability */
	enum di_cta_vesa_dddb_rotation_cap rotation_cap;
	/* Zero pixel location */
	enum di_cta_vesa_dddb_zero_pixel_location zero_pixel_location;
	/* Scan direction */
	enum di_cta_vesa_dddb_scan_direction scan_direction;
	/* Subpixel layout */
	enum di_cta_vesa_dddb_subpixel_layout subpixel_layout;
	/* Horizontal and vertical dot/pixel pitch (in millimeters) */
	float horiz_pitch_mm, vert_pitch_mm;
	/* Dithering type */
	enum di_cta_vesa_dddb_dithering_type dithering_type;
	/* Direct drive: no scaling, de-interlacing, frame-rate conversion, etc.
	 * between this interface and the panel or other display device */
	 bool direct_drive;
	/* Overdrive not recommended: the source should not apply "overdrive" to
	 * the video signal */
	 bool overdrive_not_recommended;
	/* Display can deinterlaced video input */
	 bool deinterlacing;
	/* Video interface supports audio */
	 bool audio_support;
	/* Audio inputs are provided separately from the video interface */
	 bool separate_audio_inputs;
	/* Audio information received via the video interface will automatically
	 * override any other audio input channels provided */
	 bool audio_input_override;
	/* True if audio delay information is provided */
	 bool audio_delay_provided;
	/* Audio delay (in milliseconds, may be negative), with the maximum
	 * absolute value of 254 ms */
	int32_t audio_delay_ms;
	/* Frame rate/mode conversion */
	enum di_cta_vesa_dddb_frame_rate_conversion frame_rate_conversion;
	/* Frame rate range (in Hz), with the maximum value of 63 Hz */
	int32_t frame_rate_range_hz;
	/* Native/nominal rate (in Hz) */
	int32_t frame_rate_native_hz;
	/* Color bit depth for the interface and display device */
	int32_t bit_depth_interface, bit_depth_display;
	/* Number of additional primary color chromaticities */
	size_t additional_primary_chromaticities_len;
	/* Additional primary color chromaticities given as 1931 CIE xy color
	 * space coordinates (also defines the color of subpixels for some
	 * subpixel layouts) */
	struct di_cta_vesa_dddb_additional_primary_chromaticity additional_primary_chromaticities[];
	/* Response time transition */
	enum di_cta_vesa_dddb_resp_time_transition resp_time_transition;
	/* Response time (in milliseconds), with the maximum value of 127 ms */
	int32_t resp_time_ms;
	/* Overscan horizontal and vertical percentage */
	int32_t overscan_horiz_pct, overscan_vert_pct;
};

VESA Display Device Data Block (DDDB), defined in VESA Display Device Data Block (DDDB) Standard version 1.

struct di_cta_vesa_dddb_additional_primary_chromaticity ¶

struct di_cta_vesa_dddb_additional_primary_chromaticity {
	float x, y;
};

struct di_cta_vesa_transfer_characteristics ¶

struct di_cta_vesa_transfer_characteristics {
	enum di_cta_vesa_transfer_characteristics_usage usage;
	uint8_t points_len;
	float points[];
};

VESA Display Transfer Characteristic Data Block, defined in VESA Display Transfer Characteristics Data Block Standard Version 1.0

Contains 8, 16 or 32 evenly distributed points on the input axis describing the normalized relative luminance at that input. The first value includes the relative black level luminance.

struct di_cta_video_cap_block ¶

struct di_cta_video_cap_block {
	/* If set to true, YCC quantization range is selectable (via AVI YQ). */
	 bool selectable_ycc_quantization_range;
	/* If set to true, RGB quantization range is selectable (via AVI Q). */
	 bool selectable_rgb_quantization_range;
	/* Overscan/underscan behavior for PT video formats (if set to unknown,
	 * use the IT/CE behavior) */
	enum di_cta_video_cap_over_underscan pt_over_underscan;
	/* Overscan/underscan behavior for IT video formats */
	enum di_cta_video_cap_over_underscan it_over_underscan;
	/* Overscan/underscan behavior for CE video formats */
	enum di_cta_video_cap_over_underscan ce_over_underscan;
};

Video capability data block (VCDB), defined in section 7.5.6.

struct di_cta_video_format ¶

struct di_cta_video_format {
	/* Video Identification Code (VIC) */
	uint8_t vic;
	/* Horizontal/vertical active pixels/lines */
	int32_t h_active, v_active;
	/* Horizontal/vertical front porch */
	int32_t h_front, v_front;
	/* Horizontal/vertical sync pulse */
	int32_t h_sync, v_sync;
	/* Horizontal/vertical back porch */
	int32_t h_back, v_back;
	/* Horizontal/vertical sync pulse polarity */
	enum di_cta_video_format_sync_polarity h_sync_polarity, v_sync_polarity;
	/* Pixel clock in Hz */
	int64_t pixel_clock_hz;
	/* Whether this timing is interlaced */
	 bool interlaced;
	/* Picture aspect ratio */
	enum di_cta_video_format_picture_aspect_ratio picture_aspect_ratio;
};

A CTA-861 video format, defined in section 4.

struct di_cta_ycbcr420_cap_map ¶

struct di_cta_ycbcr420_cap_map;

CTA YCbCr 4:2:0 Capability Map block, defined in section 7.5.11.

struct di_edid_cta ¶

struct di_edid_cta;

EDID CTA-861 extension block.

struct di_edid_cta_flags ¶

struct di_edid_cta_flags {
	/* Sink underscans IT Video Formats by default */
	 bool it_underscan;
	/* Sink supports Basic Audio */
	 bool basic_audio;
	/* Sink supports YCbCr 4:4:4 in addition to RGB */
	 bool ycc444;
	/* Sink supports YCbCr 4:2:2 in addition to RGB */
	 bool ycc422;
	/* Total number of native detailed timing descriptors */
	int native_dtds;
};

Miscellaneous EDID CTA flags, defined in section 7.3.3.

For CTA revision 1, all of the fields are zero.