NOTE: this is a collaborative document between a couple of my classes this semester. That means more people editing. Be mindful that only one person can edit the document at a time.

Only task headings have been provided. You are not expected to know how to do the task given by just that description (although in some cases it can be adequately figured out). Instead, if no further information is yet present, ASK FOR DETAILS on the discord, then contribute that clarity here.

If something is present but needs polish: spruce it up.

If something is present but is incorrect: please fix it.

This is intended to be an informative, useful document that all can benefit from.

Those with prior experience, please be mindful not to gobble up all the low-hanging fruit from the newcomers.

To get any textures into your cartridge other than the BIOS texture, you will need to add them into your .xml file
Adding textures will always follow the pattern of:

<textures>
    <texture path="FILENAME0.vtex" />
    <texture path="FILENAME1.vtex" />
    <texture path="FILENAME2.vtex" />
    ...
    <texture path="FILENAMEX.vtex" />
</textures>

When you go to use these textures in your code, the texture_id will follow the order of where they are in the xml, ie FILENAME0.vtex will have the texture_id 0

Just like in C, selecting a texture is simple

In C to select a texture we can use:

select_texture( int texture_id );

In Assembly the process is similar, as the command is simply:

out GPU_SelectedTexture #

Where the # is either the immediate value of the texture id, or a register containing the texture id

Defining a region is where assembly becomes much less simple, as in C one can use a variety of built in functions that handle everything, whereas in assembly we have to send the GPU every value ourselves

This looks like:

out GPU_SelectedRegion #
out GPU_RegionMinX #
out GPU_RegionMinY #
out GPU_RegionMaxX #
out GPU_RegionMaxY #
out GPU_RegionHotspotX #
out GPU_RegionHotspotY #

Once again with # corresponding to an immediate value or register containing the values we want to input