yaze::zelda3::ObjectDrawer Class Reference

Draws dungeon objects to background buffers using game patterns. More...

#include <object_drawer.h>

Collaboration diagram for yaze::zelda3::ObjectDrawer:

Classes
struct	DoorDef
struct	TileTrace
struct	TraceContext

Public Member Functions
	ObjectDrawer (Rom *rom, int room_id, const uint8_t *room_gfx_buffer=nullptr)
absl::Status	DrawObject (const RoomObject &object, gfx::BackgroundBuffer &bg1, gfx::BackgroundBuffer &bg2, const gfx::PaletteGroup &palette_group, const DungeonState *state=nullptr, gfx::BackgroundBuffer *layout_bg1=nullptr)
	Draw a room object to background buffers.
void	ResetChestIndex ()
void	SetAllowTrackCornerAliases (bool allow)
void	SetBG1RevealMaskSource (gfx::BG1RevealMaskSource source)
void	DrawDoor (const DoorDef &door, int door_index, gfx::BackgroundBuffer &bg1, gfx::BackgroundBuffer &bg2, const DungeonState *state=nullptr)
	Draw a door to background buffers.
void	DrawPotItem (uint8_t item_id, int x, int y, gfx::BackgroundBuffer &bg)
	Draw a pot item visualization.
absl::Status	DrawObjectList (const std::vector< RoomObject > &objects, gfx::BackgroundBuffer &bg1, gfx::BackgroundBuffer &bg2, const gfx::PaletteGroup &palette_group, const DungeonState *state=nullptr, gfx::BackgroundBuffer *layout_bg1=nullptr, bool reset_room_event_indices=true)
	Draw all objects in a room.
int	GetDrawRoutineId (int16_t object_id) const
	Get draw routine ID for an object.
int	GetDrawRoutineCount () const
	Get the total number of registered draw routines.
void	InitializeDrawRoutines ()
	Initialize draw routine registry Must be called before drawing objects.
void	DrawTileToBitmap (gfx::Bitmap &bitmap, const gfx::TileInfo &tile_info, int pixel_x, int pixel_y, const uint8_t *tiledata)
	Draw a single tile directly to bitmap.
absl::Status	DrawRoomDrawObjectData2x2 (uint16_t object_id, int tile_x, int tile_y, RoomObject::LayerType layer, uint16_t room_draw_object_data_offset, gfx::BackgroundBuffer &bg1, gfx::BackgroundBuffer &bg2)
	Draw a fixed 2x2 (16x16) tile pattern from RoomDrawObjectData.
std::pair< int, int >	CalculateObjectDimensions (const RoomObject &object)
	Calculate the dimensions (width, height) of an object in pixels.
void	SetTraceCollector (std::vector< TileTrace > *collector, bool trace_only=false)
void	ClearTraceCollector ()
bool	TraceOnly () const

Protected Types
using	DrawRoutine

