Classes
struct	PartialUpdateRegion
	A region to update. More...
class	AbstractTileData
	Abstract class to load tile data when using the PartialUpdateChecker. More...
class	NoTileData
	Class to not load any tile specific data when iterating over changes. More...
class	ImageTileData
	Load the ImageTile and ImBuf associated with the partial change. More...
struct	PartialUpdateChecker
struct	PartialUpdateUserImpl
struct	TileChangeset
	Dirty chunks of an ImageTile. More...
struct	Changeset
	Changeset keeping track of changes for an image. More...
struct	PartialUpdateRegisterImpl
	Partial update changes stored inside the image runtime. More...
class	ImagePartialUpdateTest

Typedefs
using	ChangesetID = int64_t

Enumerations
enum class	ePartialUpdateCollectResult { FullUpdateNeeded , NoChangesDetected , PartialChangesDetected }
	Result codes of BKE_image_partial_update_collect_changes. More...
enum class	ePartialUpdateIterResult { Finished = 0 , ChangeAvailable = 1 }
	Return codes of BKE_image_partial_update_get_next_change. More...

Functions
ePartialUpdateCollectResult	BKE_image_partial_update_collect_changes (Image image, PartialUpdateUser user)
	collect the partial update since the last request.
ePartialUpdateIterResult	BKE_image_partial_update_get_next_change (PartialUpdateUser user, PartialUpdateRegion r_region)
static int	chunk_number_for_pixel (int pixel_offset)
	get the chunk number for the give pixel coordinate.
static PartialUpdateUser *	wrap (PartialUpdateUserImpl *user)
static PartialUpdateUserImpl *	unwrap (PartialUpdateUser *user)
static PartialUpdateRegister *	wrap (PartialUpdateRegisterImpl *partial_update_register)
static PartialUpdateRegisterImpl *	unwrap (PartialUpdateRegister *partial_update_register)
static PartialUpdateRegister *	image_partial_update_register_ensure (Image *image)
	TEST_F (ImagePartialUpdateTest, mark_full_update)
	TEST_F (ImagePartialUpdateTest, mark_single_tile)
	TEST_F (ImagePartialUpdateTest, mark_unconnected_tiles)
	TEST_F (ImagePartialUpdateTest, donot_mark_outside_image)
	TEST_F (ImagePartialUpdateTest, mark_inside_image)
	TEST_F (ImagePartialUpdateTest, sequential_mark_region)
	TEST_F (ImagePartialUpdateTest, mark_multiple_chunks)
	TEST_F (ImagePartialUpdateTest, iterator)

Variables
constexpr int	CHUNK_SIZE = 256
	Size of chunks to track changes.
constexpr int	MAX_HISTORY_LEN = 4
	Max number of changesets to keep in history.
constexpr ChangesetID	UnknownChangesetID = -1
constexpr float	black_color [4] = {0.0f, 0.0f, 0.0f, 1.0f}

Typedef Documentation

◆ ChangesetID

using blender::bke::image::partial_update::ChangesetID = int64_t

Definition at line 130 of file image_partial_update.cc.

Enumeration Type Documentation

◆ ePartialUpdateCollectResult

enum class blender::bke::image::partial_update::ePartialUpdateCollectResult

strong

Result codes of BKE_image_partial_update_collect_changes.

Image partial updates.

Enumerator
FullUpdateNeeded	Unable to construct partial updates. Caller should perform a full update.
NoChangesDetected	No changes detected since the last time requested.
PartialChangesDetected	Changes detected since the last time requested.

Definition at line 37 of file BKE_image_partial_update.hh.

◆ ePartialUpdateIterResult

enum class blender::bke::image::partial_update::ePartialUpdateIterResult

strong

Return codes of BKE_image_partial_update_get_next_change.

Enumerator
Finished	no tiles left when iterating over tiles.
ChangeAvailable	a chunk was available and has been loaded.

Definition at line 68 of file BKE_image_partial_update.hh.

Function Documentation

◆ BKE_image_partial_update_collect_changes()

ePartialUpdateCollectResult blender::bke::image::partial_update::BKE_image_partial_update_collect_changes	(	Image *	image,
		PartialUpdateUser *	user )

collect the partial update since the last request.

Invoke BKE_image_partial_update_get_next_change to iterate over the collected tiles.

Returns

