vk · Structs · I4
16 public declarations with native signatures and source-owned contracts.
Stvk::ImageTilingControlEXT
Contract
Open integer representation of VkImageTilingControlEXT.
Fields
0
0: i32Methods and associated items
DEFAULT_EXT
Native value VK_IMAGE_TILING_CONTROL_DEFAULT_EXT.
MIN_SIZE_EXT
Native value VK_IMAGE_TILING_CONTROL_MIN_SIZE_EXT.
MAX_PERFORMANCE_EXT
Native value VK_IMAGE_TILING_CONTROL_MAX_PERFORMANCE_EXT.
Khronos reference: VK_IMAGE_TILING_CONTROL_MAX_PERFORMANCE_EXT
from_raw
as_raw
empty
clone
fmt
default
hash
eq
self and other values to be equal, and is used by ==.Stvk::ImageToMemoryCopy
pub struct ImageToMemoryCopy<'a> {
pub s_type: StructureType,
pub p_next: *const c_void,
pub p_host_pointer: *mut c_void,
pub memory_row_length: u32,
pub memory_image_height: u32,
pub image_subresource: ImageSubresourceLayers,
pub image_offset: Offset3D,
pub image_extent: Extent3D,
/* private fields */
}Contract
Native structure VkImageToMemoryCopy.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
p_host_pointer
p_host_pointer: *mut c_voidNative field pHostPointer.
memory_row_length
memory_row_length: u32Native field memoryRowLength.
memory_image_height
memory_image_height: u32Native field memoryImageHeight.
image_subresource
image_subresource: ImageSubresourceLayersNative field imageSubresource.
image_offset
image_offset: Offset3DNative field imageOffset.
image_extent
image_extent: Extent3DNative field imageExtent.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_host_pointer
Set native pointer pHostPointer explicitly. No borrow or extent is inferred.
Safety
The caller must establish pointee validity, extent, alignment, aliasing and the full native retention lifetime before using this record in a native call. Callback, external-object and nested-pointer contracts remain caller obligations.
set_memory_row_length
Set native field memoryRowLength without native effects.
set_memory_image_height
Set native field memoryImageHeight without native effects.
set_image_subresource
Set native field imageSubresource without native effects.
set_image_offset
Set native field imageOffset without native effects.
set_image_extent
Set native field imageExtent without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageType
Contract
Open integer representation of VkImageType.
Fields
0
0: i32Methods and associated items
_1D
Native value VK_IMAGE_TYPE_1D.
_2D
Native value VK_IMAGE_TYPE_2D.
_3D
Native value VK_IMAGE_TYPE_3D.
from_raw
as_raw
empty
clone
fmt
default
hash
eq
self and other values to be equal, and is used by ==.Stvk::ImageUsageFlagBits
Contract
Open integer representation of VkImageUsageFlagBits.
Fields
0
0: u32Methods and associated items
TRANSFER_SRC_BIT
Native value VK_IMAGE_USAGE_TRANSFER_SRC_BIT.
TRANSFER_DST_BIT
Native value VK_IMAGE_USAGE_TRANSFER_DST_BIT.
SAMPLED_BIT
Native value VK_IMAGE_USAGE_SAMPLED_BIT.
STORAGE_BIT
Native value VK_IMAGE_USAGE_STORAGE_BIT.
COLOR_ATTACHMENT_BIT
Native value VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT.
DEPTH_STENCIL_ATTACHMENT_BIT
Native value VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT.
Khronos reference: VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
TRANSIENT_ATTACHMENT_BIT
Native value VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT.
INPUT_ATTACHMENT_BIT
Native value VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT.
HOST_TRANSFER_BIT
Native value VK_IMAGE_USAGE_HOST_TRANSFER_BIT.
VIDEO_DECODE_DST_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR.
VIDEO_DECODE_SRC_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR.
VIDEO_DECODE_DPB_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR.
SHADING_RATE_IMAGE_BIT_NV
Native value VK_IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV.
FRAGMENT_DENSITY_MAP_BIT_EXT
Native value VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT.
Khronos reference: VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT
FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
HOST_TRANSFER_BIT_EXT
Native value VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT.
VIDEO_ENCODE_DST_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR.
VIDEO_ENCODE_SRC_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR.
VIDEO_ENCODE_DPB_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR.
ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
Native value VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT.
Khronos reference: VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
INVOCATION_MASK_BIT_HUAWEI
Native value VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI.
Khronos reference: VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI
SAMPLE_WEIGHT_BIT_QCOM
Native value VK_IMAGE_USAGE_SAMPLE_WEIGHT_BIT_QCOM.
SAMPLE_BLOCK_MATCH_BIT_QCOM
Native value VK_IMAGE_USAGE_SAMPLE_BLOCK_MATCH_BIT_QCOM.
Khronos reference: VK_IMAGE_USAGE_SAMPLE_BLOCK_MATCH_BIT_QCOM
TENSOR_ALIASING_BIT_ARM
Native value VK_IMAGE_USAGE_TENSOR_ALIASING_BIT_ARM.
TILE_MEMORY_BIT_QCOM
Native value VK_IMAGE_USAGE_TILE_MEMORY_BIT_QCOM.
VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR
VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR
Native value VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR
from_raw
as_raw
empty
Output
& operator.bitand
& operation. Read moreOutput-1
| operator.bitor
| operation. Read moreOutput-2
^ operator.bitxor
^ operation. Read moreclone
fmt
default
hash
Output-3
! operator.not
! operation. Read moreeq
self and other values to be equal, and is used by ==.Stvk::ImageUsageFlagBits2KHR
Contract
Open integer representation of VkImageUsageFlagBits2KHR.
Fields
0
0: u64Methods and associated items
TRANSFER_SRC_BIT_KHR
Native value VK_IMAGE_USAGE_2_TRANSFER_SRC_BIT_KHR.
TRANSFER_DST_BIT_KHR
Native value VK_IMAGE_USAGE_2_TRANSFER_DST_BIT_KHR.
SAMPLED_BIT_KHR
Native value VK_IMAGE_USAGE_2_SAMPLED_BIT_KHR.
STORAGE_BIT_KHR
Native value VK_IMAGE_USAGE_2_STORAGE_BIT_KHR.
COLOR_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_2_COLOR_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_COLOR_ATTACHMENT_BIT_KHR
DEPTH_STENCIL_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR
TRANSIENT_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_2_TRANSIENT_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_TRANSIENT_ATTACHMENT_BIT_KHR
INPUT_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_2_INPUT_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_INPUT_ATTACHMENT_BIT_KHR
FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
Native value VK_IMAGE_USAGE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
FRAGMENT_DENSITY_MAP_BIT_EXT
Native value VK_IMAGE_USAGE_2_FRAGMENT_DENSITY_MAP_BIT_EXT.
Khronos reference: VK_IMAGE_USAGE_2_FRAGMENT_DENSITY_MAP_BIT_EXT
VIDEO_DECODE_DST_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_DECODE_DST_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_DECODE_DST_BIT_KHR
VIDEO_DECODE_SRC_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_DECODE_SRC_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_DECODE_SRC_BIT_KHR
VIDEO_DECODE_DPB_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_DECODE_DPB_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_DECODE_DPB_BIT_KHR
VIDEO_ENCODE_DST_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_ENCODE_DST_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_ENCODE_DST_BIT_KHR
VIDEO_ENCODE_SRC_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_ENCODE_SRC_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_ENCODE_SRC_BIT_KHR
VIDEO_ENCODE_DPB_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_ENCODE_DPB_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_ENCODE_DPB_BIT_KHR
INVOCATION_MASK_BIT_HUAWEI
Native value VK_IMAGE_USAGE_2_INVOCATION_MASK_BIT_HUAWEI.
Khronos reference: VK_IMAGE_USAGE_2_INVOCATION_MASK_BIT_HUAWEI
ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
Native value VK_IMAGE_USAGE_2_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT.
Khronos reference: VK_IMAGE_USAGE_2_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
SAMPLE_WEIGHT_BIT_QCOM
Native value VK_IMAGE_USAGE_2_SAMPLE_WEIGHT_BIT_QCOM.
SAMPLE_BLOCK_MATCH_BIT_QCOM
Native value VK_IMAGE_USAGE_2_SAMPLE_BLOCK_MATCH_BIT_QCOM.
Khronos reference: VK_IMAGE_USAGE_2_SAMPLE_BLOCK_MATCH_BIT_QCOM
HOST_TRANSFER_BIT_KHR
Native value VK_IMAGE_USAGE_2_HOST_TRANSFER_BIT_KHR.
TENSOR_ALIASING_BIT_ARM
Native value VK_IMAGE_USAGE_2_TENSOR_ALIASING_BIT_ARM.
VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR
VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR
Native value VK_IMAGE_USAGE_2_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR.
Khronos reference: VK_IMAGE_USAGE_2_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR
TILE_MEMORY_BIT_QCOM
Native value VK_IMAGE_USAGE_2_TILE_MEMORY_BIT_QCOM.
from_raw
as_raw
empty
Output
& operator.bitand
& operation. Read moreOutput-1
| operator.bitor
| operation. Read moreOutput-2
^ operator.bitxor
^ operation. Read moreclone
fmt
default
hash
Output-3
! operator.not
! operation. Read moreeq
self and other values to be equal, and is used by ==.Stvk::ImageUsageFlags2CreateInfoKHR
Contract
Native structure VkImageUsageFlags2CreateInfoKHR.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *mut c_voidNative field pNext.
usage
usage: ImageUsageFlags2KHRNative field usage.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_usage
Set native field usage without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageView
Contract
Raw Vulkan handle VkImageView.
Khronos reference: VkImageView
Calls using this identity must satisfy Vulkan lifetime and synchronization rules.
Fields
0
0: u64Methods and associated items
NULL
is_null
from_raw
as_raw
clone
fmt
default
hash
eq
self and other values to be equal, and is used by ==.Stvk::ImageViewAddressPropertiesNVX
Contract
Native structure VkImageViewAddressPropertiesNVX.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *mut c_voidNative field pNext.
device_address
device_address: DeviceAddressNative field deviceAddress.
size
size: DeviceSizeNative field size.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_device_address
Set native field deviceAddress without native effects.
set_size
Set native field size without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewASTCDecodeModeEXT
Contract
Native structure VkImageViewASTCDecodeModeEXT.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
decode_mode
decode_mode: FormatNative field decodeMode.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_decode_mode
Set native field decodeMode without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewCaptureDescriptorDataInfoEXT
Contract
Native structure VkImageViewCaptureDescriptorDataInfoEXT.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
image_view
image_view: ImageViewNative field imageView.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_image_view
Set native field imageView without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewCreateFlagBits
Contract
Open integer representation of VkImageViewCreateFlagBits.
Fields
0
0: u32Methods and associated items
FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT
Native value VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT.
Khronos reference: VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT
DESCRIPTOR_BUFFER_CAPTURE_REPLAY_BIT_EXT
Native value VK_IMAGE_VIEW_CREATE_DESCRIPTOR_BUFFER_CAPTURE_REPLAY_BIT_EXT.
Khronos reference: VK_IMAGE_VIEW_CREATE_DESCRIPTOR_BUFFER_CAPTURE_REPLAY_BIT_EXT
FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT
Native value VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT.
Khronos reference: VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT
from_raw
as_raw
empty
Output
& operator.bitand
& operation. Read moreOutput-1
| operator.bitor
| operation. Read moreOutput-2
^ operator.bitxor
^ operation. Read moreclone
fmt
default
hash
Output-3
! operator.not
! operation. Read moreeq
self and other values to be equal, and is used by ==.Stvk::ImageViewCreateInfo
Contract
Native structure VkImageViewCreateInfo.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
flags
flags: ImageViewCreateFlagsNative field flags.
image
image: ImageNative field image.
view_type
view_type: ImageViewTypeNative field viewType.
format
format: FormatNative field format.
components
components: ComponentMappingNative field components.
subresource_range
subresource_range: ImageSubresourceRangeNative field subresourceRange.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_flags
Set native field flags without native effects.
set_image
Set native field image without native effects.
set_view_type
Set native field viewType without native effects.
set_format
Set native field format without native effects.
set_components
Set native field components without native effects.
set_subresource_range
Set native field subresourceRange without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewHandleInfoNVX
Contract
Native structure VkImageViewHandleInfoNVX.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
image_view
image_view: ImageViewNative field imageView.
descriptor_type
descriptor_type: DescriptorTypeNative field descriptorType.
sampler
sampler: SamplerNative field sampler.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_image_view
Set native field imageView without native effects.
set_descriptor_type
Set native field descriptorType without native effects.
set_sampler
Set native field sampler without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewMinLodCreateInfoEXT
Contract
Native structure VkImageViewMinLodCreateInfoEXT.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
min_lod
min_lod: f32Native field minLod.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_min_lod
Set native field minLod without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewSampleWeightCreateInfoQCOM
Contract
Native structure VkImageViewSampleWeightCreateInfoQCOM.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
filter_center
filter_center: Offset2DNative field filterCenter.
filter_size
filter_size: Extent2DNative field filterSize.
num_phases
num_phases: u32Native field numPhases.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_filter_center
Set native field filterCenter without native effects.
set_filter_size
Set native field filterSize without native effects.
set_num_phases
Set native field numPhases without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.
default
Stvk::ImageViewSlicedCreateInfoEXT
Contract
Native structure VkImageViewSlicedCreateInfoEXT.
Fields
s_type
s_type: StructureTypeNative field sType.
p_next
p_next: *const c_voidNative field pNext.
slice_offset
slice_offset: u32Native field sliceOffset.
slice_count
slice_count: u32Native field sliceCount.
Methods and associated items
new
Construct the record with its canonical sType tag and default native state.
set_slice_offset
Set native field sliceOffset without native effects.
set_slice_count
Set native field sliceCount without native effects.
push_next
Prepend one registry-compatible node, retaining its exclusive borrow.
The node must have a null p_next and both headers must have canonical tags.
Existing links are never traversed and remain written after the borrow ends.
Type compatibility does not establish enabled extensions or Vulkan valid usage.
Errors
Returns a construction error for a changed structure tag or already-linked node.