EpikTimer/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ### О компоненте | |
| 2 | 2 | ||
| 3 | 3 | EpikTimer - это секундомер для программиста, способный измерять очень короткие события с чрезвычайно высокой точностью в течение длительных периодов времени. Он прост в использовании, практически не потребляет ЦП и требует только 25 B оперативной памяти для реализации экземпляра таймера. Компонент предоставляет один внутренний таймер ... но неограниченное число может быть объявлен извне и связан с одним компонентом EpikTimer на форме. | |
| 4 | 4 | ||
| 5 | 5 | Загруженный архив содержит компонент, установочный пакет и демонстрационное приложение, которое иллюстрирует функции компонента, а также некоторые инструменты для оценки источников синхронизации в данной системе. | |
| 6 | 6 | ||
| 7 | 7 | Этот компонент был разработан для кроссплатформенных приложений и был написан специально для Lazarus IDE и Free Pascal Compiler, и включает в себя демонстрационное приложение. | |
| 8 | 8 | ||
| 9 | 9 | ### Автор | |
| 10 | 10 | ||
| 11 | 11 | Tom Lisjac | |
| 12 | 12 | ||
| 13 | 13 | ### Лицензия | |
| 14 | 14 | ||
| 15 | 15 | [LGPL](http://www.opensource.org/licenses/lgpl-license.php)(пожалуйста, свяжитесь с автором, если LGPL не совместима с лицензированием вашего проекта) | |
| 16 | 16 | ||
| 17 | 17 | ### Загрузка | |
| 18 | 18 | ||
| 19 | 19 | **Исходный код** можно загрузить из Git-репозитория следующим образом: | |
| 20 | 20 | ||
| 21 | - | ||
| 21 | + | ```text | |
| 22 | + | git clone https://github.com/graemeg/epiktimer.git | |
| 23 | + | ``` | |
| 22 | 24 | ||
| 23 | 25 | Если вы не хотите устанавливать Git-клиент, Github также позволяет загружать последний код в виде ZIP-архива. Просто перейдите по ссылке [Github EpikTimer](https://github.com/graemeg/epiktimer) и нажмите кнопку «Загрузить ZIP» справа. | |
| 24 | 26 | ||
| 25 | 27 | Все **tagged releases** (помеченные выпуски) можно скачать в формате .zip или .tar.gz, перейдя по этой ссылке [Github Releases](https://github.com/graemeg/epiktimer/releases) и выбрав zip или tar.gz ссылка для любого релиза, который вы хотите скачать. | |
| 26 | 28 | ||
| 27 | 29 | ------------------------------------------------------------------------ | |
| 28 | 30 | ||
| 29 | 31 | Прим.перев.: Боюсь ошибиться, но в релизах Лазаруса после v.2.0.0 точно, EpikTimer можно скачать и установить посредством **O**nline **P**ackage **M**anager. | |
| 30 | 32 | ||
| 31 | 33 | ------------------------------------------------------------------------ | |
| 32 | 34 | ||
| 33 | 35 | ### Статус проекта | |
| 34 | 36 | ||
| 35 | 37 | - В производстве/Стабильный | |
| 36 | 38 | ||
| 37 | 39 | ### Change Log | |
| 38 | 40 | ||
| 39 | 41 | - Initially written on 24-06-2003 TL | |
| 40 | 42 | - Pre-release 30-06-2003 TL - Needs testing on the BSD's and Win32 | |
| 41 | 43 | - Version 0.1 1-7-2003 TL | |
| 42 | 44 | ||
| 43 | 45 | 1. initial beta release | |
| 44 | 46 | ||
| 45 | 47 | - Version 0.2 3-7-2003 TL | |
| 46 | 48 | ||
| 47 | 49 | 1. Revised logic around hardware detection to prevent executing extended instructions if the HasCapabilityData call returns false. | |
| 48 | 50 | 2. Removed exposed low level diagnositic functions from unit interface. | |
| 49 | 51 | 3. Revised demo. | |
| 50 | 52 | ||
| 51 | 53 | - Version 0.3 15-11-2005 | |
| 52 | 54 | ||
| 53 | 55 | 1. Updated 0.2 version to make it compile on the latest Lazarus (0.9.10). | |
| 54 | 56 | 2. Added LCL to the required packages. | |
| 55 | 57 | 3. Changed mode to Delphi in order to compile. | |
| 56 | 58 | 4. Changed windows timebase to use QueryPerformanceCounter, because has a much greater precision then GetSystemTime. | |
| 57 | 59 | 5. Added changes to ensure the component compiles on Delphi 7.0 | |
| 58 | 60 | 6. Made tests on Windows and Linux | |
| 59 | 61 | 7. Small changes to the demo to make it compile | |
| 60 | 62 | ||
| 61 | 63 | - Version 1.0 06-10-2006 | |
| 62 | 64 | ||
| 63 | 65 | 1. Changes for 64 bits operation | |
| 64 | 66 | 2. Added units BaseUnix, Unix and UnixUtil, removed oldlinux (obsolete) | |
| 65 | 67 | 3. Gettimeofday -\> fpGettimeofday | |
| 66 | 68 | 4. Changed systemsleep for 64 bits systems | |
| 67 | 69 | 5. Some changes in timeval | |
| 68 | 70 | 6. Tested on AMD64 (linux) | |
| 69 | 71 | ||
| 70 | 72 | For any later changes, please see the Git commit log. | |
| 71 | 73 | ||
| 72 | 74 | ### Зависимости/Системные требования | |
| 73 | 75 | ||
| 74 | 76 | - Разрешение Nanosecond поддерживается в версиях Intel Pentium с счетчиком Timestamp. | |
| 75 | 77 | - Микросекундные системные часы являются временной базой по умолчанию. | |
| 76 | 78 | ||
| 77 | 79 | Протестировано на: | |
| 78 | 80 | ||
| 79 | 81 | - Pentium IV 3,2Ghz на Windows и Linux с большой точностью (~ 3,220,000,000 тиков/сек) | |
| 80 | 82 | - Pentium 233 МГц с чертовски маленьким Linux. Прекрасно работает с аппаратными часами. | |
| 81 | 83 | - Mobile AMD 64 Athlon 3200+ на Windows XP Home (32 bit), Lazarus 9.13 | |
| 82 | 84 | - Процессор AMD 64, работающем под управлением 64-битной версии Ubuntu Linux, Lazarus 9.18. | |
| 83 | 85 | - Intel i7-3770K, работающем под управлением 64-разрядной версии FreeBSD 9.1, использует FPC 2.6.2 | |
| 84 | 86 | - ARM CPU, использующем Raspberry Pi и FPC 2.6.2 | |
| 85 | 87 | ||
| 86 | 88 | ### Установка в Lazarus IDE | |
| 87 | 89 | ||
| 88 | 90 | - В Components/Open Package File, откройте etpackage.lpk | |
| 89 | 91 | - Скомпилируйте пакет и закройте окно диалога пакета | |
| 90 | 92 | - В Components -\> Open Package File, откройте etpackage_dsgn.lpk | |
| 91 | 93 | - Скомпилируйте пакет. | |
| 92 | 94 | - Нажмите кнопку "Install" и пересоберите Lazarus | |
| 93 | 95 | - Компонент появится в системной палитре (значок секундомера-линейки) | |
| 94 | 96 | ||
| 95 | 97 | ### Использование | |
| 96 | 98 | ||
| 97 | 99 | Перетащите компонент на форму. Компонент содержит один экземпляр таймера, и вызовы без параметров для запуска, остановки, истечения и очистки будут неявно ссылаться на него. | |
| 98 | 100 | ||
| 99 | 101 | **Когда таймер называется ET** | |
| 100 | 102 | ||
| 101 | 103 | ``` pascal | |
| 102 | 104 | uses epiktimer; | |
| 103 | 105 | ||
| 104 | 106 | var | |
| 105 | 107 | ET: TEpikTimer; | |
| 106 | 108 | ||
| 107 | 109 | procedure InitTimer; | |
| 108 | 110 | begin | |
| 109 | 111 | ET := TEpikTimer.Create(Application); | |
| 110 | 112 | end; | |
| 111 | 113 | ||
| 112 | 114 | procedure InstrumentedCall; | |
| 113 | 115 | Begin | |
| 114 | 116 | ET.Clear; // необязательно ... таймер очищается при создании | |
| 115 | 117 | ET.Start; | |
| 116 | 118 | ExecuteFirstTimedSection; | |
| 117 | 119 | ET.Stop; // таймер фактически приостановлен и может быть перезапущен позже | |
| 118 | 120 | TimedSection1:=ET.Elapsed; // запоминаем прошедшее время вообще | |
| 119 | 121 | MakeAnUntimedOverheadCall; // не учитывается в таймере | |
| 120 | 122 | ET.Start; //возобновляем таймер ... продолжаем накапливать тики | |
| 121 | 123 | CallTimedSection2; | |
| 122 | 124 | TimedSection2:=ET.Elapsed; //таймер продолжает работать ... мы просто сэмплируем его (т.е. формируем репрезентатитвную выборку). | |
| 123 | 125 | CallTimedSection3; | |
| 124 | 126 | CallSomethingElse; | |
| 125 | 127 | TimedSection3:=ET.Elapsed; //продолжаем считать ... фиксируем прошедшее время | |
| 126 | 128 | CallTimedSection4; | |
| 127 | 129 | TimedSection4:=ET.Elapsed; //продолжаем считать ... фиксируем прошедшее время | |
| 128 | 130 | ET.clear // готово ... таймер остановлен и обнулен | |
| 129 | 131 | end; | |
| 130 | 132 | ``` | |
| 131 | 133 | ||
| 132 | 134 | Вы также можете создать любое количество таймеров из одного компонента в форме, объявив запись TimerData и передав ее в качестве параметра для запуска, остановки, истечения и очистки с использованием перегруженных методов в компоненте. Примером может быть: | |
| 133 | 135 | ||
| 134 | 136 | ``` pascal | |
| 135 | 137 | Function TimedExecution: Extended; | |
| 136 | 138 | Var | |
| 137 | 139 | DiskAccessTime:TimerData; | |
| 138 | 140 | Begin | |
| 139 | 141 | ET.Clear(DiskAccessTimer); // Объявленные таймеры *должны* быть очищены перед использованием. | |
| 140 | 142 | ET.Start(DiskAccessTimer); | |
| 141 | 143 | ExecuteTheTimedSection; | |
| 142 | 144 | Result:=ET.Elapsed(DiskAccessTimer); // таймер продолжает работать ... | |
| 143 | 145 | и т.д. ... | |
| 144 | 146 | ``` | |
| 145 | 147 | ||
| 146 | 148 | Одним из конкретных применений EpikTimer является проверка того, прошло ли заданное количество времени, прежде чем продолжить выполнение задачи или выполнить другую итерацию той же задачи. | |
| 147 | 149 | ||
| 148 | 150 | ``` pascal | |
| 149 | 151 | DelayInSeconds := 8.5; // или любое значение | |
| 150 | 152 | OldTime := ET.Elapsed; | |
| 151 | 153 | ||
| 152 | 154 | while ((ET.Elapsed - OldTime) < DelayInSeconds) do | |
| 153 | 155 | begin | |
| 154 | 156 | ET.SystemSleep(10); | |
| 155 | 157 | end; | |
| 156 | 158 | ||
| 157 | 159 | // DelayInSeconds истек, и теперь вы можете продолжить выполнение кода | |
| 158 | 160 | ``` | |
| 159 | 161 | ||
| 160 | 162 | Смотрите etdemo.pas для дополнительных примеров использования компонентов | |
| 161 | 163 | ||
| 162 | 164 | #### EpikTimer в качестве профайлера | |
| 163 | 165 | ||
| 164 | 166 | EpikTimer может быть использован для профилирования скорости процедур: | |
| 165 | 167 | ||
| 166 | 168 | ``` pascal | |
| 167 | 169 | uses | |
| 168 | 170 | {$ifdef PROFILING}epiktimer,{$endif} | |
| 169 | 171 | ... | |
| 170 | 172 | ||
| 171 | 173 | type | |
| 172 | 174 | TMyClass = class | |
| 173 | 175 | private | |
| 174 | 176 | {$ifdef PROFILING} | |
| 175 | 177 | profiler: Tepiktimer; | |
| 176 | 178 | {$endif} | |
| 177 | 179 | ... | |
| 178 | 180 | end; | |
| 179 | 181 | ||
| 180 | 182 | implementation | |
| 181 | 183 | ||
| 182 | 184 | constructor TMyClass.Create(AOwner: TComponent); | |
| 183 | 185 | begin | |
| 184 | 186 | inherited Create(AOwner); | |
| 185 | 187 | ... | |
| 186 | 188 | {$ifdef CARDROOM_PROFILING} | |
| 187 | 189 | profiler := TEpikTimer.Create(Self) | |
| 188 | 190 | {$endif} | |
| 189 | 191 | end; | |
| 190 | 192 | ||
| 191 | 193 | procedure TMyClass.MethodToBeProfiled; | |
| 192 | 194 | begin | |
| 193 | 195 | {$ifdef PROFILING} | |
| 194 | 196 | profiler.Clear; | |
| 195 | 197 | profiler.Start; | |
| 196 | 198 | {$endif} | |
| 197 | 199 | // do stuff | |
| 198 | 200 | {$ifdef PROFILING} | |
| 199 | 201 | OPDebugLn('TMyClass.MethodToBeProfiled ' + FloatToStr(profiler.Elapsed)); | |
| 200 | 202 | {$endif} | |
| 201 | 203 | end; | |
| 202 | 204 | ``` | |
| 203 | 205 | ||
| 204 | 206 | ### Приложение ETDemo | |
| 205 | 207 | ||
| 206 | 208 | Приложение ETDemo не требует установки EpikTimer для компиляции и работы. Мне никогда не нравилось устанавливать палитру, полную компонентов, только для того, чтобы узнать, что мне не понравился ни один из них! :) | |
| 207 | 209 | ||
| 208 | 210 | **Установка** | |
| 209 | 211 | ||
| 210 | 212 | - Окройте etdemo.lpi | |
| 211 | 213 | - Скомпилируйте | |
| 212 | 214 | - Запустите | |
| 213 | 215 | ||
| 214 | 216 | ### Консольное приложение | |
| 215 | 217 | ||
| 216 | 218 | Если у вас нет экземпляра объекта «Приложение», описанного выше, просто создайте экземпляр EpikTimer следующим образом. Он должен быть освобожден вручную, когда в нем отпадет нужда: | |
| 217 | 219 | ||
| 218 | 220 | ``` pascal | |
| 219 | 221 | ET := TEpikTimer.Create(nil) | |
| 220 | 222 | ... здесь ваш код ... | |
| 221 | 223 | ET.Free; | |
| 222 | 224 | ``` | |
| 223 | 225 | ||
| 224 | 226 | ### См. также | |
| 225 | 227 | ||
| 226 | 228 | - [[doc:fcl/fptimer/index.html|FPTimer included with FPC/Lazarus]] | |
| 227 | 229 | - [[Yet another Running Timer]] | |
| 228 | 230 | ||
| 229 | 231 | --- | |
| 230 | 232 | *From the Free Pascal wiki, page "EpikTimer/ru", as it stood on 2019-09-23 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 231 | 233 | Category: Components |