#ePartialUpdateCollectResult::FullUpdateNeeded: called should not use partial updates but recalculate the full image. This result can be expected when called for the first time for a user and when it isn't possible to reconstruct the changes as the internal state doesn't have enough data stored.
#ePartialUpdateCollectResult::NoChangesDetected: There have been no changes detected since last invoke for the same user.
#ePartialUpdateCollectResult::PartialChangesDetected: Parts of the image has been updated since last invoke for the same user. The changes can be read by using BKE_image_partial_update_get_next_change.

Definition at line 470 of file image_partial_update.cc.

Referenced by blender::bke::image::partial_update::PartialUpdateChecker< TileData >::collect_changes(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), and TEST_F().

◆ BKE_image_partial_update_get_next_change()

ePartialUpdateIterResult blender::bke::image::partial_update::BKE_image_partial_update_get_next_change	(	PartialUpdateUser *	user,
		PartialUpdateRegion *	r_region )

Definition at line 528 of file image_partial_update.cc.

References ChangeAvailable, Finished, unwrap(), and blender::bke::image::partial_update::PartialUpdateUserImpl::updated_regions.

Referenced by blender::bke::image::partial_update::PartialUpdateChecker< TileData >::CollectResult::get_next_change(), TEST_F(), TEST_F(), TEST_F(), and TEST_F().

◆ chunk_number_for_pixel()

int blender::bke::image::partial_update::chunk_number_for_pixel ( int pixel_offset )

static

get the chunk number for the give pixel coordinate.

As chunks are squares this member can be used for both x and y axis.

Definition at line 86 of file image_partial_update.cc.

References CHUNK_SIZE.

Referenced by blender::bke::image::partial_update::TileChangeset::mark_region().

◆ image_partial_update_register_ensure()

PartialUpdateRegister * blender::bke::image::partial_update::image_partial_update_register_ensure ( Image * image )

static

Definition at line 460 of file image_partial_update.cc.

References wrap().

Referenced by BKE_image_partial_update_collect_changes(), BKE_image_partial_update_mark_full_update(), and BKE_image_partial_update_mark_region().

◆ TEST_F() [1/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		donot_mark_outside_image	)

Definition at line 181 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), EXPECT_EQ(), FullUpdateNeeded, NoChangesDetected, and result.

◆ TEST_F() [2/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		iterator	)

Definition at line 363 of file image_partial_update_test.cc.

References BKE_image_partial_update_mark_region(), BLI_rcti_init(), BLI_rcti_isect(), ChangeAvailable, blender::bke::image::partial_update::PartialUpdateChecker< TileData >::CollectResult::changed_region, blender::bke::image::partial_update::PartialUpdateChecker< TileData >::collect_changes(), EXPECT_EQ(), FullUpdateNeeded, blender::bke::image::partial_update::PartialUpdateChecker< TileData >::CollectResult::get_next_change(), blender::bke::image::partial_update::PartialUpdateChecker< TileData >::CollectResult::get_result_code(), NoChangesDetected, PartialChangesDetected, and blender::bke::image::partial_update::PartialUpdateRegion::region.

◆ TEST_F() [3/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		mark_full_update	)

Definition at line 91 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_mark_full_update(), EXPECT_EQ(), FullUpdateNeeded, NoChangesDetected, and result.

◆ TEST_F() [4/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		mark_inside_image	)

Definition at line 236 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), EXPECT_EQ(), FullUpdateNeeded, NoChangesDetected, PartialChangesDetected, and result.

◆ TEST_F() [5/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		mark_multiple_chunks	)

Definition at line 332 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_get_next_change(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), BLI_rcti_isect(), ChangeAvailable, EXPECT_EQ(), FullUpdateNeeded, NoChangesDetected, PartialChangesDetected, blender::bke::image::partial_update::PartialUpdateRegion::region, and result.

◆ TEST_F() [6/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		mark_single_tile	)

Definition at line 111 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_get_next_change(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), BLI_rcti_inside_rcti(), ChangeAvailable, EXPECT_EQ(), Finished, FullUpdateNeeded, NoChangesDetected, PartialChangesDetected, blender::bke::image::partial_update::PartialUpdateRegion::region, and result.

◆ TEST_F() [7/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		mark_unconnected_tiles	)

Definition at line 143 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_get_next_change(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), BLI_rcti_inside_rcti(), ChangeAvailable, EXPECT_EQ(), Finished, FullUpdateNeeded, NoChangesDetected, PartialChangesDetected, blender::bke::image::partial_update::PartialUpdateRegion::region, and result.

◆ TEST_F() [8/8]

