Top Description Inners Fields Constructors Methods
org.lwjgl.vulkan

public Class VkClearValue

extends Struct<VkClearValue>
implements NativeResource
Class Inheritance
All Implemented Interfaces
org.lwjgl.system.NativeResource, java.lang.AutoCloseable
Imports
javax.annotation.*, java.nio.*, org.lwjgl.*, org.lwjgl.system.*

Structure specifying a clear value.
Description

This union is used where part of the API requires either color or depth/stencil clear values, depending on the attachment, and defines the initial clear values in the VkRenderPassBeginInfo structure.

See Also

VkClearAttachment, VkClearColorValue, VkClearDepthStencilValue, VkRenderPassBeginInfo, VkRenderingAttachmentInfo

Layout


union VkClearValue {
    VkClearColorValue color;
    VkClearDepthStencilValue depthStencil;
}

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static class
VkClearValue.Buffer

An array of VkClearValue structs.

Field Summary

Modifier and TypeField and Description
public static final int
ALIGNOF

The struct alignment in bytes.

public static final int
COLOR

The struct member offsets.

public static final int
DEPTHSTENCIL

The struct member offsets.

public static final int
SIZEOF

The struct size in bytes.

Inherited from org.lwjgl.system.Struct:
containerDEFAULT_ALIGN_ASDEFAULT_PACK_ALIGNMENT

Constructor Summary

AccessConstructor and Description
protected
VkClearValue(long address, ByteBuffer container)

public
VkClearValue(ByteBuffer container)

Creates a VkClearValue instance at the current position of the specified ByteBuffer container.

Method Summary

Modifier and TypeMethod and Description
public static VkClearValue
calloc()

Returns a new VkClearValue instance allocated with memCalloc.

public static VkClearValue.Buffer
calloc(int
the buffer capacity
capacity
)

Returns a new VkClearValue.Buffer instance allocated with memCalloc.

public static VkClearValue
calloc(MemoryStack
the stack from which to allocate
stack
)

Returns a new VkClearValue instance allocated on the specified MemoryStack and initializes all its bits to zero.

public static VkClearValue.Buffer
calloc(int
the buffer capacity
capacity
,
MemoryStack
the stack from which to allocate
stack
)

Returns a new VkClearValue.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.

public static VkClearValue
callocStack()

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue
callocStack(MemoryStack stack)

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue.Buffer
callocStack(int capacity)

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue.Buffer
callocStack(int capacity, MemoryStack stack)

Deprecated
Deprecated for removal in 3.4.0.
public VkClearColorValue
color()

specifies the color image clear values to use when clearing a color image or attachment.

public VkClearValue
color(VkClearColorValue value)

Copies the specified VkClearColorValue to the color field.

public VkClearValue
color(Consumer<VkClearColorValue> consumer)

Passes the color field to the specified Consumer.

protected VkClearValue
create(long
the struct memory address
address
,
ByteBuffer
an optional container buffer, to be referenced strongly by the struct instance.
container
)

Implements abstract org.lwjgl.system.Struct.create.

Similar to the constructor, but returns the exact type of the Struct subclass.
public static VkClearValue
create()

Returns a new VkClearValue instance allocated with BufferUtils.

public static VkClearValue
create(long address)

Returns a new VkClearValue instance for the specified memory address.

public static VkClearValue.Buffer
create(int
the buffer capacity
capacity
)

Returns a new VkClearValue.Buffer instance allocated with BufferUtils.

public static VkClearValue.Buffer
create(long
the memory address
address
,
int
the buffer capacity
capacity
)

Create a VkClearValue.Buffer instance at the specified memory.

public static VkClearValue
createSafe(long address)

Like create, but returns null if address is NULL.

public static VkClearValue.Buffer
createSafe(long address, int capacity)

Like create, but returns null if address is NULL.

public VkClearDepthStencilValue
depthStencil()

specifies the depth and stencil clear values to use when clearing a depth/stencil image or attachment.

public VkClearValue
public VkClearValue
depthStencil(Consumer<VkClearDepthStencilValue> consumer)

