![]() |
AJA NTV2 SDK
17.5.0.1658
NTV2 SDK 17.5.0.1658
|
This object specifies the information that will be transferred to or from the AJA device in the CNTV2Card::AutoCirculateTransfer function call. More...
#include <ntv2publicinterface.h>
Public Member Functions | |
| operator NTV2_HEADER * () | |
| bool | RPCEncode (NTV2_RPC_BLOB_TYPE &outBlob) |
| bool | RPCDecode (const NTV2_RPC_BLOB_TYPE &inBlob, size_t &inOutIndex) |
Construction & Destruction | |
| AUTOCIRCULATE_TRANSFER () | |
| Constructs a default AUTOCIRCULATE_TRANSFER struct. More... | |
| ~AUTOCIRCULATE_TRANSFER () | |
| My default destructor, which frees all allocatable fields that I own. More... | |
| AUTOCIRCULATE_TRANSFER (ULWord *pInVideoBuffer, const ULWord inVideoByteCount, ULWord *pInAudioBuffer=NULL, const ULWord inAudioByteCount=0, ULWord *pInANCBuffer=NULL, const ULWord inANCByteCount=0, ULWord *pInANCF2Buffer=NULL, const ULWord inANCF2ByteCount=0) | |
| Constructs an AUTOCIRCULATE_TRANSFER object to use in a CNTV2Card::AutoCirculateTransfer call. More... | |
| void | Clear (void) |
| Resets the struct to its initialized state, with timecode capture disabled, freeing all buffers that were allocated by the SDK. (Buffers set by the client application are zeroed but not freed.) More... | |
Buffer Management | |
| bool | SetBuffers (ULWord *pInVideoBuffer, const ULWord inVideoByteCount, ULWord *pInAudioBuffer, const ULWord inAudioByteCount, ULWord *pInANCBuffer, const ULWord inANCByteCount, ULWord *pInANCF2Buffer=NULL, const ULWord inANCF2ByteCount=0) |
| Sets my buffers for use in a subsequent call to CNTV2Card::AutoCirculateTransfer. More... | |
| bool | SetVideoBuffer (ULWord *pInVideoBuffer, const ULWord inVideoByteCount) |
| Sets my video buffer for use in a subsequent call to CNTV2Card::AutoCirculateTransfer. More... | |
| bool | SetAudioBuffer (ULWord *pInAudioBuffer, const ULWord inAudioByteCount) |
| Sets my audio buffer for use in a subsequent call to CNTV2Card::AutoCirculateTransfer. More... | |
| bool | SetAncBuffers (ULWord *pInANCBuffer, const ULWord inANCByteCount, ULWord *pInANCF2Buffer=NULL, const ULWord inANCF2ByteCount=0) |
| Sets my ancillary data buffers for use in a subsequent call to CNTV2Card::AutoCirculateTransfer. More... | |
| const NTV2Buffer & | GetVideoBuffer (void) const |
| const NTV2Buffer & | GetAudioBuffer (void) const |
| const NTV2Buffer & | GetAncBuffer (const bool inField2=false) const |
Timecode | |
| bool | SetOutputTimeCodes (const NTV2TimeCodes &inValues) |
| Intended for playout, replaces the contents of my acOutputTimeCodes member. More... | |
| bool | SetOutputTimeCode (const NTV2_RP188 &inTimecode, const NTV2TCIndex inTCIndex=NTV2_TCINDEX_SDI1) |
| Intended for playout, sets one element of my acOutputTimeCodes member. More... | |
| bool | SetAllOutputTimeCodes (const NTV2_RP188 &inTimecode, const bool inIncludeF2=true) |
| Intended for playout, replaces all elements of my acOutputTimeCodes member with the given timecode value. More... | |
| bool | GetInputTimeCodes (NTV2TimeCodeList &outValues) const |
| Intended for capture, answers with the timecodes captured in my acTransferStatus member's acFrameStamp member. More... | |
| bool | GetInputTimeCode (NTV2_RP188 &outTimeCode, const NTV2TCIndex inTCIndex=NTV2_TCINDEX_SDI1) const |
| Intended for capture, answers with a specific timecode captured in my acTransferStatus member's acFrameStamp member's acTimeCodes member. More... | |
| bool | GetInputTimeCodes (NTV2TimeCodes &outTimeCodes, const NTV2Channel inSDIInput=NTV2_CHANNEL1, const bool inValidOnly=true) const |
| Retrieves the timecodes from the captured frame that are associated with the given SDI input. More... | |
Miscellaneous | |
| bool | SetFrameUserCookie (const ULWord64 &inUserCookie) |
| Intended for playout, replaces my current acUserCookie value with the new value. More... | |
| bool | SetFrameBufferFormat (const NTV2FrameBufferFormat inNewFormat) |
| Sets my acFrameBufferFormat value to the given new value (if valid and circulating with AUTOCIRCULATE_WITH_FBFCHANGE option). More... | |
| void | EnableQuarterSizeExpandMode (void) |
| Enables quarter-size expansion mode. More... | |
| void | DisableQuarterSizeExpandMode (void) |
| Enables quarter-size expansion mode. More... | |
| bool | IsQuarterSizeExpandModeEnabled (void) const |
| const AUTOCIRCULATE_TRANSFER_STATUS & | GetTransferStatus (void) const |
| Returns a constant reference to my AUTOCIRCULATE_TRANSFER_STATUS. More... | |
| const FRAME_STAMP & | GetFrameInfo (void) const |
| Returns a constant reference to my FRAME_STAMP. More... | |
| ULWord | GetCapturedAudioByteCount (void) const |
| ULWord | GetCapturedAncByteCount (const bool inField2=false) const |
| NTV2FrameBufferFormat | GetFrameBufferFormat (void) const |
| LWord | GetTransferFrameNumber (void) const |
Segmented DMAs | |
| bool | EnableSegmentedDMAs (const ULWord inNumSegments, const ULWord inNumActiveBytesPerLine, const ULWord inHostBytesPerLine, const ULWord inDeviceBytesPerLine) |
| Enables segmented DMAs given a segment count, a host pitch, and device pitch value. More... | |
| bool | DisableSegmentedDMAs (void) |
| Disables segmented DMAs, performing a Reset on my acInSegmentedDMAInfo. More... | |
| bool | SegmentedDMAsEnabled (void) const |
Public Attributes | |
| NTV2_HEADER | acHeader |
| The common structure header – ALWAYS FIRST! More... | |
| NTV2Buffer | acVideoBuffer |
| The host video buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no video will be transferred. AJA recommends keeping this buffer 64-bit aligned and page-aligned for best performance. Use the AUTOCIRCULATE_TRANSFER::SetVideoBuffer method to set or reset this field. More... | |
| NTV2Buffer | acAudioBuffer |
| The host audio buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no audio will be transferred. AJA recommends keeping this buffer 64-bit aligned and page-aligned for best performance. Use the AUTOCIRCULATE_TRANSFER::SetAudioBuffer method to set or reset this field. More... | |
| NTV2Buffer | acANCBuffer |
| The host ancillary data buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no ancillary data will be transferred. Use the AUTOCIRCULATE_TRANSFER::SetAncBuffers method to set or reset this field. More... | |
| NTV2Buffer | acANCField2Buffer |
| The host "Field 2" ancillary data buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no "Field 2" ancillary data will be transferred. Use the AUTOCIRCULATE_TRANSFER::SetAncBuffers method to set or reset this field. More... | |
| NTV2Buffer | acOutputTimeCodes |
| Intended for playout, this is an ordered sequence of NTV2_RP188 values to send to the device. If empty, no timecodes will be transferred. This field is ignored if AUTOCIRCULATE_WITH_RP188 option is not set. More... | |
| AUTOCIRCULATE_TRANSFER_STATUS | acTransferStatus |
| Contains status information that's valid after CNTV2Card::AutoCirculateTransfer returns, including the driver buffer level, number of frames processed or dropped, audio and anc transfer byte counts, and a complete FRAME_STAMP that has even more detailed clocking information. More... | |
| ULWord64 | acInUserCookie |
| Intended for playout, an optional app-specific cookie value that tags this frame, such that if this same tag appears in acTransferStatus.acFrameStamp.acCurrentUserCookie after AutoCirculateTransfer returns, or if it appears in the FRAME_STAMP's acCurrentUserCookie field after CNTV2Card::AutoCirculateGetFrameStamp returns, identifies when the frame was on-the-air. More... | |
| ULWord | acInVideoDMAOffset |
| Optional byte offset into the device frame buffer. Defaults to zero. If non-zero, should be a multiple of the line length, or else bad video will likely result. On capture, this specifies where the first byte in the device video buffer will be read from (and that byte will end up in the first byte position in the host video buffer. Conversely, on playout, this specifies where the first byte from the host video buffer will end up in the device video buffer. More... | |
| NTV2SegmentedDMAInfo | acInSegmentedDMAInfo |
| Optional segmented DMA info, for use with specialized data transfers. More... | |
| NTV2ColorCorrectionData | acColorCorrection |
| Color correction data. This field is ignored if AUTOCIRCULATE_WITH_COLORCORRECT option is not set. More... | |
| NTV2FrameBufferFormat | acFrameBufferFormat |
| Specifies the frame buffer format to change to. Ignored if AUTOCIRCULATE_WITH_FBFCHANGE option is not set. More... | |
| NTV2FBOrientation | acFrameBufferOrientation |
| Specifies the frame buffer orientation to change to. Ignored if AUTOCIRCULATE_WITH_FBOCHANGE option is not set. More... | |
| AutoCircVidProcInfo | acVidProcInfo |
| Specifies the mixer/keyer transition to make. Ignored if AUTOCIRCULATE_WITH_VIDPROC option is not set. More... | |
| NTV2QuarterSizeExpandMode | acVideoQuarterSizeExpand |
| Turns on the "quarter-size expand" (2x H + 2x V) hardware. Defaults to off (1:1). More... | |
| NTV2Buffer | acHDMIAuxData |
| NTV2_TRAILER | acTrailer |
| The common structure trailer – ALWAYS LAST! More... | |
Lesser-used and Deprecated Members | |
| ULWord | acPeerToPeerFlags |
| ULWord | acFrameRepeatCount |
| Intended for playout. The number of times to repeat the frame being transferred. More... | |
| LWord | acDesiredFrame |
| Used to specify a different frame in the circulate ring to transfer to/from. More... | |
| NTV2_RP188 | acRP188 |
| Will be deprecated – use AUTOCIRCULATE_TRANSFER::SetOutputTimeCode instead. More... | |
| NTV2Crosspoint | acCrosspoint |
| Will be deprecated – used internally by the SDK. Will be removed when the driver changes to use NTV2Channel/NTV2Mode. More... | |
This object specifies the information that will be transferred to or from the AJA device in the CNTV2Card::AutoCirculateTransfer function call.
Definition at line 8208 of file ntv2publicinterface.h.
|
explicit |
Constructs a default AUTOCIRCULATE_TRANSFER struct.
Definition at line 2780 of file ntv2publicinterface.cpp.
| AUTOCIRCULATE_TRANSFER::~AUTOCIRCULATE_TRANSFER | ( | ) |
My default destructor, which frees all allocatable fields that I own.
Definition at line 2834 of file ntv2publicinterface.cpp.
|
explicit |
Constructs an AUTOCIRCULATE_TRANSFER object to use in a CNTV2Card::AutoCirculateTransfer call.
| pInVideoBuffer | Specifies a pointer to the host video buffer. On capture, this buffer will be written during the DMA operation. On playout, this buffer will be read during the DMA operation. If NULL, no video will be transferred. |
| inVideoByteCount | On capture, specifies the maximum capacity of the host video buffer, in bytes. On playout, specifies the number of video bytes to transfer from the host buffer. If zero, no video will be transferred. |
| pInAudioBuffer | Optionally specifies a pointer to the host audio buffer. On capture, audio data will be DMA'd to this buffer. On playout, audio data will be read from this buffer. If NULL, no audio will be transferred. Defaults to NULL. |
| inAudioByteCount | Optionally specifies the maximum capacity of the host audio buffer, in bytes. If zero, no audio will be transferred. Defaults to zero. |
| pInANCBuffer | Optionally specifies a pointer to the host ancillary data buffer. On capture, ancillary data will be DMA'd into this buffer. On playout, ancillary data will be read from this buffer. If NULL, no Field 1 ancillary data will be transferred. Defaults to NULL. |
| inANCByteCount | Optionally specifies the maximum capacity of the Field 1 host ancillary data buffer, in bytes. If zero, no ancillary data (progressive or interlaced F1) will be transferred. Defaults to zero. |
| pInANCF2Buffer | Optionally specifies a pointer to the Field 2 host ancillary data buffer. On capture, ancillary data will be DMA'd into this buffer. On playout, ancillary data will be read from this buffer. If NULL, no ancillary data will be transferred. Defaults to NULL. |
| inANCF2ByteCount | Optionally specifies the maximum capacity of the Field 2 host ancillary data buffer, in bytes. If zero, no ancillary data (interlaced F2) will be transferred. Defaults to zero. |
Definition at line 2804 of file ntv2publicinterface.cpp.
| void AUTOCIRCULATE_TRANSFER::Clear | ( | void | ) |
Resets the struct to its initialized state, with timecode capture disabled, freeing all buffers that were allocated by the SDK. (Buffers set by the client application are zeroed but not freed.)
Definition at line 2943 of file ntv2publicinterface.cpp.
|
inline |
Enables quarter-size expansion mode.
Definition at line 8552 of file ntv2publicinterface.h.
| bool AUTOCIRCULATE_TRANSFER::DisableSegmentedDMAs | ( | void | ) |
Disables segmented DMAs, performing a Reset on my acInSegmentedDMAInfo.
Definition at line 2962 of file ntv2publicinterface.cpp.
|
inline |
Enables quarter-size expansion mode.
Definition at line 8547 of file ntv2publicinterface.h.
| bool AUTOCIRCULATE_TRANSFER::EnableSegmentedDMAs | ( | const ULWord | inNumSegments, |
| const ULWord | inNumActiveBytesPerLine, | ||
| const ULWord | inHostBytesPerLine, | ||
| const ULWord | inDeviceBytesPerLine | ||
| ) |
Enables segmented DMAs given a segment count, a host pitch, and device pitch value.
| [in] | inNumSegments | Specifies the number of segments (lines) to DMA. If zero or 1, this actually disables segmented DMAs, and the remaining parameters are ignored. |
| [in] | inNumActiveBytesPerLine | Specifies the number of active bytes in a line of video. |
| [in] | inHostBytesPerLine | Specifies the offset, in bytes, between two adjacent segments on the host. |
| [in] | inDeviceBytesPerLine | Specifies the offset, in bytes, between two adjacent segments on the device. |
inNumBytesPerSegment parameter to eliminate the necessity of setting AUTOCIRCULATE_TRANSFER::acVideoBuffer.fByteCount to store the bytes-per-segment value. Definition at line 2950 of file ntv2publicinterface.cpp.
|
inline |
| [in] | inField2 | Specify true for Field2. Defaults to false (Field1). |
Definition at line 8443 of file ntv2publicinterface.h.
|
inline |
Definition at line 8437 of file ntv2publicinterface.h.
| [in] | inField2 | Specify true to obtain the Field 2 ancillary byte count. Specify false (the default) to return the Field 1 (or progessive) ancillary byte count. |
Definition at line 8585 of file ntv2publicinterface.h.
|
inline |
Definition at line 8575 of file ntv2publicinterface.h.
|
inline |
Definition at line 8591 of file ntv2publicinterface.h.
|
inline |
Returns a constant reference to my FRAME_STAMP.
Definition at line 8569 of file ntv2publicinterface.h.
| bool AUTOCIRCULATE_TRANSFER::GetInputTimeCode | ( | NTV2_RP188 & | outTimeCode, |
| const NTV2TCIndex | inTCIndex = NTV2_TCINDEX_SDI1 |
||
| ) | const |
Intended for capture, answers with a specific timecode captured in my acTransferStatus member's acFrameStamp member's acTimeCodes member.
| [out] | outTimeCode | Receives the requested timecode value. |
| [in] | inTCIndex | Specifies which NTV2TCIndex to use. Defaults to NTV2_TCINDEX_SDI1. |
Definition at line 2984 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::GetInputTimeCodes | ( | NTV2TimeCodeList & | outValues | ) | const |
Intended for capture, answers with the timecodes captured in my acTransferStatus member's acFrameStamp member.
| [out] | outValues | Receives the NTV2TimeCodeList that was transferred from the device. (An NTV2TCIndex value can be used as in index in the list.) |
Definition at line 2977 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::GetInputTimeCodes | ( | NTV2TimeCodes & | outTimeCodes, |
| const NTV2Channel | inSDIInput = NTV2_CHANNEL1, |
||
| const bool | inValidOnly = true |
||
| ) | const |
Retrieves the timecodes from the captured frame that are associated with the given SDI input.
| [out] | outTimeCodes | Receives the timecode values as a mapping of NTV2TCIndex values to NTV2_RP188 objects. |
| [in] | inSDIInput | Specifies the SDI input of interest as an NTV2Channel. Defaults to NTV2_CHANNEL1 (SDI In 1). |
| [in] | inValidOnly | Optionally specifies if only valid timecodes should be returned. Defaults to true. Specify false to return all timecode values associated with the SDI input of interest, even if they're not valid. |
Definition at line 2991 of file ntv2publicinterface.cpp.
|
inline |
Definition at line 8596 of file ntv2publicinterface.h.
|
inline |
Returns a constant reference to my AUTOCIRCULATE_TRANSFER_STATUS.
Definition at line 8563 of file ntv2publicinterface.h.
|
inline |
Definition at line 8432 of file ntv2publicinterface.h.
|
inline |
Definition at line 8557 of file ntv2publicinterface.h.
|
inline |
Definition at line 8633 of file ntv2publicinterface.h.
| bool AUTOCIRCULATE_TRANSFER::RPCDecode | ( | const NTV2_RPC_BLOB_TYPE & | inBlob, |
| size_t & | inOutIndex | ||
| ) |
Definition at line 4158 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::RPCEncode | ( | NTV2_RPC_BLOB_TYPE & | outBlob | ) |
Definition at line 4124 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SegmentedDMAsEnabled | ( | void | ) | const |
Definition at line 2970 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetAllOutputTimeCodes | ( | const NTV2_RP188 & | inTimecode, |
| const bool | inIncludeF2 = true |
||
| ) |
Intended for playout, replaces all elements of my acOutputTimeCodes member with the given timecode value.
| [in] | inTimecode | Specifies the timecode value to use for all possible embedded (VITC, ATC-LTC) and analog timecode outputs for the device. |
| [in] | inIncludeF2 | Specify true to include Field2 timecode values (VITC2), or false to exclude them. Defaults to true. |
Definition at line 2914 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetAncBuffers | ( | ULWord * | pInANCBuffer, |
| const ULWord | inANCByteCount, | ||
| ULWord * | pInANCF2Buffer = NULL, |
||
| const ULWord | inANCF2ByteCount = 0 |
||
| ) |
Sets my ancillary data buffers for use in a subsequent call to CNTV2Card::AutoCirculateTransfer.
| pInANCBuffer | Specifies a pointer to the host ancillary data buffer. On capture, ancillary data will be DMA'd into this buffer. On playout, ancillary data will be read from this buffer. If NULL, no ancillary data will be transferred. |
| inANCByteCount | On capture, specifies the maximum capacity of the host ancillary data buffer, in bytes. After the transfer, it will contain the actual number of bytes transferred. On playout, specifies the number of ancillary data bytes to transfer from the host buffer. If zero, no ancillary data will be transferred. |
| pInANCF2Buffer | Optionally specifies a pointer to the Field 2 host ancillary data buffer. On capture, ancillary data for Field 2 (interlaced video formats only) will be DMA'd into this buffer. On playout, ancillary data for Field 2 (interlaced video formats only) will be read from this buffer. If NULL, no Field 2 ancillary data will be transferred. Defaults to NULL. |
| inANCF2ByteCount | Optionally specifies the maximum capacity of the Field 2 host ancillary data buffer, in bytes, or the maximum number of Field 2 ancillary data bytes to transfer. If zero, no F2 ancillary data will be transferred. Defaults to zero. |
pInANCBuffer or pInANCF2Buffer, be sure they're aligned to the nearest 8-byte boundary. Definition at line 2867 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetAudioBuffer | ( | ULWord * | pInAudioBuffer, |
| const ULWord | inAudioByteCount | ||
| ) |
Sets my audio buffer for use in a subsequent call to CNTV2Card::AutoCirculateTransfer.
| pInAudioBuffer | Specifies a pointer to the host audio buffer. On capture, audio data will be DMA'd into this buffer. On playout, audio data will be DMA'd from this buffer. If NULL, no audio data will be transferred. |
| inAudioByteCount | On capture, specifies the maximum capacity of the host audio buffer, in bytes; on playout, specifies the number of audio bytes (and therefore audio samples) to transfer. If zero, no audio data will be transferred. |
pInAudioBuffer address start on at least an 8-byte boundary or even better, on a page boundary, increases PCIe DMA efficiency on most modern operating systems. Definition at line 2859 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetBuffers | ( | ULWord * | pInVideoBuffer, |
| const ULWord | inVideoByteCount, | ||
| ULWord * | pInAudioBuffer, | ||
| const ULWord | inAudioByteCount, | ||
| ULWord * | pInANCBuffer, | ||
| const ULWord | inANCByteCount, | ||
| ULWord * | pInANCF2Buffer = NULL, |
||
| const ULWord | inANCF2ByteCount = 0 |
||
| ) |
Sets my buffers for use in a subsequent call to CNTV2Card::AutoCirculateTransfer.
| pInVideoBuffer | Specifies a pointer to the host video buffer. On capture, this buffer will be written during the DMA operation. On playout, this buffer will be read during the DMA operation. If NULL, no video will be transferred. |
| inVideoByteCount | On capture, specifies the maximum capacity of the host video buffer, in bytes. On playout, specifies the number of video bytes to transfer from the host buffer. If zero, no video will be transferred. |
| pInAudioBuffer | Specifies a pointer to the host audio buffer. On capture, audio data will be DMA'd to this buffer. On playout, audio data will be read from this buffer. If NULL, no audio will be transferred. |
| inAudioByteCount | On capture, specifies the maximum capacity of the host audio buffer, in bytes. On playout, specifies the number of audio bytes (and therefore audio samples) to transfer from the host buffer. If zero, no audio will be transferred. |
| pInANCBuffer | Specifies a pointer to the host ancillary data buffer. On capture, ancillary data will be DMA'd into this buffer. On playout, ancillary data will be read from this buffer. If NULL, no ancillary data will be transferred. |
| inANCByteCount | On capture, specifies the maximum capacity of the host ancillary data buffer, in bytes. After the transfer, it will contain the actual number of bytes transferred. On playout, specifies the number of ancillary data bytes to transfer from the host buffer. If zero, no ancillary data will be transferred. |
| pInANCF2Buffer | Optionally specifies a pointer to the Field 2 host ancillary data buffer. On capture, ancillary data for Field 2 (interlaced video formats only) will be DMA'd into this buffer. On playout, ancillary data for Field 2 (interlaced video formats only) will be read from this buffer. If NULL, no Field 2 ancillary data will be transferred. Defaults to NULL. |
| inANCF2ByteCount | Optionally specifies the maximum capacity of the Field 2 host ancillary data buffer, in bytes. If zero, no ancillary data (interlaced F2) will be transferred. Defaults to zero. |
Definition at line 2839 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetFrameBufferFormat | ( | const NTV2FrameBufferFormat | inNewFormat | ) |
Sets my acFrameBufferFormat value to the given new value (if valid and circulating with AUTOCIRCULATE_WITH_FBFCHANGE option).
| [in] | inNewFormat | Specifies the new frame buffer format value to change to. Must be a valid format for the device. |
Definition at line 2933 of file ntv2publicinterface.cpp.
|
inline |
Intended for playout, replaces my current acUserCookie value with the new value.
| [in] | inUserCookie | Specifies the new cookie value. |
Definition at line 8533 of file ntv2publicinterface.h.
| bool AUTOCIRCULATE_TRANSFER::SetOutputTimeCode | ( | const NTV2_RP188 & | inTimecode, |
| const NTV2TCIndex | inTCIndex = NTV2_TCINDEX_SDI1 |
||
| ) |
Intended for playout, sets one element of my acOutputTimeCodes member.
| [in] | inTimecode | Specifies the timecode value. |
| [in] | inTCIndex | Specifies which NTV2TCIndex to use. Defaults to NTV2_TCINDEX_SDI1. |
Definition at line 2898 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetOutputTimeCodes | ( | const NTV2TimeCodes & | inValues | ) |
Intended for playout, replaces the contents of my acOutputTimeCodes member.
| [in] | inValues | Specifies the NTV2TimeCodes map to transfer to the device. |
Definition at line 2878 of file ntv2publicinterface.cpp.
| bool AUTOCIRCULATE_TRANSFER::SetVideoBuffer | ( | ULWord * | pInVideoBuffer, |
| const ULWord | inVideoByteCount | ||
| ) |
Sets my video buffer for use in a subsequent call to CNTV2Card::AutoCirculateTransfer.
| pInVideoBuffer | Specifies a pointer to the host video buffer. On capture, this buffer will be written during the DMA operation. On playout, this buffer will be read during the DMA operation. If NULL, no video data will be transferred. |
| inVideoByteCount | Specifies the maximum capacity of the host video buffer, in bytes, or the maximum number of video data bytes to transfer. If zero, no video data will be transferred. |
pInAudioBuffer address start on at least an 8-byte boundary or even better, on a page boundary, and the inAudioByteCount be a multiple of 8-bytes (or optimally a multiple of a page) increases PCIe DMA efficiency on most modern operating systems. Definition at line 2851 of file ntv2publicinterface.cpp.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acANCBuffer |
The host ancillary data buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no ancillary data will be transferred. Use the AUTOCIRCULATE_TRANSFER::SetAncBuffers method to set or reset this field.
Definition at line 8234 of file ntv2publicinterface.h.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acANCField2Buffer |
The host "Field 2" ancillary data buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no "Field 2" ancillary data will be transferred. Use the AUTOCIRCULATE_TRANSFER::SetAncBuffers method to set or reset this field.
Definition at line 8245 of file ntv2publicinterface.h.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acAudioBuffer |
The host audio buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no audio will be transferred. AJA recommends keeping this buffer 64-bit aligned and page-aligned for best performance. Use the AUTOCIRCULATE_TRANSFER::SetAudioBuffer method to set or reset this field.
Definition at line 8223 of file ntv2publicinterface.h.
| NTV2ColorCorrectionData AUTOCIRCULATE_TRANSFER::acColorCorrection |
Color correction data. This field is ignored if AUTOCIRCULATE_WITH_COLORCORRECT option is not set.
Definition at line 8278 of file ntv2publicinterface.h.
| NTV2Crosspoint AUTOCIRCULATE_TRANSFER::acCrosspoint |
Will be deprecated – used internally by the SDK. Will be removed when the driver changes to use NTV2Channel/NTV2Mode.
Definition at line 8294 of file ntv2publicinterface.h.
| LWord AUTOCIRCULATE_TRANSFER::acDesiredFrame |
Used to specify a different frame in the circulate ring to transfer to/from.
Definition at line 8292 of file ntv2publicinterface.h.
| NTV2FrameBufferFormat AUTOCIRCULATE_TRANSFER::acFrameBufferFormat |
Specifies the frame buffer format to change to. Ignored if AUTOCIRCULATE_WITH_FBFCHANGE option is not set.
Definition at line 8279 of file ntv2publicinterface.h.
| NTV2FBOrientation AUTOCIRCULATE_TRANSFER::acFrameBufferOrientation |
Specifies the frame buffer orientation to change to. Ignored if AUTOCIRCULATE_WITH_FBOCHANGE option is not set.
Definition at line 8280 of file ntv2publicinterface.h.
| ULWord AUTOCIRCULATE_TRANSFER::acFrameRepeatCount |
Intended for playout. The number of times to repeat the frame being transferred.
Definition at line 8291 of file ntv2publicinterface.h.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acHDMIAuxData |
Definition at line 8284 of file ntv2publicinterface.h.
| NTV2_HEADER AUTOCIRCULATE_TRANSFER::acHeader |
The common structure header – ALWAYS FIRST!
Definition at line 8209 of file ntv2publicinterface.h.
| NTV2SegmentedDMAInfo AUTOCIRCULATE_TRANSFER::acInSegmentedDMAInfo |
Optional segmented DMA info, for use with specialized data transfers.
Definition at line 8277 of file ntv2publicinterface.h.
| ULWord64 AUTOCIRCULATE_TRANSFER::acInUserCookie |
Intended for playout, an optional app-specific cookie value that tags this frame, such that if this same tag appears in acTransferStatus.acFrameStamp.acCurrentUserCookie after AutoCirculateTransfer returns, or if it appears in the FRAME_STAMP's acCurrentUserCookie field after CNTV2Card::AutoCirculateGetFrameStamp returns, identifies when the frame was on-the-air.
Definition at line 8267 of file ntv2publicinterface.h.
| ULWord AUTOCIRCULATE_TRANSFER::acInVideoDMAOffset |
Optional byte offset into the device frame buffer. Defaults to zero. If non-zero, should be a multiple of the line length, or else bad video will likely result. On capture, this specifies where the first byte in the device video buffer will be read from (and that byte will end up in the first byte position in the host video buffer. Conversely, on playout, this specifies where the first byte from the host video buffer will end up in the device video buffer.
Definition at line 8275 of file ntv2publicinterface.h.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acOutputTimeCodes |
Intended for playout, this is an ordered sequence of NTV2_RP188 values to send to the device. If empty, no timecodes will be transferred. This field is ignored if AUTOCIRCULATE_WITH_RP188 option is not set.
Definition at line 8253 of file ntv2publicinterface.h.
| ULWord AUTOCIRCULATE_TRANSFER::acPeerToPeerFlags |
Definition at line 8290 of file ntv2publicinterface.h.
| NTV2_RP188 AUTOCIRCULATE_TRANSFER::acRP188 |
Will be deprecated – use AUTOCIRCULATE_TRANSFER::SetOutputTimeCode instead.
Definition at line 8293 of file ntv2publicinterface.h.
| NTV2_TRAILER AUTOCIRCULATE_TRANSFER::acTrailer |
The common structure trailer – ALWAYS LAST!
Definition at line 8296 of file ntv2publicinterface.h.
| AUTOCIRCULATE_TRANSFER_STATUS AUTOCIRCULATE_TRANSFER::acTransferStatus |
Contains status information that's valid after CNTV2Card::AutoCirculateTransfer returns, including the driver buffer level, number of frames processed or dropped, audio and anc transfer byte counts, and a complete FRAME_STAMP that has even more detailed clocking information.
Definition at line 8260 of file ntv2publicinterface.h.
| NTV2Buffer AUTOCIRCULATE_TRANSFER::acVideoBuffer |
The host video buffer. This field is owned by the client application, and thus is responsible for allocating and/or freeing it. If the pointer is NULL or the size is zero, no video will be transferred. AJA recommends keeping this buffer 64-bit aligned and page-aligned for best performance. Use the AUTOCIRCULATE_TRANSFER::SetVideoBuffer method to set or reset this field.
Definition at line 8216 of file ntv2publicinterface.h.
| NTV2QuarterSizeExpandMode AUTOCIRCULATE_TRANSFER::acVideoQuarterSizeExpand |
Turns on the "quarter-size expand" (2x H + 2x V) hardware. Defaults to off (1:1).
Definition at line 8282 of file ntv2publicinterface.h.
| AutoCircVidProcInfo AUTOCIRCULATE_TRANSFER::acVidProcInfo |
Specifies the mixer/keyer transition to make. Ignored if AUTOCIRCULATE_WITH_VIDPROC option is not set.
Definition at line 8281 of file ntv2publicinterface.h.