User Tools

Site Tools


camera_help

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
camera_help [2018/07/09 20:50] – [Silent Pictures] walter_schulzcamera_help [2019/02/19 19:56] – [Bulb/Focus Ramping] walter_schulz
Line 17: Line 17:
 Please use the edit button for the respective section above that button and use the preview feature. This helps to keep the revision list tidy. Please use the edit button for the respective section above that button and use the preview feature. This helps to keep the revision list tidy.
  
 +> Update (18.02.2019) Walter Schulz
 +> Listings (= menu items) should be complete and up-to-date by now. If not: Report back!\\
 +> Task for all readers: Check for errors, misconceptions, blank fields, unhelpful items (overcomplicated or just missing help). Think of everything you can imagine an in-camera help should include!
 +> Special task: HDR section! If you have experience with HDR workflow, preferable with Open-Source tools (but not restricted to), any input would be appreciated!
  
  
 ===== Audio ===== ===== Audio =====
-> INCOMPLETE 
  
-Manual audio controlsThis menu is available for +> Complete (18.02.2019). No pics for plugs, etc. here, because it's in-camera help and drawings for soldering doesn't help that much in this respect, IMO. 
  
-  * Cameras with DIGIC 4 processor.+> And if Audio screen isn't visible this help text won't be able to tell users why. That's one reason I opted for this screen to be visible at all times.
  
-  All cameras supporting audio recording and module MLV_SND.mo activated. Non-DIGIC-4 cams will be restricted to a single menu item: MLV Sound.+Manual audio controls.\\ If you do not see this screen check these conditions: 
 +  50D: Nope, no way to make it happen! 50D doesn't support audio recording
 +  * Your cam may have restricted audio menu after loading module MLV_SND.mo:\\ 1100D, 650D, 6D, 700D, EOS M, 100D, 70D, EOS M2, 1200D\\ The only menu option you will see with MLV_SND active:\\ - MLV Sound
  