Passes the depthStencil field to the specified Consumer.

public static VkClearValue
malloc()

Returns a new VkClearValue instance allocated with memAlloc.

public static VkClearValue.Buffer
malloc(int
the buffer capacity
capacity
)

Returns a new VkClearValue.Buffer instance allocated with memAlloc.

public static VkClearValue
malloc(MemoryStack
the stack from which to allocate
stack
)

Returns a new VkClearValue instance allocated on the specified MemoryStack.

public static VkClearValue.Buffer
malloc(int
the buffer capacity
capacity
,
MemoryStack
the stack from which to allocate
stack
)

Returns a new VkClearValue.Buffer instance allocated on the specified MemoryStack.

public static VkClearValue
mallocStack()

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue
mallocStack(MemoryStack stack)

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue.Buffer
mallocStack(int capacity)

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearValue.Buffer
mallocStack(int capacity, MemoryStack stack)

Deprecated
Deprecated for removal in 3.4.0.
public static VkClearColorValue
ncolor(long struct)

Unsafe version of color.

public static void
ncolor(long struct, VkClearColorValue value)

Unsafe version of color.

public static VkClearDepthStencilValue
ndepthStencil(long struct)

Unsafe version of depthStencil.

public static void
ndepthStencil(long struct, VkClearDepthStencilValue value)

Unsafe version of depthStencil.

public VkClearValue

Returns:

this struct
set
(VkClearValue
the source struct
src
)

Copies the specified struct data to this struct.

public int
sizeof()

Implements abstract org.lwjgl.system.Struct.sizeof.

Returns sizeof(struct).
Inherited from org.lwjgl.system.Struct:
__array__array__array__checkContainer__checkMalloc__create__getContainer__getContainer__member__member__member__padding__padding__struct__struct__union__unionclearfreeisNullvalidate

Field Detail

ALIGNOFback to summary
public static final int ALIGNOF

The struct alignment in bytes.

COLORback to summary
public static final int COLOR

The struct member offsets.

DEPTHSTENCILback to summary
public static final int DEPTHSTENCIL

The struct member offsets.

SIZEOFback to summary
public static final int SIZEOF

The struct size in bytes.

Constructor Detail

VkClearValueback to summary
protected VkClearValue(long address, ByteBuffer container)
VkClearValueback to summary
public VkClearValue(ByteBuffer container)

Creates a VkClearValue instance at the current position of the specified ByteBuffer container. Changes to the buffer's content will be visible to the struct instance and vice versa.

The created instance holds a strong reference to the container object.

Method Detail

callocback to summary
public static VkClearValue calloc()

Returns a new VkClearValue instance allocated with memCalloc. The instance must be explicitly freed.

callocback to summary
public static VkClearValue.Buffer calloc(int capacity)

Returns a new VkClearValue.Buffer instance allocated with memCalloc. The instance must be explicitly freed.

Parameters
capacity:int

the buffer capacity

callocback to summary
public static VkClearValue calloc(MemoryStack stack)

Returns a new VkClearValue instance allocated on the specified MemoryStack and initializes all its bits to zero.

Parameters
stack:MemoryStack

the stack from which to allocate

callocback to summary
public static VkClearValue.Buffer calloc(int capacity, MemoryStack stack)

Returns a new VkClearValue.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.

Parameters
capacity:int

the buffer capacity

stack:MemoryStack

the stack from which to allocate

callocStackback to summary
public static VkClearValue callocStack()

Deprecated

Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.

Annotations
@Deprecated
callocStackback to summary
public static VkClearValue callocStack(MemoryStack stack)

Deprecated

Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.

Annotations
@Deprecated
callocStackback to summary
public static VkClearValue.Buffer callocStack(int capacity)

Deprecated

Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.

Annotations
@Deprecated
callocStackback to summary
public static VkClearValue.Buffer callocStack(int capacity, MemoryStack stack)

Deprecated

Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.

Annotations
@Deprecated
colorback to summary
public VkClearColorValue color()