Protected Member Functions
void	DrawChest (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawBigChest (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawBigKeyLock (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawNothing (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	CustomDraw (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawRightwards4x4_1to16 (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawRightwardsDecor4x3spaced4_1to16 (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawLargeCanvasObject (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, int width, int height)
void	DrawCustomObject (const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state=nullptr)
void	DrawMissingCustomObjectPlaceholder (gfx::BackgroundBuffer &bg, int tile_x, int tile_y)
void	DrawUsingRegistryRoutine (int routine_id, const RoomObject &obj, gfx::BackgroundBuffer &bg, std::span< const gfx::TileInfo > tiles, const DungeonState *state)
void	WriteTile8 (gfx::BackgroundBuffer &bg, int tile_x, int tile_y, const gfx::TileInfo &tile_info)
bool	IsValidTilePosition (int tile_x, int tile_y) const
void	MarkBg1RectRevealed (gfx::BackgroundBuffer &bg1, int start_px, int start_py, int pixel_width, int pixel_height)
void	MarkBg1OpaqueTilePixelsRevealed (gfx::BackgroundBuffer &bg1, const gfx::TileInfo &tile_info, int pixel_x, int pixel_y, const uint8_t *tiledata)
void	DrawDoorIndicator (gfx::BackgroundBuffer &bg, int tile_x, int tile_y, int width, int height, DoorType type, DoorDirection direction)
void	SetTraceContext (const RoomObject &object, RoomObject::LayerType layer)
void	PushTrace (int tile_x, int tile_y, const gfx::TileInfo &tile_info)

Static Protected Member Functions
static bool	RoutineDrawsToBothBGs (int routine_id)
static bool	RequiresRectangularBg1Mask (const RoomObject &object)
static void	TraceHookThunk (gfx::BackgroundBuffer *bg, int tile_x, int tile_y, const gfx::TileInfo &tile_info, void *user_data)

Protected Attributes
std::vector< DrawRoutine >	draw_routines_
bool	routines_initialized_ = false
TraceContext	trace_context_ {}
std::vector< TileTrace > *	trace_collector_ = nullptr
bool	trace_only_ = false
Rom *	rom_
int	room_id_
int	current_chest_index_ = 0
int	current_room_event_index_ = 0
bool	allow_track_corner_aliases_ = true
gfx::BackgroundBuffer *	registry_secondary_bg_ = nullptr
RoomObject::LayerType	registry_primary_layer_ = RoomObject::LayerType::BG1
RoomObject::LayerType	registry_secondary_layer_ = RoomObject::LayerType::BG2
gfx::BackgroundBuffer *	active_object_bg1_mask_ = nullptr
gfx::BackgroundBuffer *	active_layout_bg1_mask_ = nullptr
gfx::BackgroundBuffer *	active_mask_source_bg_ = nullptr
gfx::BG1RevealMaskSource	bg1_reveal_mask_source_
const uint8_t *	room_gfx_buffer_

Static Protected Attributes
static constexpr int	kMaxTilesX = 64
static constexpr int	kMaxTilesY = 64

Detailed Description

Draws dungeon objects to background buffers using game patterns.

This class interprets object IDs and draws them to BG1/BG2 buffers using the patterns extracted from the game's drawing routines. Based on ZScream's DungeonObjectData.cs and Subtype1_Draw.cs patterns.

Architecture:

1. Load tile data from ROM for the object
2. Look up draw routine ID from object ID mapping
3. Execute appropriate draw routine with size/orientation
4. Write tiles to BackgroundBuffer according to pattern
5. Handle palette coordination and graphics sheet access

Definition at line 36 of file object_drawer.h.

Member Typedef Documentation

DrawRoutine

using yaze::zelda3::ObjectDrawer::DrawRoutine

protected

Initial value:

 std::function<void(
      ObjectDrawer*, const RoomObject&, gfx::BackgroundBuffer&,
      std::span<const gfx::TileInfo>, const DungeonState*)>

Definition at line 200 of file object_drawer.h.

Constructor & Destructor Documentation

ObjectDrawer()

yaze::zelda3::ObjectDrawer::ObjectDrawer ( Rom * rom, int room_id, const uint8_t * room_gfx_buffer = nullptr )

explicit

Definition at line 81 of file object_drawer.cc.

References InitializeDrawRoutines().

Here is the call graph for this function:

Member Function Documentation

DrawObject()

absl::Status yaze::zelda3::ObjectDrawer::DrawObject	(	const RoomObject &	object,
		gfx::BackgroundBuffer &	bg1,
		gfx::BackgroundBuffer &	bg2,
		const gfx::PaletteGroup &	palette_group,
		const DungeonState *	state = nullptr,
		gfx::BackgroundBuffer *	layout_bg1 = nullptr )

Draw a room object to background buffers.

Parameters

object	The object to draw
bg1	Background layer 1 buffer (object buffer)
bg2	Background layer 2 buffer (object buffer)
palette_group	Current palette group for color mapping
layout_bg1	Optional second BG1 target for room-object reveal masks

Returns

Status of the drawing operation

Definition at line 215 of file object_drawer.cc.

References active_layout_bg1_mask_, active_mask_source_bg_, active_object_bg1_mask_, allow_track_corner_aliases_, yaze::zelda3::RoomObject::BG1, yaze::zelda3::RoomObject::BG2, yaze::zelda3::DrawRoutineUtils::ClearTraceHook(), draw_routines_, DrawCustomObject(), yaze::core::FeatureFlags::get(), yaze::zelda3::CustomObjectManager::Get(), yaze::zelda3::DimensionService::Get(), yaze::zelda3::DrawRoutineRegistry::Get(), yaze::zelda3::ObjectDimensionTable::Get(), GetDrawRoutineId(), yaze::zelda3::CustomObjectManager::GetObjectInternal(), yaze::zelda3::DrawRoutineRegistry::GetRoutineInfo(), yaze::zelda3::DimensionService::GetSelectionBoundsPixels(), yaze::Rom::is_loaded(), yaze::zelda3::DrawRoutineIds::kAutoStairs, yaze::core::FeatureFlags::Flags::kEnableCustomObjects, yaze::zelda3::DrawRoutineIds::kSpiralStairsGoingDownLower, yaze::zelda3::DrawRoutineIds::kSpiralStairsGoingDownUpper, yaze::zelda3::DrawRoutineIds::kSpiralStairsGoingUpLower, yaze::zelda3::DrawRoutineIds::kSpiralStairsGoingUpUpper, yaze::zelda3::DrawRoutineIds::kStraightInterRoomStairs, yaze::zelda3::ObjectDimensionTable::LoadFromRom(), LOG_DEBUG, LOG_WARN, MarkBg1RectRevealed(), yaze::zelda3::DrawRoutineInfo::min_tiles, yaze::zelda3::DrawRoutineInfo::name, registry_primary_layer_, registry_secondary_bg_, registry_secondary_layer_, RequiresRectangularBg1Mask(), rom_, RoutineDrawsToBothBGs(), routines_initialized_, yaze::zelda3::RoomObject::SetRom(), SetTraceContext(), yaze::zelda3::DrawRoutineUtils::SetTraceHook(), trace_collector_, trace_only_, TraceHookThunk(), and WriteTile8().

Referenced by yaze::editor::anonymous_namespace{dungeon_canvas_issue_report.cc}::BuildObjectTraceReport(), yaze::zelda3::ObjectTileEditor::CaptureObjectLayout(), DrawObjectList(), yaze::emu::render::EmulatorRenderService::RenderDungeonObjectStatic(), and yaze::editor::TileObjectHandler::RenderGhostPreviewBitmap().

ResetChestIndex()

void yaze::zelda3::ObjectDrawer::ResetChestIndex ( )

inline

Definition at line 74 of file object_drawer.h.

References current_chest_index_, and current_room_event_index_.

Referenced by DrawObjectList().

SetAllowTrackCornerAliases()

void yaze::zelda3::ObjectDrawer::SetAllowTrackCornerAliases ( bool allow )

inline

Definition at line 78 of file object_drawer.h.

References allow_track_corner_aliases_.

Referenced by yaze::zelda3::RoomLayout::Draw(), and yaze::zelda3::Room::RenderObjectsToBackground().

SetBG1RevealMaskSource()

void yaze::zelda3::ObjectDrawer::SetBG1RevealMaskSource ( gfx::BG1RevealMaskSource source )

inline

Definition at line 81 of file object_drawer.h.

References bg1_reveal_mask_source_.

Referenced by yaze::zelda3::RoomLayout::Draw(), and yaze::zelda3::Room::RenderObjectsToBackground().

DrawDoor()

void yaze::zelda3::ObjectDrawer::DrawDoor	(	const DoorDef &	door,
		int	door_index,
		gfx::BackgroundBuffer &	bg1,
		gfx::BackgroundBuffer &	bg2,
		const DungeonState *	state = nullptr )

Draw a door to background buffers.

Parameters

door	Door definition (type, direction, position)
bg1	Background layer 1 buffer
bg2	Background layer 2 buffer

Definition at line 1442 of file object_drawer.cc.

References bg1_reveal_mask_source_, yaze::gfx::BackgroundBuffer::bitmap(), yaze::zelda3::BottomShutterLower, yaze::zelda3::BottomSidedShutter, yaze::gfx::BackgroundBuffer::ClearBG1RevealMaskRect(), yaze::zelda3::CurtainDoor, yaze::Rom::data(), yaze::zelda3::ObjectDrawer::DoorDef::direction, yaze::zelda3::DoubleSidedShutter, yaze::zelda3::DoubleSidedShutterLower, DrawDoorIndicator(), DrawTileToBitmap(), yaze::zelda3::East, yaze::zelda3::ExplicitRoomDoor, yaze::zelda3::ExplodingWall, yaze::zelda3::ObjectDrawer::DoorDef::GetDimensions(), yaze::zelda3::GetDoorDimensions(), yaze::zelda3::GetDoorDirectionName(), yaze::zelda3::GetDoorTypeName(), yaze::zelda3::ObjectDrawer::DoorDef::GetTileCoords(), yaze::Rom::is_loaded(), yaze::zelda3::DungeonState::IsDoorOpen(), yaze::zelda3::kDoorGfxDown, yaze::zelda3::kDoorGfxLeft, yaze::zelda3::kDoorGfxRight, yaze::zelda3::kDoorGfxUp, LOG_DEBUG, yaze::gfx::BackgroundBuffer::mutable_coverage_data(), yaze::gfx::BackgroundBuffer::mutable_priority_data(), yaze::zelda3::NormalDoor, yaze::zelda3::NormalDoorOneSidedShutter, yaze::zelda3::North, yaze::zelda3::ObjectDrawer::DoorDef::position, rom_, room_gfx_buffer_, room_id_, yaze::Rom::size(), yaze::zelda3::South, yaze::zelda3::TopShutterLower, yaze::zelda3::TopSidedShutter, yaze::zelda3::ObjectDrawer::DoorDef::type, yaze::zelda3::West, yaze::zelda3::DoorDimensions::width_tiles, and yaze::gfx::WordToTileInfo().

Referenced by yaze::zelda3::Room::RenderObjectsToBackground().

DrawPotItem()

void yaze::zelda3::ObjectDrawer::DrawPotItem	(	uint8_t	item_id,
		int	x,
		int	y,
		gfx::BackgroundBuffer &	bg )

Draw a pot item visualization.

Parameters

item_id	Item ID
x	X coordinate (pixels)
y	Y coordinate (pixels)
bg	Background buffer

Definition at line 3297 of file object_drawer.cc.

References yaze::gfx::BackgroundBuffer::bitmap(), yaze::gfx::BackgroundBuffer::ClearBG1RevealMaskRect(), and yaze::gfx::BackgroundBuffer::mutable_coverage_data().

Referenced by yaze::zelda3::Room::RenderObjectsToBackground().

Here is the call graph for this function:

DrawObjectList()

absl::Status yaze::zelda3::ObjectDrawer::DrawObjectList	(	const std::vector< RoomObject > &	objects,
		gfx::BackgroundBuffer &	bg1,
		gfx::BackgroundBuffer &	bg2,
		const gfx::PaletteGroup &	palette_group,
		const DungeonState *	state = nullptr,
		gfx::BackgroundBuffer *	layout_bg1 = nullptr,
		bool	reset_room_event_indices = true )

Draw all objects in a room.

Parameters

objects	Vector of room objects
bg1	Background layer 1 buffer (object buffer)
bg2	Background layer 2 buffer (object buffer)
palette_group	Current palette group for color mapping
layout_bg1	Optional second BG1 target for room-object reveal masks
reset_room_event_indices	If true, reset the chest-only and shared chest/lock counters before drawing (set false on subsequent USDASM list passes; see Room::RenderObjectsToBackground)

Returns

Status of the drawing operation

Definition at line 444 of file object_drawer.cc.

References yaze::zelda3::RoomObject::BG2, yaze::gfx::BackgroundBuffer::bitmap(), DrawObject(), GetDrawRoutineId(), LOG_DEBUG, ResetChestIndex(), and RoutineDrawsToBothBGs().

Referenced by yaze::zelda3::RoomLayout::Draw(), and yaze::zelda3::Room::RenderObjectsToBackground().

GetDrawRoutineId()

int yaze::zelda3::ObjectDrawer::GetDrawRoutineId

(

int16_t

object_id

)

const

Get draw routine ID for an object.

Parameters

object_id

The object ID to look up

Returns

Draw routine ID (0-24) based on ZScream mapping

Definition at line 1433 of file object_drawer.cc.

References yaze::zelda3::DrawRoutineRegistry::Get(), and yaze::zelda3::DrawRoutineRegistry::GetRoutineIdForObject().

Referenced by CalculateObjectDimensions(), DrawObject(), yaze::editor::DungeonObjectSelector::DrawObjectAssetBrowser(), and DrawObjectList().

Here is the call graph for this function:

GetDrawRoutineCount()

int yaze::zelda3::ObjectDrawer::GetDrawRoutineCount ( ) const

inline

Get the total number of registered draw routines.

Definition at line 134 of file object_drawer.h.

References draw_routines_.

InitializeDrawRoutines()

void yaze::zelda3::ObjectDrawer::InitializeDrawRoutines

(

)

Initialize draw routine registry Must be called before drawing objects.

Definition at line 501 of file object_drawer.cc.

References draw_routines_, DrawBigKeyLock(), DrawChest(), DrawCustomObject(), DrawNothing(), DrawUsingRegistryRoutine(), yaze::zelda3::RoomObject::id_, yaze::zelda3::DrawRoutineIds::kActual4x4, yaze::zelda3::DrawRoutineIds::kArcheryGameTargetDoor, yaze::zelda3::DrawRoutineIds::kBed4x5, yaze::zelda3::DrawRoutineIds::kBigLightBeam, yaze::zelda3::DrawRoutineIds::kBossShell4x4, yaze::zelda3::DrawRoutineIds::kDamFloodGate, yaze::zelda3::DrawRoutineIds::kDownwardsEdge1x1_1to16plus7, yaze::zelda3::DrawRoutineIds::kFloorLight, yaze::zelda3::DrawRoutineIds::kGanonTriforceFloorDecor, yaze::zelda3::DrawRoutineIds::kHorizontalTurtleRockPipe, yaze::zelda3::DrawRoutineIds::kLightBeam, yaze::zelda3::DrawRoutineIds::kRightwards3x6, yaze::zelda3::DrawRoutineIds::kRupeeFloor, yaze::zelda3::DrawRoutineIds::kSingle2x2, yaze::zelda3::DrawRoutineIds::kSingle4x3, yaze::zelda3::DrawRoutineIds::kSingle4x4, yaze::zelda3::DrawRoutineIds::kSolidWallDecor3x4, yaze::zelda3::DrawRoutineIds::kUtility3x5, yaze::zelda3::DrawRoutineIds::kUtility6x3, yaze::zelda3::DrawRoutineIds::kVerticalTurtleRockPipe, yaze::zelda3::DrawRoutineIds::kWaterfall47, yaze::zelda3::DrawRoutineIds::kWaterfall48, yaze::zelda3::DrawRoutineIds::kWaterHopStairsA, yaze::zelda3::DrawRoutineIds::kWaterHopStairsB, yaze::zelda3::DrawRoutineIds::kWeird2x4_1to16, and routines_initialized_.

Referenced by CalculateObjectDimensions(), ObjectDrawer(), yaze::emu::render::EmulatorRenderService::RenderDungeonObjectStatic(), and yaze::editor::TileObjectHandler::RenderGhostPreviewBitmap().

DrawTileToBitmap()

void yaze::zelda3::ObjectDrawer::DrawTileToBitmap	(	gfx::Bitmap &	bitmap,
		const gfx::TileInfo &	tile_info,
		int	pixel_x,
		int	pixel_y,
		const uint8_t *	tiledata )

Draw a single tile directly to bitmap.

Parameters

bitmap	Target bitmap to draw to
tile_info	Tile information (ID, palette, mirroring)
pixel_x	X pixel coordinate in bitmap
pixel_y	Y pixel coordinate in bitmap
tiledata	Source graphics data from ROM

Definition at line 2242 of file object_drawer.cc.

References yaze::gfx::Bitmap::height(), yaze::gfx::TileInfo::horizontal_mirror_, yaze::gfx::TileInfo::id_, yaze::gfx::Bitmap::is_active(), LOG_DEBUG, yaze::gfx::Bitmap::mutable_data(), yaze::gfx::TileInfo::palette_, yaze::gfx::Bitmap::set_modified(), yaze::gfx::TileInfo::vertical_mirror_, and yaze::gfx::Bitmap::width().

Referenced by yaze::zelda3::ObjectTileEditor::BuildTile8Atlas(), DrawDoor(), yaze::zelda3::ObjectTileEditor::RenderLayoutToBitmap(), and WriteTile8().

DrawRoomDrawObjectData2x2()

absl::Status yaze::zelda3::ObjectDrawer::DrawRoomDrawObjectData2x2	(	uint16_t	object_id,
		int	tile_x,
		int	tile_y,
		RoomObject::LayerType	layer,
		uint16_t	room_draw_object_data_offset,
		gfx::BackgroundBuffer &	bg1,
		gfx::BackgroundBuffer &	bg2 )

Draw a fixed 2x2 (16x16) tile pattern from RoomDrawObjectData.

USDASM uses hardcoded offsets into RoomDrawObjectData for certain special objects that are NOT part of the room object stream (e.g. pushable blocks and lightable torches). See bank_01.asm: RoomDraw_PushableBlock and RoomDraw_LightableTorch.

Parameters

object_id	Identifier used only for tracing/debugging (not used for routine lookup)
tile_x	Top-left X position in tiles
tile_y	Top-left Y position in tiles
layer	Target layer (BG1/BG2)
room_draw_object_data_offset	Offset from RoomDrawObjectData base (not an absolute PC address)

Definition at line 2351 of file object_drawer.cc.

References yaze::zelda3::RoomObject::BG2, yaze::Rom::is_loaded(), yaze::zelda3::kRoomObjectTileAddress, rom_, SetTraceContext(), yaze::Rom::vector(), yaze::gfx::WordToTileInfo(), and WriteTile8().

Referenced by yaze::zelda3::Room::RenderObjectsToBackground().

CalculateObjectDimensions()

std::pair< int, int > yaze::zelda3::ObjectDrawer::CalculateObjectDimensions

(

const RoomObject &

object

)

Calculate the dimensions (width, height) of an object in pixels.

Parameters

object

The object to calculate dimensions for

Returns

Pair of (width, height) in pixels

Definition at line 2421 of file object_drawer.cc.

References yaze::zelda3::DimensionService::Get(), GetDrawRoutineId(), yaze::zelda3::DimensionService::GetPixelDimensions(), InitializeDrawRoutines(), yaze::zelda3::DrawRoutineIds::kDamFloodGate, yaze::zelda3::DrawRoutineIds::kDownwardsEdge1x1_1to16plus7, yaze::zelda3::DrawRoutineIds::kDownwardsHasEdge1x1_1to16_plus23, yaze::zelda3::DrawRoutineIds::kFloorLight, yaze::zelda3::DrawRoutineIds::kWaterHopStairsA, yaze::zelda3::DrawRoutineIds::kWaterHopStairsB, yaze::zelda3::DrawRoutineIds::kWeird2x4_1to16, and routines_initialized_.

Here is the call graph for this function:

SetTraceCollector()

void yaze::zelda3::ObjectDrawer::SetTraceCollector	(	std::vector< TileTrace > *	collector,
		bool	trace_only = false )

Definition at line 87 of file object_drawer.cc.

References trace_collector_, and trace_only_.

Referenced by yaze::editor::anonymous_namespace{dungeon_canvas_issue_report.cc}::BuildObjectTraceReport(), and yaze::zelda3::ObjectTileEditor::CaptureObjectLayout().

ClearTraceCollector()

void yaze::zelda3::ObjectDrawer::ClearTraceCollector

(

)

Definition at line 93 of file object_drawer.cc.

References trace_collector_, and trace_only_.

Referenced by yaze::editor::anonymous_namespace{dungeon_canvas_issue_report.cc}::BuildObjectTraceReport(), and yaze::zelda3::ObjectTileEditor::CaptureObjectLayout().

TraceOnly()

bool yaze::zelda3::ObjectDrawer::TraceOnly ( ) const

inline

Definition at line 196 of file object_drawer.h.

References trace_only_.

DrawChest()

void yaze::zelda3::ObjectDrawer::DrawChest ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 1923 of file object_drawer.cc.

References current_chest_index_, current_room_event_index_, DrawUsingRegistryRoutine(), yaze::zelda3::RoomObject::id_, yaze::zelda3::DrawRoutineIds::kSingle2x2, room_id_, WriteTile8(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Referenced by InitializeDrawRoutines().

Here is the call graph for this function:

DrawBigChest()

void yaze::zelda3::ObjectDrawer::DrawBigChest ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 1971 of file object_drawer.cc.

References current_chest_index_, current_room_event_index_, DrawUsingRegistryRoutine(), yaze::zelda3::DungeonState::IsBigChestOpen(), yaze::zelda3::DrawRoutineIds::kSingle4x3, and room_id_.

Here is the call graph for this function:

DrawBigKeyLock()

void yaze::zelda3::ObjectDrawer::DrawBigKeyLock ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 1993 of file object_drawer.cc.

References current_room_event_index_, DrawUsingRegistryRoutine(), yaze::zelda3::DungeonState::IsBigKeyLockOpen(), yaze::zelda3::DrawRoutineIds::kBigKeyLock, and room_id_.

Referenced by InitializeDrawRoutines().

Here is the call graph for this function:

DrawNothing()

void yaze::zelda3::ObjectDrawer::DrawNothing ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 2007 of file object_drawer.cc.

References yaze::zelda3::RoomObject::id_, and LOG_DEBUG.

Referenced by InitializeDrawRoutines().

CustomDraw()

void yaze::zelda3::ObjectDrawer::CustomDraw ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 2017 of file object_drawer.cc.

References WriteTile8(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Here is the call graph for this function:

DrawRightwards4x4_1to16()

void yaze::zelda3::ObjectDrawer::DrawRightwards4x4_1to16 ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 2028 of file object_drawer.cc.

References yaze::zelda3::RoomObject::id_, LOG_DEBUG, yaze::zelda3::RoomObject::size_, WriteTile8(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Here is the call graph for this function:

DrawRightwardsDecor4x3spaced4_1to16()

void yaze::zelda3::ObjectDrawer::DrawRightwardsDecor4x3spaced4_1to16 ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 2063 of file object_drawer.cc.

References yaze::zelda3::RoomObject::size_, WriteTile8(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Here is the call graph for this function:

DrawLargeCanvasObject()

void yaze::zelda3::ObjectDrawer::DrawLargeCanvasObject ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, int width, int height )

protected

Definition at line 2404 of file object_drawer.cc.

References WriteTile8(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Here is the call graph for this function:

DrawCustomObject()

void yaze::zelda3::ObjectDrawer::DrawCustomObject ( const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state = nullptr )

protected

Definition at line 3212 of file object_drawer.cc.

References yaze::zelda3::CustomObjectManager::Get(), yaze::zelda3::RoomObject::id_, LOG_DEBUG, yaze::zelda3::RoomObject::size_, yaze::gfx::WordToTileInfo(), yaze::zelda3::RoomObject::x_, and yaze::zelda3::RoomObject::y_.

Referenced by DrawObject(), and InitializeDrawRoutines().

Here is the call graph for this function:

DrawMissingCustomObjectPlaceholder()

void yaze::zelda3::ObjectDrawer::DrawMissingCustomObjectPlaceholder ( gfx::BackgroundBuffer & bg, int tile_x, int tile_y )

protected

Definition at line 3248 of file object_drawer.cc.

References yaze::gfx::BackgroundBuffer::bitmap(), yaze::gfx::BackgroundBuffer::ClearBG1RevealMaskRect(), yaze::gfx::BackgroundBuffer::mutable_coverage_data(), and yaze::gfx::BackgroundBuffer::mutable_priority_data().

Here is the call graph for this function:

DrawUsingRegistryRoutine()

void yaze::zelda3::ObjectDrawer::DrawUsingRegistryRoutine ( int routine_id, const RoomObject & obj, gfx::BackgroundBuffer & bg, std::span< const gfx::TileInfo > tiles, const DungeonState * state )

protected

Definition at line 140 of file object_drawer.cc.

References yaze::zelda3::DrawRoutineUtils::ClearTraceHook(), yaze::zelda3::DrawRoutineRegistry::Get(), yaze::zelda3::DrawRoutineRegistry::GetRoutineInfo(), LOG_DEBUG, registry_primary_layer_, registry_secondary_bg_, registry_secondary_layer_, rom_, room_gfx_buffer_, room_id_, SetTraceContext(), yaze::zelda3::DrawRoutineUtils::SetTraceHook(), yaze::zelda3::DrawContext::target_bg, yaze::zelda3::RoomObject::tiles(), and WriteTile8().

Referenced by DrawBigChest(), DrawBigKeyLock(), DrawChest(), and InitializeDrawRoutines().

WriteTile8()

void yaze::zelda3::ObjectDrawer::WriteTile8 ( gfx::BackgroundBuffer & bg, int tile_x, int tile_y, const gfx::TileInfo & tile_info )

protected

Definition at line 2147 of file object_drawer.cc.

References active_layout_bg1_mask_, active_mask_source_bg_, active_object_bg1_mask_, bg1_reveal_mask_source_, yaze::gfx::BackgroundBuffer::bitmap(), yaze::gfx::BackgroundBuffer::ClearBG1RevealMaskRect(), DrawTileToBitmap(), IsValidTilePosition(), LOG_DEBUG, MarkBg1OpaqueTilePixelsRevealed(), yaze::gfx::BackgroundBuffer::mutable_coverage_data(), yaze::gfx::BackgroundBuffer::mutable_priority_data(), yaze::gfx::TileInfo::over_, PushTrace(), room_gfx_buffer_, and trace_only_.

Referenced by CustomDraw(), DrawChest(), DrawLargeCanvasObject(), DrawObject(), DrawRightwards4x4_1to16(), DrawRightwardsDecor4x3spaced4_1to16(), DrawRoomDrawObjectData2x2(), and DrawUsingRegistryRoutine().

IsValidTilePosition()

bool yaze::zelda3::ObjectDrawer::IsValidTilePosition ( int tile_x, int tile_y ) const

protected

Definition at line 2237 of file object_drawer.cc.

References kMaxTilesY.

Referenced by WriteTile8().

RoutineDrawsToBothBGs()

bool yaze::zelda3::ObjectDrawer::RoutineDrawsToBothBGs ( int routine_id )

staticprotected

Definition at line 492 of file object_drawer.cc.

References yaze::zelda3::DrawRoutineRegistry::Get(), and yaze::zelda3::DrawRoutineRegistry::RoutineDrawsToBothBGs().

Referenced by DrawObject(), and DrawObjectList().

Here is the call graph for this function:

MarkBg1RectRevealed()

void yaze::zelda3::ObjectDrawer::MarkBg1RectRevealed ( gfx::BackgroundBuffer & bg1, int start_px, int start_py, int pixel_width, int pixel_height )

protected

Definition at line 2093 of file object_drawer.cc.

References bg1_reveal_mask_source_, and yaze::gfx::BackgroundBuffer::SetBG1RevealMaskRect().

Referenced by DrawObject().

Here is the call graph for this function:

MarkBg1OpaqueTilePixelsRevealed()

void yaze::zelda3::ObjectDrawer::MarkBg1OpaqueTilePixelsRevealed ( gfx::BackgroundBuffer & bg1, const gfx::TileInfo & tile_info, int pixel_x, int pixel_y, const uint8_t * tiledata )

protected

Definition at line 2100 of file object_drawer.cc.

References bg1_reveal_mask_source_, yaze::gfx::BackgroundBuffer::bitmap(), yaze::gfx::TileInfo::horizontal_mirror_, yaze::gfx::TileInfo::id_, yaze::gfx::BackgroundBuffer::mutable_bg1_reveal_mask_data(), and yaze::gfx::TileInfo::vertical_mirror_.

Referenced by WriteTile8().

Here is the call graph for this function:

RequiresRectangularBg1Mask()

bool yaze::zelda3::ObjectDrawer::RequiresRectangularBg1Mask ( const RoomObject & object )

staticprotected

Definition at line 428 of file object_drawer.cc.

Referenced by DrawObject().

DrawDoorIndicator()

void yaze::zelda3::ObjectDrawer::DrawDoorIndicator ( gfx::BackgroundBuffer & bg, int tile_x, int tile_y, int width, int height, DoorType type, DoorDirection direction )

protected

Definition at line 1816 of file object_drawer.cc.

References bg1_reveal_mask_source_, yaze::zelda3::BigKeyDoor, yaze::gfx::BackgroundBuffer::bitmap(), yaze::zelda3::BombableCaveExit, yaze::zelda3::BombableDoor, yaze::zelda3::BottomShutterLower, yaze::zelda3::BottomSidedShutter, yaze::zelda3::CaveExit, yaze::gfx::BackgroundBuffer::ClearBG1RevealMaskRect(), yaze::zelda3::CurtainDoor, yaze::zelda3::DashWall, yaze::zelda3::DoubleSidedShutter, yaze::zelda3::DoubleSidedShutterLower, yaze::zelda3::DungeonSwapMarker, yaze::zelda3::ExitMarker, yaze::zelda3::ExplodingWall, yaze::zelda3::EyeWatchDoor, yaze::zelda3::FancyDungeonExit, yaze::zelda3::FancyDungeonExitLower, yaze::zelda3::LayerSwapMarker, yaze::zelda3::LitCaveExitLower, yaze::gfx::BackgroundBuffer::mutable_coverage_data(), yaze::zelda3::NormalDoor, yaze::zelda3::NormalDoorLower, yaze::zelda3::SmallKeyDoor, yaze::zelda3::SmallKeyStairsDown, yaze::zelda3::SmallKeyStairsDownLower, yaze::zelda3::SmallKeyStairsUp, yaze::zelda3::SmallKeyStairsUpLower, yaze::zelda3::TopShutterLower, yaze::zelda3::TopSidedShutter, yaze::zelda3::UnopenableBigKeyDoor, and yaze::zelda3::WaterfallDoor.

Referenced by DrawDoor().

Here is the call graph for this function:

SetTraceContext()

void yaze::zelda3::ObjectDrawer::SetTraceContext ( const RoomObject & object, RoomObject::LayerType layer )

protected

Definition at line 98 of file object_drawer.cc.

References yaze::zelda3::ObjectDrawer::TraceContext::layer, yaze::zelda3::ObjectDrawer::TraceContext::object_id, yaze::zelda3::ObjectDrawer::TraceContext::size, and trace_context_.

Referenced by DrawObject(), DrawRoomDrawObjectData2x2(), and DrawUsingRegistryRoutine().

PushTrace()

void yaze::zelda3::ObjectDrawer::PushTrace ( int tile_x, int tile_y, const gfx::TileInfo & tile_info )

protected

Definition at line 105 of file object_drawer.cc.

References yaze::gfx::TileInfo::horizontal_mirror_, yaze::gfx::TileInfo::id_, yaze::zelda3::ObjectDrawer::TraceContext::layer, yaze::zelda3::ObjectDrawer::TileTrace::object_id, yaze::zelda3::ObjectDrawer::TraceContext::object_id, yaze::gfx::TileInfo::over_, yaze::gfx::TileInfo::palette_, yaze::zelda3::ObjectDrawer::TraceContext::size, trace_collector_, trace_context_, and yaze::gfx::TileInfo::vertical_mirror_.

Referenced by TraceHookThunk(), and WriteTile8().

TraceHookThunk()

void yaze::zelda3::ObjectDrawer::TraceHookThunk ( gfx::BackgroundBuffer * bg, int tile_x, int tile_y, const gfx::TileInfo & tile_info, void * user_data )

staticprotected

Definition at line 130 of file object_drawer.cc.

References PushTrace().

Referenced by DrawObject().

Here is the call graph for this function:

Member Data Documentation

draw_routines_

std::vector<DrawRoutine> yaze::zelda3::ObjectDrawer::draw_routines_

protected

Definition at line 272 of file object_drawer.h.

Referenced by DrawObject(), GetDrawRoutineCount(), and InitializeDrawRoutines().

routines_initialized_

bool yaze::zelda3::ObjectDrawer::routines_initialized_ = false

protected

Definition at line 273 of file object_drawer.h.

Referenced by CalculateObjectDimensions(), DrawObject(), and InitializeDrawRoutines().

trace_context_

TraceContext yaze::zelda3::ObjectDrawer::trace_context_ {}

protected

Definition at line 286 of file object_drawer.h.

Referenced by PushTrace(), and SetTraceContext().

trace_collector_

std::vector<TileTrace>* yaze::zelda3::ObjectDrawer::trace_collector_ = nullptr

protected

Definition at line 287 of file object_drawer.h.

Referenced by ClearTraceCollector(), DrawObject(), PushTrace(), and SetTraceCollector().

trace_only_

bool yaze::zelda3::ObjectDrawer::trace_only_ = false

protected

Definition at line 288 of file object_drawer.h.

Referenced by ClearTraceCollector(), DrawObject(), SetTraceCollector(), TraceOnly(), and WriteTile8().

rom_

Rom* yaze::zelda3::ObjectDrawer::rom_

protected

Definition at line 290 of file object_drawer.h.

Referenced by DrawDoor(), DrawObject(), DrawRoomDrawObjectData2x2(), and DrawUsingRegistryRoutine().

room_id_

int yaze::zelda3::ObjectDrawer::room_id_

protected

Definition at line 291 of file object_drawer.h.

Referenced by DrawBigChest(), DrawBigKeyLock(), DrawChest(), DrawDoor(), and DrawUsingRegistryRoutine().

current_chest_index_

int yaze::zelda3::ObjectDrawer::current_chest_index_ = 0

mutableprotected

Definition at line 292 of file object_drawer.h.

Referenced by DrawBigChest(), DrawChest(), and ResetChestIndex().

current_room_event_index_

int yaze::zelda3::ObjectDrawer::current_room_event_index_ = 0

mutableprotected

Definition at line 293 of file object_drawer.h.

Referenced by DrawBigChest(), DrawBigKeyLock(), DrawChest(), and ResetChestIndex().

allow_track_corner_aliases_

bool yaze::zelda3::ObjectDrawer::allow_track_corner_aliases_ = true

protected

Definition at line 294 of file object_drawer.h.

Referenced by DrawObject(), and SetAllowTrackCornerAliases().

registry_secondary_bg_

gfx::BackgroundBuffer* yaze::zelda3::ObjectDrawer::registry_secondary_bg_ = nullptr

protected

Definition at line 295 of file object_drawer.h.

Referenced by DrawObject(), and DrawUsingRegistryRoutine().

registry_primary_layer_

RoomObject::LayerType yaze::zelda3::ObjectDrawer::registry_primary_layer_ = RoomObject::LayerType::BG1

protected

Definition at line 296 of file object_drawer.h.

Referenced by DrawObject(), and DrawUsingRegistryRoutine().

registry_secondary_layer_

RoomObject::LayerType yaze::zelda3::ObjectDrawer::registry_secondary_layer_ = RoomObject::LayerType::BG2

protected

Definition at line 297 of file object_drawer.h.

Referenced by DrawObject(), and DrawUsingRegistryRoutine().

active_object_bg1_mask_

gfx::BackgroundBuffer* yaze::zelda3::ObjectDrawer::active_object_bg1_mask_ = nullptr

protected

Definition at line 298 of file object_drawer.h.

Referenced by DrawObject(), and WriteTile8().

active_layout_bg1_mask_

gfx::BackgroundBuffer* yaze::zelda3::ObjectDrawer::active_layout_bg1_mask_ = nullptr

protected

Definition at line 299 of file object_drawer.h.

Referenced by DrawObject(), and WriteTile8().

active_mask_source_bg_

gfx::BackgroundBuffer* yaze::zelda3::ObjectDrawer::active_mask_source_bg_ = nullptr

protected

Definition at line 300 of file object_drawer.h.

Referenced by DrawObject(), and WriteTile8().

bg1_reveal_mask_source_

gfx::BG1RevealMaskSource yaze::zelda3::ObjectDrawer::bg1_reveal_mask_source_

protected

Initial value:

=
      gfx::BG1RevealMaskSource::kBG2Objects

Definition at line 301 of file object_drawer.h.

Referenced by DrawDoor(), DrawDoorIndicator(), MarkBg1OpaqueTilePixelsRevealed(), MarkBg1RectRevealed(), SetBG1RevealMaskSource(), and WriteTile8().

room_gfx_buffer_

const uint8_t* yaze::zelda3::ObjectDrawer::room_gfx_buffer_

protected

Definition at line 304 of file object_drawer.h.

Referenced by DrawDoor(), DrawUsingRegistryRoutine(), and WriteTile8().

kMaxTilesX

constexpr int yaze::zelda3::ObjectDrawer::kMaxTilesX = 64

staticconstexprprotected

Definition at line 307 of file object_drawer.h.

kMaxTilesY

constexpr int yaze::zelda3::ObjectDrawer::kMaxTilesY = 64

staticconstexprprotected

Definition at line 308 of file object_drawer.h.

Referenced by IsValidTilePosition().

---

The documentation for this class was generated from the following files:

• src/zelda3/dungeon/object_drawer.h
• src/zelda3/dungeon/object_drawer.cc