Skip to content

gSetupActorDLs - #1893

Merged
AngheloAlf merged 3 commits into
zeldaret:mainfrom
hensldm:gActorEmptyDL
Aug 28, 2026
Merged

gSetupActorDLs#1893
AngheloAlf merged 3 commits into
zeldaret:mainfrom
hensldm:gActorEmptyDL

Conversation

@hensldm

@hensldm hensldm commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator

Name D_801AEF88-> gActorSetupXluDL and D_801AEFA0 -> gActorSetupOpaDL.

@hensldm hensldm added documentation Improvements or additions to documentation Needs-second-approval Second approval Needs-first-approval First approval labels Aug 16, 2026
Comment thread src/overlays/actors/ovl_En_Ishi/z_en_ishi.c Outdated
Comment thread src/overlays/actors/ovl_En_Po_Composer/z_en_po_composer.c Outdated
Comment thread src/overlays/actors/ovl_En_Po_Sisters/z_en_po_sisters.c Outdated

@AngheloAlf AngheloAlf left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM (as far as you apply dragorn's suggestions)

@AngheloAlf AngheloAlf removed the Needs-first-approval First approval label Aug 16, 2026
@mzxrules

Copy link
Copy Markdown
Contributor

This is not a good rename, all things considered.

In Zelda64, you have some cases where display lists are either rendered opaque or translucent, such as the Kokiri, the sages, the poes and poe sisters, etc. z_actor.c provides some of the code to handle drawing these actors, which includes the D_801AEF88 and D_801AEFA0 (which is the one being renamed) display lists.

The purpose of these display list, at least to my very limited understanding, is to configure the color combiner for rendering for the translucent display list and opaque display list respectively. It's just that for the opaque version, there is nothing to update so it is a simple SpEndDisplayList() command.

The pattern is nearly the same in Ocarina of Time, where MM's D_801AEF88 display list is identical to OoT's D_80116280. The difference is that in OoT, the opaque display list is stored within the translucent, at D_80116280[2], whereas MM refactored them to no longer be coupled together.

Incidently, the two calls to DPSetRenderMode should be modified to use OoT's simplified arguments.

@Dragorn421

Copy link
Copy Markdown
Contributor

yeah; what names would you suggest?

@hensldm

hensldm commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator Author

Hmm, what about gActorSetupOpaDL and gActorSetupXluDL? For what it is worth, OoT has them separate as well with D_80116280 (xlu) and D_80115FF0 (opa). Though, they never used D_80115FF0 instead doing D_80116280[2] as you mentioned.

@hensldm hensldm changed the title D_801AEFA0 -> gActorEmtpyDL gSetupActorDLs Aug 16, 2026
@AngheloAlf AngheloAlf added Merge-ready All reviewers satisfied, just waiting for CI and removed Needs-second-approval Second approval labels Aug 28, 2026
@AngheloAlf
AngheloAlf merged commit 7ddfb60 into zeldaret:main Aug 28, 2026
5 checks passed
@hensldm
hensldm deleted the gActorEmptyDL branch August 28, 2026 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Merge-ready All reviewers satisfied, just waiting for CI

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants