DEPRECATED - the samples directory is now part of the BOINC tree

David 7 April 2006

- extended upper_case so that it draws graphics

(text, image, bouncing ball)

NOTE: to get this to work, you have to put in your build dir:

- file called "logo.jpg" (the image)

- Helvetica.txf

- a file called "in" (any old text)

- added text functions to library

uppercase/

upper_case.C

win_build/

libboincapi.vcproj

Charlie 11 April 2006

- Mac: updated XCode project for upper_case

mac_build/

UpperCase.xcodeproj/

project.pbxproj

David 12 Apr 2006

- split out graphics code into separate file

uppercase/

uc_graphics.C (new)

upper_case.C

win_build/

upper_case.vcproj

David 13 Apr 2006

- got graphics to work under Linux; added a Makefile

uppercase/

Makefile (new)

README (new)

upper_case.C

David 13 Apr 2006

- handle mouse events

uppercase/

uc_graphics.C

David 21 Apr 2006

- resolve logo filename

uppercase/

uc_graphics.C

upper_case.C

Charlie 27 April 2006

- Mac: updated XCode project for upper_case, fixed

jconfig.h to be cross-platform. upper_case now

works fully on Intel and PowerPC Macs.

jpeglib/

jconfig.h

mac_build/

UpperCase.xcodeproj/

project.pbxproj

David 29 Apr 2006

- use project preferences (<color_scheme>) for graphics color

- remove -exit, -signal options from upper_case

uppercase/

uc_graphics.C

upper_case.C

David 1 May 2006

- implement boinc_reread_prefs()

uppercase/

uc_graphics.C

David 26 May 2006

- Added sleeper application (to test non-CPU-intensive features)

sleeper/

sleeper.C

Makefile

David 29 May 2006

- moved wrapper application here from boinc/apps

win_build

sleeper.vcproj

wrapper.vcproj

wrapper/

wrapper.C

Makefile

Rom 31 May 2006

- Demonstrate delay load functionality on graphics libraries for Windows.

uppercase/

uc_graphics.C

David 13 June 2006

- Added "worker" (for testing wrapper)

worker/

Makefile

worker.C

David 13 June 2006

- added Win project file for worker,

fixed names in project files, got stuff to compile

uppercase/

upper_case.C

win_build/

samples.sln

sleeper.vcproj

worker.vcproj (new)

worker/

worker.C

wrapper/

wrapper.C

David 14 June 2006

- debugged and updated "wrapper" program.

It works now, more or less, on Windows.

- wrapper no longer copies input/output files.

You must use the <copy_file/> attribute

in the file reference instead.

- attempted to have wrapper pass stderr handle to worker

(Windows). Doesn't work yet.

worker/

worker.C

wrapper/

wrapper.C

David 16 June 2006

- generalized wrapper.C so task descriptions are kept in structs;

changed format of job file

(suggested by Janus)

wrapper/

Makefile

wrapper.C

David 12 Aug 2006

- wrapper: add support for stdin/stdout files

(adapted from Eric Myers)

- changed project files to VS 2005

win_build/

*.vcproj

wrapper/

wrapper.C

David 16 Aug 2006

- wrapper: get it to compile on Win, and fix XML parsing

wrapper/

wrapper.C

David 9 Sept 2006

- change wrapper to use new XML parser

wrapper/

wrapper.C

David 11 Sept 2006

- added library dependencies to makefiles

uppercase/Makefile

sleeper/Makefile

worker/

Makefile

worker.C

wrapper/Makefile

David 11 Sept 2006

- include all apps in VS solution

win_build/samples.sln

David 26 Sept 2006

- close state file in uppercase (from Ian/Tigher)

uppercase/

upper_case.C

David 4 Nov 2006

- uppercase: call boinc_graphics_possible() instead of

using a bunch of mysterious inline code.

This is supposed to be a good example, not a bad one.

uppercase/

upper_case.C

Rom 6 Nov 2006

- Checkin VS 2003 project files.

David 8 Nov 2006

- The upper_case project file (but not the others)

needs GDI32.DLL;OPENGL32.DLL;GLU32.DLL in its list

of Delay Loaded DLLs (Linker properties),

