{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "comments: true\n",
    "layout: post\n",
    "title: JavaScript For Loops and Sprites\n",
    "description: An introduction to JavaScript for loops and working with Sprites.\n",
    "permalink: /csse/javascript/fundamentals/for-loops/\n",
    "categories: [JavaScript Fundamentals]\n",
    "courses: { csse: {week: 7} }\n",
    "type: ccc\n",
    "---\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## MetaData, Class, For Loops\n",
    "\n",
    "The objective of this article is to enhance your knowledge and understanding of MetaData, Class Definitions, and For-Loops.\n",
    "\n",
    "**MetaData**: In this article, MetaData contains information about the sprite, including its name, source URL, and orientation details such as the number of rows and columns, header size, padding, and jagged rows.\n",
    "\n",
    "**Class**: In this context, the canvas and drawing operations are initialized and stored in a class. These are used to output the sprite sheet image and individual frames within the sprite sheet.\n",
    "  - **constructor**: Initializes the canvas, context, and sprite image.\n",
    "  - **draw() method**: Uses nested **for-loops** to iterate through the sprite sheet and draw each frame independently on the canvas. It calculates the source and destination coordinates for each frame, taking into account the header and padding.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Introduction to For Loops\n",
    "\n",
    "For Loops are commonly used to iterate over data structures, including JavaScript Arrays and Objects.\n",
    "\n",
    "Below is an example of a conventional for loop that iterates over an array of names and displays each name in a paragraph (`<p>`) tag within a designated HTML div.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "<!-- HTML output div -->\n",
    "<div id=\"forConventional\"></div>\n",
    "\n",
    "<script>\n",
    "    var names = ['turtle', 'fish', 'frog', 'penguin'];\n",
    "\n",
    "    // Conventional for loop with index used to access elements\n",
    "    for (let i = 0; i < names.length; i++) {\n",
    "\n",
    "        // Create a p tag for each name and add it to the forConventional div\n",
    "        const p = document.createElement('p');\n",
    "        p.innerHTML = names[i];\n",
    "        document.getElementById('forConventional').appendChild(p);\n",
    "\n",
    "    }\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### ForEach Loop\n",
    "\n",
    "The ForEach loop is another way to iterate over data structures, such as JavaScript Arrays and Objects. Below is an example of a ForEach loop that iterates over an array of coding adventures and displays each adventure in a paragraph (`<p>`) tag within a designated HTML div.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "<!-- HTML output div -->\n",
    "<div id=\"forEach\"></div>\n",
    "\n",
    "<script>\n",
    "    var codingAdventures = ['GitHub', 'Terminal', 'Jupyter', 'JavaScript'];\n",
    "\n",
    "    // ForEach loop to iterate over the array\n",
    "    for (let adventure of codingAdventures) {\n",
    "\n",
    "        // Create a p tag for each adventure and add it to the forEach div\n",
    "        const p = document.createElement('p');\n",
    "        p.innerHTML = adventure;\n",
    "        document.getElementById('forEach').appendChild(p);\n",
    "\n",
    "    }\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2D array\n",
    "\n",
    "There is a data structure called **arrays in arrays** or **2D arrays**. The data structure helps organize the data efficiently and access it using **nested loops**. Each row in the 2D array will represent a category (e.g., GitHub, Terminal), and each column will contain an array of questions and answers for that category.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "<div id=\"questionsAnswers\"></div>\n",
    "\n",
    "<script>\n",
    "    // 2D array of questions and answers with titles\n",
    "    var qaArray = [\n",
    "        [\n",
    "            'GitHub',\n",
    "            [\n",
    "                { question: 'What is a repository?', answer: 'A repository is a storage space where your project lives.' },\n",
    "                { question: 'How do you create a branch?', answer: 'You can create a branch by using the command git checkout -b branchName.' },\n",
    "                { question: 'How do you merge branches?', answer: 'You can merge branches by using the command git merge branchName.' },\n",
    "                { question: 'How do you push changes to GitHub?', answer: 'You can push changes to GitHub by using the command git push origin branchName.' }\n",
    "            ]\n",
    "        ],\n",
    "        [\n",
    "            'Terminal',\n",
    "            [\n",
    "                { question: 'What is the command to list hidden files in a directory?', answer: 'The command to list files in a directory is ls -a.' },\n",
    "                { question: 'What is the command to change directories?', answer: 'The command to change directories is cd.' },\n",
    "                { question: 'What is the command to create a new directory?', answer: 'The command to create a new directory is mkdir.' },\n",
    "                { question: 'What is the command to remove a directory?', answer: 'The command to remove a directory is rm -rf.' }\n",
    "            ]\n",
    "        ],\n",
    "        [\n",
    "            'Jupyter Notebook',\n",
    "            [\n",
    "                { question: 'How do you setup a markdown cell?', answer: 'You setup a markdown cell by selecting the cell type dropdown and selecting markdown.' },\n",
    "                { question: 'How do you setup a code cell?', answer: 'You setup a code cell by selecting the cell type dropdown and selecting code.' },\n",
    "                { question: 'What kernel do you select to run JavaScript code?', answer: 'You select the Python kernel to run JavaScript code.' },\n",
    "                { question: 'How do you see JavaScript console output?', answer: 'You see JavaScript console output by using the console.log() method.' }\n",
    "            ]\n",
    "        ],\n",
    "        [\n",
    "            'JavaScript',\n",
    "            [\n",
    "                { question: 'What is JavaScript?', answer: 'JavaScript is a programming language that enables you to create interactive web pages.' },\n",
    "                { question: 'What is a variable?', answer: 'A variable is a container that stores data.' },\n",
    "                { question: 'What is a function?', answer: 'A function is a block of code that performs a specific task.' },\n",
    "                { question: 'What is a loop?', answer: 'A loop is a programming structure that repeats a sequence of instructions.' }\n",
    "            ]\n",
    "        ]\n",
    "    ];\n",
    "\n",
    "    // Nested for loops to display questions and answers with titles\n",
    "    for (let category of qaArray) {\n",
    "        // Create an h2 tag for each category title\n",
    "        const h2 = document.createElement('h2');\n",
    "        h2.innerHTML = category[0];  // index 0 is the title of the category\n",
    "        document.getElementById('questionsAnswers').appendChild(h2);\n",
    "\n",
    "        // Iterate through each question and answer in the category\n",
    "        for (let qa of category[1]) {  // index 1 is the array of questions and answers\n",
    "            // Create a p tag for each question and answer\n",
    "            const p = document.createElement('p');\n",
    "            p.innerHTML = `<strong>Q:</strong> ${qa.question} <br> <strong>A:</strong> ${qa.answer}`;\n",
    "            document.getElementById('questionsAnswers').appendChild(p);\n",
    "        }\n",
    "    }\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Hack #1: Apply Your Own Game Idea\n",
    "\n",
    "Create new code cells to implement some of the sprite interactions or features you have ideated for your game. This exercise is crucial if you plan to have interactions with a Non-Player Character (NPC).\n",
    "\n",
    "**Challenge**: Use the concepts of 2D arrays and nested loops to create and display interactions or features for your game. Think about how you can organize and manage different elements, such as NPC dialog, questions, and receiving answers.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Sprite Files\n",
    "\n",
    "### Transition to Sprite Files\n",
    "\n",
    "Now that we have a solid understanding of data structures and loops, we will transition to working with Sprite Files. This section will help you understand how to manage and display sprite images, which are essential for creating animations in your game.\n",
    "\n",
    "### Sprite Files\n",
    "\n",
    "Sprite files are essentially a 2D table of sprite images. They contain 2D columnar sequences of pictures that aid in creating animation.\n",
    "\n",
    "### Display Sprite File\n",
    "\n",
    "The next code block shows a sprite file. This can be helpful in understanding the properties of your sprite. It contains `console.log` output that shows the sprite properties.\n",
    "\n",
    "Here are some terms that you will see in the next code block:\n",
    "- **MetaData**: Data that describes the file\n",
    "  - **name**: A friendly identifier naming the file\n",
    "  - **src**: The location of the file\n",
    "- **drawImage**: A function call that, when used with five parameters, outputs the entirety of the file\n",
    "- **class**: A coding structure that contains a constructor, data, and method (draw) to read and output a file\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "<style>\n",
    "    #gameCanvas {\n",
    "        border: 4px solid rgb(102, 4, 4); /* Red border for the canvas */\n",
    "    }\n",
    "</style>\n",
    "\n",
    "<canvas id=\"gameCanvas\" width=\"521\" height=\"967\"></canvas>\n",
    "\n",
    "<script>\n",
    "    function defineAndDrawImage() {\n",
    "        /**\n",
    "        * Function to define the sprite metadata for Tux the penguin\n",
    "        * @returns {Object} spriteMetaData - The metadata for the Tux sprite\n",
    "        */\n",
    "        function TuxSpriteMetaData() {\n",
    "            // NPC sprite data (Tux the penguin)\n",
    "            const spriteMetaData = {\n",
    "                name: 'tux',\n",
    "                src: 'path/to/tux/sprite.png',\n",
    "                // other metadata here\n",
    "            };\n",
    "            return spriteMetaData;\n",
    "        }\n",
    "\n",
    "        const canvas = document.getElementById('gameCanvas');\n",
    "        const ctx = canvas.getContext('2d');\n",
    "        const img = new Image();\n",
    "        img.src = TuxSpriteMetaData().src;\n",
    "\n",
    "        img.onload = function () {\n",
    "            // Draw the entire image on the canvas\n",
    "            ctx.drawImage(img, 0, 0, img.width, img.height);\n",
    "        };\n",
    "    }\n",
    "\n",
    "    // Call the function to define and draw the sprite\n",
    "    defineAndDrawImage();\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "<style>\n",
    "    #gameCanvas {\n",
    "        border: 4px solid rgb(102, 4, 4); /* Red border for the canvas */\n",
    "    }\n",
    "</style>\n",
    "\n",
    "<canvas id=\"gameCanvas\" width=\"521\" height=\"967\"></canvas>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "javascript"
    }
   },
   "outputs": [],
   "source": [
    "%%js \n",
    "<script>\n",
    "    function defineAndDrawImage() {\n",
    "        /**\n",
    "         * Function to define the sprite metadata for Tux the penguin\n",
    "         * @returns {Object} spriteMetaData - The metadata for the Tux sprite\n",
    "         */\n",
    "        function TuxSpriteMetaData() {\n",
    "            // NPC sprite data (Tux the penguin)\n",
    "            const spriteMetaData = {\n",
    "                name: 'tux',\n",
    "                src: \"./tux.png\",\n",
    "            };\n",
    "            return spriteMetaData;\n",
    "        }\n",
    "\n",
    "        /**\n",
    "         * Class to handle the canvas data and drawing of the image file\n",
    "         */\n",
    "        class CanvasDrawImage {\n",
    "            constructor(spriteMetaData) {\n",
    "                this.INIT_POSITION = { x: 0, y: 0 };\n",
    "                this.spriteMetaData = spriteMetaData;\n",
    "                this.canvas = document.getElementById('gameCanvas');\n",
    "                this.ctx = this.canvas.getContext('2d');\n",
    "                this.spriteImage = new Image();\n",
    "                this.spriteImage.src = spriteMetaData.src;\n",
    "                this.spriteImage.onload = () => this.draw(); // Ensure draw is called after image is loaded\n",
    "            }\n",
    "\n",
    "            // Method to draw the sprite on the canvas\n",
    "            draw() {\n",
    "                // This is the size of the sprite file, calculated from the PNG file \n",
    "                const width = this.spriteImage.width; \n",
    "                const height = this.spriteImage.height;\n",
    "\n",
    "                console.log(`Drawing sprite: ${this.spriteMetaData.name}`);\n",
    "                console.log(`Sprite Dimensions: ${width}x${height}`);\n",
    "\n",
    "                this.ctx.drawImage(this.spriteImage, 0, 0, width, height);\n",
    "            }\n",
    "        }\n",
    "\n",
    "        const tux = new CanvasDrawImage(TuxSpriteMetaData());\n",
    "    }\n",
    "\n",
    "    // Call the function to define the class and draw the sprite\n",
    "    defineAndDrawImage();\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Display Frames in Sprite File\n",
    "\n",
    "The next code block contains logic to extract frames within the sprite sheet. This is a more practical game enhancement compared to the previous example.\n",
    "\n",
    "Here are terms to describe key elements in the code:\n",
    "\n",
    "- **MetaData**: Contains information about the sprite file, including its name, source URL, and orientation details.\n",
    "  - **orientation**: Describes the layout of the sprite in the PNG file.\n",
    "    - **header**: Size of the area of description above the sprite.\n",
    "    - **pad**: Size of the area between the sprites.\n",
    "    - **jagged**: Indicates that each row can contain a different number of sprites.\n",
    "- **drawImage**: In the 9-property format, it provides the ability to scale the source into the destination.\n",
    "- **class**: Continues using the constructor and draw methods for source and output; adds math to abstract each frame independently.\n",
    "- **for-loops**: Demonstrates nested for loops to process each frame within the 2D sprite sheet.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "vscode": {
     "languageId": "html"
    }
   },
   "outputs": [],
   "source": [
    "\n",
    "<style>\n",
    "    #gameCanvasUnique {\n",
    "        border: 4px solid rgb(4, 102, 33); /* Green border for the canvas */\n",
    "    }\n",
    "</style>\n",
    "\n",
    "<canvas id=\"gameCanvasUnique\" width=\"521\" height=\"967\"></canvas>\n",
    "\n",
    "<script>\n",
    "// Outer function is required by Jupyter Notebook to avoid conflicts\n",
    "function defineAndDrawSprite() {\n",
    "\n",
    "    /**\n",
    "     * Function to define the sprite metadata for Tux the penguin\n",
    "     * @returns {Object} spriteMetaData - The metadata for the Tux sprite\n",
    "     */\n",
    "    function TuxSpriteMetaData() {\n",
    "        // NPC sprite data (Tux the penguin)\n",
    "        const spriteMetaData = {\n",
    "            name: 'tux',\n",
    "            src: \"./tux.png\",\n",
    "            orientation: {\n",
    "                rows: 10,\n",
    "                columns: 8,\n",
    "                header: 16,\n",
    "                pad: 2,\n",
    "                jagged: [1, 2, 1, 1, 1, 1, 1, 7, 8, 4]\n",
    "            },\n",
    "        };\n",
    "        return spriteMetaData;\n",
    "    }\n",
    "\n",
    "    /**\n",
    "     * Class to handle the canvas data and drawing of the sprite\n",
    "     */\n",
    "    class CanvasData {\n",
    "        constructor(spriteMetaData) {\n",
    "            this.spriteMetaData = spriteMetaData;\n",
    "            this.INIT_POSITION = { x: 0, y: 0 };\n",
    "            this.canvas = document.getElementById('gameCanvasUnique');\n",
    "            this.ctx = this.canvas.getContext('2d');\n",
    "            this.spriteImage = new Image();\n",
    "            this.spriteImage.src = spriteMetaData.src;\n",
    "            this.spriteImage.onload = () => this.draw(); // Ensure draw is called after image is loaded\n",
    "        }\n",
    "\n",
    "        // Method to draw each sprite individually\n",
    "        draw() {\n",
    "            const sheetWidth = this.spriteImage.width; \n",
    "            const sheetHeight = this.spriteImage.height;\n",
    "            const rows = this.spriteMetaData.orientation.rows;\n",
    "            const cols = this.spriteMetaData.orientation.columns;\n",
    "            const jagged = this.spriteMetaData.orientation.jagged || null;\n",
    "            const header = this.spriteMetaData.orientation.header || 0;\n",
    "            const pad = this.spriteMetaData.orientation.pad || 0;\n",
    "            const x = this.INIT_POSITION.x;\n",
    "            const y = this.INIT_POSITION.y;\n",
    "\n",
    "            // Calculate the dimensions of each individual sprite\n",
    "            const spriteWidth = sheetWidth / cols;\n",
    "            const spriteHeight = (sheetHeight - header * rows) / rows;\n",
    "\n",
    "            console.log(`Sprite Sheet Dimensions: ${sheetWidth}x${sheetHeight}`);\n",
    "            console.log(`Individual Sprite Dimensions: ${spriteWidth}x${spriteHeight}`);\n",
    "            console.log(`Rows: ${rows}, Columns: ${cols}`);\n",
    "\n",
    "            // Nested for loop to draw 2-dimensional sprite sheet\n",
    "            for (let row = 0; row < rows; row++) {\n",
    "                const columnsInRow = jagged ? jagged[row] || cols : cols;\n",
    "                for (let col = 0; col < columnsInRow; col++) {\n",
    "                    const srcX = col * spriteWidth;\n",
    "                    const srcY = row * (spriteHeight + header) - (pad * row);\n",
    "                    const destX = x + col * spriteWidth;\n",
    "                    const destY = y + row * spriteHeight;\n",
    "                    const destWidth = spriteWidth;\n",
    "                    const destHeight = spriteHeight;\n",
    "\n",
    "                    console.log(`Drawing row: ${row}, column: ${col}`);\n",
    "                    console.log(`Source: (${srcX}, ${srcY}, ${spriteWidth}, ${spriteHeight})`);\n",
    "                    console.log(`Destination: (${destX}, ${destY}, ${destWidth}, ${destHeight})`);\n",
    "\n",
    "                    this.ctx.drawImage(\n",
    "                        this.spriteImage,\n",
    "                        srcX, srcY + header, spriteWidth, spriteHeight, // Source rectangle\n",
    "                        destX, destY, destWidth, destHeight // Destination rectangle\n",
    "                    );\n",
    "                }\n",
    "            }\n",
    "        }\n",
    "    }\n",
    "\n",
    "    // Setup to Tux sprite\n",
    "    const tux = new CanvasData(TuxSpriteMetaData());\n",
    "}\n",
    "\n",
    "defineAndDrawSprite();\n",
    "</script>\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Hack #2: Display Individual Sprites\n",
    "\n",
    "Create new code cell(s) to display individual sprites from a sprite sheet. This sprite sheet will potentially be used in your game.\n",
    "\n",
    "**Challenge**: Use the concepts of 2D arrays, nested loops, and sprite metadata to extract and display individual sprites. Think about how you can manage and display different frames or animations for your game characters or objects.\n"
   ]
  }
 ],
 "metadata": {
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}