After creating your sprites, you will need to move them onto lab46 and possibly onto your PI. One way of doing this is using the scp command. To use the scp command use to following format:

scp FILENAME DESTINATION:PATH

Here is an example:

scp sprites.png username@lab46.g7n.org:~/src/fall2023/discrete/ttb0

If necessary, this is how you would get the desired file onto your PI:

scp sprites.png username@raspberrypi:~/src/fall2023/discrete/ttb0

Once you have your sprites .png file on lab46 and on your PI it is now time to load them into the cartridge. To do this open your make.sh file.

Once in the make.sh file, add the following lines:

echo
echo Convert the PNG textures
echo --------------------------
png2vircon BreakoutTextures.png -o BreakoutTextures.vtex || abort_build

“BreakoutTextures.png” represents the name of your texture file.

After including the texture file in make.sh you also need to add it to your .xml file. To do so, open your .xml file and add the following:

    <textures>
        <texture path="BreakoutTextures.vtex" />
    </textures>

“BreakoutTextures” represents the name of your breakout texture file.

Once you have added your texture file to BOTH the make.sh and the .xml file your textures are loaded into the cartridge.

When making your structure for the brick, it is important to remember that every time the ball hits the brick it needs to disappear. This means that inside the brick structure, you need to have a flag.

Here is a simple brick structure that you can add or build onto if necessary:

struct BrickOBJ
{
    bool Active;
    int X, Y;          // Brick X and Y location
    int Width, Height; // Brick size
};

A pointer points to and references a location in memory. We can obtain the value that is stored at that location by dereferencing the pointer. The main use of pointers in this project will be to reference/dereference each brick you have allocated memory for (malloc).

Memory Allocation. This is a way to perform memory management manually for dynamic memory. The syntax for malloc is below.

  ptr = (cast-type*) malloc(byte-size);
  
  
  

To access the specific parts of your array you need to use (*(ptr)). The ptr is the pointer and it can be added to (*(ptr+n)).. If you want to use a part of the structure you will need to put the name of it at the end of (*(ptr)).(varible). You can use an int to add to ptr. The ptr starts with zero so use one more number than you want.

When you have a ptr with a variable (*(ptr)).variable they function as that variable so int's can be +,-,/,* booleans can be set false and true, etc.

For this project we will be using a pointer to point to an array of structs that we have allocated memory for. So we can use a line that looks similar to this.

  ptr = (Brick *)malloc(sizeof(Brick)*number_of_bricks);
  Brick*ptr = NULL;
  

With Brick being a struct. You need to make sure you set the ptr to = NULL before you use it as that is creating it and it needs a value.

free( ptr );

Be sure to free any allocated memory by the end of the program.