and delayimp.lib in its Additional Dependencies

uppercase/

logo.jpg (new)

David 23 Nov 2006

- don't include util.h in worker.C!

- fix win compile

worker/

worker.C

David 24 Nov 2006

- change "worker" to use stdin/stdout

- change "worker" to take nsec CPU arg

- add example job file

worker/

worker.C

wrapper/

job.xml

David 25 Nov 2006

- wrapper: redirection of stdin/stdout wasn't

working correctly on Windows.

Need to open files with CreateFile().

win_build/

samples.sln

wrapper/

wrapper.C

David 5 Dec 2006

- changed upper_case options to -early_crash

-early_exit

uppercase/

upper_case.C

David 8 Dec 2006

- added -early_sleep option to upper_case

(for debugging core client)

uppercase/

uc_graphics.C

upper_case.C

David 18 Dec 2006

- compile fix

win_build/

libboinc_vcproj

David 27 Dec 2006

- comment out boinc_graphics_possible() call

uppercase/

upper_case.C

David 11 Jan 2007

- upper_case: if checkpoint found,

truncate the output file to the indicated size.

Otherwise a checkpoint/restart generally produces a bad result.

uppercase/

upper_case.C

David 21 Feb 2007

- compile fixes

sleeper/

sleeper.C

uppercase/

upper_case.C

win_build/

libboinc.vcproj

wrapper/

wrapper.C

David 20 Mar 2007

- wrapper (Unix) get actual CPU time of child (not wall time)

- uppercase (Unix): change makefile to work on FC6

uppercase/

Makefile

uc_graphics.C

wrapper/

wrapper.C

David 20 Mar 2007

- wrapper (Unix): use more efficient way of getting CPU time

wrapper/

wrapper.C

David 26 Apr 2007

- wrapper: pass wrapper's command-line args to application,

after those in the job file (if any).

This lets you pass different command-line args to the app

for different workunits,

without creating a new app version per workunit.

NOTE: actually, I don't think this is necessary;

the job file can be part of the workunit, not part of the app version.

wrapper/

wrapper.C

Rom 9 May 2007

- Update Windows build files so that the advanced features of

Visual Studio can be supported, like building multiple binaries

at a time.

win_build/

*.vcproj

David 22 May 2007

- add version 6-style app

example_app/

Makefile

uc2.C

uc2_graphics.C

David 22 May 2007

- first stab at getting it to work on Win

win_build/

libboincapi.vcproj

libgraphics2.vcproj (new)

samples.sln

uc2.vcproj (new)

uc2_graphics.vcproj (new)

David 23 May 2007

- version 6 example app works on Win

example_app/

uc2.C

uc2.h (new)

uc2_graphics.C

win_build/

libgraphics2.vcproj

samples.sln

uc2.vcproj

uc2_graphics.vcproj

David 23 May 2007

- version 6 example app works on Linux

example_app/

uc2.h

uppercase/

Makefile

David 28 May 2007

- Wrapper can handle multiple tasks

wrapper/

job.xml

wrapper.C

David 8 June 2007

- Wrapper: use default diag options

wrapper/

wrapper.C

David 8 June 2007

example_app/

uc2.C,h

uc2_graphics.C

David 13 June 2007

- wrapper: set thread priority of worker processes

to IDLE class (Win);

set prior of worker processes to PROCESS_IDLE_PRIORITY (Unix)

uppercase/

upper_case.C

wrapper/

wrapper.C

David 19 June 2007

example_app/

uc2_graphics.C

David 28 June 2007

- wrapper: report CPU time correctly when >1 job

wrapper/

wrapper.C

David 17 July 2007

- fix fraction done for uppercase.

fixes #341

uppercase/

upper_case.C

David 20 July 2007

- example_app: #ifdef graphics stuff so we can use this in boinc/apps

example_app/

Makefile

uc2.C

Charlie 29 Aug 2007

- Mac: new XCode project for version 6 example_app.

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

David 17 Aug 2007

- project file fix

win_build/

libgraphics2.vcproj

Charlie 29 Aug 2007

- Mac: new XCode project for version 6 example_app.

- Mac example_app: Redirect stderr to gfx_stderr.txt so we have a way

