| 295 | | |
| 296 | | == Graphics Status == |
| 297 | | |
| 298 | | Used by worker applications to inform graphics applications of various pieces of |
| 299 | | runtime state information. |
| 300 | | |
| 301 | | Worker applications call: |
| 302 | | {{{ |
| 303 | | #!c++ |
| 304 | | int boinc_write_graphics_status( |
| 305 | | double cpu_time, double elapsed_time, double fraction_done |
| 306 | | ); |
| 307 | | }}} |
| 308 | | |
| 309 | | Graphics applications call: |
| 310 | | {{{ |
| 311 | | #!c++ |
| 312 | | int boinc_parse_graphics_status( |
| 313 | | double* update_time, double* cpu_time, double* elapsed_time, double* fraction_done, BOINC_STATUS* status |
| 314 | | ); |
| 315 | | }}} |
| 316 | | |
| 317 | | === Graphics Status File === |
| 318 | | |
| 319 | | The graphics status file has the name of '''graphics_status.xml'''. |
| 320 | | |
| 321 | | It has following structure: |
| 322 | | {{{ |
| 323 | | <graphics_status> |
| 324 | | <updated_time>X</updated_time> |
| 325 | | <cpu_time>X</cpu_time> |
| 326 | | <elapsed_time>X</elapsed_time> |
| 327 | | <fraction_done>X</fraction_done> |
| 328 | | <boinc_status> |
| 329 | | <no_heartbeat>0|1</no_heartbeat> |
| 330 | | <suspended>0|1</suspended> |
| 331 | | <quit_request>0|1</quit_request> |
| 332 | | <reread_init_data_file>0|1</reread_init_data_file> |
| 333 | | <abort_request>0|1</abort_request> |
| 334 | | <network_suspended>0|1</network_suspended> |
| 335 | | </boinc_status> |
| 336 | | </graphics_status> |
| 337 | | }}} |
| 338 | | Required elements: |
| 339 | | '''updated_time''':: |
| 340 | | UNIX time of the last time this file was updated. |
| 341 | | '''cpu_time''':: |
| 342 | | Amount of CPU time this task has consumed, in seconds. |
| 343 | | '''elapsed_time''':: |
| 344 | | Amount of wall clock time this task has consumed, in seconds. |
| 345 | | '''fraction_done''':: |
| 346 | | What percentage of the overall task is complete, values between 0..1. |
| 347 | | '''no_heartbeat''':: |
| 348 | | Whether or not the task has received a heartbeat as of the last update. |
| 349 | | '''suspended''':: |
| 350 | | Whether or not the task is suspended. |
| 351 | | '''quit_request''':: |
| 352 | | Whether or not the task has been requested to exit. |
| 353 | | '''reread_init_data_file''':: |
| 354 | | Whether or not the task should reread all initialization data. |
| 355 | | '''abort_request''':: |
| 356 | | Whether or not the task has been requested to abort. |
| 357 | | '''network_suspended''':: |
| 358 | | Whether or not the task has been told the network has been suspended. |