specifies the color image clear values to use when clearing a color image or attachment.

colorback to summary
public VkClearValue color(VkClearColorValue value)

Copies the specified VkClearColorValue to the color field.

colorback to summary
public VkClearValue color(Consumer<VkClearColorValue> consumer)

Passes the color field to the specified Consumer.

createback to summary
protected VkClearValue create(long address, ByteBuffer container)

Implements abstract org.lwjgl.system.Struct.create.

Doc from org.lwjgl.system.Struct.create.

Similar to the constructor, but returns the exact type of the Struct subclass.

Effectively, every Struct instance is a factory for more instances of the same type. This is used by StructBuffer.

Parameters
address:long

the struct memory address

container:ByteBuffer

an optional container buffer, to be referenced strongly by the struct instance.

Annotations
@Override
createback to summary
public static VkClearValue create()

Returns a new VkClearValue instance allocated with BufferUtils.

createback to summary
public static VkClearValue create(long address)

Returns a new VkClearValue instance for the specified memory address.

createback to summary
public static VkClearValue.Buffer create(int capacity)

Returns a new VkClearValue.Buffer instance allocated with BufferUtils.

Parameters
capacity:int

the buffer capacity

createback to summary
public static VkClearValue.Buffer create(long address, int capacity)

Create a VkClearValue.Buffer instance at the specified memory.

Parameters
address:long

the memory address

capacity:int

the buffer capacity

createSafeback to summary
public static VkClearValue createSafe(long address)

Like create, but returns null if address is NULL.

Annotations
@Nullable
createSafeback to summary
public static VkClearValue.Buffer createSafe(long address, int capacity)

Like create, but returns null if address is NULL.

Annotations
@Nullable
depthStencilback to summary
public VkClearDepthStencilValue depthStencil()

specifies the depth and stencil clear values to use when clearing a depth/stencil image or attachment.

depthStencilback to summary
public VkClearValue depthStencil(VkClearDepthStencilValue value)

Copies the specified VkClearDepthStencilValue to the depthStencil field.

depthStencilback to summary
public VkClearValue depthStencil(Consumer<VkClearDepthStencilValue> consumer)

Passes the depthStencil field to the specified Consumer.

mallocback to summary
public static VkClearValue malloc()

Returns a new VkClearValue instance allocated with memAlloc. The instance must be explicitly freed.

mallocback to summary
public static VkClearValue.Buffer malloc(int capacity)

Returns a new VkClearValue.Buffer instance allocated with memAlloc. The instance must be explicitly freed.

Parameters
capacity:int

the buffer capacity

mallocback to summary
public static VkClearValue malloc(MemoryStack stack)

Returns a new VkClearValue instance allocated on the specified MemoryStack.

Parameters
stack:MemoryStack

the stack from which to allocate

mallocback to summary
public static VkClearValue.Buffer malloc(int capacity, MemoryStack stack)

Returns a new VkClearValue.Buffer instance allocated on the specified MemoryStack.

Parameters
capacity:int

the buffer capacity

stack:MemoryStack

the stack from which to allocate

mallocStackback to summary
public static VkClearValue mallocStack()

Deprecated

Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.

Annotations
@Deprecated
mallocStackback to summary
public static VkClearValue mallocStack(MemoryStack stack)

Deprecated

Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.

Annotations
@Deprecated
mallocStackback to summary
public static VkClearValue.Buffer mallocStack(int capacity)

Deprecated

Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.

Annotations
@Deprecated
mallocStackback to summary
public static VkClearValue.Buffer mallocStack(int capacity, MemoryStack stack)

Deprecated

Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.

Annotations
@Deprecated
ncolorback to summary
public static VkClearColorValue ncolor(long struct)

Unsafe version of color.

ncolorback to summary
public static void ncolor(long struct, VkClearColorValue value)

Unsafe version of color.

ndepthStencilback to summary
public static VkClearDepthStencilValue ndepthStencil(long struct)

Unsafe version of depthStencil.