to get error messages from system for graphics app; fix bugs.

example_app/

uc2_graphics.C

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

Charlie 2 Sep 2007

- Mac: remove jpeg sources from worker app in example_app XCode project.

- example_app: put boinc_graphics_get_shmem in main graphics loop to

retry if worker application has not yet created shared memory.

example_app/

uc2_graphics.C

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

Charlie 4 Sep 2007

- Mac: redirect stderr only on Development builds so as not to violate

sandbox security.

example_app/

uc2_graphics.C

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

David 12 Sept 2007

- uppercase: fix crash in standalone mode

- wrapper: fix append mode in win_fopen()

uppercase/

uc_graphics.C

wrapper/

wrapper.C

David 20 Sept 2007

- wrapper: fix append mode in win_fopen() (2nd try)

wrapper/

wrapper.C

Charlie 25 Sep 2007

- example_app: Set backwards_compatible_graphics" flag.

- example_app: Port David's crash fix of 12 Sept into uc2_graphics.C.

example_app/

uc2.C

uc2_graphics.C

David 26 Sept 2007

- example_app: don't set above flag (it's set by default now)

example_app/

uc2.C

David 26 Sept 2007

- minor stuff

example_app

uc2.C

uc2_graphics.C

Charlie 27 Sep 2007

Mac: remove "-DAPP_GRAPHICS" from XCode project C flags to fix a

compiler warning now that it is defined in the source file.

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

David 27 Nov 2007

- wrapper, Win: if GetProcessTimes() fails (which it does on Win 98/ME),

use wall CPU time as estimate of CPU time

wrapper/

wrapper.C

Charlie 28 Nov 2007

Mac: Add x86_64_Deployment build configuration to XCode project for use

with V6 Clients running under OS 10.5 on 64-bit capable Intel Macs.

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

David 6 Jan 2008

- small bug fix

wrapper/

wrapper.C

David 28 Jan 2008

- example app: parse <max_frames_sec> and <max_gfx_cpu_pct>

from project-specific prefs. This gives the user a couple

of ways of limiting CPU usage for graphics.

- example app: define APP_GRAPHICS in project file, not source

example_app/

uc2.C

uc2_graphics.C

Charlie 19 Feb 2008

Mac: Restore "-DAPP_GRAPHICS" to XCode project C flags.

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

Charlie 21 Feb 2008

Mac: Add an application icon to example_app graphics application.

example_app/

uc2_graphics.C

mac/

uc2_graphics.icns

app_icon.h

David 6 Mar 2008

- wrapper: if a child exits with nonzero status X,

call boinc_finish() with ERR_CHILD_FAILED rather than X.

If X is zero in the low-order byte

