{"id":13,"date":"2017-05-27T08:54:03","date_gmt":"2017-05-27T08:54:03","guid":{"rendered":"https:\/\/blogs.scummvm.org\/yinsimei\/?p=13"},"modified":"2022-05-24T08:54:34","modified_gmt":"2022-05-24T08:54:34","slug":"gsoc-week-1","status":"publish","type":"post","link":"https:\/\/blogs.scummvm.org\/yinsimei\/2017\/05\/27\/gsoc-week-1\/","title":{"rendered":"GSoC Week 1"},"content":{"rendered":"

GSoC 2017: Sludge Engine Week 1<\/h1>\n

Week task conclusion<\/h1>\n

In general, my first week of working for GSoC project was going smoothly. And a huge thank you to my mentors _sev(Eugene Sandulenko), t0by(Tobia Tesan) and all scummvm team members that has helped me during this week.<\/p>\n

Due to my project plan, my task for this week was originally :<\/p>\n\n\n\n
Task 1-1 Read game data file, initialization, timer , main_loop: <\/p>\n
    \n
  1. Use Common:File to read and slice game data file to init game objects and get index of sources in data file<\/li>\n
  2. Main loop: checkInput, playAnimation, handleInput, display, wait_frame\n
      \n
    1. Use TimerManager for timer<\/li>\n<\/ol>\n<\/li>\n
    2. Define macros and built-in functions<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      We have modified the plan, though, because it\u2019s not to rewrite the whole engine bit by bit as I originally thought, but to add whole engine files at first and stub all the parts calling libraries and functions forbidden by scummvm, then gradually unstub them using scummvm functions, till we have the whole engine.<\/p>\n

      To make a brief conclusion about what we have achieved and changed for\u00a0this week<\/b>\u00a0:<\/p>\n

      Achieved :<\/b><\/p>\n\n\n\n
      \n
        \n
      1. Add all sludge engine files into the scummvm and make it compile under Linux<\/a><\/li>\n
      2. Replace original data reading functions by Common::File\/SeekabbleReadStream<\/a><\/li>\n
      3. We are moving to make graphics work for sludge<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

        For later (They don\u2019t have much effects for now):<\/b><\/p>\n\n\n\n
        \n
          \n
        1. Timer, input, \u2026<\/li>\n
        2. File writing stuff<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

          Some problems left to be solved :<\/b><\/p>\n\n\n\n
          \n
            \n
          1. There is an segmentation fault due to the incomplete data loading of image files and animations whenever animation or sprite variables are referenced, at not initialized yet.<\/li>\n
          2. The code don\u2019t compile yet for Mac or Windows at present<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

            What\u2019s for next week: Graphics<\/h1>\n

            Generally, what we will do next week is :<\/p>\n\n\n\n
            \n
              \n
            1. Get backdrop (background) reading and displaying work<\/li>\n
            2. Get the sprite system up based on 1<\/li>\n
            3. Get spritebank up to have animations<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

              We have started a little on making graphics works, hopefully the \u201csegmentation fault\u201d could be fixed then if we would be able to load animations.<\/p>\n

              Some findings about sludge<\/h1>\n

              How game data works<\/h2>\n

              Find out how do they parse the game data file and try to adapt engine objects<\/p>\n

              Inner structure of .slg file:<\/p>\n

              A string here is composed of:<\/p>\n

                \n
              • 2 bytes to indicate the string length<\/li>\n
              • a series of chars for the string<\/li>\n<\/ul>\n

                \"\"<\/p>\n

                \"\"<\/p>\n

                \"\"<\/p>\n

                A resource block is like: (same for text, sub, object, data)<\/p>\n

                \"\"<\/p>\n

                  \n
                • Text<\/b>\u00a0is a string.<\/li>\n
                • Sub\u00a0<\/b>contains\u00a0<\/b>functions used and defined by user<\/li>\n
                • Object<\/b>\u00a0(items that can be put into inventory and combined and characters)<\/li>\n
                • Data<\/b>\u00a0(image, audio, video)<\/li>\n<\/ul>\n

                  In Sludge, we stock the beginning position of the index of resources (startOfObjectIndex, startOfDataIndex, startOfDataIndex<\/b>) to access them.<\/p>\n

                  Built-in function<\/h2>\n

                  In sludge, not only the events, but also all resources are integrated through built-in functions and everything except raw bitmaps and waveforms is handled through a constructor in the scripts. To take a simple script for example :<\/p>\n\n\n\n
                  sub init () { <\/p>\n

                  addOverlay (\u2018image.tga\u2019, 0, 0);<\/p>\n

                  playSound (\u2018tada.wav\u2019);<\/p>\n

                  pause (60);<\/p>\n

                  quitGame ();<\/p>\n

                  }<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                  We can see that the background and sound are all added through built-in functions called in these game scripts.<\/p>\n

                  The whole game interpreter is basing on a stack machine to work. For built-in functions as well. That is to say, when a built-in function is called, all its attributes will be pushed into a stack which will be pop() inside the function for using.<\/p>\n","protected":false},"excerpt":{"rendered":"

                  GSoC 2017: Sludge Engine Week 1 Week task conclusion In general, my first week of working for GSoC project was going smoothly. And a huge thank you to my mentors _sev(Eugene Sandulenko), t0by(Tobia Tesan) and all scummvm team members that has helped me during this week. Due to my project plan, my task for this […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-13","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/posts\/13","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/comments?post=13"}],"version-history":[{"count":1,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/posts\/13\/revisions"}],"predecessor-version":[{"id":14,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/posts\/13\/revisions\/14"}],"wp:attachment":[{"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/media?parent=13"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/categories?post=13"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.scummvm.org\/yinsimei\/wp-json\/wp\/v2\/tags?post=13"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}