List of all NvSciBuf enumerations for attribute keys.
| enum NvSciBufAttrKey |
Describes the NvSciBuf public attribute keys holding corresponding values specifying buffer constraints.
The accessibility property of an attribute refers to whether the value of an attribute is accessible in an NvSciBufAttrList. Input attribute keys specify desired buffer constraints from client and can be set/retrieved by client to/from unreconciled NvSciBufAttrList using NvSciBufAttrListSetAttrs()/NvSciBufAttrListGetAttrs() respectively. Output attribute keys specify actual buffer constraints computed by NvSciBuf if reconciliation succeeds. Output attributes can be retrieved from reconciled NvSciBufAttrList using NvSciBufAttrListGetAttrs(). The presence property of an attribute refers to whether the value of an attribute having accessibility as input needs to be present in at least one of the unreconciled attribute lists for reconciliation. The presence property of an attribute can have one of the three values: Mandatory/Optional/Conditional. Mandatory implies that it is mandatory that the value of an attribute be set in at least one of the unreconciled NvSciBufAttrLists involved in reconciliation. Failing to set mandatory input attribute in at least one of the input unreconciled NvSciBufAttrLists results in reconciliation failure. Optional implies that it is not mandatory that value of an attribute be set in at least of the unreconciled NvSciBufAttrLists involved in reconciliation. If the optional input attribute is not set in any of the input unreconciled NvSciBufAttrLists, NvSciBuf uses default value of such attribute to calculate/reconcile output attributes dependent on such input attribute. Conditional implies that the presence of an attribute is mandatory if condition associated with its presence is satisfied, otherwise its optional.
| Enumerator | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| NvSciBufAttrKey_LowerBound | Specifies the lower bound value to check for a valid NvSciBuf attribute key type. | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_Types | An array of all types that the buffer is expected to have. For each type the buffer has, the associated attributes are valid. In order to set NvSciBufAttrKeys corresponding to the NvSciBufType, NvSciBufType must be set first using this key. NOTE: A single buffer may have multiple types. For example, a buffer may simultaneously be a NvSciBufType_Image (for integration with NvMedia), a NvSciBufType_Tensor (for integration with TensorRT or NvMedia), and a NvSciBufType_RawBuffer (for integration with CUDA kernels that will directly access it). During reconciliation, if all the NvSciBufTypes specified by all the unreconciled NvSciBufAttrLists are same, this key outputs the specified NvSciBufType. If all NvSciBufTypes are not same, reconciliation succeeds only if the set of NvSciBufTypes contains NvSciBufType_Image and NvSciBufType_Tensor only otherwise reconciliation fails. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the input unreconciled NvSciBufAttrList(s) is not present in the set of values of this attribute in the provided reconciled NvSciBufAttrList. Accessibility: Input/Output attribute Presence: Mandatory Value: NvSciBufType[] valid input value: All values defined by NvSciBufType for safety build such that NvSciBufType_General < value < NvSciBufType_MaxValid | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_NeedCpuAccess | Specifies if CPU access is required for the buffer. If this attribute is set to During reconciliation, reconciler sets value of this key to true in the reconciled NvSciBufAttrList if any of the unreconciled NvSciBufAttrList(s) involved in reconciliation that is owned by the reconciler has this key set to true, otherwise it is set to false in reconciled NvSciBufAttrList. When importing the reconciled NvSciBufAttrList, for every peer owning the unreconciled NvSciBufAttrList(s) involved in reconciliation, if any of the unreconciled NvSciBufAttrList(s) owned by the peer set the key to true then value of this key is true in the reconciled NvSciBufAttrList imported by the peer otherwise its false. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the unreconciled NvSciBufAttrList(s) belonging to NvSciIpc channel owner is true and value of the same attribute in reconciled NvSciBufAttrList is false. Accessibility: Input/Output attribute Presence: Optional Value: | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_RequiredPerm | Specifies buffer access permissions. If reconciliation succeeds, granted buffer permissions are reflected in NvSciBufGeneralAttrKey_ActualPerm. If NvSciBufGeneralAttrKey_NeedCpuAccess is true and write permission are granted, then NvSciBufObjGetCpuPtr() can be used to obtain a non-const pointer to the buffer. NOTE: Whether this key is present in reconciled attribute lists is unspecified, as is its value if it is present. Accessibility: Input attribute Presence: Optional Value: NvSciBufAttrValAccessPerm valid input value: NvSciBufAccessPerm_Readonly or NvSciBufAccessPerm_ReadWrite | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_EnableCpuCache | Specifies whether to enable/disable CPU caching. If set to The CPU must perform write-back caching of the buffer to the greatest extent possible considering all the CPUs that are sharing the buffer. Coherency is guaranteed with:
If set to The CPU must not access the caches at all on read or write accesses to the buffer from applications. Coherency is guaranteed with:
During reconciliation, this key is set to true in reconciled NvSciBufAttrList if any of the unreconciled NvSciBufAttrList owned by any peer set it to true, otherwise it is set to false. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the unreconciled NvSciBufAttrList(s) is true and value of the same attribute in reconciled NvSciBufAttrList is false. Accessibility: Input/Output attribute Presence: Optional Value: | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_GpuId | GpuIDs of the GPUs in the system that will access the buffer. In a multi GPU System, if multiple GPUs are supposed to access the buffer, then provide the GPU IDs of all the GPUs that need to access the buffer. The GPU which is not specified in the list of GPUIDs may not be able to access the buffer. During reconciliation, the value of this attribute in reconciled NvSciBufAttrList is equivalent to the aggregate of all the values specified by all the unreconciled NvSciBufAttrLists involved in reconciliation that have this attribute set. The value of this attribute is set to implementation chosen default value if none of the unreconciled NvSciBufAttrLists specify this attribute. Note that the default value chosen by the implementation must be an invalid NvSciRmGpuId value. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the input unreconciled NvSciBufAttrList(s) is not present in the set of values of this attribute in the provided reconciled NvSciBufAttrList. Accessibility: Input/Output attribute Presence: Optional Value: NvSciRmGpuId[] valid input value: Valid NvSciRmGpuId of the GPU(s) present in the system. | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_CpuNeedSwCacheCoherency | Indicates whether the CPU is required to flush before reads and after writes. This can be accomplished using NvSciBufObjFlushCpuCacheRange(), or (if the application prefers) with OS-specific flushing functions. It is set to true in reconciled NvSciBufAttrList if both NvSciBufGeneralAttrKey_EnableCpuCache and NvSciBufGeneralAttrKey_NeedCpuAccess are requested by setting them to true in any of the unreconciled NvSciBufAttrList(s) from which reconciled NvSciBufAttrList is obtained and any of the ISO engines would operate on the buffer. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute reconciled from the input unreconciled NvSciBufAttrList(s) is true and value of the same attribute in the provided reconciled NvSciBufAttrList is false. Accessibility: Output attribute Value: | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_ActualPerm | Specifies the buffer access permissions to the NvSciBufObj. This key is only valid in reconciled NvSciBufAttrList and undefined in unreconciled NvSciBufAttrList. During reconciliation, this attribute is set to the maximum value of the requested permission set in NvSciBufGeneralAttrKey_RequiredPerm of all the unreconciled NvSciBufAttrLists are involved in the reconciliation. This attribute is set to default value of NvSciBufAccessPerm_Readonly if none of the unreconciled NvSciBufAttrLists specify value of the NvSciBufGeneralAttrKey_RequiredPerm attribute. If NvSciBufObj is obtained by calling NvSciBufObjAlloc(), NvSciBufGeneralAttrKey_ActualPerm is set to NvSciBufAccessPerm_ReadWrite in the reconciled NvSciBufAttrList corresponding to it since allocated NvSciBufObj gets read-write permissions by default. For any peer importing the reconciled NvSciBufAttrList, this key is set to maximum value of the requested permission set in NvSciBufGeneralAttrKey_RequiredPerm of all the unreconciled NvSciBufAttrLists that were exported by the peer for reconciliation. The key is set by the reconciler when exporting the reconciled NvSciBufAttrList. For any peer importing the NvSciBufObj, this key is set in the reconciled NvSciBufAttrList to the permissions associated with NvSciBufObjIpcExportDescriptor. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute reconciled from the input unreconciled NvSciBufAttrList(s) is greater than the value of the same attribute in the provided reconciled NvSciBufAttrList. Accessibility: Output attribute Value: NvSciBufAttrValAccessPerm | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_VidMem_GpuId | GPU ID of dGPU from which vidmem allocation should come when multiple GPUs are sharing buffer. This key should be empty if multiple GPUs access shared buffer from sysmem. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to implementation chosen default value if none of the unreconciled NvSciBufAttrLists involved in reconciliation specify this attribute. Note that the default value chosen by the implementation must be an invalid NvSciRmGpuId value. Accessibility: Input/Output attribute Presence: Optional Value: NvSciRmGpuId valid input value: Valid NvSciRmGpuId of the dGPU present in the system. | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_EnableGpuCache | An array of NvSciBufAttrValGpuCache[] specifying GPU cacheability requirements. Currently, NvSciBuf supports cacheability control for single iGPU and thus if user decides to request cacheability control via this attribute then an array, NvSciBufAttrValGpuCache[] shall provide a single value where GPU ID specified in it is of type iGPU and is part of GPU IDs specified in NvSciBufGeneralAttrKey_GpuId. Not satisfying any of the above conditions results in reconciliation failure. During reconciliation, for all the unreconciled NvSciBufAttrLists involved in reconciliation, the input values of this attribute for a particular GPU ID are taken from a) Value specified by unreconciled NvSciBufAttrLists b) Default value based on table specified below if particular unreconciled NvSciBufAttrList does not specify it. The set of input values are then reconciled using AND policy. The policy specified above is applied for ALL the GPU IDs specified in NvSciBufGeneralAttrKey_GpuId. |-------—|------------—|--------—|------------—|
Type: Input/Output attribute Presence: Optional Datatype: NvSciBufAttrValGpuCache[] | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_GpuSwNeedCacheCoherency | An attribute indicating whether application needs to perform GPU cache maintenance before read and after writes. The value of this attribute is set in reconciled NvSciBufAttrList as follows: The value in NvSciBufAttrValGpuCache is set to TRUE for a particular GPU ID in the same struct if, 1) Memory domain is Sysmem AND that particular GPU ID in the NvSciBufGeneralAttrKey_EnableGpuCache has cacheability value set to TRUE AND a) At least one of the GPU IDs in the NvSciBufGeneralAttrKey_EnableGpuCache has cacheability set to FALSE. OR b) At least one of the unreconciled NvSciBufAttrList has requested CPU access via NvSciBufGeneralAttrKey_NeedCpuAccess OR c) At least one HW engine will be accessing the buffer. 2) Memory domain is Vidmem AND that particular GPU ID in the NvSciBufGeneralAttrKey_EnableGpuCache has cacheability value set to TRUE AND a) Any of the HW engines accessing the buffer are not cache coherent with Vidmem It is set to FALSE otherwise. Type: Output attribute Datatype: NvSciBufAttrValGpuCache[] | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_EnableGpuCompression | Specifies whether to enable/disable GPU compression for the particular GPU. User can specify the value of this attribute in terms of an array of NvSciBufAttrValGpuCompression. During reconciliation, if any of the following conditions are satisfied, the reconciliation fails:
If none of the conditions mentioned above for reconciliation failure are met then this attribute is reconciled as follows:
The number of elements in the array value NvSciBufAttrValGpuCompression[] of NvSciBufGeneralAttrKey_EnableGpuCompression attribute in the reconciled NvSciBufAttrList is equal to the number of GPU IDs specified in the NvSciBufGeneralAttrKey_GpuId attribute. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of input unreconciled NvSciBufAttrLists yield NvSciBufAttrValGpuCompression value of NvSciBufCompressionType_None for the particular GPU ID while value of the same GPU ID in the reconciled NvSciBufAttrList is other than NvSciBufCompressionType_None. Type: Input/Output attribute Presence: Optional Datatype: NvSciBufAttrValGpuCompression[] | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_PeerLocationInfo | An attribute indicating location information of late attaching peer(s) which are going to gain access to the allocated NvScibufObj using NvSciBufObjAttachPeer() API. During reconciliation, the value of this attribute in reconciled NvSciBufAttrList is equivalent to the aggregate of all the values specified by all the unreconciled NvSciBufAttrLists involved in reconciliation that have this attribute set. Note: During reconciliation, if NvSciBufGeneralAttrKey_PeerHwEngineArray is not set: NvSciBuf will consider all Hw engines, which are reconcilable with other Hw engines present in other unreconciled NvSciBufAttrList, to align buffer attributes. else if NvSciBufGeneralAttrKey_PeerHwEngineArray is set: NvSciBuf only consider Hw engines from NvSciBufGeneralAttrKey_PeerHwEngineArray which are reconcilable with other Hw engines present in other unreconciled NvSciBufAttrList, to align buffer attributes. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the input unreconciled NvSciBufAttrList(s) is not present in the set of values of this attribute in the provided reconciled NvSciBufAttrList. Accessibility: Input/Output attribute Presence: Optional Value: NvSciBufPeerLocationInfo[] | ||||||||||||||||||||||||||||
| NvSciBufGeneralAttrKey_PeerHwEngineArray | An attribute indicating list of hardware engines which will access the allocated buffer on late attaching peer(s). These late attaching peer(s) will gain access to the allocated NvSciBufObj using NvSciBufObjAttachPeer() API. During reconciliation, the value of this attribute in reconciled NvSciBufAttrList is equivalent to the aggregate of all the values specified by all the unreconciled NvSciBufAttrLists involved in reconciliation that have this attribute set. Note: During reconciliation, NvSciBuf will consider all Hw engines, which are reconcilable with other Hw engines present in other unreconciled NvSciBufAttrList, to align buffer attributes. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if value of this attribute set in any of the input unreconciled NvSciBufAttrList(s) is not present in the set of values of this attribute in the provided reconciled NvSciBufAttrList. Accessibility: Input/Output attribute Presence: Optional Value: NvSciBufPeerHwEngine[] | ||||||||||||||||||||||||||||
| NvSciBufRawBufferAttrKey_Size | Specifies the size of the NvSciBufType_RawBuffer NvSciBufObj that the underlying buffer allocation satisfies. The input size specified in unreconciled NvSciBufAttrList(s) should be greater than 0. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_RawBuffer and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufRawBufferAttrKey_Align | Specifies the alignment requirement of NvSciBufType_RawBuffer. Input alignment should be power of 2. If more than one unreconciled NvSciBufAttrLists specify this input attribute, value in the reconciled NvSciBufAttrList corresponds to maximum of the values specified in all of the unreconciled NvSciBufAttrLists. The value of this attribute is set to default alignment with which buffer is allocated if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_RawBuffer and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Optional Unit: byte Value: valid input value: value is power of 2. | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_Layout | Specifies the layout of NvSciBufType_Image: Block-linear or Pitch-linear. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Only pitch-linear layout is supported for image-tensor buffer type reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: NvSciBufAttrValImageLayoutType valid input value: Any value defined by NvSciBufAttrValImageLayoutType enum. | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_TopPadding | Specifies the top padding for the NvSciBufType_Image. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to default value of 0 if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify the attribute. Padding is not allowed to be specified for image-tensor reconciliation. It is allowed for image only buffer reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_BottomPadding | Specifies the bottom padding for the NvSciBufType_Image. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to default value of 0 if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify the attribute. Padding is not allowed to be specified for image-tensor reconciliation. It is allowed for image only buffer reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: uint64_t[] | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_LeftPadding | Specifies the left padding for the NvSciBufType_Image. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to default value of 0 if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify the attribute. Padding is not allowed to be specified for image-tensor reconciliation. It is allowed for image only buffer reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_RightPadding | Specifies the right padding for the NvSciBufType_Image. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to default value of 0 if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify the attribute. Padding is not allowed to be specified for image-tensor reconciliation. It is allowed for image only buffer reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_VprFlag | Specifies the VPR flag for the NvSciBufType_Image. During reconciliation, this key is set to true in reconciled NvSciBufAttrList if any of the unreconciled NvSciBufAttrList owned by any peer set it to true, otherwise it is set to false. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Optional Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_Size | Specifies the size of the NvSciBufType_Image NvSciBufObj that the underlying buffer allocation satisfies after successful reconciliation. The output size for this key is computed by aggregating the size of all the planes in the output key NvSciBufImageAttrKey_PlaneAlignedSize. The size is calculated the following way: NvSciBufImageAttrKey_Size = sum of NvSciBufImageAttrKey_PlaneAlignedSize During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_Alignment | Output alignment of the NvSciBufType_Image after successful reconciliation. The output value of this key is same as alignment value of the first plane in the key NvSciBufImageAttrKey_PlaneBaseAddrAlign after reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneCount | Specifies the number of planes for NvSciBufType_Image. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. If NvSciBufType_Image and NvSciBufType_Tensor are involved in reconciliation and if this attribute is set in any of unreconciled NvSciBufAttrList(s) to be reconciled, the value of this attribute should be 1. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Mandatory when surface-based image attributes are not used, and should not be specified otherwise. Value: valid input value: 1 <= value <= NV_SCI_BUF_IMAGE_MAX_PLANES | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneColorFormat | Specifies the NvSciBufAttrValColorFmt of the NvSciBufType_Image plane. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Mandatory when surface-based image attributes are not used, and should not be specified otherwise. Value: NvSciBufAttrValColorFmt[] valid input value: NvSciColor_LowerBound < value < NvSciColor_UpperBound | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneColorStd | Specifies a set of plane color standards. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to implementation chosen default value if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Value: NvSciBufAttrValColorStd[] valid input value: Any value defined by NvSciBufAttrValColorStd enum. | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneBaseAddrAlign | Specifies the NvSciBufType_Image plane base address alignment for every plane in terms of an array. Input alignment must be power of 2. If more than one unreconciled NvSciBufAttrLists specify this attribute, reconciled NvSciBufAttrList has maximum alignment value per array index of the values specified in unreconciled NvSciBufAttrLists for the same array index. On top of that, for all the HW engines for which buffer is being allocated, if the maximum start address alignment constraint of all the engines taken together is greater than the reconciled alignment value at any index, it is replaced with start address alignment value. In other words, reconciled alignment per array index = MAX(MAX(alignments in unreconciled list at the same index), MAX(start address alignment constraint of all the engines)) The value of this attribute is set to default alignment with which buffer is allocated if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Optional when surface-based image attributes are not used, and should not be specified otherwise. Unit: byte Value: valid input value: value is power of 2. | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneWidth | Specifies the NvSciBufType_Image plane width in pixels. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Mandatory when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneHeight | Specifies the NvSciBufType_Image plane height in number of pixels. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. This is Mandatory when surface-based image attributes are not used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneScanType | Specifies the NvSciBufType_Image scan type: Progressive or Interlaced. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match.
During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: NvSciBufAttrValImageScanType valid input value: Any value defined by NvSciBufAttrValImageScanType enum. | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_ScanType | |||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneBitsPerPixel | Outputs number of bits per pixel corresponding to the NvSciBufAttrValColorFmt for each plane specified in NvSciBufImageAttrKey_PlaneColorFormat. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneOffset | Indicates the starting offset of the NvSciBufType_Image plane from the first plane. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneDatatype | Outputs the NvSciBufAttrValDataType of each plane based on the NvSciBufAttrValColorFmt provided in NvSciBufImageAttrKey_PlaneColorFormat for every plane. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Value: NvSciBufAttrValDataType[] | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneChannelCount | Outputs number of channels per plane. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneSecondFieldOffset | Indicates the offset of the start of the second field, 0 for progressive valid for interlaced. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlanePitch | Outputs the pitch (aka width in bytes) for every plane. The pitch is calculated the following way (prior to additional alignment constraints from the hardware engines accessing the buffer being considered), such that the pitch is at least: NvSciBufImageAttrKey_PlanePitch = (NvSciBufImageAttrKey_PlaneWidth * (Bits per pixel for NvSciBufImageAttrKey_PlaneColorFormat)) / 8 This value is then aligned to the maximum of the pitch alignment constraint value of all the HW engines that are going to operate on the buffer using extra padding bytes. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneAlignedHeight | Outputs the aligned height of every plane in terms of number of pixels. This height is calculated by aligning value for every plane provided in NvSciBufImageAttrKey_PlaneHeight with maximum of the height alignment constraints of all the engines that are going to operate on the buffer. The height is calculated the following way: If (NvSciBufImageAttrKey_ScanType == NvSciBufScan_InterlaceType) NvSciBufImageAttrKey_PlaneAlignedHeight = (NvSciBufImageAttrKey_PlaneHeight / 2) This value is aligned to highest height HW constraints among all the HW engines accessing the buffer Else NvSciBufImageAttrKey_PlaneAlignedHeight = NvSciBufImageAttrKey_PlaneHeight This value is aligned to highest height HW constraints among all the HW engines accessing the buffer During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_PlaneAlignedSize | Indicates the aligned size of every plane. The size is calculated from the value of NvSciBufImageAttrKey_PlanePitch and NvSciBufImageAttrKey_PlaneAlignedHeight. The size is calculated the following way: If (NvSciBufImageAttrKey_ScanType == NvSciBufScan_InterlaceType) NvSciBufImageAttrKey_PlaneAlignedSize = NvSciBufImageAttrKey_PlanePitch * NvSciBufImageAttrKey_PlaneAlignedHeight * 2 This value is aligned to highest size HW constraints among all the HW engines accessing the buffer Else NvSciBufImageAttrKey_PlaneAlignedSize = NvSciBufImageAttrKey_PlanePitch * NvSciBufImageAttrKey_PlaneAlignedHeight This value is aligned to highest size HW constraints among all the HW engines accessing the buffer During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_ImageCount | Attribute to specify number of NvSciBufType_Image(s) for which buffer should be allocated. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. This attribute is set to default value of 1 if none of the unreconciled NvSciBufAttrList(s) specify this attribute and the condition for the optional presence of this attribute is satisfied. NvSciBuf supports allocating buffer for single image only and thus, this attribute should be set to 1. A single buffer cannot be allocated for multiple images. Allocating 'N' buffers corresponding to 'N' images is allowed. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory for Image/Tensor reconciliation, Optional otherwise. Value: valid input value: 1 | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfType | Specifies the NvSciBufSurfType. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufSurfType | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfMemLayout | Specifies the NvSciBufSurfMemLayout. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufSurfMemLayout | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfSampleType | Specifies the NvSciBufSurfSampleType. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufSurfSampleType valid input value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfBPC | Specifies the NvSciBufSurfBPC. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufSurfBPC | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfComponentOrder | Specifies the NvSciSurfComponentOrder. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufSurfComponentOrder | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfWidthBase | Specifies the surface base width. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfHeightBase | Specifies the Surface base height. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory when surface-based image attributes are used, and should not be specified otherwise. Unit: pixel Value: | ||||||||||||||||||||||||||||
| NvSciBufImageAttrKey_SurfColorStd | Specifies the NvSciBufAttrValColorStd applicable to all the surface's planes. If more than one unreconciled NvSciBufAttrList specifies this input attribute, reconciliation is successful if all the input attributes of this type match. This value is set on the reconciled NvSciBufAttrList. This attribute is unset in the reconciled NvSciBufAttrList if no surface-based image attributes were requested in the unreconciled NvSciBufAttrList(s). During validation of a reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Image and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Optional when surface-based image attributes are used, and should not be specified otherwise. Value: NvSciBufAttrValColorStd valid input value: Any value defined by NvSciBufAttrValColorStd enum. | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_DataType | Specifies the tensor data type. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: NvSciBufAttrValDataType valid input value: NvSciDataType_Int4 <= value <= NvSciDataType_Float32 | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_NumDims | Specifies the number of tensor dimensions. A maximum of 8 dimensions are allowed. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. If NvSciBufType_Image and NvSciBufType_Tensor NvSciBufTypes are used in reconciliation, reconciliation succeeds only if this key is set to 4, since NvSciBuf only supports reconciliation of NvSciBufType_Tensor of NHWC type with NvSciBufType_Image. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: valid input value: 1 <= value <= NV_SCI_BUF_TENSOR_MAX_DIMS | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_SizePerDim | Specifies the size of each tensor dimension. This attribute takes size value in terms of an array. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Number of elements in value array of this attribute should not be less than value specified by NvSciBufTensorAttrKey_NumDims attribute.
During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_AlignmentPerDim | Specifies the alignment constraints per tensor dimension. Number of elements in value array of this attribute should not be less than value specified by NvSciBufTensorAttrKey_NumDims attribute. Value of every element in the value array should be power of two. If more than one unreconciled NvSciBufAttrLists specify this input attribute, value in the reconciled NvSciBufAttrList corresponds to maximum of the values specified in all of the unreconciled NvSciBufAttrLists that have set this attribute. The value of this attribute is set to default alignment with which buffer is allocated if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute and condition for the optional presence of this attribute is satisfied. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory for Tensor only reconciliation, optional otherwise. Unit: byte Value: valid input value: value is power of 2. | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_StridesPerDim | Returns the stride value (in bytes) for each tensor dimension.
During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_PixelFormat | Attribute providing pixel format of the tensor. This key needs to be set only if NvSciBufType_Image and NvSciBufType_Tensor are involved in reconciliation. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Additionally, reconciliation succeeds only if value of this attribute matches with the value of NvSciBufImageAttrKey_PlaneColorFormat in all the input unreconciled NvSciBufAttrList(s) that have set it. Image/Tensor reconciliation only supports NvSciColor_A8B8G8R8 and NvSciColor_Float_A16B16G16R16 color formats as of now. This attribute is set to default value if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute and condition for the optional presence of this attribute is satisfied. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Conditional. Mandatory for Image/Tensor reconciliation, optional otherwise. Value: NvSciBufAttrValColorFmt valid input value: NvSciColor_LowerBound < value < NvSciColor_UpperBound | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_BaseAddrAlign | Attribute providing base address alignment requirements for tensor. Input value provided for this attribute must be power of two. Output value of this attribute is always power of two. If more than one unreconciled NvSciBufAttrLists specify this input attribute, value in the reconciled NvSciBufAttrList corresponds to maximum of the values specified in all of the unreconciled NvSciBufAttrLists that have set this attribute. The value of this attribute is set to default alignment with which buffer is allocated if none of the unreconciled NvSciBufAttrList(s) involved in reconciliation specify this attribute and condition for the optional presence of this attribute is satisfied. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Optional Unit: byte Value: valid input value: value is power of 2. | ||||||||||||||||||||||||||||
| NvSciBufTensorAttrKey_Size | Specifies the size of the NvSciBufType_Tensor NvSciBufObj with NvSciBufTensorAttrKey_NumDims tensor dimensions that the underlying buffer allocation satisfies after successful reconciliation. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) contains NvSciBufType_Tensor and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufArrayAttrKey_DataType | Specifies the data type of a NvSciBufType_Array. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Upon successful reconciliation, the reconciled value of this attribute is equal to the value of the same attribute in one of the unreconciled NvSciBufAttrLists. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Array and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: NvSciBufAttrValDataType valid input value: NvSciDataType_Int4 <= value <= NvSciDataType_Bool | ||||||||||||||||||||||||||||
| NvSciBufArrayAttrKey_Stride | Specifies the stride of each element in the NvSciBufType_Array. Stride must be greater than or equal to size of datatype specified by NvSciBufArrayAttrKey_DataType. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Upon successful reconciliation, the reconciled value of this attribute is equal to the value of the same attribute in one of the unreconciled NvSciBufAttrLists. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Array and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufArrayAttrKey_Capacity | Specifies the NvSciBufType_Array capacity. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Upon successful reconciliation, the reconciled value of this attribute is equal to the value of the same attribute in one of the unreconciled NvSciBufAttrLists. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Array and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: | ||||||||||||||||||||||||||||
| NvSciBufArrayAttrKey_Size | Specifies the size of the NvSciBufType_Array NvSciBufObj that the underlying buffer allocation satisfies after successful reconciliation. During reconciliation, the size is calculated as follows: NvSciBufArrayAttrKey_Size = reconciled value of NvSciBufArrayAttrKey_Capacity * reconciled value of NvSciBufArrayAttrKey_Stride. This value is then aligned to highest data alignment constraints among all the HW engines accessing the buffer. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Array and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufArrayAttrKey_Alignment | Indicates the base alignment of a NvSciBufType_Array. During reconciliation, the value of this attribute is set as the highest start address alignment among all the HW engines accessing the buffer. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Array and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufPyramidAttrKey_NumLevels | Specifies the number of levels of images in a pyramid. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Upon successful reconciliation, the reconciled value of this attribute is equal to the value of the same attribute in one of the unreconciled NvSciBufAttrLists. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Pyramid and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: valid input value: 1 <= value <= NV_SCI_BUF_PYRAMID_MAX_LEVELS | ||||||||||||||||||||||||||||
| NvSciBufPyramidAttrKey_Scale | Specifies the scaling factor by which each successive image in a pyramid must be scaled. If more than one unreconciled NvSciBufAttrLists specify this input attribute, reconciliation is successful if all the input attributes of this type match. Upon successful reconciliation, the reconciled value of this attribute is equal to the value of the same attribute in one of the unreconciled NvSciBufAttrLists. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Pyramid and any of the following conditions is satisfied:
Accessibility: Input/Output attribute Presence: Mandatory Value: valid input value: 0.0f < value <= 1.0f | ||||||||||||||||||||||||||||
| NvSciBufPyramidAttrKey_LevelOffset | Buffer offset per level. During reconciliation, value of this attribute is calculated per level such that offset per level is equal to the number of offset bytes that need to be added from the starting buffer address of the first level to jump to the starting buffer address of the current level. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Pyramid and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufPyramidAttrKey_LevelSize | Buffer size per pyramid level. During reconciliation, values of NvSciBufImageAttrKey_PlaneWidth and NvSciBufImageAttrKey_PlaneHeight in reconciled NvSciBufAttrList are considered for computation of image size for the first level. For subsequent levels, the width and height are scaled down from the previous level by the factor specified in reconciled value of NvSciBufPyramidAttrKey_Scale and buffer size of image for each level is computed as specified in NvSciBufImageAttrKey_Size. The reconciled value of this attribute contains the buffer size of the image for each level. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Pyramid and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: | ||||||||||||||||||||||||||||
| NvSciBufPyramidAttrKey_Alignment | Alignment attribute of pyramid. During reconciliation, the value of this attribute is assigned the value equal to the value of NvSciBufImageAttrKey_Alignment in the reconciled NvSciBufAttrList. During validation of reconciled NvSciBufAttrList against input unreconciled NvSciBufAttrList(s), validation fails if reconciliation of NvSciBufGeneralAttrKey_Types attribute from the input unreconciled NvSciBufAttrList(s) yields NvSciBufType_Pyramid and any of the following conditions is satisfied:
Accessibility: Output attribute Unit: byte Value: uint64_t | ||||||||||||||||||||||||||||
| NvSciBufAttrKey_UpperBound | Specifies the maximum number of NvSciBuf attribute keys. The total space for keys is 32K. Value: None | ||||||||||||||||||||||||||||
Definition at line 442 of file nvscibuf.h.
