Module org.freedesktop.cairo

Package org.freedesktop.cairo

Class TeeSurface

java.lang.Object

io.github.jwharm.cairobindings.Proxy

org.freedesktop.cairo.Surface

org.freedesktop.cairo.TeeSurface

All Implemented Interfaces:

AutoCloseable

public final class TeeSurface
extends Surface

The "tee" surface supports redirecting all its input to multiple surfaces.

Since:

1.10

See Also:

• Surface

Constructor Summary

Constructors

Constructor	Description
TeeSurface(MemorySegment address)	Constructor used internally to instantiate a java TeeSurface object for a native cairo_surface_t instance

Method Summary

Modifier and Type	Method	Description
void	add(Surface target)	Adds a new target surface to the list of replicas of a tee surface.
static TeeSurface	create(Surface primary)	Creates a new "tee" surface.
Surface	index(int index)	Retrieves the replica surface at the given index.
void	remove(Surface target)	Removes the given surface from the list of replicas of a tee surface.

Methods inherited from class org.freedesktop.cairo.Surface

close, copyPage, createForRectangle, createSimilar, createSimilarImage, destroy, finish, flush, getContent, getDevice, getDeviceOffset, getDeviceScale, getFallbackResolution, getFontOptions, getMimeData, getSurfaceType, getType, getUserData, hasShowTextGlyphs, mapToImage, markDirty, markDirtyRectangle, setDeviceOffset, setDeviceScale, setFallbackResolution, setMimeData, setUserData, showPage, status, supportsMimeType, unmapImage

Methods inherited from class io.github.jwharm.cairobindings.Proxy

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TeeSurface

public TeeSurface(MemorySegment address)

Constructor used internally to instantiate a java TeeSurface object for a native cairo_surface_t instance

Parameters:

address - the memory address of the native cairo_surface_t instance

Method Details

create

public static TeeSurface create(Surface primary)

Creates a new "tee" surface.

The primary surface is used when querying surface options, like font options and extents.

Operations performed on the tee surface will be replayed on any surface added to it.

Parameters:

primary - the primary Surface

Returns:

the newly created surface

Since:

1.10

add

public void add(Surface target)

Adds a new target surface to the list of replicas of a tee surface.

Parameters:

target - the surface to add

Since:

1.10

index

public Surface index(int index)

Retrieves the replica surface at the given index.

The primary surface used to create the TeeSurface is always set at the zero index.

Parameters:

index - the index of the replica to retrieve

Returns:

the surface at the given index

Since:

1.10

remove

public void remove(Surface target)

Removes the given surface from the list of replicas of a tee surface.

Parameters:

target - the surface to remove

Since:

1.10