Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.

memory-logic.html 8.3KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. <!DOCTYPE html>
  2. <html>
  3. <meta charset="utf-8">
  4. <head>
  5. <link rel="stylesheet" href="../../style.css">
  6. </head>
  7. <body>
  8. <script data-goatcounter="https://services.opengamestudio.org:443/count" async src="//services.opengamestudio.org:443/count.js"></script>
  9. <div id="header">
  10. <div>
  11. <strong id="title">Open Game Studio</strong>
  12. <div id="lang">
  13. <a href="../../en/news/memory-logic.html">EN</a>
  14. <a href="../../ru/news/memory-logic.html">RU</a>
  15. </div>
  16. </div>
  17. <div class="header2">
  18. <div class="menu">
  19. <a href="../../ru/news/index.html">Новости</a>
  20. <a href="../../ru/game/index.html">Игры</a>
  21. <a href="../../ru/tool/index.html">Инструменты</a>
  22. <a href="../../ru/page/about.html">О нас</a>
  23. </div>
  24. <a class="discord" href="https://discord.gg/3A6THQabNf">
  25. <img src="../../images/discord.png"></img>
  26. </a>
  27. <div class="clear"></div>
  28. </div>
  29. </div>
  30. <h3 class="left_item_title">В новостях...</h3>
  31. <center>
  32. <div class="news_item">
  33. <h2 class="news_item_title">
  34. <a href="memory-logic.html">Игровая логика «Памяти»</a>
  35. </h2>
  36. <p class="news_item_date">
  37. 2024-05-03 00:00
  38. </p>
  39. <div class="news_item_contents">
  40. <h1 id="">Игровая логика «Памяти»</h1>
  41. <p>В апреле реализовал игровую логику игры «Память» на Python в виде модели ограниченного языка и успешно перевёл её инструментом в C++.</p>
  42. <p>Модель ограниченного языка предполагает следующую архитектуру из двух частей:</p>
  43. <ol>
  44. <li>контекст состояния</li>
  45. <li>чистые функции без побочных эффектов, работающие лишь с контекстом</li>
  46. </ol>
  47. <p>Контекст состояния игровой логики на Python получился следующим (<a href="https://git.opengamestudio.org/kornerr/research-portable-memory/src/commit/6fcd542daa6242c8c23dddb88d04cda74a730328/v3/memory_Context.h">C++</a>):</p>
  48. <pre><code class="python language-python">class memory_Context:
  49. def __init__(self):
  50. self.hiddenItems = []
  51. self.mismatchedItems = []
  52. self.playfieldItems = {}
  53. self.playfieldSize = 0
  54. self.recentField = "none"
  55. self.selectedId = -1
  56. self.selectedItems = []
  57. self.victory = False
  58. </code></pre>
  59. <p>Т.к. инструмент на текущий момент работает лишь с функциями, то контекст для Python и С++ пока пишем руками.</p>
  60. <p>Функции получились примерно такими (<a href="https://git.opengamestudio.org/kornerr/research-portable-memory/src/commit/6fcd542daa6242c8c23dddb88d04cda74a730328/v3/memory.cpp#L29">C++</a>):</p>
  61. <pre><code class="python language-python"># Select item
  62. @llm_by_value
  63. def memory_selectItem(
  64. c: memory_Context
  65. ) -&gt; memory_Context:
  66. if (
  67. len(c.selectedItems) == 2
  68. ):
  69. c.selectedItems.clear()
  70. #}
  71. c.selectedItems.append(c.selectedId)
  72. c.recentField = "selectedItems"
  73. return c
  74. #}
  75. </code></pre>
  76. <p>Особенности функций для модели ограниченного языка:</p>
  77. <ul>
  78. <li>декоратор <code>@llm_by_value</code> в Python нужен для передачи аргументов по значению, а не по ссылке (по умолчанию - по ссылке)</li>
  79. <li>передача по значению обязательна для ограничения сферы действия функции ровно одним исходящим полем контекста, т.е. это реализация Принципа Единственной Ответственности (Single Responsibility Principle)</li>
  80. <li>контекст содержит поле <code>recentField</code>, представляющее собой хранимое «событие»; это поле позволяет функциям среагировать лишь в момент изменения значения интересующего поля</li>
  81. <li>функция обязана в поле <code>recentField</code> указать изменённое поле контекста либо <code>none</code> в случае отсутствия изменений</li>
  82. <li>функция принимает на вход контекст и выдаёт (изменённый) контекст на выход</li>
  83. </ul>
  84. <p>Полный список фукций игровой логики «Памяти»:</p>
  85. <table>
  86. <thead>
  87. <tr>
  88. <th>№</th>
  89. <th>Функция</th>
  90. <th>Инициатор вызова</th>
  91. <th>Описание</th>
  92. </tr>
  93. </thead>
  94. <tbody>
  95. <tr>
  96. <td>1</td>
  97. <td><code>memory_generateConstPlayfield</code></td>
  98. <td>Пользователь</td>
  99. <td>Генерируем упрощённое игровое поле, в котором последовательно парами идут элементы одной группы</td>
  100. </tr>
  101. <tr>
  102. <td>2</td>
  103. <td><code>memory_selectItem</code></td>
  104. <td>Пользователь</td>
  105. <td>Выбор элемента игрового поля</td>
  106. </tr>
  107. <tr>
  108. <td>3</td>
  109. <td><code>memory_shouldDeselectMismatchedItems</code></td>
  110. <td>Система</td>
  111. <td>Реакция снятия выделения с пары выбранных фишек различающихся групп</td>
  112. </tr>
  113. <tr>
  114. <td>4</td>
  115. <td><code>memory_shouldDetectVictory</code></td>
  116. <td>Система</td>
  117. <td>Реакция определения победы после скрытия всех фишек</td>
  118. </tr>
  119. <tr>
  120. <td>5</td>
  121. <td><code>memory_shouldHideMatchingItems</code></td>
  122. <td>Система</td>
  123. <td>Реакция скрытия пары выбранных фишек одной группы</td>
  124. </tr>
  125. </tbody>
  126. </table>
  127. <p>Для удостоверения работоспособности и идентичности работы этих функций как в Python, так и в C++, на каждую функцию ввёл минимум по одной функции проверки:</p>
  128. <ul>
  129. <li><code>memory_test_generateConstPlayfield</code></li>
  130. <li><code>memory_test_selectItem_1x</code></li>
  131. <li><code>memory_test_selectItem_2x</code></li>
  132. <li><code>memory_test_selectItem_3x</code></li>
  133. <li><code>memory_test_shouldDeselectMismatchedItems</code></li>
  134. <li><code>memory_test_shouldDeselectMismatchedItems_itemTwice</code></li>
  135. <li><code>memory_test_shouldDetectVictory</code></li>
  136. <li><code>memory_test_shouldHideMatchingItems</code></li>
  137. </ul>
  138. <h1 id="-1">Планы на май</h1>
  139. <p>Сделаю возможность сыграть одну партию игры «Память» в текстовом интерфейсе.</p>
  140. </div>
  141. </div>
  142. <div id="disqus_thread"></div>
  143. <script>
  144. var disqus_config = function () {
  145. this.page.url = "https://opengamestudio.org/ru/news/memory-logic.html";
  146. this.page.identifier = "memory-logic.html";
  147. };
  148. (function() { // DON'T EDIT BELOW THIS LINE
  149. var d = document, s = d.createElement('script');
  150. s.src = 'https://opengamestudio.disqus.com/embed.js';
  151. s.setAttribute('data-timestamp', +new Date());
  152. (d.head || d.body).appendChild(s);
  153. })();
  154. </script>
  155. <noscript>Пожалуйста, включите JavaScript для просмотра <a href="https://disqus.com/?ref_noscript">комментариев на платформе Disqus.</a></noscript>
  156. <div id="footer">
  157. Сайт сгенерирован <a href="http://opengamestudio.org/pskov/ru">ПСКОВОМ</a>
  158. из <a href="http://github.com/ogstudio/site-opengamestudio">этого исходного кода</a>.
  159. </div>
  160. </center>
  161. </body>
  162. </html>