-Please check [[https://builds.magiclantern.fm/features.html#Audio|feature matrix]]+The options available differ a lot depending on your camera type.\\ Please check [[https://builds.magiclantern.fm/features.html#Audio|feature matrix]]
  
  
Line 46: Line 51:
  
  
-==== DigitalGain ====+==== Digital Gain ====
  
 In-camera digital gain. In-camera digital gain.
Line 58: Line 63:
 **AGC** ON or OFF **AGC** ON or OFF
  
-Applying digital gain in-camera is not recommended as any nonzero value reduces+Applying digital gain in-camera is not recommended as any non-zero value reduces
 audio quality and you can achieve the same effect with more control in audio quality and you can achieve the same effect with more control in
 post, but it can serve as an evaluative tool on set. You can apply post, but it can serve as an evaluative tool on set. You can apply
Line 72: Line 77:
 //Submenu options:// //Submenu options://
  
-**internal mic** your camera's internal mic+**Internal mic** your camera's internal mic(s)
  
 **L:int R:ext** **L:int R:ext**
  
-**external stereo**+**External stereo**
  
 **L:int R:balanced** (internal mic on Left, external mic on Right from both external pins as balanced audio) **L:int R:balanced** (internal mic on Left, external mic on Right from both external pins as balanced audio)
Line 121: Line 126:
  
  
-==== Headphone Monitoring ====+==== Headphone Mon. ====
  
 Audio monitoring with headphones, using the A/V cable. Audio monitoring with headphones, using the A/V cable.
Line 138: Line 143:
 600D/T3i. 600D/T3i.
  
 +Tip: Before cuting/soldering or ordering a monitoring cable check [[https://builds.magiclantern.fm/features.html#Audio|feature matrix]] if this feature is available for your cam at all.
  
-==== Output volume ====+==== Headphone volume ====
  
 Digital output gain for audio monitoring. Digital output gain for audio monitoring.
Line 179: Line 185:
 ==== Beep, test tones ==== ==== Beep, test tones ====
  
-Customise camera sounds.+Customize camera sounds.
  
 //Submenu options:// //Submenu options://
  
-**Enable Beeps**+**Enable Beeps** ML uses beep tones for several events. Turn them off if you have to go silent.
  
 **Tone Waveform** Sine tones of lower frequency might be not audible on the internal speaker. Use square. Always check with Test beep sound. **Tone Waveform** Sine tones of lower frequency might be not audible on the internal speaker. Use square. Always check with Test beep sound.
  
-**Tone Frequency** +**Tone Frequency** Default is 1 kHz. Range from 55 Hz (A1) to 12 kHz. Human ears are considered to be most sensitive between 2 and 5 kHz.
  
 **Play test tone** **Play test tone**
Line 218: Line 224:
 Adjusting the exposure parameters. Most of these settings only work in Manual Adjusting the exposure parameters. Most of these settings only work in Manual
 (photo and video), and some of them work in P, Av and Tv too. For availability see [[https://builds.magiclantern.fm/features.html#Expo|feature matrix]] (photo and video), and some of them work in P, Av and Tv too. For availability see [[https://builds.magiclantern.fm/features.html#Expo|feature matrix]]
 +Some items will only be shown after loading a module in Module screen:
 +  * Auto ETTR: ettr.mo
 +  * Dual-ISO: dual_iso.mo
 +  * Auto exposure: autoexpo.mo
  
 +The following settings are linked to Canon settings. If you change them here changes will appear in Canon menu, too. Vice versa.
 +  * White Balance
 +  * ISO
 +  * Shutter
 +  * Aperture
 +  * Picture Style
  
 ==== WhiteBalance ==== ==== WhiteBalance ====
Line 227: Line 243:
  
 **White Balance:** Rated in Kelvin, manually adjust from 1500 to 15000K. **White Balance:** Rated in Kelvin, manually adjust from 1500 to 15000K.
 +
 +No "AWB" option found here. If you want to use AWB you have to re-enable it in Canon menu.
  
 **WBShift G/M:** Green-Magenta white balance shift. Useful for fluorescent lighting. **WBShift G/M:** Green-Magenta white balance shift. Useful for fluorescent lighting.
  
-**WBShift B/A:** Blue-Amber white balance shift. 1 unit = 5 mireks on Kelvin axis, according to this post.+**WBShift B/A:** Blue-Amber white balance shift. 1 unit = 5 mireks on Kelvin axis, according to [[http://www.openphotographyforums.com/forums/archive/index.php/t-5450.html|this post]].
  
 **Custom RGB multipliers:** Fine-tune custom white balance. **Custom RGB multipliers:** Fine-tune custom white balance.
- 
-**Black level:** 
-This parameter is applied on RAW data, before applying white balance. 
-Adjust it if you have problems with green or magenta shadows. 
  
 **Auto adjust Kelvin + G/M:** **Auto adjust Kelvin + G/M:**
Line 242: Line 256:
 using the center (200×200 pixels rectangle) as reference gray. using the center (200×200 pixels rectangle) as reference gray.
  
-The preferred method is manual White Balance, but when shooting raw video+Preferred method is manual White Balance, but when shooting raw video
 this is more of evaluative tool as you have control of your WB later. this is more of evaluative tool as you have control of your WB later.
 Best practice is to have a reference colour at the beginning of each Best practice is to have a reference colour at the beginning of each
Line 262: Line 276:
  
 **Canon digital ISO:** Digital ISO is the process of pulling or pushing your analog ISO to affect detail. **Canon digital ISO:** Digital ISO is the process of pulling or pushing your analog ISO to affect detail.
 +Requires "Exp. Override ON" (see below in Expo screen)
 +
 +Strongly recommended not to touch this setting! 0 EV it is!
 +
  
 **ML digital ISO (DIGIC):** **ML digital ISO (DIGIC):**
--2 to +7 EV Preferred to the Canon implementation, in movie mode+-2 to +7 EV  
 +Preferred to the Canon implementation, in movie mode
 negative values will reduce noise, but may cause color issues in negative values will reduce noise, but may cause color issues in
-highlights. This feature +highlights.  
-enables ISO 50, ISO 51200 and many other intermediate or astronomical ISOs+This feature enables ISO 25 or 50, ISO 51200 and many other intermediate or astronomical ISOs.
- +
- +
-> OBSOLETE -> Moved to Display screen **Display Gain (night vision):** In photo mode, for previewing night scenes. +
- +
-> OBSOLETE? Not found in 100D/650D/7D **Highlight Tone Priority:** Increases dynamic range by 1 stop in movie mode. Use with negative ML digital ISO. +
- +
-> OBSOLETE? Not found in 100D/650D/7D **ISO selection:** Canon ISOs or ML ISOs. Only used in movie mode.+
  
-> Still valid? **Color coding: ** 
-  * <color orange>orange</color> = Standard Canon ISO with good noise or dynamic range characteristics. 
-  * <color green>green</color> = ISO with negative digital gain applied via DIGIC obtained by setting ML digital ISO to a negative value. These can have lower noise or better  highlight rolloff than their Canon counterparts. 
-  * <color red>red</color> = ISO with positive digital gain, avoid these values. 
  
 ==== Shutter ==== ==== Shutter ====
Line 332: Line 340:
 automagically). May be useful with flat picture styles. Raw video makes automagically). May be useful with flat picture styles. Raw video makes
 no use of this feature. no use of this feature.
 +This setting will not be shown in Canon menu! At the beginning of recording a notification about the REC-PicStyle selected will be seen.
  
  
 ==== Auto ETTR ==== ==== Auto ETTR ====
 +
  
 Automatically expose to the right. Automatically expose to the right.
 +Only visible after loadin ettr.mo in Modules.tab.
 +ML needs LiveView to compute camera settings according to environment!
 +
 +[[https://wiki.magiclantern.fm/ettr|ETTR wiki]]
 +> this wiki entry is massive! Copying it here makes little sense, IMO. Extracting basics?
 +
 +> Text bit copied from ettr.mo Readme
 +ETTR is a techinque that optimizes your exposure for raw shooting, with the goal of minimizing noise without accidently blowing the highlights.
 +
 +Auto ETTR will adjust the exposure for you until the histogram will touch the right side, but - whenever possible - without clipping. This will minimize image noise for your given set of restrictions (e.g. slowest shutter, max ISO, or what highlights can be clipped).
 +
 +You will usually have to darken the image in post (which is good).
 +
 +Tip: on the raw histogram you will see an ETTR hint that can be used for manually exposing the image.
 +
  
 //Submenu options:// //Submenu options://
Line 349: Line 374:
 0 to 50%. Percentage of bright pixels allowed above target level. 0 to 50%. Percentage of bright pixels allowed above target level.
 Use this to allow spec(ta)cular highlights to be clipped. Use this to allow spec(ta)cular highlights to be clipped.
 +Example: In standard situations with sun in frame it makes no sense to avoid the sun to be blown out. The rest of the pic will be vastly underexposed. Same for sun reflected by polished metall and similiar situations.
  
 **Allow clipping** OFF, Green channel & Any channel. Choose which channels to be clipped. **Allow clipping** OFF, Green channel & Any channel. Choose which channels to be clipped.
Line 363: Line 389:
  
 **Show metered areas** Show where the white point and SNR levels are metered (what exactly is considered highlight, midtone and shadow). **Show metered areas** Show where the white point and SNR levels are metered (what exactly is considered highlight, midtone and shadow).
 +
 +**Allow beeps**
  
 **Show debug info** For nerds. **Show debug info** For nerds.
  
 See ettr.mo in [[#modules|Modules]]. See ettr.mo in [[#modules|Modules]].
- 
  
 ==== Expo. Lock ==== ==== Expo. Lock ====
-INCOMPLETE+COMPLETE
  
-Locks different exposure controls.+In M mode this settings lets you change Tv, Av or ISO without changing exposure.  
 + 
 +Locks different exposure controls in M mode
  
 //Submenu options:// //Submenu options://
  
-**Tv**+**Tv** You can change Tv to your needs and ML will adjust ISO and/or Av to keep exposure. 
 +  * OFF 
 +  * Av, ISO  Change Av first. Tries to keep ISO constant. 
 +  * ISO, Av  Change ISO first. Tries to keep Av constant.
  
-**Av** +**Av** You can change Av to your needs and ML will adjust ISO and/or Tv to keep exposure. 
- +  * OFF 
-**ISO**+  Tv, ISO Change Tv first. Tries to keep ISO constant. 
 +  ISO, Tv Change ISO first. Tries to keep Tv constant.
  
 +**ISO** You can change ISO to your needs and ML will adjust Tv and/or AV to keep exposure.
 +  * OFF
 +  * Tv,Av  Change Tv first. Tries to keep Av constant.
 +  * Av,Tv  Change Av first. Tries to keep Tv constant.
  
 ==== Expo. Presets ==== ==== Expo. Presets ====
- +> COMPLETE 
-Toggles for exposure presets.+Toggles  exposure presets (ISO, shutter, aperture)
  
 //Submenu options:// //Submenu options://
Line 394: Line 431:
  
 **Press INFO** **Press INFO**
 +
 +How to: Activate "Press SET" or "Press INFO". Press according button once, adjust ISO/shutter/aperture. Press button again and previous settings will be there. Pressing again will toggle to the settings you adjusted.
 +  * Both exposure settings may be changed anytime and are changed on the spot.
 +  * "Expo. Presets OFF" will not change presets contents. If you enable this option again your "old" settings are there. This is true for Power Off, too.
  
  
 ==== Dual ISO ==== ==== Dual ISO ====
 +> INCOMPLETE
 +
 +Capture using 2 different ISOs in a single picture for better detail in certain ranges.
 +Only visible after loading dual_iso.mo in Modules screen tab.
 +
 +[[https://www.magiclantern.fm/forum/index.php?topic=7139.0|Dual ISO thread]]
 +
 +Increases dynamic range by sampling the sensor at two different ISOs, switching ISO for every other line pair. This trick cleans up shadow noise, resulting in a dynamic range improvement of around 3 stops, at the cost of reduced vertical resolution and increased aliasing and moire.
 +
 +Works for both raw photos (CR2) and raw videos (DNG). You need to postprocess these files with a tool called cr2hdr.
 +
 +After postprocessing, you will get a DNG that looks like a dark ISO 100 shot, but you can bring the exposure back up and be delighted by how little noise is present in those recovered shadows.
 +
 +
 +Quick start
 +  *Start at ISO 100 in Canon menu
 +  *Expose to the right by changing shutter and aperture
 +  *If the image is still dark, enable dual ISO
 +  *Adjust recovery ISO: higher values = cleaner shadows, but more artifacts
 +  *Try not to go past ISO 1600; you will not see any major improvements, but you will get more interpolation artifacts and hot pixels.
 +
 +
 +Tips and tricks
 +  *Do not use dual ISO for regular scenes that don't require a very high dynamic range.
 +  *Raw zebras are aware of dual ISO: weak zebras are displayed where only the high ISO is overexposed, strong (solid) zebras are displayed where both ISOs are overexposed.
 +  *Raw histogram will display only the low-ISO half of the image (since the high-ISO data is used for cleaning up shadow noise).
 +  *For optimal exposure (minimal noise without clipped highlights), try both dual ISO and ETTR.
 +  *Do not be afraid of less aggressive settings like 100/400. They are almost as good as 100/1600 regarding shadow noise, but with much less aliasing artifacts.
 +  *Be careful with long exposures, you may get lots of hot pixels.
 +
  
-Capture using 2 different ISOs for better detail in certain ranges. 
  
 //Submenu options:// //Submenu options://
Line 415: Line 485:
  
  
-==== Expo.Override ====+==== Expo. Override ====
  
 This mode bypasses Canon exposure limitations for ISO, Tv & Av. This mode bypasses Canon exposure limitations for ISO, Tv & Av.
Line 432: Line 502:
   * 1/8000s in movie mode, useful for slow motion.   * 1/8000s in movie mode, useful for slow motion.
   * ISO 12800 is allowed in movie mode on 60D and 600D.   * ISO 12800 is allowed in movie mode on 60D and 600D.
-  * Full-time DOF preview in photo mode, without blocking certain keys.+  * Full-time DOF preview in photo mode, without blocking certain keys. > Looks like another bug report knocking at the door. D5 issues with lens liveview update again, I suppose.
  
 In photo mode, anything slower than 1/25 seconds will be underexposed in In photo mode, anything slower than 1/25 seconds will be underexposed in
Line 443: Line 513:
 ==== ExpSim ==== ==== ExpSim ====
  
-Exposure Simulation+Enabling/disabling Exposure Simulation in LiveView
  
 //Submenu options:// //Submenu options://
 +
 +In entry level cams (xxxD/Rebel) there is no option in Canon menu to disable Exposure Simulation. Without ML it may enforce some additional steps to get exposure settings you need. 
  
 ==== Auto exposure ==== ==== Auto exposure ====
 +> Will add some fine-tuning soon, promise!
 +
 +Automatic control of your exposure during a take.\\ 
 +
 +"P mode on steroids" by pravdomil.\\
 +You always wanted taking pics slightly stopped down because wide open your lens is a tad too soft? Here you go!\\
 +
 +Only visible after loading autoexpo.mo in Modules tab.\\
 +https://www.magiclantern.fm/forum/index.php?topic=7208.msg60545#msg60545
  
-Automatic control of your exposure during a take. 
  
 //Submenu options:// //Submenu options://
  
-See auto_expo.mo in [[#modules|Modules]].+Auto Exposure uses APEX values! 
 + 
 +**Show graph** ON 
 + 
 +{{:autoexpo.png?360|}} 
 +   Red: Exposure duration 
 +   Green: Aperture 
 +   Blue: ISO 
 +   Orange: Exposure Compensation 
 +   x-axis: Light (Brightness Value = BV). Left: Bright light. Right: Darkness 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 +**Use in LV** 
 + 
 +**Lens Aperture** 
 + 
 +**TV minimum** sets the minimum shutter value 
 + 
 +**Same TV curve** 
 + 
 +**AV range** sets aperture range, if it not match with current lens, it doesn't matter, it will be compensated with shutter 
 + 
 +**AV curve** by main dial you set point where will start aperture decreasing (in BV value) 
 +speed dial sets how much will be aperture decreased, it sets the slope (minus EV per one BV) 
 + 
 +**ISO range** 100 - 25600 make sure that you set correct ISO range (you can set this values via Canon ISO menu), otherwise you can get incorrect exposure. It also solves the 5D2 auto ISO bug, where is ISO hardcored to 400. 
 + 
 +**ISO curve** by main dial you set point where will start ISO increasing (in BV value) 
 +speed dial sets how much will be ISO increased, it sets the slope (plus EV per one BV) 
 + 
 +**EC** 
 + 
 +**EC range** 
 + 
 +**EC curve** 
 + 
 +**Browse** Works with "Show graph ON" and is non-persistent. You will get a movable vertical line inside your graph. Top line shows chosen BV value and bottom line lists shutter time, aperture, ISO and EC for given BV. 
 + 
 +{{:autoexpo2.png?400|}} 
 + 
 +Instructions\\ 
 +Graph\\ 
 +Here are a few BV values you can get:\\ 
 +16   light sand or snow\\ 
 +16 - 13   daylight\\ 
 +13 - 8   cloudy, shade\\ 
 +8 - 1   Indoor\\ 
 +<nowiki><</nowiki> 1   low light\\ 
 +-12   complete darkness\\ 
 +[[http://en.wikipedia.org/wiki/Exposure_value#Tabulated_exposure_values|full list]]\\ 
 +graph shows what combinations will be used depending on light conditions (on BV) 
 +last BV value of current scene is marked with the cyan line 
 +shutter value is computed dynamically as BV - AV + SV - EC 
 + 
  
  
Line 461: Line 603:
 Graphics overlays that can be used in LiveView or in image review mode: Graphics overlays that can be used in LiveView or in image review mode:
 histogram, zebras, cropmarks, spotmeter, focus peaking, false color… histogram, zebras, cropmarks, spotmeter, focus peaking, false color…
 +
 +You can create and configure up to 4 individual ML LiveView screens which may be toggled by INFO button, too. If you want to have 2, 3 or 4 go to Prefs screen -> LV Display Presets and change number accordingly. To determine which screen is active: Text field shows "DISP 0" to "DISP 3" in LV. Same number will be shown in Overlay screen.
 +
 +Overlays do affect processor performance. Doing high performance write operations (as in RAW/MLV movie recording) it is adviced to reduce "active" overlays or surpress them at all during recording. You will find a lot of options affecting the appearance of overlays for that reason.
 +
 +Same applies to streaming and recording via HDMI. Be aware it might take some time to find a workflow and appropriate settings for your needs.
  
  
Line 480: Line 628:
 If you used display presets, press Q on this item to switch the presets while you are in ML menu. If you used display presets, press Q on this item to switch the presets while you are in ML menu.
  
 +Be aware there are 2 other menu options influencing Overlay visibility: 
 +- Display screen -> Clear overlays 
 +- If MLV_REC module is used there is an option "Global Draw" and default is OFF! Computing overlays will reduce cam's storage interface write rate.
 ==== Zebras ==== ==== Zebras ====
  
Line 490: Line 640:
   * Luma: zebras are computed from Y channel only.   * Luma: zebras are computed from Y channel only.
   * RGB: check overexposure for each RGB channel. Clipped channels are displayed in the opposite color (i.e. clipped red shown as cyan, underexposed as  white and so on).   * RGB: check overexposure for each RGB channel. Clipped channels are displayed in the opposite color (i.e. clipped red shown as cyan, underexposed as  white and so on).
 +  * Luma Fast: 
 +> No info found for "Luma Fast".
 +
 +  Color Space settings apply to JPG/H.264 only. RAW is not affected.
 **Underexposure** - JPG only.  Set the RGB point where underexposure zebras are displayed. **Underexposure** - JPG only.  Set the RGB point where underexposure zebras are displayed.
  
Line 504: Line 658:
 **Raw zebra underexposure** **Raw zebra underexposure**
  
-You may adjust thresholds for underexposure and overexposureor you can +  * OFF - 0EV <> +4EV 
-disable zebras while recordingNotewhen using the Technicolor + 
-CineStyle picture styleluma will have values between 16 and 255; +This allows you to choose at what exposure the underexposure zebras will be displayed.  0 EV means that the zebras will be displayed where the amount of noise in the imageis equal to the amount of signal in the image (the noise floor).  
-therefore, you will have to set the underexposure threshold to 16 or +A general consensus among photographers, is that the limit for acceptable amount of noise in images, is 2 EV above this noise floor. 
-greater.+ 
 +**NOTE:** 
 + 
 +Dual ISO zebras:  When using dual ISO, there are dual exposures and the zebras reflect this.  With dual ISO there are two types of zebras.  
 +  * Full/solid zebras which work exactly like normal zebras, and describe overexposure in both ISOs.  
 +  * Half/stripe zebras which represent overexposure only in the higher ISO.
  
  
Line 518: Line 677:
  
 **Filter bias:** **Filter bias:**
 +  * Strong edges
 +  * Balanced
 +  * Fine details
  
-**Image buffer:**+**Display type:** 
 +  * Blinking dots 
 +  * Fine dots 
 +  * Alpha blend 
 +  * Sharpness 
 +  * Raw 
 + 
 +Alpha blend will be laged.
  
 **Threshold:** how many pixels are considered in focus (percentage). **Threshold:** how many pixels are considered in focus (percentage).
  
 **Color:** either fixed color, or a color coding according to focus intensity. **Color:** either fixed color, or a color coding according to focus intensity.
 +
  
 **Grayscale image:** if enabled, LiveView will displayed as grayscale, but still recorded as color. **Grayscale image:** if enabled, LiveView will displayed as grayscale, but still recorded as color.
  
-High-contrast lines will be marked by blinking dots showing which part of the image +High-contrast lines will be marked by blinking dots (or other setting from "Display type"showing which part of the image is in focus. To see how it works, check this [[http://www.luminous-landscape.com/forum/index.php?topic=56246.0|article]] from
-is in focus. To see how it works, check this [[http://www.luminous-landscape.com/forum/index.php?topic=56246.0|article]] from+
 Luminous Landscape. Luminous Landscape.
  
Line 543: Line 712:
   * Zoom In (*): triggered by Zoom In button (overrides Canon's default zoom  modes). To bypass magic zoom, press both zoom buttons at the same time  or cover the LCD sensor.   * Zoom In (*): triggered by Zoom In button (overrides Canon's default zoom  modes). To bypass magic zoom, press both zoom buttons at the same time  or cover the LCD sensor.
   * Always On: no trigger key needed. You can use both Canon's 5x/10x zoom and Magic Zoom.   * Always On: no trigger key needed. You can use both Canon's 5x/10x zoom and Magic Zoom.
-**Size**+**Size** Size of zoom box: Small, medium or large
  
 **Position** **Position**
  
-**Magnification**+**Magnification** 1:1, 2:1 or 3:1
  
 **Focus confirm** When ML believes you have achieved perfect focus, Magic Zoom will display a focus confirmation: **Focus confirm** When ML believes you have achieved perfect focus, Magic Zoom will display a focus confirmation:
Line 562: Line 731:
  
 ==== Cropmarks ==== ==== Cropmarks ====
 +[Incomplete]
 +Do to: 
 +- Status of "Cropmark Repository"? http://www.sawomedia.de/magiclantern/cropmarks/
 +- Passport cropmark. Replacing by newer (not neckless) version?
  
-Cropmarks or custom grids for framing and composition.+Cropmarks/custom grids for framing and composition. 
 + 
 +{{:crop.png?400|}}
  
 //Submenu options:// //Submenu options://
  
 **Bitmap (1/9)** **Bitmap (1/9)**
 +Up to nine different cropmarks supported. Second number will show number of cropmarks actually available. 
 +Currently there are 5 cropmarks supplied with nightly builds:
 +  * CineSco2
 +  * CrssMtr2
 +  * Passport
 +  * PhiPhoto
 +  * PhiVideo
  
 **Show in photo mode** **Show in photo mode**
Line 574: Line 756:
  
 If you use custom cropmarks, place them in ML/CROPMKS folder on your SD If you use custom cropmarks, place them in ML/CROPMKS folder on your SD
-card and give them short 8.3 names. You can place at most 9 cropmarks on+card and give them names following 8.3 naming convention. Example: MyCrop01.bmp. You can place at most 9 cropmarks on
 the card. Get more cropmarks from the ML cropmark repository or draw the card. Get more cropmarks from the ML cropmark repository or draw
-your own (see Cropmarks).+your own. http://magiclantern.wikia.com/wiki/Cropmarks
  
 +Be aware about cropmarks not scaling when switching to "Crop mode" and/or changing aspect ratio!
 +Grids activated by "Grid display" in Canon menu will interfere with ML's cropmarks. It's recommended not to use both at the same time.
  
 ==== Ghost image ==== ==== Ghost image ====
Line 592: Line 776:
  
  
-==== Defishing ==== 
- 
-> OBSOLETE Now in Display screen 
- 
-Preview the rectified (defished) image from Samyang 8mm fisheye lens, using rectilinear projection. 
- 
-//Submenu options:// 
- 
-This feature works best in photo mode (outside LiveView). Defishing uses a 
-pre-computed look-up table (LUT). It is possible to create LUT files for 
-any other lens or projection by defishing vram/xy.png with your 
-favorite defishing software, and then running vram/defish-lut.m to get 
-the LUT file. All the required files are found in the ML source tree. 
-Project files (*.PTO) for nona (hugin) are provided for both rectilinear 
-and Panini projections. 
  
  
Line 617: Line 786:
 **Spotmeter Unit** **Spotmeter Unit**
   * Percent - 0 to 100%.   * Percent - 0 to 100%.
-  * 0..255 - RGB levels.+  * 0..255 - 8 bit RGB levels.
   * RGB (HTML)- Displays HTML-like color codes.   * RGB (HTML)- Displays HTML-like color codes.
   * RAW (EV) - Exposure level from sensor saturation using raw sensor data.   * RAW (EV) - Exposure level from sensor saturation using raw sensor data.
 +  * RGB (Percent) - RGB colors in percentag.
 **Spot Position** **Spot Position**
   * Focus box - Spot meter linked to the focus box.   * Focus box - Spot meter linked to the focus box.
Line 627: Line 797:
  
 This is a tool for evaluating the exposure. This is a tool for evaluating the exposure.
 +
 +{{:false.png?400|}}
  
 //Submenu options:// //Submenu options://
Line 639: Line 811:
  
 **Banding detection** **Banding detection**
 +Enables fast check if there are under- or overexposed areas. Everything else is greyed out.
  
 **GreenScreen** **GreenScreen**
 +Enables fast check if green screen conditions (uniform lighting) are met. 
  
 It shows different luma (Y) levels using a color map. You may configure a It shows different luma (Y) levels using a color map. You may configure a
Line 658: Line 832:
   * YUV-based, Luma   * YUV-based, Luma
   * YUV-based, RGB   * YUV-based, RGB
-  * RAW-based (RGB)+  * RAW-based (RGB) > To do: Pic example, basic functions included
   * RAW HistoBar (MAX)   * RAW HistoBar (MAX)
 **RAW EV indicator** **RAW EV indicator**
-  * OFF - Don'not use the indicator. +  * OFF - Don't use the indicator. 
-  * Dynamic Range - Display the dynamic range at current ISO, from noise stdev. +  * Dynamic Range - Displays ynamic range at current ISO, from noise stdev. 
-  * ETTR hint - Show how many stops you can push the exposure to the right.+  * ETTR hint - Show how many stops you can push exposure to the right.
 **Scaling** **Scaling**
   * Log   * Log
   * Linear   * Linear
 **Clip warning** **Clip warning**
-- Display warning is the histogram with clipping.  This will+- Display warning if the histogram with clipping.  This will
 display a warning for each color channel, when that channel is being display a warning for each color channel, when that channel is being
-overexposed.  The numbers represent the percentage of pixels being+overexposed.  Numbers represent the percentage of pixels being
 clipped. clipped.
  
->OBSOLETE? **Use RAW histogram** +To learn how to read these graphs, see [[http://www.luminous-landscape.com/tutorials/understanding-series/understanding-histograms.shtml|Understanding Histograms]]. 
-  * OFF - Disable raw based histogram and use JPG based histogram. + 
-  * Full Histogram Use the full histogram. +
-  * Simplified Histobar Only use the simplified histobar in liveview.+
  
  
 ==== Waveform ==== ==== Waveform ====
 +
 +> To do: Waveform image 
  
 **Waveform Size** **Waveform Size**
  
 +//Submenu Options://
 +
 +**Small**
 +
 +**Large**
 +
 +**FullScreen**
 +
 +To learn how to read these graphs, see [http://www.youtube.com/watch?v=JXMvFk146R0|Final Cut Waveform Monitor]].
  
 ==== Vectorscope ==== ==== Vectorscope ====
Line 692: Line 876:
 **UV scaling** **UV scaling**
  
-Useful for color grading. To learn how to read it, see Introducing Color Scopes: The Vectorscope.+Useful for color grading. To learn how to read it, see [[http://www.kdenlive.org/users/granjow/introducing-color-scopes-vectorscope|Introducing Color Scopes: The Vectorscope]]. 
  
 ==== Level Indicator ==== ==== Level Indicator ====
Line 698: Line 883:
 //Submenu options:// //Submenu options://
  
 +Will show an electronic level indicator in Liveview ML screen, supported by a numerical display on the upper left. Resolution is 0.5 degrees. Indicator is available if supported by Canon. For those cams equipped with a dual-axis level indicator there is no numerical display for second axis.
  
  
Line 735: Line 921:
 BuffWarnLevel setting to customize this. BuffWarnLevel setting to customize this.
  
 +==== Movie Record (50D) ====
 +
 +//Submenu options://
 +
 +Enable movie recording on 50D (1920×1080, 30fps, without sound). To start
 +recording, go to LiveView (P/Tv/Av/M) and press SET. WARNING: Canon 50D
 +was NOT designed to record movies. Keep in mind: This feature was not
 +thoroughly tested by Canon and may be unstable (even if you record
 +without ML). Always disable movie recording when you don't use it.
 +Battery will drain quickly when recording; also, the camera may
 +overheat.
 +
 +Limitations: The camera will not record sound. You can
 +use an external recorder (for example, Zoom H1, H2 or H4n) and sync the
 +sound in post with a clapperboard. You can't play back movies in the
 +camera. This setting remains active even if you start the camera with
 +standard firmware (until you clear your settings).
 +
 +==== Shutter Button (50D) ====
 +
 +//Submenu options://
 +
 +**Block during REC**
 +blocks the shutter and related (AF, *) buttons while recording. In 50D,
 +taking pictures while recording would result in ERR99; with this
 +option, you can avoid taking pictures while recording by mistake. Side
 +effect: this will disable image stabilization during recording.
 +
 +**Hold during REC (IS)**
 +ML will keep the shutter button pressed half-way during recording,
 +which will enable image stabilization (IS). Side effect: you need to
 +press the shutter button half way to turn IS off before the camera will
 +let you stop recording.
  
 ==== REC key ==== ==== REC key ====
Line 743: Line 962:
  
 **Require long press** **Require long press**
 +
 +   * OFF
 +   * ON (1s)
  
 **Allowed actions** **Allowed actions**
 +
 +   * Start/Stop
 +   * Start only
 +   * Stop only
  
 With this, you can use a wired remote to start/stop recording. With this, you can use a wired remote to start/stop recording.
Line 830: Line 1056:
  
 ==== HDR video ==== ==== HDR video ====
 +
 +[Incomplete] outdated info, dead links ...
  
 This feature allows you to shoot a high dynamic range video by alternating ISO every other frame. This feature allows you to shoot a high dynamic range video by alternating ISO every other frame.
 +Your win: Dynamic range
 +Your loss: Resulting frame rate is reduced.
 +
  
 //Submenu options:// //Submenu options://
Line 846: Line 1077:
   * etc (please help me filling the list!)Discussion thread, postprocessing workflow, FAQ...   * etc (please help me filling the list!)Discussion thread, postprocessing workflow, FAQ...
  
 +Don't get confused about HDR and Dual-ISO feature. This here is about HDR combining 2 frames with different ISO settings for movies. Dual-ISO is about using 2 ISO settings inside a frame/still photo by interlaced sensor lines.
  
 ==== Vignetting ==== ==== Vignetting ====
Line 877: Line 1109:
  
 **Noise Reduction** In camera noise reduction. **Noise Reduction** In camera noise reduction.
 +
 +==== Creative Effects ====
 +
 +Custom image effects found by investigating DIGIC registers.
 +
 +//Submenu options://
 +
 +**Desaturate** lets you record grayscale with any picture style.
 +
 +**Negative image** Inverts your luma values
 +
 +**Swap U-V** Red becomes blue.
 +
 +**Cartoon look** for this to work, set sharpness in your picture style to any nonzero value.
 +
  
  
Line 905: Line 1152:
 **Global Draw** ON or OFF. Disables GD while recording, though some previews require it. **Global Draw** ON or OFF. Disables GD while recording, though some previews require it.
  
-**Frame skipping** ON or OFF. Stops recording if you drop a frame.+**Frame Skipping** ON or OFF. Stops recording if you drop a frame.
  
-**Preview** Auto, Canon, ML Grayscale, HaCKeD & Hacked No Prev.+**Preview Options** Auto, Canon, ML Grayscale, HaCKeD & Hacked No Prev.
  
 **Status when recording** Icon, None & Debug. **Status when recording** Icon, None & Debug.
  
 **Start delay** 2, 4 & 10 second delay, useful for stabilizing. **Start delay** 2, 4 & 10 second delay, useful for stabilizing.
 +
 +**Files > 4GB (exFAT)** OFF, ON. By default ML will splitt long recordings into chunks up to 4 GByte each. File naming starts with *.MLV, followed by *.M00, M01 and - in theory - up to *.M99. Your record consists of *all* parts put together in postprocessing. So don't forget to transfer them to your working directory.
 +With setting ON only a unique file *.MLV will be created and growing in size while recording. If your file system is not exFAT ML will get stuck reaching 4 GB limit. ML itself does not check if file system is exFAT!
 +Caveat: Files > 4 GB are not supported on some file systems so make sure your storage device is compatible!
  
 **Digital dolly** Pan your frame in camera digitally. **Digital dolly** Pan your frame in camera digitally.
Line 918: Line 1169:
  
 **Extra Hacks** Small tweaks to maximise writing speed. **Extra Hacks** Small tweaks to maximise writing speed.
- 
-**Fix black level** Forces the black level to 2048 to combat green shadows. 
  
 **Debug trace** Writes an execution trace to your card and causes performance dips. **Debug trace** Writes an execution trace to your card and causes performance dips.
Line 926: Line 1175:
  
 **Buffer fill method** Select your method for filling buffers. **Buffer fill method** Select your method for filling buffers.
 +
 +**CF-only Buffers** 
 +
 +**Card Spanning**
  
 **Reserve card space** Reserves a chunk of space before recording to write over if you fill the card during a take. **Reserve card space** Reserves a chunk of space before recording to write over if you fill the card during a take.
Line 935: Line 1188:
  
 ==== RAW video ==== ==== RAW video ====
-(http://www.magiclantern.fm/forum/index.php?board=49.0)+(https://www.magiclantern.fm/forum/index.php?topic=16650.0)
  
-Magic Lantern (RAW) Video format v1.0.+Magic Lantern (RAW) Video format v1.1. (MLV Lite). Only visible after loading mlv_lite.mo in Modules tab.
  
 //Submenu options:// //Submenu options://
  
-**Resolution** 640 to 3584. Width of captured image in pixels. 5D2 tops out at 1856.+**Resolution** 640 to 35xx. Width of captured image in pixels. 5D2 tops out at 1856.
  
-**Aspect Ratio** :1 to 1:2. Height of captured image.+**Aspect Ratio** 5:1 to 1:2. Defines height of captured image.
  
-**Digital dolly** Pan your frame in camera digitally.+**Pre-record** OFF 1, 2 5 or 10 seconds: Stores given duration into internal memory buffer in a loop. Old frames are discarded
  
-**Preview** Auto, Canon, ML Grayscale, HaCKeD & Hacked No Prev.+**Playback** Will play back the last record. Requires module mlv_play to be loaded.
  
-**Frame skipping** ON or OFFStops recording if you drop a frame.+**Advanced ...**
  
-**Card warm-up** Some cards perform better after warming up.+ Preview: Auto, Real-time, Framing, Frozen LV 
  
-**Small hacks** Small tweaks to maximise writing speed.+ Digital dolly: Pan your frame in camera digitally.
  
-**Debug info** Shows detailed info and buffer allocation graphs.+ Card warm-up: Some cards perform better after warming up.
  
-**Playback** Playback the last raw video you shot.+ Use SRM job memory:
  
-Raw video has come a long way in a year [[http://www.magiclantern.fm/forum/index.php?topic=11243.0|2014NEW Current Raw Capabilities]].+ * Small hacksSmall tweaks to maximise writing speed. 
 + 
 + * Show buffer graphShows detailed info and buffer allocation graphs.
  
 ==== Movie Tweaks ==== ==== Movie Tweaks ====
Line 984: Line 1239:
 **Movie Restart** **Movie Restart**
 While this setting is on, movie recording will restart automatically, While this setting is on, movie recording will restart automatically,
-unless you stop it. There will be a few seconds skipped during +unless you stop it. There will be a few frames (typ. about 0.5 secondsskipped during 
-restarting.+restarting.  
 + 
 +H.264 (native Canon MOV recording): 
 +Older Canon cams (Digic 4, no ExFAT support) do have 2 limits: 29:59 minutes recording time or recording reaching 4 GB. Whatever comes first will cause recording to stop. 
 +Newer cams (Digic 5, ExFAT support) will stop at 29:59 minutes only. 
 + 
 +MLV/RAW recording (Magic Lantern only): 
 +No limit at all. Record as long as you like and battery, card space and temperature are good to go. 
 +You may want to use this option to restart recordings stopped due to buffer overflow (card too slow to manage data bandwidth) but there will be corrupted frames. Buffer overruns will coming back after a short period. 
 + 
 + 
 + 
 +If you want to do external recording or streaming (HDMI, USB) for 30+ minutes you do not have to use this setting anymore. Requires an experimental build (lua_fix or 4k). 
  
 **REC/STBY notify** Custom notifications for recording or standby: **REC/STBY notify** Custom notifications for recording or standby:
   * Red Crossout highly recommended if you forget to press record   * Red Crossout highly recommended if you forget to press record
   * Message it shows STBY or REC   * Message it shows STBY or REC
-  * Beeps it will beep when recording starts or stops+  * Beeps it will beep when recording starts or stops (only available for 500D, 550D, 5D2 and 60D).
   * Blue LED obvious if your camera has it   * Blue LED obvious if your camera has it
 +All options with display output require Global Draw/Overlays activated.
  
 **Force LiveView** bypass the dialog saying Press LV button to activate movie shooting. **Force LiveView** bypass the dialog saying Press LV button to activate movie shooting.
Line 999: Line 1268:
  
  
-==== Movie Record (50D) ==== 
  
-//Submenu options:// 
  
-Enable movie recording on 50D (1920×1080, 30fps, without sound). To start 
-recording, go to LiveView (P/Tv/Av/M) and press SET. WARNING: Canon 50D 
-was NOT designed to record movies. Keep in mind: This feature was not 
-thoroughly tested by Canon and may be unstable (even if you record 
-without ML). Always disable movie recording when you don't use it. 
-Battery will drain quickly when recording; also, the camera may 
-overheat. 
  
-Limitations: The camera will not record sound. You can 
-use an external recorder (for example, Zoom H1, H2 or H4n) and sync the 
-sound in post with a clapperboard. You can't play back movies in the 
-camera. This setting remains active even if you start the camera with 
-standard firmware (until you clear your settings). 
- 
- 
-==== Shutter Button (50D) ==== 
- 
-//Submenu options:// 
- 
-**Block during REC** 
-blocks the shutter and related (AF, *) buttons while recording. In 50D, 
-taking pictures while recording would result in ERR99; with this 
-option, you can avoid taking pictures while recording by mistake. Side 
-effect: this will disable image stabilization during recording. 
- 
-**Hold during REC (IS)** 
-ML will keep the shutter button pressed half-way during recording, 
-which will enable image stabilization (IS). Side effect: you need to 
-press the shutter button half way to turn IS off before the camera will 
-let you stop recording. 
  
  
Line 1054: Line 1292:
 ==== Advanced Bracket ==== ==== Advanced Bracket ====
 > INCOMPLETE > INCOMPLETE
-Exposure bracketing for HDR images and timelapses.+Exposure bracketing for HDR images and timelapses.  
 +Aperture bracketing for landscapes, etc.
  
 //Submenu options:// //Submenu options://
  
 **Bracket type** Choose the variables to bracket. **Bracket type** Choose the variables to bracket.
 +  * Exposure (Tv, Ae)
 +  * Exposure (Flash)
 +  * DOF (Aperture)
  
 **Frames** Number of bracketed shots. Can be computed automatically. **Frames** Number of bracketed shots. Can be computed automatically.
 +  * Automated
 +  * 0 - 12
  
 **EV increment** Exposure difference between two frames. **EV increment** Exposure difference between two frames.
 +  * Range 0.5 - 8 EV (0.5 - 2 EV in 0.5 EV increments, 2 - 8 in 1)
  
-**Sequence** Bracketing sequence order / type. Zero is always first.+**Sequence** Bracketing sequence order / type. Zero is always first (cannot be changened in code, don't ask for it). 
 +  * 0 - -- (descending exposure time 
 +  * 0 - + -- ++ 
 +  * 0 + ++
  
 **2- second delay** Delay before starting the exposure. **2- second delay** Delay before starting the exposure.
 +  * Auto
 +  * OFF
  
 **ISO shifting** Also use ISO as bracket variable. Range 100 - max AutoISO. **ISO shifting** Also use ISO as bracket variable. Range 100 - max AutoISO.
 +  * OFF 
 +  * Full 
 +  * Half 
 +  * 
 [[http://www.magiclantern.fm/forum/index.php?topic=3045.0|Aperture bracketing]] In [[http://www.magiclantern.fm/forum/index.php?topic=3045.0|Aperture bracketing]] In
 M mode, this function does shutter and/or ISO bracketing. In the other M mode, this function does shutter and/or ISO bracketing. In the other
Line 1079: Line 1332:
 may also write a bash script for stacking the exposures with enfuse may also write a bash script for stacking the exposures with enfuse
 (version 4.x), with optional alignment (align_image_stack). More info: (version 4.x), with optional alignment (align_image_stack). More info:
-Exposure Fusion: What is it? How does it Compare to HDR? How Do I Do + [[https://digital-photography-school.com/exposure-fusion-what-is-it-how-does-it-compare-to-hdr-how-do-i-do-it | Exposure Fusion: What is it? How does it Compare to HDR? How Do I Do 
-It?.+It?]] 
 + 
 +Exposure time > 30 seconds: Not a problem at all. ML will extend exposure time on its own = entering ML's bulb mode. Screen will use setting stored in Bulb Timer -> Display during exposure (see below in section Bulb Timer).
  
 +Exposure time below cam's shortest shutter time: You will see an "E" appended to the lowest duration time. Means: Cam's limits are reached, this is an error. All photos set for lower durations will be taken with cam's fastest shutter timing.
 ==== Intervalometer ==== ==== Intervalometer ====
 > INCOMPLETE > INCOMPLETE
Line 1089: Line 1345:
 //Submenu options:// //Submenu options://
  
-**Take a pic every** Duration between two shots. +**Take a pic every** Duration between two shots. More precise: Time between 2 "shutter button actuations". If duration is set to lowest setting (0s/like crazy) cam will take pics in burst mode.
 Caveats: Caveats:
-If duration is exceeded by exposure time next pic will be taken immediately. +If selected interval is lower than exposure time next pic will be taken immediately after last pic
-Option "Long exp. noise reduction will double exposure time by running "dark frame" pic if condition is met.+Option "Long exp. noise reductionwill result in exposure time doubled if condition is met.
 If Intervalometer is used to trigger "Full Resolution Silent Pic" camera will take a few seconds for processing FRSP.  If Intervalometer is used to trigger "Full Resolution Silent Pic" camera will take a few seconds for processing FRSP. 
 +Don't expect "like crazy" (burst mode) to run without hickups. Cam has to wait for free buffer to continue shooting. Same may be happen with low duration settings in combination with high date rates (RAW) and/or cards with low write rate.
  
 > Internal note: ML menu shows (bottom line) calculation for time lapse duration depending on number of pics and interval. No idea how to represent this. > Internal note: ML menu shows (bottom line) calculation for time lapse duration depending on number of pics and interval. No idea how to represent this.
Line 1101: Line 1358:
    * Leave Menu: Will trigger Intervalometer by leaving ML menu or by camera startup/exiting powersave. Using this option is recommended if Intervalometer is running together with other ML/Canon features triggered by shutter button (FRSP, for example).     * Leave Menu: Will trigger Intervalometer by leaving ML menu or by camera startup/exiting powersave. Using this option is recommended if Intervalometer is running together with other ML/Canon features triggered by shutter button (FRSP, for example). 
    * Half Shutter: Trigger Intervalometer by half-pressing shutter release. May interfere with other ML/Canon features triggered by this action.    * Half Shutter: Trigger Intervalometer by half-pressing shutter release. May interfere with other ML/Canon features triggered by this action.
-   * Take a pic: Trigger Intervalometer by half-pressing shutter release. May interfere with other ML/Canon features triggered by this action.+   * Take a pic: Trigger Intervalometer by full-pressing shutter release. May interfere with other ML/Canon features triggered by this action.
  
  
Line 1107: Line 1364:
  
 **Stop after** Stop after X pictures. **Stop after** Stop after X pictures.
- 
-> Advanced Intervalometer options missing. 
  
 You can stop the intervalometer by rotating the mode dial, by pressing MENU You can stop the intervalometer by rotating the mode dial, by pressing MENU
-or PLAY, or by turning off the camera. To avoid flicker, shoot in+or PLAY, or by turning off the camera. To avoid aperture flicker, shoot in
 manual mode, use manual white balance, avoid short exposure times and manual mode, use manual white balance, avoid short exposure times and
 use a manual lens (if you use an EF lens, lock the aperture and unscrew use a manual lens (if you use an EF lens, lock the aperture and unscrew
Line 1127: Line 1382:
 blink once per second to let you know it's alive and kicking. blink once per second to let you know it's alive and kicking.
  
 +**Ramping options**
 +Only visible after loading module adv_int.mo
  
-==== Post Deflicker ==== +Advanced ramping and exposure control for the intervalometer  
-> INCOMPLETE +Forum: 
-(http://www.magiclantern.fm/forum/index.php?topic=10496.0)+http://www.magiclantern.fm/forum/index.php?topic=8431.0 
  
-//Submenu options://+Create keyframes from current camera settings and specify the frame at which the keyframe is applied. You will select which parameters you would like to set in the keyframe and which you would like to ignore. The module ramps (linearly) the vaules of selected parameters from one keyframe to the next while the intervalometer is running.
  
-**Sidecar file type** Sidecar file format for deflicker metadata.+Usage
  
-**Deflicker percentile** Where to meter for deflickeringRecommended 50%.+You should create an initial keyframe at 1, that has the settings you are going to start with, that way the module knows what to ramp fromIf you don't do this the module won't ramp to your first keyframe, it will simply set the values when it gets there (it doesn't know how to calculate the ramp, b/c it doesn't know what the values started as).
  
-**Deflicker target level** Desired exposure level for processed pics. 0 = overexposed.+Exposure ramping
  
-Menu item only visible after loading module "Post Deflicker (deflick.mo)+To ramp basic expo controls (Av, Tv, ISOset them like normal in the canon GUI as if you were taking a picture, then go into the ML menu under 'Shoot' -> 'Intervalometer' -> 'Ramping Options' -> 'New Keyframe' and create a new keyframe. Turn on or off to specify which parameters are to be included in the keyframe. The current values are displayed on the right for you, but you cannot change them from here.
  
-==== Bulb/Focus Ramping ====+Focus ramping
  
-> INCOMPLETE +For Focus you do specify the offset to focus to from the 'New Keyframe' menu. The module will calculate the number of focus steps it need to take each frame to arrive at your offset that you specify. It steps from wherever the lens is focused at the start. Negative values mean focus closer, positve is towards infinity. You need to be in LiveView for the focusing to work and make sure there is enough time after the exposure is taken, before the next one starts for the focusing to take place (I recommend at least 2s, maybe more depending on camera and lens)
-> OBSOLETE Whole section is no longer represented in Shoot menu. IMO this should be replaced by a proper description for Advanced Intervalometer.+
  
-Bulb Ramping allows the capture of a timelapse that gradually changes +Misc notes
-exposure, compensating for the transition from day to night.+
  
-//Submenu options://+You can ramp the intervalometer period as well, this you also specify from within the new keyframe menu 
 +Once you have created keyframes you can view them with the 'List Keyframes' menu. You can also save your keyframe sequence to file, and then reload them later. If not saved, any keyframes you created will be lost when the camera is turned off. Keyframes are saved and loaded from a file called "SEQ.TXT" in the ML/SETTINGS directory. 
 +When you have created keyframes and are ready to begin, make sure the advanced intervalometer is turned on, then turn the intervalometer on as usual from the ML Shoot menu.
  
-Auto exposure ramping: this option will adjust shutter and ISO automatically, by looking at image brightness of previous shots.+AutoETTR compatibility
  
-Manual exposure ramping: this option will adjust shutter and ISO to follow a +This module is compatible with AutoETTR so long as you don't try to ramp the parameters that AutoETTR is trying to change. You can ramp Av and let AutoETTR take care of Tv and ISO, or you can ramp Av and Tv and let AuttoETTR only set ISO, or put AutoETTR to link to Canon shutter (then your Tv will basically be setting the slowest Tv parameter of AutoETTR)
-fixed exposure ramp (a fixed amount of EV change per shot). Can be used +
-as standalone or combined with auto ramping.+
  
-Manual focus 
-ramping: this lets you adjust focus gradually while shooting the 
-timelapse. It requires a lens with autofocus and it can only work in 
-LiveView. 
  
-Settings for auto ramping:+//Submenu options://
  
-Mode: sunset / +  * Enabled OFF, ON 
-sunrise / auto. In sunset modethe exposure will always increase. In +  * Use Global Time OFFON 
-sunrise modethe exposure will always decrease. This idea was suggested +  * Loop After OFF1 - 5000 
-by Tom Lowe on RedUser.net forum.+  * External Source OFF, ON 
 +  * List Keyframes  
 +  * Save Keyframes 
 +  * Clear Keyfames 
 +  * New Keyframe...
  
-Maximum ramping speed: this 
-parameter is used for computing the optimal smoothness factor. A lower 
-value will reduce flicker, but if the value is twice as low as the real 
-rate of brightness change, ML will lose the ability to ramp correctly. 
-For example, if you set a maximum ramping speed of 0.1 EV / shot, and 
-the scene requires a ramping of 0.2 EV / shot, ML will start flickering 
-heavily. 
  
-Quick start guide for auto ramping:+==== Post Deflicker ====
  
-1. Take a picture of your scene. You will use it to say: I want my timelapse to be exposed like this picture.+Menu item only visible after loading module "Post Deflicker (deflick.mo)
  
-2. Enable Bulb Ramping and Intervalometer.+De-flickering stills, time-lapses and movies to achieve matching brightness. May be used to get [[https://www.magiclantern.fm/forum/index.php?topic=5705.0|flicker free time-lapse]]
  
-3. Leave the camera still while ML runs a calibration step:+> INCOMPLETE 
 +(http://www.magiclantern.fm/forum/index.php?topic=10496.0)
  
-Make sure you have a static and well-lit scene (any static scene which does not require long exposure should be fine).+//Submenu options://
  
-After calibration, you should get a nice S-curve on the screen.+**Sidecar file type** Sidecar file format for deflicker metadata. 
 +   * UFRaw: Suitable for open-source UFRaw image processor. Because of cam's limitation files are named "*.UFR". Rename to "*.ufraw" before running them into UFRaw. 
 +   * Adobe XMP: Suitable for Adobe products.
  
-4. Now you will have to say what tone range to meter for (i.ehighlights, midtones…)Follow the wizard:+**Deflicker percentile** Where to meter for deflickeringRecommended 50%.
  
-Use arrow keys to select your reference picture (which you just took).+**Deflicker target level** Desired exposure level for processed pics. 0 = overexposed.
  
-Use the main dial to select the tone range to meter for. You can't +File naming for sidecar files expects setting "Color Space = sRGB" and does not support "Adobe RGB" setting on its own
-perfectly match two images just by varying one parameter (exposure), so +If used for silent pics: Supports DNG files only!
-you have to choose what's important for you in this picture.+
  
-For 
-lowest flicker, meter for midtones (choose the 50th percentile, i.e. 
-median, because it's a robust estimation, unlike simple averaging). 
-Leave some headroom for highlights (underexpose a bit). 
- 
-If 
-highlights are important, meter for them (choose 80th percentile for 
-example). You will have to shoot RAW and remove flicker when you develop 
-the RAW files. 
-The algorithm works best when brightness is close to 50% (try not to choose extreme values for it). 
-When you are ready to start, press SET. 
-5. Sit back and relax :) 
-Limits: 
-ISO is chosen between 100 and maximum auto ISO value from Canon menu. 
-Shutter speed is chosen between 1/8000 (lower limit) and the delay between two 
-shots minus two seconds (upper limit). Example: for 10-second intervals, 
-shutter speed will be between 1/8000 and 8 seconds. 
-Aperture is fixed (you can change it manually). 
-Tips: 
-Don't adjust ISO and shutter before the timelapse, they are fully automatic. 
-Use a ND filter to reduce flicker during daylight. 
-Reduce flicker in post. We recommend VirtualDub with MSU Deflicker plugin 
-(free, works with Windows and Wine). See also Timelapse workflow using 
-free software tutorial. 
-Technical notes: 
- 
-Exposure is metered using a condition like this (for example): 70% of pixels should be below 50% brightness. 
- 
-Exposure for every shot is computed from previous shots, using a feedback controller algorithm with a smoothing factor. 
- 
-ISO is chosen using the 180 degree rule, so the resulting shutter speed 
-stays between 90 and 270 degrees (that is, between 1/4 and 3/4 of the 
-delay between two shots). 
- 
-Only full-stop ISOs (100, 200, 400 etc) are used (because you are supposed to shoot RAW). 
- 
-Shutter speed can be adjusted with a resolution of 10ms. 
-Frames with fast shutter speeds (less than 1 second in Rebel cameras, less 0.1 
-seconds in 60D) are taken in Manual mode. You will get flicker. 
-It can go from 1/8000s @ ISO 100 (daylight) to several minutes of exposure time @ ISO 6400 (complete darkness). 
- 
-Exposure algorithm is a feedback controller designed with pole placement - the 
-closed loop response will have two real poles placed at the smoothing 
-factor value. Smoothing factor is computed in such a way that, when 
-scene ramping speed matches the speed selected in menu, ramp is followed 
-at exactly 1 EV behind it. If the lighting changes suddenly a few stops 
-between two shots (for example, you change the ND filters or the 
-aperture), the algorithm should recover completely after 2 or 3 shots. A 
-sudden exposure change is considered when the exposure difference is 
-greater than 2 stops. 
- 
-Logging: When you use bulb ramping, Magic 
-Lantern will save a log file with the exposure parameters, metered 
-values and so on. Please send this file to developers. These log files 
-can be used to see how well the ramping went and to fine-tune the 
-algorithm. 
  
  
Line 1262: Line 1456:
 //Submenu options:// //Submenu options://
  
-**Exposure duration**+**Exposure duration** from 1s to 8h00m00s in 1 seconds increments.
  
 **Display during exposure** **Display during exposure**
 +
 +   * Don't change: You will see a clock counting up
 +   * Turn off: Just black
 +   * Show previous pic: Shows last image taken and clock counting up + Remaining seconds
  
 Bulb timer is started by holding the shutter pressed halfway for one second, Bulb timer is started by holding the shutter pressed halfway for one second,
 or by remote triggers / intervalometer. You can cancel the exposure or by remote triggers / intervalometer. You can cancel the exposure
 earlier by half-pressing the shutter button. earlier by half-pressing the shutter button.
 +If used together with other features (Silent pics, Intervalometer, ...) make sure half-shutter actuation will not get mixed up.
  
  
Line 1305: Line 1504:
 This may trigger the shutter from the sounds made by camera (like focus This may trigger the shutter from the sounds made by camera (like focus
 beep or noise from operating the buttons). beep or noise from operating the buttons).
 +
 +This setting is not persistent! If cam is turned off or going into powersave Audio Remote Shot will be disabled.
 +If you want to use this feature for surveillance you may want to use LUA script to enable Audio Remote Shot after brownouts.
  
  
Line 1324: Line 1526:
 **Detect Size** Size of the area on which motion shall be detected. **Detect Size** Size of the area on which motion shall be detected.
  
-**Delay** Delay between the detected motion and picture taken.+**Delay** Range from 0 (OFF) to 1 second in 0.1 second increments. Delay between the motion detection and picture taken.
  
-Detection time is somewhere between 200 and 300 ms according to DataGhost's speed test and it'faster with silent pictures.+Detection time is somewhere between 200-300ms (according to DataGhost's speed test), or faster with silent pictures. If "Use Autofocus" is selected it may add another (non-deterministic) delay due to the focusing. 
 + 
 +This setting is not persistent! If camera is turned off or going into powersave Motion Detection will be OFF! 
 +If you want to use this feature for surveillance you may want to use LUA script to enable Motion Detection after brownouts.
  
  
Line 1333: Line 1538:
 >INCOMPLETE >INCOMPLETE
  
-Take pictures in LiveView mode without moving the mirror.+Take pictures in LiveView mode without moving mirror or shutter. 
 + 
 +All options (excluding "Full-res" which does use full sensor area and resolution) work similiar in respect to resolution/aspect ratio. Resolution/aspect ratio depends on LiveView and is therefore restricted. And actual resolution/aspect ratio depends on camera model, being in still or movie LiveView, zoomed in or not. 
 +You might want to use movie mode for highest vertical resolution. And yes: "Silent pictures" is working in Movie mode, too.
  
 //Submenu options:// //Submenu options://
Line 1342: Line 1550:
 recording or not, and movie resolution). For almost-FullHD resolution recording or not, and movie resolution). For almost-FullHD resolution
 (1720×974), choose FullHD to record a dummy movie. (1720×974), choose FullHD to record a dummy movie.
-    * Burst: +    * Burst: Same as "Simple" but in burst mode. Started by pressing Half-Shutter (> 0.5 seconds) - and keeping it pressed - it fills up internal memory buffer with individual images. If button is released or buffer is filled (whatever comes first) buffer content is written to card . Number of images depends on resolution and cam's buffer size. 
-    * Burst, End Trigger: +    * Burst, End Trigger: Same as "Burst" but overwrites oldest buffered images if buffer limit is reached without stopping taking new pics. If button is released image aquisition will stop and buffer will be written to card. This option allows you to record a sequence that's determined by an unpredictable event: a bird approacing a nest, lightning bolt, etc... 
-    * Best Focus +    * Best Focus: Pretty much like burst but with postprocessing in regards of focus precision. As long as you keep Shutter button half-pressed images go into buffer continuously (overwriting oldest images, if any). After shutter button is released cam will calculate focus for each picture and store them in order. Lowest file number goes to the pic with best focus, highest number to the worst. 
-    * Slit-Scan:  +    * Slit-Scan: For creative use and fun. Enjoy "rolling shutter" galore! If enabled you may choose 
-    * Full-res: Silent pic covering full sensor area.+    * Slit-Scan Mode:  Top->Bottom, Bottom->Top, Left->Right, Right->Left, Horizontal 
 + 
 +    * Full-res: Silent pic covering full sensor area. In ML forums this feature is known as FRSP (Full Resolution Silent Pics). [[https://www.magiclantern.fm/forum/index.php?topic=12523.msg120497#msg120497|Forum thread covering FRSP]] 
 + 
 Limits:  Limits: 
 FRSP is not made for short exposures. You will get overexposured pictures if you insist on using short shutter settings. FRSP is not made for short exposures. You will get overexposured pictures if you insist on using short shutter settings.
Line 1355: Line 1567:
 ETTR works best with Intervalometer. Set ETTR option "Always On". Adjust aperture or use ND filter to get exposure times above 0.5 seconds. Otherwise results may be impossible to deflicker in postprocessing. Don't forget Silent pic and Intervalometer are using the same default trigger. Change Intervalometer trigger to "Leave menu" to avoid this. ETTR works best with Intervalometer. Set ETTR option "Always On". Adjust aperture or use ND filter to get exposure times above 0.5 seconds. Otherwise results may be impossible to deflicker in postprocessing. Don't forget Silent pic and Intervalometer are using the same default trigger. Change Intervalometer trigger to "Leave menu" to avoid this.
 Source: https://www.magiclantern.fm/forum/index.php?topic=12523.msg143510#msg143510 Source: https://www.magiclantern.fm/forum/index.php?topic=12523.msg143510#msg143510
- 
- 
- 
-> OBSOLETE? Silent Pic Hi-Res: 
-emulates high-resolution by taking a matrix of small silent pics, in 
-zoom x5 mode. You need to have the camera on a tripod and the subject 
-should be static (a picture is taken in a few seconds). Could be useful 
-for focus stacking or for timelapse without increasing shutter count. 
  
 **File Format** Choose DNG or MLV. Later requires loading MLV_REC.mo. **File Format** Choose DNG or MLV. Later requires loading MLV_REC.mo.
 +In short: "DNG" writes a single pic to a single files. MLV writes all single pics of a session into a single MLV. Similiar to a movie file consisting of several consecutive frames. A new session (incrementing file name) begins after powersave or after shutdown/restart. 
 +If you want to use Deflicker option (deflick.mo) you have to use DNG format. MLV not supported.
  
 +Storing into MLV is considerable faster than writing DNG. Example: 7D, burst mode (94 pics). 
 +Writing DNG: 80 seconds
 +Writing to MLV: 24 seconds
  
-Silent picture setting is applied to intervalometer and remote triggers. It +Silent picture setting is applied to intervalometer and remote triggers.  
-will also go to LiveView when you press the shutter half-way. Therefore, +> Description neeeds work: It will also go to LiveView when you press the shutter half-way.  
-you should only enable this setting when you actually use it. When +Therefore, you should only enable this setting when you actually use it. 
-enabled, it saves uncompressed YUV422 frames from the LiveView image +
-buffer when you press the shutter halfway. Make sure you don't have +
-autofocus assigned to half-shutter press (put it on * or turn it off) +
-Images are saved in DCIM/1xxCANON/ after the following rules:+
  
-If intervalometer is OFF, silent pics are named after last picture/movie +File names (DNG): 
-taken without this function (e.g12340001.422). You are limited to +File naming for silent pics is derived from the last "normal" picture taken. Canon names RAW files IMG_xxxx.CR2 (colour space setting sRGB) or _MG_xxxx.CR2 (colour space setting aRGB). Silent DNG pics will be named xxxxyyyy.dng beginning with yyyy=0000. Number will be incremented with each silent pic written to card.  
-10000 silent pictures for each noisy picture.+Keep in mind option "Best Focus" does write files not in chronological order but in order of focus precision.
  
-If intervalometer +If Silent Pics are triggered by Intervalometer name schema changes to Intervalometer settings: Counting beginns with 00000000.DNG on an empty card (=no previous intervalometer session storedor continues counting from the last intervalometer shot.
-is ON, silent pics have names like 12345678.422. Tip: use File Numbering +
-? Manual Reset from Canon menu to increase folder number (to sort them +
-easier).+
  
-To convert a 422 image to JPEG on the PC, use one of the following programs:+File names (MLV): 
 +File naming for silent pics is derived from the last "normal" picture taken. Canon names RAW files IMG_xxxx.CR2 (colour space setting sRGB) or _MG_xxxx.CR2 (colour space setting aRGB). Silent pics (MLV) of a session will be stored in xxxxyyyy.MLV beginning with yyyy=0000 for the first session.  
 +In "Simple" mode a new session begins after Powersave or Shutdown/restart. 
 +In "Burst" modes each burst will generate a new session file with file number incrementing.
  
-422-jpg.py (command-line tool, runs on all platforms, you need to install Python, PIL and numpy). 
  
-422toimage (Windows only, source code available). 
  
-YUV422 Convertor (Windows only, closed source). 
  
  
Line 1420: Line 1622:
 //Submenu options:// //Submenu options://
  
-Flash expo compensation (-10..+3 EV). Tip: you may use -10EV to trigger an+   Flash expo compensation (-10..+3 EV). Tip: you may use -10EV to trigger an
 external flash without putting light on the scene coming from the external flash without putting light on the scene coming from the
 onboard flash. onboard flash.
  
-Flash / No flash: use this when you are not sure+   Flash / No flash: use this when you are not sure
 whether to use flash or not. Odd pictures (by file number) will be taken whether to use flash or not. Odd pictures (by file number) will be taken
 with flash, even pictures without flash. with flash, even pictures without flash.
  
-3rd party flash in LV: a + 
-trick for using a non-Canon flash in LiveView on Rebel cameras, which +> Available for 1100D, 500D, 550D and 600D only. None of them here to test. Anyone out here to be able to drop a word? 
-disables LiveView on half-shutter press. DISABLE this option when you + 
-don't use it!!!+   3rd party flash in LV: a trick for using a non-Canon flash in LiveView on Rebel cameras, which 
 +disables LiveView on half-shutter press. DISABLE this option when you don't use it!!!
  
 ==== Shoot Preferences ==== ==== Shoot Preferences ====
Line 1437: Line 1640:
 //Submenu options:// //Submenu options://
  
-**Pics at once** How many pics to take at once for each trigger event.+**Pics at once** Range: 1 (OFF) - 9. How many pics to take at once for each trigger event.  
 + 
 +Useful for one-time events like Audio Remote Shot, Trap Focus, Motion Detect. 
 +If using together with Intervalometer make sure exposure time (multiplied) does not exceed interval duration.
  
 **Use Autofocus** For intervalometer, audio remote shot and motion detect. **Use Autofocus** For intervalometer, audio remote shot and motion detect.
  
-**Post scripts** Post processing scripts for bracketing and focus stacking.+With default setting OFF intervalometer, audio remote shot and motion detect will *not* use autofocus no matter AF on lens is selected. If trigger condition is met an image will be taken! 
 +With setting ON autofocus will be used. If the cam is unable to establish focus confirmation there will be no image aquisition.  
 +Also consider that lag between trigger condition met and image aquisition will be extended by the time needed for focusing. 
 + 
 +**Post scripts** Post processing scripts/listings for bracketing and focus stacking. 
 + 
 +  * Enfuse 
 +  * Align+Enfuse 
 +  * File List 
 + 
 +This option will generate a flat text file for each bracketing or focus stacking sequence. Those are made for Unix-like systems (OS X, macOS, Linux,...) able to run .sh scripts or (in case of "File list") are just lists of image file names for given sequences. 
 +Caveat: Image file names are generated with .JPG extension regardless which image files format is actually recorded. If you want to run those scripts with RAW/DNG/MLV you may want adjust this by another script. ;-) 
 + 
 + 
 +**Intervalometer Script** Scripts/list for sorting intervalometer sequences. 
 + 
 +Those scripts consists of commands creating directories for each interval sequence and moving associated image files to those directories. 
 + 
 +  * Bash: .sh script for running on Unix-like systems (OS X, macOS, Linux, ...) 
 + 
 +  * MS-DOS: Batch file for the Windows CLI (command line interface) aka DOS-box. 
 + 
 +  * File List: Plain text file  
 + 
 +Directories names are computed according to first file name of a sequence. Example: First file is named IMG_1234.CR2 -> Directory name will be IMG_1234 (without extension) and it will contain all files for that sequence. 
  
-**Intervalometer Script** Scripts for sorting intervalometer sequences. 
  
-**Snap Simulation** Simulates picture aquisition for testing purposes without wearing out shutter and mirror. Useful for Íntervalometer, Advanced Bracketing and Focus Stacking.+**Snap Simulation** Simulates picture aquisition for testing purposes without wearing out shutter and mirror. Useful for testing Íntervalometer, Advanced Bracketing and Focus Stacking features.
  
  
Line 1491: Line 1721:
 //Submenu options:// //Submenu options://
  
-**OFF ON**+**Focus using OFF**
  
-Arrows: +**Focus using Arrows** 
-you will be able to focus with the arrow keys. LCD Sensor: on +you will be able to focus with the arrow keys.  
-550D/500D, focus by placing your hand near the LCD sensor (avoiding+ 
 +**Focus using LCD Sensor** 
 +Focus by placing your hand near the LCD sensor (avoiding
 shake). To use this, you may need to disable LCDsensor Remote. shake). To use this, you may need to disable LCDsensor Remote.
-Recommended focus step settings: 
-Focus StepSize: 1 or 2 
-Focus StepDelay: small values, without Wait flag. 
-If the motion is not smooth, try larger delays (100ms) 
  
-Quick rack focus while recording:+Quick rack focus **while recording**:
  
-Press MENU to save current focus point (this means I want to return here); +  * Press ''MENU'' to save current focus point (this means ''I want to return here''); 
-Use follow focus to change focus point (focus somewhere else); +  Use follow focus to change focus point (focus somewhere else); 
-Press PLAY to go to saved focus point; +  Press ''PLAY'' to go to saved focus point; 
-Press PLAY again to go back.+  Press ''PLAY'' again to go back
 + 
 +When "Arrows" is selected you have the option to use slow (FF-, FF+) or fast (FF--, FF++) focusing. 
 + 
 +When "LCD Sensor" is activated you only have slow focusing (FF-, FF+). You have to toggle direction by LCD sensor itself! A short wave in front of the sensor will trigger focusing one step into the "false" direction and toggle FFx.
  
  
Line 1513: Line 1745:
  
 This is end point of rack focus (X focus steps from the start point, i.e. from current focus point). This is end point of rack focus (X focus steps from the start point, i.e. from current focus point).
 +
  
 //Submenu options:// //Submenu options://
  
-First you have to set the end point. Focus the lens, then press SET on this +Works in Liveview only! 
-menu item. After pressing SET, ML will display Focus End Point: 0 steps+ 
 +First you have to set the end point. Focus the lens, then press on this 
 +menu item. After pressing Q, ML will display Focus End Point: 0 steps
 from here.. This means the end point is now assigned to current focus from here.. This means the end point is now assigned to current focus
-position. At this point, you will see the LiveView image and set the +position. At this point, you will see the LiveView image (if not: Press Q again until LiveView is active. See screenshot) and set start point using left and right keys (just like with follow focus) or
-start point using left and right keys (just like with follow focus) or+
 the main dial (scrollwheel). The start point will be always the current the main dial (scrollwheel). The start point will be always the current
 focus point (which you are changing); the end point will remain fixed. focus point (which you are changing); the end point will remain fixed.
 +There may be a bit of lagging between arrow press and screen info getting updated with actual focus step numbers.
 +
  
  
Line 1535: Line 1771:
 SET: rack focus will start after 2 seconds; SET: rack focus will start after 2 seconds;
  
-Q: rack focus will start immediately;+> Not reproducable with 650D,7. Not working  Q: rack focus will start immediately;
  
-PLAY: ML will automatically record a short clip with the rack focus operation.+> Record start not working in 650D, 7D 
 +> Play button not working in 100D at all PLAY: ML will automatically record a short clip with the rack focus operation.
  
 Step-by-step: Step-by-step:
Line 1552: Line 1789:
 focus from the LCD sensor, avoiding camera shake. focus from the LCD sensor, avoiding camera shake.
  
-Recommended focus step settings:+Recommended focus step settings (menu item "Focus Settings"):
  
-Focus StepSize: 1 or 2+Step Size: 1 or 2
  
-Focus StepDelay: - without Wait flag: large delays (around 100 ms) ? will+Step Delay: - without Wait flag: large delays (around 100 ms) ? will
 ignore small position errors - with Wait flag: small delays (only lens ignore small position errors - with Wait flag: small delays (only lens
 is in very good mechanical condition) is in very good mechanical condition)
Line 1562: Line 1799:
  
 ==== Focus Stacking ==== ==== Focus Stacking ====
 +
 +This selection will shoot a series of photographs with varying focus points.
 +It is frequently used in macro photography to enlarge depth-of-field (DOF) by merging photos where each has a different focus point.
 +
  
 //Submenu options:// //Submenu options://
Line 1577: Line 1818:
 **Copy rack focus range** **Copy rack focus range**
  
-This selection will shoot a series of photographs with varying focus points. +Usage:
-It is used in macro photography to assemble sharper final images by +
-merging photos where each has a different focus point.+
  
-This +Before you begin you may consider running cam in Snap Simulation (Shoot screen -> Shoot Preferences). This will prevent wearing out mirror and shutter while struggling to make sense of focus stacking settingsespfinding front and back focus planes.
-function can also create scripts named like named FST_1234.SHwhich can +
-be used for stacking the images with enfuseSee Exposure bracketing +
-for details on how to use these scripts, and the focus stacking section +
-from Enfuse reference manual. To enable (or disable) the post-processing +
-scripts, go to HDR bracketing submenu.+
  
-Usage:+Sequences running into focus delimiter (reaching cam's focus distance limit) will get terminated leaving you with a bunch of files not suitable for postprocessing. 
 + 
 + 
 +Method 1:
  
 Configure rack focus and use it to preview the focus range. Configure rack focus and use it to preview the focus range.
Line 1594: Line 1831:
 Select the number of focus steps to skip. This will determine the number of pictures to be taken. Select the number of focus steps to skip. This will determine the number of pictures to be taken.
  
-Press PLAY to start the focus sequence (PLAY mode) or take the first picture (SNAP mode).+Press PLAY to start the focus sequence (PLAY mode) or take the first picture with shutter release. 
 + 
 +Method 2: 
 + 
 +> To do
  
-You can also combine this function with HDR bracketing and silent pictures. 
  
 Recommended focus step settings: same as for rack focus. Recommended focus step settings: same as for rack focus.
  
-The following items are display only:+> To doScript files 
 + 
  
 ==== Focus Settings ==== ==== Focus Settings ====
Line 1625: Line 1867:
  
  
-==== Rack Delay ==== 
-> OBSOLETE? 
- 
-Sets the number of seconds before starting a rack focus. 
- 
-//Submenu options:// 
- 
-This lets you film the start point first, then initialise the rack focus without touching the camera. 
  
  
Line 1650: Line 1884:
 ==== Focus Patterns ==== ==== Focus Patterns ====
  
-Custom focus patterns which can be used either with autofocus or trap focus.+Custom focus patterns which can be used either with autofocus or trap focus. Menu item will be seen in cameras with "classic" 9-point rhombus. 
 + 
 +{{ :focuspat.png?nolink |}}
  
 //Submenu options:// //Submenu options://
Line 1720: Line 1956:
  
 ==== LV Digic peaking ==== ==== LV Digic peaking ====
 +
 +LiveView focus peaking __without__ affecting write performance
 +
 +Will only displayed if half-shutter button is not pressed!
  
 //Submenu options:// //Submenu options://
Line 1725: Line 1965:
 **OFF** **OFF**
  
-**Slightly sharper**+**Slightly sharper** Areas in focus will be slightly sharpened
  
-**Edge image**+**Edge image** Grey image with edges displayed in white
  
-**Edge + chroma**+**Edge + chroma** Same as Edge image but in chroma.
  
 ==== LV brightness ==== ==== LV brightness ====
Line 1771: Line 2011:
  
 **High** **High**
 +
 **Very high** **Very high**
  
Line 1778: Line 2019:
 ==== LV display gain ==== ==== LV display gain ====
  
 +Photo/stills mode only.
 This feature increases the brightness in LiveView, making it usable in very This feature increases the brightness in LiveView, making it usable in very
 dark scenes (where Canon's LiveView would be pitch black). dark scenes (where Canon's LiveView would be pitch black).
Line 1805: Line 2047:
 (audio, zebra, crops, shutter speeds…).Tip: assign autofocus to * button (audio, zebra, crops, shutter speeds…).Tip: assign autofocus to * button
 (from Custom Functions, set Shutter/AE lock button = AE lock/AF). (from Custom Functions, set Shutter/AE lock button = AE lock/AF).
 +
 **WhenIdle** **WhenIdle**
 In this mode, all the overlays are erased from the screen (100% clean In this mode, all the overlays are erased from the screen (100% clean
 display) when the camera is idle (i.e. you don't press any buttons). display) when the camera is idle (i.e. you don't press any buttons).
 +
 **Always** **Always**
 In this mode, all the overlays are erased from the screen; you will In this mode, all the overlays are erased from the screen; you will
Line 1813: Line 2057:
 menus.Tip: this feature may be useful with External Recorders, since it menus.Tip: this feature may be useful with External Recorders, since it
 removes the focus box and other graphics from the display. removes the focus box and other graphics from the display.
 +
 **Recording** **Recording**
  
 +
 +Be aware there are other options affecting overlay visibility: Overlay screen -> Global Draw -> Options: Off, LiveView only, Quickreview only, Both LV and QR. And MLV_REC has a switch to turn off Global Draw, too.
  
 ==== Defishing ==== ==== Defishing ====
  
-Correct wide angle lens distortion.+Preview the rectified (defished) image from Samyang 8mm fisheye lens, using rectilinear projection. 
  
 //Submenu options:// //Submenu options://
Line 1828: Line 2076:
 **Panini** **Panini**
  
 +This feature works best in photo mode (outside LiveView). Defishing uses a pre-computed look-up table (LUT). It is possible to create LUT files for any other lens or projection by defishing vram/xy.png with your favorite defishing software, and then running vram/defish-lut.m to get the LUT file. All the required files are found in the ML source tree. Project files (*.PTO) for nona (hugin) are provided for both rectilinear and Panini projections.
  
 ==== Anamorphic ==== ==== Anamorphic ====
Line 1856: Line 2105:
 **Screen Layout** Choose screen layout (position of ML top and bottom bars), for different cameras or for external monitors. **Screen Layout** Choose screen layout (position of ML top and bottom bars), for different cameras or for external monitors.
 Top/bottom layouts: Top/bottom layouts:
-Inside 3:2: default layout for 3:2-screen cameras (550D and newer). + 
-Inside 16:10: for 16:10 HDMI monitors. +  * 3:2 display, t/b: default layout for 3:2-screen cameras (550D and newer). 
-Inside 16:9: for 16:9 HDMI monitors. +   
-4:3 movie (for 5D Mark II, 500D and 50D in movie mode).+  * 16:10 HDMI, t/b: for 16:10 HDMI monitors. 
 + 
 +  * 16:9 HDMI, t/b: for 16:9 HDMI monitors. 
 + 
 +  * 4:3 movie (for 5D Mark II, 500D and 50D in movie mode).
 Bottom-only layouts: Bottom-only layouts:
-Under 3:2: useful for 4:3-screen cameras (500D, 50D, 5D Mark 2) in photo mode. + 
-Under 16:9: suitable for low-resolution external monitors and for 4:3-screen cameras in movie mode.+  * Bottom, under 3:2: useful for 4:3-screen cameras (500D, 50D, 5D Mark 2) in photo mode. 
 + 
 +  * Bottom, under 16:9: suitable for low-resolution external monitors and for 4:3-screen cameras in movie mode.
  
 **Color scheme** **Color scheme**
Line 1869: Line 2124:
 //Submenu options:// //Submenu options://
  
-Range from: Bright (default), Dark, Bright Gray, Dark Gray, Dark Red. Tip:+Range from: Default (bright), Dark, Bright Gray, Dark Gray, Dark Red, Dark Green. Tip:
 dark themes may reduce the eye strain during night shooting. dark themes may reduce the eye strain during night shooting.
  
Line 1876: Line 2131:
 **Image position** **Image position**
 This may make the image better visible from different angles This may make the image better visible from different angles
-(especially on cameras without flip-out screen). Auto Mirroring For +(especially on cameras without flip-out screen).  
-cameras with flip-out LCD, this options prevents mirroring the display + 
-when you open it at 180 degrees. DisplayNormal/Reverse/Mirror For +//Submenu options:// 
-cameras with flip-out LCD, you may select a different flipping/mirroring + 
-option.+Range from -16px to 16px in 8px increments. 
 **UpsideDown mode** This mode is useful if you want to mount your camera upside-down. **UpsideDown mode** This mode is useful if you want to mount your camera upside-down.
 +
 +**Orientation**
 +
 +Upside-down and mirroring option
 +
 +For cams with flip-out LCD
 +
 +//Submenu options://
 +
 +   * Normal
 +
 +   * Reverse: Another Upside-Down option
 +
 +   * Mirror: Flip horizontally (mirrored along vertical axis)
 +
 +
 +**Auto Mirroring** 
 +For cameras with flip-out LCD, this options prevents mirroring the display
 +when you open it at 180 degrees. 
 +
 **LV crazy colors** **LV crazy colors**
 +
 +May be helpful for white balance.
 +
 +//Submenu options://
 +
 +   * OFF
 +
 +   * Swap U-V
 +
 +   * Extreme Chrome
  
 **Force HDMI-VGA** **Force HDMI-VGA**
Line 1901: Line 2187:
 //Submenu options:// //Submenu options://
  
-Idle/Menus: only enable Canon graphics when some transparent menu from LiveView is active. +   Idle/Menus: only enable Canon graphics when some transparent menu from LiveView is active. 
-Idle/Menus+Keys: only enable Canon graphics when you press some keys or navigate the transparent menus from LiveView.+ 
 +   Idle/Menus+Keys: only enable Canon graphics when you press some keys or navigate the transparent menus from  LiveView.
  
  
Line 1912: Line 2199:
  
 ===== Prefs ===== ===== Prefs =====
 +> INCOMPLETE
  
-**Card settings**+==== Card settings ===== 
 + 
 +This menu is unique to 5D3. 
 + 
 +//Submenu options:// 
 + 
 +**Card test at startup** 
 + 
 +**CF card workaround** 
 + 
 +**Preferred card**
  
-   * Card test at startup 
-   * CF card workaround 
-   * Preferred card 
  
 ==== Config options ==== ==== Config options ====
Line 1932: Line 2227:
  
 ML options and settings can be overwhelming, esp. when trying to switch between different setups. ML options and settings can be overwhelming, esp. when trying to switch between different setups.
-Therefore presets come handy. +Using Config Presets allows to switch numerous ML settings at once. Therefore presets come handy.
  
     * OFF     * OFF
     * Startup mode: Load a preset associated to selected mode (by Mode Dial)     * Startup mode: Load a preset associated to selected mode (by Mode Dial)
-    * Startup key: Load a preset by pressing MENU/PLAY/INFO at startup. INFO button might be tricky because it will work only if pressed shortly after turning on cam.  +    * Startup key: Load a preset by pressing MENU/PLAY/INFO at startup. INFO button might be tricky because it will work only if pressed shortly after power on. The other keys work fine if being pressed before powering up cam.  
-    * Custom presets: You are able to create up to 13 custom presets at startup. They will only be visible after creating subdirectories in ML/Settings (using your PC). Name length for such directories is limited to 8 characters. +    * Custom presets: You are able to configure up to 13 custom presets. They will only be visible after creating subdirectories in ML/Settings (using your PC). The name displayed in this menu matches the name given to the subdirectory. Name length for directories is limited to 8 characters. 
-be advised to use smart naming conventions such as using preceeding P or V letters to tell photo and video presets. +Tipp: Use smart naming conventions such as preceeding P or V letters to distinguish between photo and video presets.  
 +Caveat: Order of custom presets is not by alphabet/number but date of directory creation (time stamp)! Newest cames last, oldest first.
  
 **Config AutoSave** **Config AutoSave**
Line 1945: Line 2241:
 the menu. the menu.
  
-**Save config now** Save ML settings to ML/SETTINGS/MAGIC.CFG.+**Save config now** Save ML settings to ML/SETTINGS/MAGIC.CFG or the config preset selected.
  
 **Restore ML defaults** use this to restore ML default settings. After deleting the config file, restart the camera. **Restore ML defaults** use this to restore ML default settings. After deleting the config file, restart the camera.
  
 +As mentioned above using Config Presets allows to switch numerous ML settings at once. If you want to rely on this feature make up your mind about how to change and preserve settings. 
 +The issue at hand is: There is no "Back to last setting". ML has 2 options (indiviual for each config preset): 
 +    * Always save all and every changes as soon as changes are done and the menu item is closed: Config AutoSave ON
 +    * Do not save any change to config file MAGIC.CFG: Config AutoSave OFF
 +Imagine you are in the field and one of your precious config preset settings has to be changened because of unique circumstances. With Config AutoSave ON your precious preset will be overwritten and you have to remind yourself to reset this very setting if you want to go back to status before. 
 +With Config AutoSave OFF the changed setting will not be persistent and gone after shutdown. So you have to remind yourself to re-set this very setting or you are shooting with just the setting from the very beginning.
 +
 +There is no right or wrong in using either option. It's just up to you to find a suitable workflow to avoid problems.
 +Don't forget: If you are using Config Autosave OFF you are still able to overwrite your settings by using "Save config now"!
 +
 +Recommended for custom presets: Backup your ML\Settings directory to a safe location. You will be able to restore settings anytime by just overwriting the troubled preset directory or all of them.
  
 ==== Image review settings ==== ==== Image review settings ====
Line 1956: Line 2263:
 //Submenu options:// //Submenu options://
  
-**Play mode actions** When you hold SET pressed and turn the main dial (scrollwheel), ML may perform one of these functions: +**Play mode actions** When you press associated "Trigger key(s)" (see below), ML may perform one of these functions: 
-  * Play 422display silent pictures from DCIM/100CANON (low-res only). + 
-  * Exposure Fusion: combine two or more images, useful for previewing HDR images or multiple exposures. +//Submenu options:/
-  * Compare Images: compare two images with a diagonal split view. The current image will always end up in the top half. + 
-  * Timelapse Play: scroll through all your pictures quickly.+  * **Action type**: 
 + 
 + 
 +       * OFF 
 +       * Exposure Fusion: combine two or more images, useful for previewing HDR images or multiple exposures. 
 +       * Compare Images: compare two images with a diagonal split view. The current image will always end up in the top half. 
 +       * Timelapse Play: scroll through all your pictures quickly. 
 +       * Exposure Adjust: ? 
 + 
 +     * **Trigger key(s)** 
 + 
 + 
 +   * Set+MainDial 
 +   * Left/Right 
 +   * L/R & Set+Dial 
  
 **Image Review** **Image Review**
Line 1970: Line 2292:
   * ON - zooms faster than Canon firmware.   * ON - zooms faster than Canon firmware.
   * SinglePress ? 100%: a single press of Zoom In will zoom all the way in (to 100%) -  on center point. Next press will zoom out (full screen image).   * SinglePress ? 100%: a single press of Zoom In will zoom all the way in (to 100%) -  on center point. Next press will zoom out (full screen image).
-  * Full zoom on AF point: similar, but it will zoom on currently selected autofocus point. +  * Full zoom on AF pt.: similar, but it will zoom on currently selected autofocus point. 
-  * Full zoom on last position: similar, but it will remember the last position of the zoom box.+  * Full on last pos.: similar, but it will remember the last position of the zoom box.
  
 **LV button** Customize the LiveView button in PLAY mode: **LV button** Customize the LiveView button in PLAY mode:
   * Default (enter LiveView)   * Default (enter LiveView)
   * Protect image   * Protect image
 +  * Rate image
  
 **Quick Erase** Shortcut for erasing images without confirmation (hold SET and press ERASE). Be careful! **Quick Erase** Shortcut for erasing images without confirmation (hold SET and press ERASE). Be careful!
Line 2062: Line 2385:
  
  
-Swap MENU &lt;-&gt; ERASE (60D)+**Swap MENU ERASE** (60D)
 Swaps MENU and ERASE buttons. This feature allows one-handed navigation in ML Swaps MENU and ERASE buttons. This feature allows one-handed navigation in ML
 menu on 60D, but will have to use MENU button to delete the pictures. menu on 60D, but will have to use MENU button to delete the pictures.
-DigitalZoom Shortcut (600D)+ 
 +**DigitalZoom Shortcut** (600D)
 On 600D/T3i, this lets you customize the behavior of DISP + Zoom In / Zoom Out shortcut key in movie mode: On 600D/T3i, this lets you customize the behavior of DISP + Zoom In / Zoom Out shortcut key in movie mode:
 1x,3x : toggle between 1x and 3x digital zoom modes (FullHD) 1x,3x : toggle between 1x and 3x digital zoom modes (FullHD)
Line 2113: Line 2437:
 **Turn off GlobalDraw** If the camera is idle, ML overlay graphics will be disabled to reduce CPU usage. **Turn off GlobalDraw** If the camera is idle, ML overlay graphics will be disabled to reduce CPU usage.
  
-> OBSOLETE? **Battery Level** Battery levels. Wait for 2% discharge before reading. 
  
  
 +==== GPS Power Save (6D) ====
 +
 +Force GPS into powersave mode.
 +
 +//Submenu options://
  
  
 ==== LV Display Presets ==== ==== LV Display Presets ====
  
-This feature lets you use up to 4 display presets for the settings in the Overlay menu.+This feature lets you create 1, 2 or 3 additional ML LiveView screens with individual Overlay presets.
  
 //Submenu options:// //Submenu options://
Line 2132: Line 2460:
 **4** **4**
  
-This menu item sets the maximum number of available DISP presetsTo disable +This menu item sets the number of available ML LiveView screensDefault setting  
-this featureset the number of presets to 1. To change the current +is OFF (1)enabling only a single ML LiveView screen. 
-display preset, press INFO/DISP in LiveView, or [Q] on the GlobalDraw+To change the current preset, press INFO/DISP in LiveView, or [Q] on the GlobalDraw
 entry in the Overlay menu. On the top bar, you will see DISP 0, 1, 2 or entry in the Overlay menu. On the top bar, you will see DISP 0, 1, 2 or
 3. Each of those is a preset for the settings in Overlay menu. So you 3. Each of those is a preset for the settings in Overlay menu. So you
Line 2158: Line 2486:
  
  
-==== Auto BurstPicQuality ==== 
  
-OBSOLETE?+==== Customize Menus ==== 
 +Ready for review 
 +Creating "MyMenu" screen for ML settings.  
 +You can select menu items of your choice. 
  
-When enabled, it will temporarily reduce picture quality in burst mode in +Activate browsing by pressing SET. Bar colour will change from blue to dark orange, same colour as bottom line and tab (screen) name. Browse to the item you want to select for ML's MyMenu screen and press SET once. Green star icon shows selected items. Press SET twice to hide menu items in ML screens (<color #ed1c24>x</color>). Pressing SET a third time will deactivate selection. 
-order to maintain a decent frame rate even when the buffer becomes +After selection completed go back to Prefs screen -> Customize Menus and press SET again to deactivate browsing. Colours will change back to default.
-almost full.+
  
-//Submenu options://+All items marked for MyMenu (green star icon) will be displayed in screen MyMenu and are accessible from here, too.  
 +If you access a screen with hidden items you will see a text "Hidden:..."(in orange color) indicating what items are hidden.
  
-This function will reduce picture quality if the buffer has space for less than 4 pictures: +MyMenu will work together with Config Presets and are configurable individually for each config preset. 
-  * RAW+JPG ? JPG Large Fine ? JPG Medium Fine +MyMenu settings are stored in ML\Settings (and associated config preset subdirectories). File name is MENU.CFG. If you got totally lost you may want to delete MENU.CFG to go back to default menu structure.
-  * RAW ? JPG Large Fine ? JPG Medium Fine +
-  * JPG Large Coarse ? JPG Medium CoarsePossible results (550D, Transcend Class 10, your mileage may vary)+
-  * RAW+JPG, JPG-L, all others JPG-M +
-  * RAW, RAW, all others JPG-M +
- +
- +
- +
- +
-==== Customize Menus ==== +
-> Incomplete +
-You can select menu items of your choice +
-Pressing SET once will copy menu item into a new menu tab "MyMenu" located at the very right. +
-Pressing SET twice will hide a menu item. If you access a screen with hidden items you will see a text "Hidden:..."(in orange color) indicating what items are hidden.+
  
 //Submenu options:// //Submenu options://
Line 2200: Line 2517:
 it: [[http://www.magiclantern.fm/forum/index.php?topic=9517.0|creating your own modules]] or it: [[http://www.magiclantern.fm/forum/index.php?topic=9517.0|creating your own modules]] or
 [[http://www.magiclantern.fm/forum/index.php?topic=11334.0|creating your own modules 2]] [[http://www.magiclantern.fm/forum/index.php?topic=11334.0|creating your own modules 2]]
 +
 +Remark: LUA script language is another approach to lower the bar for creating own enhancements for ML. LUA scripting is considered to be easier to learn and develop (no compiling needed) but is restricted to things implemented in LUA API. Modules don't have this limitation.
  
 The modules listed in this section are included in the nightly builds. For other modules see [[#Modules (other)]] The modules listed in this section are included in the nightly builds. For other modules see [[#Modules (other)]]
Line 2455: Line 2774:
  
 Functions for troubleshooting and development.  Functions for troubleshooting and development. 
-Most likely you will have no reason to access this screen using ML. Exceptions: +Most likely you (presumptively a non-developer) will have no reason to access this screen using ML. Exceptions: 
-  * Benchmarking your flash card+  * Benchmarking your flash card.  
 +          * Recommended to run this at least once for a new card. Helps you to determine card's performance when used in cam and to detect fraudulent cards. 
 +  * Using ML's File Manager  
 +          * Basic file manipulation (copy, move, delete)  
 +          * View files not supported by Canon itself (DNG, raw video formats, text files)
   * Checking shutter count   * Checking shutter count
-  * In case of misbehaving cam, you may be asked to run some diagnostics.+  * Checking cam temperature 
 +  * In case of misbehaving cam, you may be asked to run some diagnostics. Assisted by a developer, of course!
  
  
 ==== Modules debug ==== ==== Modules debug ====
 +
 +
  
 //Submenu options:// //Submenu options://
Line 2468: Line 2794:
  
 **Load modules after crash** **Load modules after crash**
 +
 +By default (OFF) ML modules will not be loaded after a crash or after battery pull during operation. Users and developers may find setting OFF helpful to identify and disable misbehaving modules in the field. 
 +For unattended cameras in remote locations setting "Load modules after crash ON" might be preferable esp. if used together with some kind of watchdog timer or otherwise intermittent power source. Same for situations under stress where having time for troubleshooting is not an option.
  
 **Show console** **Show console**
  
 ==== Benchmarks ==== ==== Benchmarks ====
 +
 +Card interface performance and other (more nerdy) tests. 
 +
 +Only visible after loading Bench.mo in Module screen.
 +
 +Completed benchmark runs will save results as PPM files (Portable Pixmap) to card's root directoy. File naming will be BENCHx.PPM with consecutive numbers whenever a benchmark is taken. You can convert PPM to PNG/JPEG (using your PC )if you want to share results in ML forum (for example).
  
 > INCOMPLETE  > INCOMPLETE 
Line 2479: Line 2814:
 **Card benchmarks** **Card benchmarks**
     * Quick R/W benchmark (1 min)     * Quick R/W benchmark (1 min)
 +      
 +      To determine read and write performance of your card/camera combination. 
 +        * There will be two consecutive R/W runs. It will tell you if/how heating up the card affects card performance.
 +        * Benchmark runs in photo/stills and movie mode may differ quite a bit. In photo mode numbers are higher because benchmark will surpress most of ML code during benchmark run.  Therefore numbers in photo mode are close to limits of card/cam combination without overhead caused by ML. Benchmark runs in movie mode are closer to reality (when recording). Another benchmark will be shown in footer lines of movie tab inside MLV menu. Those numbers are processed by the MLV module itself. Take this calculation with a grain of salt.
 +        * Numbers will be shown in MByte/s. 1 MByte = 1024 kByte =1024*1024 Byte
 +        * Make sure to have sufficient free space for temporary benchmark files (> 1 GB). ML does not check this condition resulting in stunning high (but false) numbers if free space runs out.
 +        
 +      Theoretical interface limits and photo benchmark numbers (R/W) to expect. (MByte/s, without overclocking)
 +        * 100D: 50; xx/xx
 +        * 1100D: xx; xx/xx
 +        * 5D2: 100; xx/xx
 +        * 5D3: 25; xx/xx (SD)
 +        * 5D3: 166; xx/xx (CF)
 +        * 50D: 100; xx/xx
 +        * 500D, 550D, 600D: 25; xx/xx
 +        * 6D: 50; xx/xx
 +        * 60D: 25; xx/xx
 +        * 7D: 133; xx/xx
 +        * 70D: 50; xx/xx
 +        * M, 650D, 700D: 50; xx/xx
 +
 +
     * Buffer R/W benchmark (5 min)     * Buffer R/W benchmark (5 min)
     * Buffer write benchmark (inf)     * Buffer write benchmark (inf)
Line 2506: Line 2863:
 //Submenu options:// //Submenu options://
  
-Allows you to browse your storage medium.+Allows you to browse your storage medium and do basic file manipulations. 
 +Only visible after loading file_man.mo in Modules screen tab. 
 + 
 +  * Show file attributes: Timestamp and file size. 
 +  * View plain text files contents (logs, LUA scripts, Readme, ...) 
 +  * View PPM files (generated by ML's snapshot and benchmark features) (Requires module pic_view.mo to be loaded) 
 +  * View raw video files (Requires module mlv_play to be loaded) 
 +  * Copy all types of files (but not directories). 
 +  * Move all types of files (but not directories). 
 +  * Delete all types of files (but not directories). 
 + 
 +  * Select files in a directory based on file extension. (*.LOG, *.JPG, ...) and copy, move or delete them.
  
 ==== Self tests ==== ==== Self tests ====
 +
 +Only visible (together with "Fault emulation") after loading selftest.mo in Modules tab.
  
 **Stubs API test** **Stubs API test**
Line 2534: Line 2904:
  
 ==== Fault emulation ==== ==== Fault emulation ====
 +
 +Only visible (together with "Self tests") after loading selftest.mo in Modules tab.
  
 **Create a stuck task** **Create a stuck task**
Line 2567: Line 2939:
 //Submenu options:// //Submenu options://
  
-Print screen after 10 seconds. This option saves a BMP file for the overlays +Print screen after 10 seconds. The card LED will blink every second, until the screenshot is taken. 
-and a 422 file (silent picturefor the LiveView image. The BMP does not +This option saves a PPM file (Portable Pixmapto card's root directoy. File naming will be VRAM0.PPM with consecutive numbers whenever a screenshot is taken. The PPM does not contain transparency data. You can convert PPM to PNG/JPEG if you want to illustrate your problem in a forum request
-contain transparency data. You can combine the two files in GIMP or +
-other image editing programsThe card LED will blink every second, +
-until the screenshot is taken.+
  
  
Line 2586: Line 2956:
  
 ==== Don't click me! ==== ==== Don't click me! ====
 +
 +This is a placeholder in one of ML's source files for customized/temporary debugging code. By default it is empty, doing nothing at all. If needed you (or more likely: a developer) can add code inside source which has to be compiled to a customized ML build to be executed by you.
  
 //Submenu options:// //Submenu options://
Line 2650: Line 3022:
 //Submenu options:// //Submenu options://
  
-Displays the number of shutter actuations.+Displays the number of shutter actuations divided to "pics taken" + "Liveview actuations".  
 +A liveview session will increment "Liveview actuations" by 1. Each pic taken in a liveview session will increment "pics taken" *and* "Liveview actuations"
 +Therefore a single still picture taken in Liveview will add 1 to "pics taken and 2 to "Liveview actuations"
 + 
 +Numbers will not get updated until next startup
  
  
Line 2657: Line 3033:
 //Submenu options:// //Submenu options://
  
-Displays the internal CMOS temperature, in raw units+Displays internal temperature, in Celsius, Fahrenheit and some Canon-specific unit called "raw" (not to be confused with image data format)
 +ML reads cam's value for "efic_temp" which can a little bit different from value found in image's exif data.
  
 +Internal Temp will be shown in ML liveview screen, too. Celsius value only!
 ==== Battery level ==== ==== Battery level ====
  
 //Submenu options:// //Submenu options://
  
-60D and 5D Mark II only: displays battery percentage, estimated time remaining and battery discharging rate.+Displays battery percentage, estimated time remaining and battery discharging rate.
 For accurate readings, wait until the percentage indicator decreases by at least 2% since powering on. For accurate readings, wait until the percentage indicator decreases by at least 2% since powering on.
 +
 +Remarks: 
 +There had been several complaints about ML draining batteries. Down to this day all of these claims could either be broken down to user errors (improper card handling, activating ML features affecting powersave mode, ...) or were not reproducable at all. Avoid improper camera shutdown and - most important - never remove card during shutdown or immediately after opening card door.
 +For those who want to play it absolutely safe: Remove battery after shutdown.
 +
 +ML being active does however cost some energy thus reducing battery life a bit.
  
  
Line 2722: Line 3105:
 ===== Modules (other) ===== ===== Modules (other) =====
 Modules by developers/members, not available in the nightly builds Modules by developers/members, not available in the nightly builds
 +
 +> Didn't check it
  
 ==== astro.mo ==== ==== astro.mo ====
Line 2788: Line 3173:
  
 //Submenu options:// //Submenu options://
 +
 +===== Abbrevations =====
 +AGC\\
 +APEX\\
 +BV\\
 +CBR\\
 +D4, D5\\
 +dB\\
 +DNG\\
 +EC\\
 +ETTR\\
 +EV\\
 +EXIF\\
 +fps\\
 +FRSP\\
 +ISO\\
 +Luma\\
 +MLV\\
 +VBR\\
 +XLR\\
 +YUV\\
 +
 +
 +
 +===== Obsolete? =====
 +Parking lot for items lost in transition
 +
 +==== Rack Delay ====
 +> OBSOLETE?
 +
 +Sets the number of seconds before starting a rack focus.
 +
 +//Submenu options://
 +
 +This lets you film the start point first, then initialise the rack focus without touching the camera.
 +
 +==== Focus ... ====
 +Recommended focus step settings:
 +Focus StepSize: 1 or 2
 +Focus StepDelay: small values, without Wait flag.
 +If the motion is not smooth, try larger delays (100ms)
 +
 +Quick rack focus while recording:
 +
 +Press MENU to save current focus point (this means I want to return here);
 +Use follow focus to change focus point (focus somewhere else);
 +Press PLAY to go to saved focus point;
 +Press PLAY again to go back.
 +
 +==== Bulb/Focus Ramping ====
 +
 +> INCOMPLETE
 +> OBSOLETE Whole section is no longer represented in Shoot menu. IMO this should be replaced by a proper description for Advanced Intervalometer.
 +
 +Bulb Ramping allows the capture of a timelapse that gradually changes
 +exposure, compensating for the transition from day to night.
 +
 +//Submenu options://
 +
 +Auto exposure ramping: this option will adjust shutter and ISO automatically, by looking at image brightness of previous shots.
 +
 +Manual exposure ramping: this option will adjust shutter and ISO to follow a
 +fixed exposure ramp (a fixed amount of EV change per shot). Can be used
 +as standalone or combined with auto ramping.
 +
 +Manual focus
 +ramping: this lets you adjust focus gradually while shooting the
 +timelapse. It requires a lens with autofocus and it can only work in
 +LiveView.
 +
 +Settings for auto ramping:
 +
 +Mode: sunset /
 +sunrise / auto. In sunset mode, the exposure will always increase. In
 +sunrise mode, the exposure will always decrease. This idea was suggested
 +by Tom Lowe on RedUser.net forum.
 +
 +Maximum ramping speed: this
 +parameter is used for computing the optimal smoothness factor. A lower
 +value will reduce flicker, but if the value is twice as low as the real
 +rate of brightness change, ML will lose the ability to ramp correctly.
 +For example, if you set a maximum ramping speed of 0.1 EV / shot, and
 +the scene requires a ramping of 0.2 EV / shot, ML will start flickering
 +heavily.
 +
 +Quick start guide for auto ramping:
 +
 +1. Take a picture of your scene. You will use it to say: I want my timelapse to be exposed like this picture.
 +
 +2. Enable Bulb Ramping and Intervalometer.
 +
 +3. Leave the camera still while ML runs a calibration step:
 +
 +Make sure you have a static and well-lit scene (any static scene which does not require long exposure should be fine).
 +
 +After calibration, you should get a nice S-curve on the screen.
 +
 +4. Now you will have to say what tone range to meter for (i.e. highlights, midtones…). Follow the wizard:
 +
 +Use arrow keys to select your reference picture (which you just took).
 +
 +Use the main dial to select the tone range to meter for. You can't
 +perfectly match two images just by varying one parameter (exposure), so
 +you have to choose what's important for you in this picture.
 +
 +For
 +lowest flicker, meter for midtones (choose the 50th percentile, i.e.
 +median, because it's a robust estimation, unlike simple averaging).
 +Leave some headroom for highlights (underexpose a bit).
 +
 +If
 +highlights are important, meter for them (choose 80th percentile for
 +example). You will have to shoot RAW and remove flicker when you develop
 +the RAW files.
 +The algorithm works best when brightness is close to 50% (try not to choose extreme values for it).
 +When you are ready to start, press SET.
 +5. Sit back and relax :)
 +Limits:
 +ISO is chosen between 100 and maximum auto ISO value from Canon menu.
 +Shutter speed is chosen between 1/8000 (lower limit) and the delay between two
 +shots minus two seconds (upper limit). Example: for 10-second intervals,
 +shutter speed will be between 1/8000 and 8 seconds.
 +Aperture is fixed (you can change it manually).
 +Tips:
 +Don't adjust ISO and shutter before the timelapse, they are fully automatic.
 +Use a ND filter to reduce flicker during daylight.
 +Reduce flicker in post. We recommend VirtualDub with MSU Deflicker plugin
 +(free, works with Windows and Wine). See also Timelapse workflow using
 +free software tutorial.
 +Technical notes:
 +
 +Exposure is metered using a condition like this (for example): 70% of pixels should be below 50% brightness.
 +
 +Exposure for every shot is computed from previous shots, using a feedback controller algorithm with a smoothing factor.
 +
 +ISO is chosen using the 180 degree rule, so the resulting shutter speed
 +stays between 90 and 270 degrees (that is, between 1/4 and 3/4 of the
 +delay between two shots).
 +
 +Only full-stop ISOs (100, 200, 400 etc) are used (because you are supposed to shoot RAW).
 +
 +Shutter speed can be adjusted with a resolution of 10ms.
 +Frames with fast shutter speeds (less than 1 second in Rebel cameras, less 0.1
 +seconds in 60D) are taken in Manual mode. You will get flicker.
 +It can go from 1/8000s @ ISO 100 (daylight) to several minutes of exposure time @ ISO 6400 (complete darkness).
 +
 +Exposure algorithm is a feedback controller designed with pole placement - the
 +closed loop response will have two real poles placed at the smoothing
 +factor value. Smoothing factor is computed in such a way that, when
 +scene ramping speed matches the speed selected in menu, ramp is followed
 +at exactly 1 EV behind it. If the lighting changes suddenly a few stops
 +between two shots (for example, you change the ND filters or the
 +aperture), the algorithm should recover completely after 2 or 3 shots. A
 +sudden exposure change is considered when the exposure difference is
 +greater than 2 stops.
 +
 +Logging: When you use bulb ramping, Magic
 +Lantern will save a log file with the exposure parameters, metered
 +values and so on. Please send this file to developers. These log files
 +can be used to see how well the ramping went and to fine-tune the
 +algorithm.
 +
 +** Focus/Focus Stacking **
 +
 +This function can also create scripts named like named FST_1234.SH, which can
 +be used for stacking the images with enfuse. See Exposure bracketing
 +for details on how to use these scripts, and the focus stacking section
 +from Enfuse reference manual. To enable (or disable) the post-processing
 +scripts, go to <del>HDR bracketing</del> Shoot -> Shoot Preferences submenu.
 +
 +
 +You can also combine this function with HDR bracketing and silent pictures.
 +
 +** RAW video (MLV)**
 +
 +> Still there? **Fix black level** Forces the black level to 2048 to combat green shadows.
 +
 +
 +** Silent Pics **
 +Outdated, redo here, then up again
 +> Outdated 
 +When enabled, it saves uncompressed YUV422 frames from the LiveView image
 +buffer when you press the shutter halfway. Make sure you don't have
 +autofocus assigned to half-shutter press (put it on * or turn it off)
 +Images are saved in DCIM/1xxCANON/ after the following rules:
 +
 +
 +>Outdated 
 +If intervalometer is OFF, silent pics are named after last picture/movie
 +taken without this function (e.g. 12340001.422). You are limited to
 +10000 silent pictures for each noisy picture.
 +
 +If intervalometer
 +is ON, silent pics have names like 12345678.422. Tip: use File Numbering
 +? Manual Reset from Canon menu to increase folder number (to sort them
 +easier).
 +
 +To convert a 422 image to JPEG on the PC, use one of the following programs:
 +
 +422-jpg.py (command-line tool, runs on all platforms, you need to install Python, PIL and numpy).
 +
 +422toimage (Windows only, source code available).
 +
 +YUV422 Convertor (Windows only, closed source).
 +
 +> OBSOLETE? Silent Pic Hi-Res:
 +emulates high-resolution by taking a matrix of small silent pics, in
 +zoom x5 mode. You need to have the camera on a tripod and the subject
 +should be static (a picture is taken in a few seconds). Could be useful
 +for focus stacking or for timelapse without increasing shutter count.
 +
 +** Auto BurstPicQuality **
 +
 +> OBSOLETE?
 +
 +When enabled, it will temporarily reduce picture quality in burst mode in
 +order to maintain a decent frame rate even when the buffer becomes
 +almost full.
 +
 +//Submenu options://
 +
 +This function will reduce picture quality if the buffer has space for less than 4 pictures:
 +  * RAW+JPG ? JPG Large Fine ? JPG Medium Fine
 +  * RAW ? JPG Large Fine ? JPG Medium Fine
 +  * JPG Large Coarse ? JPG Medium CoarsePossible results (550D, Transcend Class 10, your mileage may vary):
 +  * RAW+JPG, JPG-L, all others JPG-M
 +  * RAW, RAW, all others JPG-M
 +
 +
  
  
  
camera_help.txt · Last modified: 2023/01/24 05:08 by Walter Schulz