blender::bke::image::partial_update::TEST_F	(	ImagePartialUpdateTest	,
		sequential_mark_region	)

Definition at line 275 of file image_partial_update_test.cc.

References BKE_image_partial_update_collect_changes(), BKE_image_partial_update_get_next_change(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), BLI_rcti_inside_rcti(), ChangeAvailable, EXPECT_EQ(), Finished, FullUpdateNeeded, NoChangesDetected, PartialChangesDetected, blender::bke::image::partial_update::PartialUpdateRegion::region, and result.

◆ unwrap() [1/2]

PartialUpdateRegisterImpl * blender::bke::image::partial_update::unwrap ( PartialUpdateRegister * partial_update_register )

static

Unwrap the PartialUpdateRegister C-struct to its CPP counterpart (PartialUpdateRegisterImpl).

Definition at line 125 of file image_partial_update.cc.

◆ unwrap() [2/2]

PartialUpdateUserImpl * blender::bke::image::partial_update::unwrap ( PartialUpdateUser * user )

static

Unwrap the PartialUpdateUser C-struct to its CPP counterpart (PartialUpdateUserImpl).

Definition at line 109 of file image_partial_update.cc.

Referenced by BKE_image_partial_update_collect_changes(), BKE_image_partial_update_free(), BKE_image_partial_update_get_next_change(), BKE_image_partial_update_mark_full_update(), BKE_image_partial_update_mark_region(), and BKE_image_partial_update_register_free().

◆ wrap() [1/2]

PartialUpdateRegister * blender::bke::image::partial_update::wrap ( PartialUpdateRegisterImpl * partial_update_register )

static

Wrap PartialUpdateRegisterImpl to its C-struct (PartialUpdateRegister).

Definition at line 117 of file image_partial_update.cc.

◆ wrap() [2/2]

PartialUpdateUser * blender::bke::image::partial_update::wrap ( PartialUpdateUserImpl * user )

static

Wrap PartialUpdateUserImpl to its C-struct (PartialUpdateUser).

Definition at line 101 of file image_partial_update.cc.

Referenced by BKE_image_partial_update_create(), and image_partial_update_register_ensure().

Variable Documentation

◆ black_color

float blender::bke::image::partial_update::black_color[4] = {0.0f, 0.0f, 0.0f, 1.0f}

constexpr

Definition at line 26 of file image_partial_update_test.cc.

◆ CHUNK_SIZE

int blender::bke::image::partial_update::CHUNK_SIZE = 256

constexpr

Size of chunks to track changes.

Definition at line 67 of file image_partial_update.cc.

Referenced by BKE_image_partial_update_collect_changes(), chunk_number_for_pixel(), and blender::bke::image::partial_update::TileChangeset::update_resolution().

◆ MAX_HISTORY_LEN

int blender::bke::image::partial_update::MAX_HISTORY_LEN = 4

constexpr

Max number of changesets to keep in history.

A higher number would need more memory and processing to calculate a changeset, but would lead to do partial updates for requests that don't happen every frame.

A to small number would lead to more full updates when changes couldn't be reconstructed from the available history.

Definition at line 79 of file image_partial_update.cc.

Referenced by blender::bke::image::partial_update::PartialUpdateRegisterImpl::limit_history().

◆ UnknownChangesetID

ChangesetID blender::bke::image::partial_update::UnknownChangesetID = -1

constexpr

Definition at line 131 of file image_partial_update.cc.

Classes

Typedefs

Enumerations

Functions

Variables

Typedef Documentation

◆ ChangesetID

Enumeration Type Documentation

◆ ePartialUpdateCollectResult

◆ ePartialUpdateIterResult

Function Documentation

◆ BKE_image_partial_update_collect_changes()

◆ BKE_image_partial_update_get_next_change()

◆ chunk_number_for_pixel()

◆ image_partial_update_register_ensure()

◆ TEST_F() [1/8]

◆ TEST_F() [2/8]

◆ TEST_F() [3/8]

◆ TEST_F() [4/8]

◆ TEST_F() [5/8]

◆ TEST_F() [6/8]

◆ TEST_F() [7/8]

◆ TEST_F() [8/8]

◆ unwrap() [1/2]

◆ unwrap() [2/2]

◆ wrap() [1/2]

◆ wrap() [2/2]

Variable Documentation

◆ black_color

◆ CHUNK_SIZE

◆ MAX_HISTORY_LEN

◆ UnknownChangesetID