Skip to Content
Last modified by Max on 2025/03/02 15:18
From version 2.58
edited by Max
on 2025/02/25 15:57
Change comment: (Autosaved)
To version 2.65
edited by Max
on 2025/02/25 16:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -972,26 +972,24 @@
972 972   return
973 973  {{/code}}
974 974  
975 -== **044: Cохранение скриншота в файл** ==
975 +== 044: Saving a screenshot to a file ==
976 976  
977 -Код команды 044,  данная команда предназначена для снятия образа памяти указанного размера (или определенного автоматически на основании сохраненных параметров)
978 -технически команда может служить как средство отладки ибо способная снимать образ памяти
979 -общее ограничение на снятие образа памяти - 2МБ на один образ
980 -\\в качестве параметров используется служебная страница памяти 76(8)
977 +Command code 044, this command is designed to take a memory image of the specified size (or determined automatically based on saved parameters) technically, the command can serve as a debugging tool because it is capable of taking a memory image the general limitation on taking a memory image is 2MB per image
978 +\\service memory page 76(8) is used as parameters
981 981  
982 -Структура заполнения информации о скриншоте
980 +Structure of filling information about a screenshot
983 983  
984 984  {{code language="c"}}
985 -// структура хидера скриншота
983 +// screenshot header structure
986 986  typedef __packed struct screen_header
987 987  {
988 - unsigned short int tag; // должен быть равен 0240
986 + unsigned short int tag; // must be equal to 0240
989 989  
990 - unsigned int begin_adress; // начальный адрес в словах - прямая задача в физических адресах
991 - unsigned int length; // длина в словах - прямая задача в физических адресах
988 + unsigned int begin_adress; // start address in words - forward task in physical addresses
989 + unsigned int length; // length in words - forward task in physical addresses
992 992  
993 - unsigned short int begin_page; // начальная страница - номер - прямая задача в номерах страниц
994 - unsigned short int len_pages; // количество страниц - прямая задача в номерах страниц
991 + unsigned short int begin_page; // start page - number - forward task in page numbers
992 + unsigned short int len_pages; // number of pages - forward task in page numbers
995 995  
996 996   unsigned short int R177300; //
997 997   unsigned short int R177302; //
... ... @@ -1009,57 +1009,56 @@
1009 1009   unsigned short int R177332; //
1010 1010   unsigned short int R177334; //
1011 1011   unsigned short int R177336; //
1012 - unsigned short int R177340; // - Регистр управления активацией окно - маски окон
1013 - unsigned short int R177342; // - Регистр управления r/o на окно
1014 - unsigned short int R177344; // - Регистр управления shadow окон - маски окон
1015 - unsigned short int R177346; // - Регистр управления маппером
1016 - unsigned short int R177350; // - регистр копия по записи 177130 в режиме записи управления памятью в SMK
1017 - unsigned short int R177352; // - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
1010 + unsigned short int R177340; // - Window activation control register - window masks
1011 + unsigned short int R177342; // - Control register r/o per window
1012 + unsigned short int R177344; // - Shadow window control register - window masks
1013 + unsigned short int R177346; // - Mapper control register
1014 + unsigned short int R177350; // - copy by record register 177130 in memory management write mode in SMK
1015 + unsigned short int R177352; // - copy by record register 177716 in memory management write mode in BK11M
1018 1018  
1019 - unsigned short int R177230; // - регистр управления
1020 - unsigned short int R177232; // - регистр номера страницы начала отображения - верхняя страница (слой 0)
1021 - unsigned short int R177240; // - регистр номера страницы начала отображения - средняя страница (слой 1)
1022 - unsigned short int R177242; // - регистр номера страницы начала отображения - нижняя страница (слой 2)
1023 - unsigned short int R177244; // - регистр вертикального скролинга слой 2
1024 - unsigned short int R177246; // - регистр вертикального скролинга слой 1
1025 - unsigned short int R177250; // - регистр вертикального скролинга слой 0
1026 - unsigned short int R177252; // - регистр гозизонтального скролинга слой 0
1027 - unsigned short int R177254; // - регистр гозизонтального скролинга слой 1
1028 - unsigned short int R177256; // - регистр гозизонтального скролинга слой 2
1017 + unsigned short int R177230; // - control register
1018 + unsigned short int R177232; // - display start page number register - upper page (layer 0)
1019 + unsigned short int R177240; // - display start page number register - upper page (layer 1)
1020 + unsigned short int R177242; // - display start page number register - upper page (layer 2)
1021 + unsigned short int R177244; // - vertical scroll register layer 2
1022 + unsigned short int R177246; // - vertical scroll register layer 1
1023 + unsigned short int R177250; // - vertical scroll register layer 0
1024 + unsigned short int R177252; // - horizontal scroll register layer 0
1025 + unsigned short int R177254; // - horizontal scroll register layer 1
1026 + unsigned short int R177256; // - horizontal scroll register layer 2
1029 1029  
1030 1030   unsigned short int paldata[338]; //
1031 1031  } screen_header_t;
1032 1032  {{/code}}
1033 1033  
1034 -Пример кода для заполнения страницы памяти
1032 +Example code for filling a memory page
1035 1035  
1036 1036  {{code language="assembler"}}
1037 1037  ;--------------------------------------------------
1038 -; карта 76й страницы - туда мы готовим данные для команды скринщотов
1039 - SCR_PAGE = 130000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000
1040 - SCR_TAG = SCR_PAGE+0 ; тут вход - 240 - 1 слово
1041 - SCR_ADDR_CONF = SCR_TAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
1042 - SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
1043 - SCR_MEM_CONF = SCR_PAGE_CONF+4. ; cюда конфигурацию памяти из регистров - 22 слова
1044 - SCR_VGA_CONF = SCR_MEM_CONF+44. ; сюда конфигурацию видеоконтроллера - 10 cлов
1045 - SCR_PAL = SCR_VGA_CONF+20. ; сюда 338. значений(слов) палитры 338 слов
1036 +; 76th page map - we prepare data for the screenshot command there
1037 +SCR_PAGE = 130000 ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window
1038 +SCR_TAG = SCR_PAGE+0 ; here is the input - 240 - 1 word
1039 +SCR_ADDR_CONF = SCR_TAG+2 ; here is the command with addresses - address+length 24 bits - 4 words
1040 +SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words
1041 +SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words
1042 +SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words
1043 +SCR_PAL = SCR_VGA_CONF+20. ; here 338. values ??(words) of palette 338 words
1046 1046  ;--------------------------------------------------
1047 1047  
1046 +; trap 41 - preparation of default information for screenshot functionality
1047 +PrepSRC: jsr R5, PUSHA ; batch saving of registers
1048 + mov @#177326,-(SP) ; save page 130k which was before the call
1049 + mov #76,@#177326 ; hook 76th page into window
1048 1048  
1049 -; trap 41 - подготовка дефолтной информации для работы функционала скриншотов
1050 -PrepSRC: jsr R5, PUSHA ; пакетное сохранение регистров
1051 - mov @#177326,-(SP) ; сохраним страницу 130k которая была до вызова
1052 - mov #76,@#177326 ; цепляем 76ую страницу в окно
1053 -
1054 - mov #100377,R3 ; константа-заполнитель
1051 + mov #100377,R3 ; constant-filler
1055 1055   mov #SCR_PAGE,R4
1056 1056   mov #2047.,R2
1057 1057  4$: mov R3,(R4)+
1058 1058   sob R2,4$
1059 1059  
1060 - mov #240,@#SCR_TAG ; проставляем тег
1057 + mov #240,@#SCR_TAG ; put the tag
1061 1061  
1062 - ; чистим участок адресов - дефолтно автоматическое определение адресов
1059 + ; clean the address section - default is automatic address detection
1063 1063   clr R3
1064 1064   mov #SCR_ADDR_CONF,R4
1065 1065   mov #10,R2
... ... @@ -1066,7 +1066,7 @@
1066 1066  2$: mov R3,(R4)+
1067 1067   sob R2,2$
1068 1068  
1069 - ;конфигурация памяти - дефолтная
1066 + ; memory configuration - default
1070 1070   mov #SCR_MEM_CONF,R4
1071 1071   mov #30,(R4)+ ;177300
1072 1072   mov #31,(R4)+ ;177302
... ... @@ -1085,29 +1085,29 @@
1085 1085   mov #110,(R4)+ ;177334
1086 1086   mov #100,(R4)+ ;177336
1087 1087  
1088 - mov #170000,(R4)+ ;177340 - Регистр управления активацией окно - маски окон
1089 - mov R3,(R4)+ ;177342 - Регистр управления r/o на окно
1090 - mov #7777,(R4)+ ;177344 - Регистр управления shadow окон - маски окон
1091 - mov #40404,(R4)+ ;177346 - Регистр управления маппером
1092 - mov R3,(R4)+ ;177350 - регистр копия по записи 177130 в режиме записи управления памятью в SMK
1093 - mov #16000,(R4)+ ;177352 - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
1085 + mov #170000,(R4)+ ;177340
1086 + mov R3,(R4)+ ;177342
1087 + mov #7777,(R4)+ ;177344
1088 + mov #40404,(R4)+ ;177346
1089 + mov R3,(R4)+ ;177350
1090 + mov #16000,(R4)+ ;177352
1094 1094  
1095 - ;конфигурация видеоконтроллера - дефолтная
1092 + ;Video controller configuration - default
1096 1096   ; 177230-177256
1097 1097   mov #SCR_VGA_CONF,R4
1098 1098  
1099 - mov #12201,(R4)+ ;177230 - регистр управления
1100 - mov #4,(R4)+ ;177232 - регистр номера страницы начала отображения - верхняя страница (слой 0)
1101 - mov R3,(R4)+ ;177240 - регистр номера страницы начала отображения - средняя страница (слой 1) "под спрайты"
1102 - mov R3,(R4)+ ;177242 - регистр номера страницы начала отображения - нижняя страница (слой 2) "под фон"
1103 - mov R3,(R4)+ ;177244 - регистр вертикального скролинга слой 2
1104 - mov R3,(R4)+ ;177246 - регистр вертикального скролинга слой 1
1105 - mov R3,(R4)+ ;177250 - регистр вертикального скролинга слой 0
1106 - mov R3,(R4)+ ;177252 - регистр гозизонтального скролинга слой 0
1107 - mov R3,(R4)+ ;177254 - регистр гозизонтального скролинга слой 1
1108 - mov R3,(R4)+ ;177256 - регистр гозизонтального скролинга слой 2
1096 + mov #12201,(R4)+ ;177230
1097 + mov #4,(R4)+ ;177232
1098 + mov R3,(R4)+ ;177240
1099 + mov R3,(R4)+ ;177242
1100 + mov R3,(R4)+ ;177244
1101 + mov R3,(R4)+ ;177246
1102 + mov R3,(R4)+ ;177250
1103 + mov R3,(R4)+ ;177252
1104 + mov R3,(R4)+ ;177254
1105 + mov R3,(R4)+ ;177256
1109 1109  
1110 - ; закачиваем палитру - берем дефолтную из этой ПЗУшки
1107 + ; download the palette - take the default one from this ROM
1111 1111   mov #SCR_PAL,R4
1112 1112   mov #PalData,R2
1113 1113   mov #338.,R3
... ... @@ -1114,32 +1114,31 @@
1114 1114  1$: mov (R2)+,(R4)+
1115 1115   sob R3,1$
1116 1116  
1117 - mov (SP)+,@#177326; вернем страницу с которой был вызов
1114 + mov (SP)+,@#177326; return the page from which the call was made
1118 1118   return
1119 1119  {{/code}}
1120 1120  
1121 -Вариантов указания участков памяти три
1118 +There are three options for specifying memory areas.
1122 1122  
1123 -1. указать адрес и длину 24х битные - cм формат, если их нет - система смотрит дальше
1124 -1. указать номер страницы и количество страницы, если их нет
1125 -1. система смотрит дальше - те делает скриншот на основании данных о регистрах 177230 и т.д..
1120 +1. specify the address and length 24-bit - see format, if they are not there - the system looks further
1121 +1. specify the page number and page quantity, if they are not there
1122 +1. the system looks further - that is, it makes a screenshot based on the data about registers 177230, etc.
1126 1126  
1127 -Cкриншот сохраняется в формате
1128 -- страница 76 - ее первый килобайт
1129 -- сам образ памяти (если режим слоеный - то все три слоя)
1124 +The screenshot is saved in the format
1125 +- page 76 - its first kilobyte
1126 +- the memory image itself (if the mode is layered - then all three layers)
1130 1130  
1131 1131  
1132 -Перед вызовом команды можно загрузить имя файла для сохранения скриншота [в cmosmem буфер], однако при его отсутствии (в буфере не будет имени - строки заканчивающейся 0) система сформирует свое имя, на основании следующего правила:
1133 -дефолтный путь для сохранения скриншотов
1129 +Before calling the command, you can load the file name for saving the screenshot [in the cmosmem buffer], but if it is missing (there will be no name in the buffer - a line ending with 0), the system will generate its own name based on the following rule: default path for saving screenshots
1134 1134  0:/SCREENS/
1135 -формат имени - DDHHMISS.SCR
1136 -где DD - две цифры дня месяца, HH - час, MI - минута, SS-секунда
1137 -\\Если в процессе выполнения команды возникнет ошибка - вместо имени будет "ERROR *"
1138 -к примеру
1131 +name format - DDHHMISS.SCR
1132 +where DD is two digits of the day of the month, HH is the hour, MI is the minute, SS is the second
1133 +\\If an error occurs during the command execution, the name will be "ERROR *"
1134 +for example
1139 1139  "ERROR f_open 6"
1140 1140  
1141 1141  
1142 -Пример программы
1138 +Example program
1143 1143  
1144 1144  {{code language="assembler"}}
1145 1145  ; обновим информацию в хидере скриншота