ndepthStencilback to summary
public static void ndepthStencil(long struct, VkClearDepthStencilValue value)

Unsafe version of depthStencil.

setback to summary
public VkClearValue set(VkClearValue src)

Copies the specified struct data to this struct.

Parameters
src:VkClearValue

the source struct

Returns:VkClearValue

this struct

sizeofback to summary
public int sizeof()

Implements abstract org.lwjgl.system.Struct.sizeof.

Doc from org.lwjgl.system.Struct.sizeof.

Returns sizeof(struct).

Annotations
@Override
org.lwjgl.vulkan back to summary

public Class VkClearValue.Buffer

extends StructBuffer<VkClearValue, VkClearValue.Buffer>
implements NativeResource
Class Inheritance
All Implemented Interfaces
org.lwjgl.system.NativeResource, java.lang.AutoCloseable

An array of VkClearValue structs.

Field Summary

Modifier and TypeField and Description
private static final VkClearValue

Constructor Summary

AccessConstructor and Description
public
Buffer(ByteBuffer container)

Creates a new VkClearValue.Buffer instance backed by the specified container.

public
Buffer(long address, int cap)

pack-priv
Buffer(long address, ByteBuffer container, int mark, int pos, int lim, int cap)

Method Summary

Modifier and TypeMethod and Description
public VkClearColorValue

Returns:

a VkClearColorValue view of the VkClearValue#color field.
color
()

public VkClearValue.Buffer
color(VkClearColorValue value)

Copies the specified VkClearColorValue to the VkClearValue#color field.

public VkClearValue.Buffer
color(Consumer<VkClearColorValue> consumer)

Passes the VkClearValue#color field to the specified Consumer.

public VkClearDepthStencilValue
public VkClearValue.Buffer
public VkClearValue.Buffer
protected VkClearValue
protected VkClearValue.Buffer
Inherited from org.lwjgl.system.StructBuffer:
applyapplyforEachgetgetgetgetiteratorparallelStreamputputsizeofspliteratorstream

Field Detail

ELEMENT_FACTORYback to summary
private static final VkClearValue ELEMENT_FACTORY

Constructor Detail

Bufferback to summary
public Buffer(ByteBuffer container)

Creates a new VkClearValue.Buffer instance backed by the specified container.

Changes to the container's content will be visible to the struct buffer instance and vice versa. The two buffers' position, limit, and mark values will be independent. The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by VkClearValue#SIZEOF, and its mark will be undefined.

The created buffer instance holds a strong reference to the container object.

Bufferback to summary
public Buffer(long address, int cap)
Bufferback to summary
pack-priv Buffer(long address, ByteBuffer container, int mark, int pos, int lim, int cap)

Method Detail

colorback to summary
public VkClearColorValue color()
Returns:VkClearColorValue

a VkClearColorValue view of the VkClearValue#color field.

colorback to summary
public VkClearValue.Buffer color(VkClearColorValue value)

Copies the specified VkClearColorValue to the VkClearValue#color field.

colorback to summary
public VkClearValue.Buffer color(Consumer<VkClearColorValue> consumer)

Passes the VkClearValue#color field to the specified Consumer.

depthStencilback to summary
public VkClearDepthStencilValue depthStencil()
Returns:VkClearDepthStencilValue

a VkClearDepthStencilValue view of the VkClearValue#depthStencil field.

depthStencilback to summary
public VkClearValue.Buffer depthStencil(VkClearDepthStencilValue value)

Copies the specified VkClearDepthStencilValue to the VkClearValue#depthStencil field.

depthStencilback to summary
public VkClearValue.Buffer depthStencil(Consumer<VkClearDepthStencilValue> consumer)

Passes the VkClearValue#depthStencil field to the specified Consumer.

getElementFactoryback to summary
protected VkClearValue getElementFactory()

Implements abstract org.lwjgl.system.StructBuffer.getElementFactory.

Annotations
@Override
selfback to summary
protected VkClearValue.Buffer self()

Implements abstract org.lwjgl.system.CustomBuffer.self.

Annotations
@Override