(e.g. if the program isn't executable)

the BOINC client will restart us, which isn't what we want.

wrapper/

wrapper.C

David 6 Mar 2008

- wrapper (Win): suspend or resume all the threads in an app,

not just the initial one.

- wrapper: merge app_suspended and TASK::suspended variables

wrapper/

wrapper.C

David 6 Mar 2008

- Wrapper (Mac): use elapse wall time as CPU time;

there's no easy way to get another process's CPU time in Mac OS X

wrapper/

wrapper.C

David 9 Mar 2008

- wrapper: compile fixes for Mac

wrapper/

wrapper.C

Charlie 11 Mar 2008

- UpperCase: delete XCode project for deprecated uppercase application.

mac_build/

UpperCase.xcodeproj/ (removed)

project.pbxproj (removed)

Rom 13 Mar 2008

- Uppercase: Initialize the diagnostics framework for graphics

application.

example_app/

uc2_graphics.C

David 14 Mar 2008

- added example multi-thread application

multi_thread/

Makefile

multi_thread.C

David 14 Mar 2008

- get multi_thread to work on Windows, and fix it up

multi_thread/

multi_thread.C

win_build/

multi_thread.vcproj (new)

samples.sln

David 17 Mar 2008

- multi_thread: default to 1 thread; print to stderr at end

multi_thread/

multi_thread.C

David 20 Mar 2008

- multi-thread: the Windows version was running unexpectedly fast.

It turned out that the VS2005 C++ compiler was noticing

that giga_flop() didn't use any inputs or globals,

so it was caching its value after the first run.

Very impressive!

multi_thread/

multi_thread.C

win_build/

multi_thread.vcproj

Charlie 25 Mar 2008

- example_app: Create Mac makefile and build script to demonstrate

building project applications for the Mac using makefiles.

example_app/

Makefile_mac (new)

MakeMacExample.sh (new)

Charlie 26 Mar 2008

- example_app: Update Mac makefile and build script, create second,

stand-alone makefile to demonstrate another way to build Mac

applications.

example_app/

Makefile_mac

Makefile_mac2 (new)

MakeMacExample.sh

David 27 Mar 2008

- multi_thread: maintain fraction done;

get nthreads from command line, not init file

multi_thread/

multi_thread.C

Charlie 28 Mar 2008

- example_app: Fixes to Mac build script.

example_app/

MakeMacExample.sh

David 28 Mar 2008

- multi_thread: suspend/resume didn't work in the Unix implementation.

REMINDER TO SELF: you can't suspend or resume pthreads - period.

So I changed things so that in the Unix implementation,

we fork a second process, in which the threads run.

The first process handles suspend/resume messages

by signaling the 2nd process.

The 2nd process generates system messages (frac done, CPU time)

multi_thread/

multi_thread.C

David 31 Mar 2008

- example graphics app: if no heartbeat, quit after 5 seconds

example_app/

uc2_graphics.C

Charlie 1 Apr 2008

- example_app: Remove -fvisibility* compiler flags from all 3 Mac build

methods.

example_app/

Makefile_mac2

MakeMacExample.sh

mac_build/

UpperCase2.xcodeproj/

project.pbxproj

Rom 8 May 2008

- Uc2 - Change the call to diagnostics_init to boinc_init_graphics_diagnostics

for the graphics application.

example_app/

uc2_graphics.C

Rom 8 May 2008

- Example_App - Rename Uc2 stuff to example_app stuff.

win_build/

<various Files>

David 8 May 2008

- uppercase: use binary output mode on Win,

otherwise results don't match.

- graphics app: call boinc_finish_diag() instead of diagnostics_finish()

(API calls should start with boinc_;

it would be nice it the init/finish names matched)

example_app/

uc2_graphics.C

uc2.C

David 14 May 2008

- uppercase: borrow CPU-burning routine from multithread

(won't be optimized out)

example_app/

uc2.C

David 16 May 2008

- wrapper: when run a job, write program name and cmdline to stderr

wrapper/

wrapper.C

David 10 June 2008

- graphics: if no graphics app is running,

don't bother updating shmem

(not important in the example app,

but a useful technique if updating the shmem is expensive)

example_app/

uc2.C,h

uc2_graphics.C

David 17 June 2008

- wrapper: add two new features.

1) each task can include a <weight> (double, default=1).

The task's contribution to total fraction done is

proportional to the weight.

2) each task can include a <checkpoint_filename> (string)

This names a checkpoint file used by the app.

If its mod time changes, we'll assume a checkpoint

has been done and notify the client.

wrapper/

wrapper.C

David 18 June 2008

- change name of exit code

wrapper/

wrapper.C

David 18 June 2008

- wrapper: replace $PROJECT_DIR with project dir in task command lines

- wrapper: if program name starts with $PROJECT_DIR,

substitute with project dir and treat as physical name

wrapper/

wrapper.C

David 18 June 2008

- wrapper: Win: change slashes to backslashes in executable path

wrapper/

wrapper.C

David 19 June 2008

- wrapper, Win: put quotes around program name in command-line arg

to CreateProcess() (in case it contains spaces)

- wrapper: close files

wrapper/

wrapper.C

David 26 June 2008

- wrapper: added --graphics cmdline arg.

Use this if your app has a graphics app.

wrapper/

wrapper.C

David 27 July 2009

- example app: fix a bug in June 10 checkin.

If we don't update the update_time field,

the graphics app will immediately exit.

example_app/

uc2.C

uc2_graphics.C

Charlie 11 Feb 2009

- Mac Samples: adjust XCode project for current source file names

(*.cpp instead of *.C).

samples/

mac_build/

UpperCase2.xcodeproj