PropertyCase

Property cases (PropertyCase or PropCase) are basically variables in the camera's RAM that we can read and write from CHDK by using uBasic commands get_prop and set_prop. "Under the hood" some other uBasic commands work by changing propcases, making it possible to use them in a portable way. Some propcases are read only. Often writing to a propcase will have a different effect than pressing the corresponding buttons on the camera's user interface. Typically this means that while you may change something like the shutter speed and your change will be effective in your photo, it may not be updated to the camera's on-screen display.

To find out which Property case a function changes see this!

Note: there also is now a List of Params, it needs to be filled with data though ;)

Property cases are different for Digic II and Digic III cameras. EXAMPLE: A570IS ISO is at #149, not #21 like on the S3IS, and the white balance control is #268, not #206. Furthermore, some Digic III cameras (G7, SD800IS, SD900) use the Digic II property set. You are advised to confirm that these properties are appropriate for your camera before you attempt to change them.

Digic II

Digic II based camera (and some Digic III cameras: G7, SD800IS, SD900)

#	R/W	Description	A620	S3IS	SD900
0,236		Shooting MODE Dial position		*	*
1		Photo effect
2		Custom MyColors Sharpness
3		Custom MyColors Saturation
4		Custom MyColors Contrast
5		White Balance Mode (0,1,2,3,4,5,7 = Auto, Day Light, Cloudy, Tungsten, Fluorescent, Fluorescent H, Custom) S2: 6=flash same as SX10 maybe all S-Series
6		Drive mode (0=normal, 1=continuous, 2=timer)
8		Hi-speed continuous (1=OFF, 0=ON)
9		Metering mode (0=eval, 2=center, 1=spot)
10		Spot AE Point (0=center, 1=auto focus point)
11		Focus mode (0=Auto, 1=macro, 4=MF 5=super macro)
12		Manual Focus (0=Auto, 1=Manual)
13		AF S3IS: 0=Single, 1=continuous		*
14		Delay of selftimer (in msec)
15		Flash adjust mode S3IS: 0=Auto, 1=Manual (see 28&29)		*
16		Flash mode (0,1,2 = flash auto, flash on, flash off)
18		Red eye mode (0=OFF, 1=ON)
19		Flash slow sync (0=OFF, 1=ON)
20		Flash Sync Curtain (0=1st, 1=2nd)
21		ISO value S3IS: 0=auto, 1=ISO-HI, or actual ISO: 80,100,etc		*
23		Image quality S3IS: 0,1,2 from best to worst		*
24		Image resolution S3IS: 0,1,2,4,8 for L,M1,M2,S,W		*
25,26		EV correction (units: +/- 96 per 1 stop range) (On s3is and i guess on more models: Also used in movie mode!, but AE lock has to be activated -> 205 to 1)
28		Flash correction (units: +/- 96 per 1 stop range, if #15=0)
29		Manual flash output (units 0,1,2 from less to full, if #15=1)
32		Exposure bracket range (units: 96 per 1 stop extension)
34		Focus bracket range (2=Smallest, 1=Medium, 0=largest)
36		Bracket mode (0=none, 1=EV, 2=focus)
37		Orientation sensor SD900: 0=Normal, 270=Left, 90=Right also S2: -1=inverse not 180			*
38		Automatic Image Rotation S3IS / SD900: 1=ON, 0=OFF		*	*
39		Chosen Av (User AV)
40		Chosen Tv (User TV) SD900: 65152=15", 65184=13", 65218=10", 65248=8", 65280=6", 65312=5", 65344=4", 65376=3.2", 65408=2.5", 65440=2", 65472=1.6", 65504=1.3", 0=1"			*
46/47		Seem to be influenced by stitch mode, i guess this is important for exif data -> data for stitch programs or the canon stitch assisant - assumption!
52		Stitch Mode S3IS: 0=from left to right, 1=from right to left, 2=bottom to top, 3=top to bottom, 4=top left->top right->bottom left->bottom right		*
57		Digital Zoom S3IS: 0 - 6, 0 is no digital zoom, 6 is "most digital zoom" (48x) SD900: 3=2.3x, 1=1.4x, 0=no Zoom / Default		*	*
58		Digital Zoom State S3IS: 1=On, 0=Off SD900: 2=1.4x / 2.3x, 1=Default, 0=Off		*	*
63		AF-light S3IS / SD900: 1=ON, 2=OFF		*	*
64		manual settings
65,66		Focus distance
67		focus ok (green, not yellow) when in photo mode 1=OK, 0=not set
68		Coming Av
69		Coming Tv
71		422
72		Looks like it's ~ISO*something + 380
73		371
74		AE lock activated S3IS: 1=yes, 0=no; see 205 (also in movie mode)		*
75		0
76		0
77		min available Av
78	R	Flash fired
79	RW	Flash fire
80		1
81		1
82-85		Often the same, sometimes slightly different
86		Av
87		0
88		2
89		0
90		0
91		5
92		0
93		0
94		0
95		8
96		10
99		Zoom step S3IS: 0 = open wide, 128 = maximum zoom, on a620 this will be 8 i guess		*
100		Custom White Balance (28 bytes)
101		constantly varying with light depends on White Balance and Scene Mode
120		280457692 after shooting s2
126		Video FPS SD900: 30=30FPS, 15=15FPS			*
127		Video resolution SD900: 3=1024x768, 2=640x480, 1=320x240, 0=160x120			*
128		Video resolution = 640x480 SD900: 1=640x480, 0=320x240/1024x768/160x120			*
171		Zoom
172		Digital zoom
177		intervalometer #of shots
178		File numbering (Continuous=0, Auto Reset=1)
181		Display mode (record mode only) (0 = show info icons, 1 = Do not show info icons, 2 = LCD off, 3 = EVF)
184		Slideshow Settings - repeat slideshow (1 = repeat, 0 = do not repeat)
185		Slideshow Settings - duration (1 = 3 seconds, 2 = 4s, 3 = 5s, 4 = 6s, 5 = 7s, 6 = 8s, 7 = 9s, 8 = 10s, 9 = 15s, 10 = 30s)
186		Print Settings/DPOF (1 = standard, 2 = overview, 3 = both)
187		Print Settings/DPOF (1 = date, 0 = no date)
188		Print Settings/DPOF (1 = filenumber, 0 = no filenumber)
190		In Postcard mode this determines what will be "printed" into the pictures available on cameras which support this A620: 0 = off, 1 = date, 2 = date & time	*
192		AF Frame/Flexizone x-position
193	RW	AFL active / activate AF
194		used part of sensor when digital zoomed S3IS: no digital zoom = 2816 then descending with increased digital zoom: 2048,1600,1280,1024,832,704 - can be useful!		*
195		max resolution?
196	R	Language Setting: 2=english, 258 = german, 514 = french, 770 = dutch, 1026 = danish, 1282 = finnish, 1538 = italian, 1794 = norwegian, 2050=swedish, 2306 = spanish, 2562 = simplified chinese, 2818 = russian, 3074 = portuguese, 3330 = greek, 3586 = polish, 3842 = czech,4098=hungarian, 4354 = turkish, 4610 = traditional chinese, 4866 = Korean, 5122 = Thai, 5378 = arabic, 5634 = japanese) (Confirmed on s3is & a620 and several other cams) NOTE: I just discovered that this setting directly is related to NTSC/PAL setting. these numbers are valid vor PAL. If you set to NTSC, all these numbers are decremented by 1, meaning english is 1 and german is 257 in NTSC (instead of 2 and 258).	*	*	*
200		Selected Movie mode			*
204		Related to flash (at least on s3is) - if flash popped down, value is 4, if up value is 3 (in flash ON) and 0 (in Flash AUTO mode) - on a620 when i disable flash, this is also 4 (i guess we can ignore this value on cameras with a "fixed" flash, and use this on cameras with "pop-up flash" to detect if the flash is popped up!)		*
205		1 during shooting process (this may be an indication that exposure has been determined; it is set shortly after shoot_half, and remains set if AE lock activated. See #74) (in movie mode this is 1 when you activate AE Lock!!!)
206		Submode of "MyColors?" mode, including Color accent/swap S3IS: 0-11: off,strong,neutral,sepia,black/white,dia,brighter skintone,darker skintone,strong blue,strong green,strong red,custom color		*	*
207		Custom MyColors Red
208		Custom MyColors Blue
209		Custom MyColors Green
210		Custom MyColors Skin Tone
211		Color Accent color
212		Color Swap from color
213		Color Swap to color
218		Custom timer continuous (value: # of shots to be taken)
219		Self Timer setting S3IS: 0=2 sec, 1=10 sec, 2=custom continuous		*
223		Mic - recording frequency (0 = 11.025 kHz, 1 = 22.050 kHz, 2 = 44.100 kHz)
226		MODE Dial - looks like it's the same as propcase 0 (S3IS: tested in scene mode, cycling through "programs")		*	*
227		Mic Level S3IS: 1-5, low to high		*
228		Mic Wind Protection S3IS: 1=ON, 0=OFF		*
229		IS (0,1,2,3 = continous, shoot only, panning, off)
230		Converter (0=off, 1 = wide, 2 = tele)
231		Color Accent tolerance setting
233		Color Swap/Accent tolerance
235		Safety Shift (0 = off, 1 = on)
236		MODE Dial			-
237		47
254		Focus. auto, 320-725
257		Color Swap tolerance setting
260		500
262		0 in fireworks or movie mode, otherwise 1
274		411
298		201329664
299		-201264128

* = camera supports PropertyCase (PropertyCase value may be camera specific)

- = camera does not support PropertyCase (at least value does not change)

Digic III & Digic IV

• Digic III based cameras: SD1000, A570IS, A650IS, A590IS (and also others)
• Digic IV based cameras: SX10, SX1, SD990, SX200 (and also others); notes like ^[SX10] should fit also for other Digic IV based cameras with this feature...

#	R/W	Description
3	RO	Auto-Exposure Lock
4		Exposure bracket range (units: 96 per 1 stop extension)
5		AF Assist Beam Setting (0,1 = Off, On)
6	RW	Focus Mode (0,1,3,4,5 = Normal, Macro, Infinity, Manual, Super Macro [SX10])
8		AiAF Mode (0,1,2 = On, Off, FaceDetect)
11	RW	Auto-Focus Lock
12		AF Mode (0=single, 1=continuous) [SX10]
18	RW	Auto-Focus state after half-press (stays 1 if shoot_half is released!) (0 orange, >=1 green) (with AiAF=off only 0 or 1, with enabled AiAF or Face the value depends on position & number of AF boxes)
21		Auto Rotate (0,1 = Off, On)
23	RW	Av (for next shot, updates on half-shoot), 96 per 1 stop
24		Min Av (widest available aperture for current zoom, updates on half shoot), 96 per 1 stop. Note: on SD990, this includes the ND filter, if the ND was selected by the camera in an auto mode.
25		Min Av (widest available aperture for current zoom, updates on half shoot), 96 per 1 stop. Note: on SD990, this does not include the ND filter.
26	RW	User Av (user selected "market" value in M/Av modes, writes become effective on LCD on half shoot), 96 per 1 stop.
29		Bracket mode (0=none, 1=EV, 2=focus)
34		Bv
49,50		MODE Dial
55		Custom Color: Saturation (-2, -1, 0, 1, 2 = 254, 255, 0, 1, 2)
57		Picture Quality (0,1,2 = Superfine, Fine, Normal)
59		Custom Color: Contrast (-2, -1, 0, 1, 2 = 254, 255, 0, 1, 2)
60		Converter (0,1,2,4)
61		Language + video standard settings; Value=PAL; for NTSC=value-1 (A720) english=1, german=257, french=513, dutch=769, danish=1025, finnish=1281, italian=1537, norwegian=1793,ukrainian=2049, swedish=2305, spain=2561, chinese_simplified=2817, russian=3073, portuguese=3329, greek=3585, polish=3841, czech=4097, hungarian=4353, turkish=4609, chinese_traditional=4865, korean=5121, thai=5377, arabic=5633, romanian=5889, japanese=6145
63		Number of continuous shots taken last time
64	RW	Flash Sync Curtain (0=1st, 1=2nd)
65		Subject Dist 2 ("Near limit", most linear to real distance. You can get-and-set this prop_id, but it doesnt affect the near limit and/or the focus - tested with A590).
66	RW	Date stamp (0=Off, 1=Date, 2=Date & Time); only postcard mode
79		Delta Sv (What is this? Someone please add a description.)
91	RO	Digital Tele-Converter mode (>0 if enabled)
92	RO	Digital zoom source image width in pixels
94		Digital zoom mode (1="Standard", 0=any other mode)
95	RO	Digital Zoom depth (0--6: 0=none, 1--6 are for camera dependent zoom steps, higher number = higher magnification)
102	RO	Drive Mode (0,1,3,4: 0=single, 1=continuous, 2=continuous shooting AF [SX10 & sx200], 3=FaceSelf-Timer [SX10], 4=custom timer [SX10])
103		changes with light only in M-Mode (-445 is completely dark and 328 is fully bright. Also depends on the current av/tv setting.)
105		Display mode (record mode only) (0,1,2,3 = show info icons, do not show info icons, LCD off, EVF)
107,207	RO,RW	Exposure Shift/Compensation (32 for 1/3 stop)
111		External flash state (0=Absent, 1=Present and turned on, 2=Present but turned off)
113		Focus bracket range (2=Smallest, 1=Medium, 0=largest)
115	RO	Ready to shoot, focus okay.
117		File numbering (Continuous=0, Auto Reset=1)
121	RW	Flash adjust mode (0=Auto, 1=Manual (see 127&141)
122	RO	Flash used in last shot (0,1 = Flash not used, Flash used)
127	RW	Flash exposure compensation (units: +/- 96 per 1 stop range, if #121=0)
133	RO	Manual Focus Mode (0,1 = Off,On)
141	RW	Manual flash output (units 0,1,2 from min to full, if #121=1)
143	RW	Flash Mode (0,1,2 = flash auto, flash on, flash off)
145		IS (0,1,2,3 = continous, shoot only, panning, off)
149	RW	ISO Mode (0=auto, 1=high auto, 100=manual ISO 100 etc)
155	RW	Metering Method (0, 1, 2 = Evaluative, Spot, Center)
165	RW	Time lapse movie shoot interval (milli-seconds)
166		Movie frame rate
169		Video size mode (160=0, 320=1, 640=2, ?=3, 1280x720=4)
170		Video play mode (LP=0, SP=1)
184		My Colors (0 - 11): 0=Off, 1=Vivid, 2=Neutral, 3=B/W, 4=Sepia, 5=Positive Film, 6=Lighter Skin Tone, 7=Darker Skin Tone, 8=Vivid Red, 9=Vivid Green, 10=Vivid Blue, 11=Custom Color)
195		Optical Zoom position (0,1,2,3,4,5,6...128) (0 to 128 on Sx10)
196		(? Scene dependent/ stays 0 when scene is black or when scene has optimal light)
206		Shooting in progress
208		Flash Ready (1 during shutter half press after metering if camera is going to use flash)
212		Review info (0=Off, 2=detailed, 3=focus check) [SX10]
213		Red-Eye (0 "Off", 1 "On")
218	RW	Picture Size (0,1,2,3,4,5,6,8 = L,M1,M2,M3,S,RAW (on g9),Postcard, W)
219	RO	Orientation Sensor (0,90,270)
220		Safety FE (0 "Off", 1 "On")
223		Timer Mode (0,1,2 = 2 Seconds, 10 Seconds, Custom), SX 200 IS & SD 780 0,1,2,3,4=Off, 2 Seconds, 10 Seconds, Custom, Face Detection
224		Timer Delay (ms) (can't override)
225		Custom Color: Sharpness (-2, -1, 0, 1, 2 = 254, 255, 0, 1, 2)
227		"long time exposure" indicator: 1 always in "Night snapshot" scene mode & when the exposure time is set to >= 1s
228	RW	Audio channels (0=1ch, 1=2ch). Right channel mute if 2ch selected.
229	RW	Audio sample rate (0=11025, 1=22050, 2=44100)
230	RW	Audio sample format (0=u8, 1=s16le). U8 gives "Unidentified Image" in Play mode but works with other players.
233		Orientation stitch assistant (left to right=0, right to left=1)
245		Subject Dist 1 (equals id 65 on the A590)
246		Sv Market (for next shot, updates on half-shoot), 96 per 1 stop
247		Sv (for next shot, updates on half-shoot), 96 per 1 stop
249		Digital Zoom position, same as #95, 0-6 on a590
251		Optical Zoom position, same as #192, 0-128 on [SX10], same as #195 on a590, 0-7 on a590
252		Manual focus: equal value like 65, 245
254		Focus related, -1 for infinity
262	RW	Tv (for next shot, updates on half-shoot), 96 per 1 stop
264	RW	User Tv (user selected value in M/Tv modes, writes become effective on LCD on half shoot), 96 per 1 stop
268		White Balance Mode (0,1,2,3,4,5,6,7 = Auto, Day Light, Cloudy, Tungsten, Fluorescent, Fluorescent H, Flash [SX10], Custom)
269		White Balance Value (Middle around 900. Less corrects red and higher corrects blue. Can't override.)
277		Safety MF (0 "Off", 1 "On")
280		RAW+JPG (Raw+Jpg off = 0, Raw+Jpg on = 1)
290		iContrast setting (0=off, 1=on) [SX10]
293		Servo AF (0=off, 1=on) [SX10]
294		Aspect / Widescreen (1=widescreen, 0=standard) [SX1] ([1])
296	RO	ND filter status (0 off, 1 on) for manual mode. NOT updated in auto modes (SD990). Note: you can write to it, but actual ND state doesn't change.
297		??? ([SX10],[SD990]: 1 after half-press)

On the A590, it seems that possible prop-id´s range from 0 to 287. Id´s greater than 287 will return always "14".

New Digic IV (propset3)

This is work in process, pls. help filling this table !

• New propcases introduced with the G11
• Digic IV based cameras: G11, probably S90, probably SX210, probably SD4000
• include\propset3.h

#	R/W	Description	SD4000
5	RW	AF Assist Beam Setting (0=Off, 1=On)
26	?	User Av (user selected "market" value in M/Av modes)	*
49,50	?	MODE Dial	*
63	R	Number of shots taken during last continuous shoot, Or, number of shots taken so far in current continuous shoot
127	RW	Flash Exposure Compensation (+/- 32, 64, 96, 128, 160, 192 = +/- 1/3, 2/3, 1, 1 1/3, 1 2/3, 2) Note: you can write to it, but actual state doesn't change.
138	RW	Low-light mode (sensor sends 1/4 the data; 0=off, 1=on; use with picture size M)
149	?	ISO Mode SD4000: 0=Auto, 125, 200, 400, 800, 1600, 3200	*
155	RW	Meter Mode (0=evaluative, 1=spot, 2=center weighted) Note: you can write to it, but actual mode doesn't change.	*
194	RW	ND Filter (0=off, 1=on) Note: you can write to it, but actual filter state doesn't change.
197	RW	Optical Zoom Setting (0-13) Note: you can write to it, but actual zoom state doesn't change.
209	RW	Exposure Compensation Dial (+/- 32, 64, 96, 128, 160, 192 = +/- 1/3, 2/3, 1, 1 1/3, 1 2/3, 2) Note: you can write to it, but actual state doesn't change.
220	RW	Picture Size (0,1,2,3,4,5,7,8 = L,M1,M2,M3,S,RAW,M,W)
221	RW	Camera Orientation Sensor (0, 90, 270) Note: you can write to it, but actual state doesn't change.	*
253	RW	Optical Zoom Setting (0-13) Note: you can write to it, but actual zoom state doesn't change.
266	?	Tv	*
270		White balance mode (Auto, Day Light, Cloudy etc.) [2]	*
271		White balance fine tuning (color channel multipliers, 28 bytes for propset 1-2) (PROPCASE_WB_ADJ in CHDK, used in DNG for "white balance embedding") [3]	*
284	RW	Rec Raw + L-jpg (0=off, 1=on) Note: you can write to it, but actual state doesn't change.
294	RW	iContrast (0=off, 1=auto) Note: you can write to it, but actual state doesn't change.

* = camera supports PropertyCase (PropertyCase value may be camera specific)

- = camera does not support PropertyCase (at least value does not change)

PropertyCase NOT found

• Manual White balance settings, needed for white balance fine tuning

Manual White balance property case for G11 is 0x10F.

It was found based on the analysis of firmware and needs confirmation from developers who can access camera to perform some tests to verify is it correct or not.

(cppasm)

• MF Point Zoom
• AF-assist Beam
• Number of shots in Custom drive mode
• Review time
• Selected Scene Mode
• Current Display Mode, i.e. no info, more info, full info, where you cycle through by pressing disp.

Where could these be stored? I scanned all Property Cases from 0 till 300, after that everything seems to be 0. PTT 01:59, 9 July 2007 (UTC)

• A face is being detected

Some parameters can be read with the function get_parameter_data(). 
   ?ut the numbers of parameters depends on the camera model. For example, Canon 710 IS: 
72  Delay in Custom drive mode (in seconds, 1 byte) 
73  Number of shots in Custom drive mode (1 byte) 
 9  Review time (in msec, 4 bytes) 
54  Current Display Mode for record review mode - 0,1 or 2 (2 bytes) 
53  Current Display Mode for view mode - 0,1 or 2 (2 bytes)

get_parameter_data()

Here are a few values that I think work that way with get_parameter_data() on my ixus 950 is... maybe someone can test and verify them for this cam or even for others?

2    Next Image/Movie Number (0-9999)   
18   LCD Brightness     
56   Current Display Mode for view mode - 0,1 or 2     
73   Number of shots in Custom drive mode     
104  "Show clock" (in seconds)

Timezone Information

On my cam (ixus 950 is) get_parametr_data(20,...) seems to be the timezone information. There is a strong correlation of the following values (Names are in german or translated):

(DST Must be somewhere else)     
0x010100 London ( = 65792 )     
0x010101 Paris     
0x010102 Kairo     
0x010103 Moskau     
0x010104 Teheran     
0x010105 Dubai     
0x010106 Kabul     
0x010107 Karachi     
0x010108 Delhi     
0x010109 Kathmandu     
0x01010A Dacca     
0x01010B Yangon     
0x01010C Bangkok     
0x01010D HongKong     
0x01010E Tokyo     
0x01010F Adelaide     
0x010110 Sydney     
0x010111 Solomon Islands     
0x010112 Wellington     
0x010113 Chathman Islands     
0x010114 Samoa     
0x010115 Honolulu     
0x010116 Anchorage     
0x010117 LosAngeles     
0x010118 Denver     
0x010119 Chicago     
0x01011A NewYork     
0x01011B Caracas     
0x01011C NewFoundland     
0x01011D Rio De Janeiro     
0x01011E Fernando de noronha     
0x01011F Azoren ( = 65823 )

Given that there are more than 24 of such entries, these seem to be offsets into somewhere else, will need to find it there... My cam also has a travel timezone setting. I get really high numbers for when chosing one, so it looks to me like they get somewhat ORed together with a shift or so... need to still test...

Discovering PropertyCase meanings and values

In CHDK → Miscellaneous → Debug parameters menu, there are options to allow you to view the current PropertyCase values.

For property cases that are not yet documented, you have two ways of discovering what they are:

• look for which property case changes after modifying camera settings (see below).
• disassemble the Canon firmware and look for how property cases are used by functions of known purpose (see this thread).

There is a PropertyCaseDump lua script that will dump out current values to a file, and also print out differences compared with a previous dump.

There is a feature added by PlasmaHH (see this changeset) which shows changes in Property Cases. Usage:

• go to debug menu, go to "ALT +/- debug action", set to "CmpProps?" (Compare propcases)
• then in alt-mode, press the +/- button to initialize it (all current propcases are then saved)
• then after you made changes in the camera (canon menu) you enter alt-mode, press +/- button - you will see all the props that have changed, until you exit alt-mode
• if there are more than 12 changed propcases, after 15 seconds it will show the next entries. this is not convenient, but i couldnt come up with a better way for now. On the other hand: it's not clever changing so many things at once (in-camera) to find out propcases. one at a time is the better solution.

Links

• PropertyCaseDump
• Params