JES Deinterlacer Preferences

General Preferences
Anamorphic Preferences
Color Preferences
File Preferences
iPod Preferences
Preferred compressor for standards conversion
Deinterlaced playback preferences
Debug messages preferences

General Preferences

Sound preferences

To have the sound of the input movie copied to the output file check "Copy sound"
To save some disk space you can check "Copy by reference" at the risk of losing the sound if you delete the original.
If you do QTMovie export and uncheck "Sound" in the export dialog the sound is simply copied instead if the preference to copy sound has been set.

Force QuickTime Import

Forcing QT import sometimes solves problems with iMovie projects and other movies which are simple in the sense that they have only one video track which is not temporally compressed, yet are complex because of many edits, transitions etc. They may not open or processing may hang at some point.

Use FCP TimeScales

Some of the timescales FCP prefers to work with are different from the QuickTime defaults. If you are going to use the result movie in an FCP project you may want to check this box.

Play Progress Sound

If you check this box the sound is played 2 seconds at a time during processing.

Maximum Number of Projects

The maximum projects carried out simultaneously can be set to at most 8, but you may want to set it to a lower value.
Projects that cannot be carried out immediately end up in the waiting list shown in the waiting queue window.

nice number

The "nice" number determines the Unix priority of the application.
If JES Deinterlacer hogs the processor, set it to a higher value. Default = 1 which is a little nicer than most applications and should be OK in most cases.
If you change the nice number from the command line this is not reflected in the preferences!
The nice number cannot be decremented while the application is running. To lower it, set the value and restart the application.

Anamorphic Preferences

Anamorphic preferences control the handling of cropping and aspect ratio.
Checking "Use input aspect ratio" and "Use input clip" is equivalent to using the input movie as it looks in QT Player by default (in "clean" presentation mode).
See also "Target rectangle" in output tab

Use input aspect ratio

Use information in the input movie to determine the pixel aspect ratio. If no info is found the pixels are assumed to be square.
If this box is not checked pixels are assumed to be square.

Set output aspect ratio

If you check "Set output aspect ratio" the input aspect ratio is copied to the output movie.
This is only possible if the output is a QT movie.
If you export using a compressor with "native dimensions" or a special output size (like "HD 1440x1080 16:9"") then the only way to preserve aspect ratio is to check the corresponding box in the export dialog.

Use input clip

If you check "Use input clip" the cropping in the source movie determines the default in trim value. You can trim off less or more.

Set output clip

If you use "Set output clip" then any edge is clipped (all parts that would otherwise get the border color or were part of the input movie's edge). This is only possible if the output is a QT movie.
If you export using a compressor with "native dimensions" or a special output size (like "HD 1440x1080 16:9") the output clip (before export) is ignored. Depending on export aspect ratio settings and the various dimensions involved more may be cropped, or less.
In case of letterboxing by the exporter the "Paint over in edge" settings determines if the input edge is visible or painted over.

Paint edge color over in edge

If you want to keep the edge pixels of the input movie in the output movie, leave this box unchecked. The edges often contain clean pixels!
If they are really dirty you may want to have them painted over in the output frame buffer.

Height 1080 MPEG2 is anamorphic

If you check this box height 1080 MPEG2 is treated as 1440x1080, else as 1920x1080.
The wrong choice causes scaling artifacts.

Image percentage to stretch

If you do "stretch sides" this determines how the image is stretched.
For example, consider stretching 480x720 to 16:9 = 480x854 with the default value 0.25. In this case 0.25*480 = 120 pixels are used and stretched to 120+(854-720) = 254 pixels. IOW on both left and right sides 60 pixels are stretched to 127 pixels.

Fixing image description extensions

You can edit some image description extensions with my utility JES Extensifier.
This applies to pixel aspect ratio, clip, gamma, nclc and fiel (interlace).

Color Preferences

A set of rarely needed, esoteric color transforms.

NTSC Safe Colors

If the output needs to be shown on TV through analog broadcasting you may need to limit the sum of Y and C amplitudes.

Preserve Super White and Super Black

You may want to keep values outside the standard video range (16-235) because they are somehow meaningful. We try to preserve these values during a (gamma-like) brightness transform.
Only relevant if in and out video use video range coding (as is usual).

Don't Scale Chroma

Video digitizers often allow separate control of luma and chroma. Luma is controlled with Brightness and Contrast settings, Saturation is a separate setting. If you check this box you can correct luma digitizing settings.
Sometimes brightened up video looks too saturated without this setting. Also contrast reduction (black level < 0) may lead to funky colors in dark areas without this setting.

Yuv Sanity Check

The YUV sanity check turns oversaturated YUV into valid RGB by means of desaturation. This may be necessary if the original analog video contains video artistry.

File Preferences

Keep Source File

Don't remove the source file after processing is finished. Convenient when you are testing with various settings, or if the source file is renewed or edited on a regular basis.

Act As Droplet

Files that are dropped on the application icon are processed with the current settings immediately. If you open the application through a movie file drop the application autoquits after the job is done.

Default Target Folder

The default target folder can be set either to the folder that contains the input movie or to a fixed location.

Keep input name

Copy the source file name (not adding " proj").
The file name extension may change of course.

Keep creation date

Copy the input file's creation date.
The start time of the project is set as the modification date.

iPod Preferences

Small iPod

If checked, Standards conversion scales the movie to fit in 320x240 frame dimensions.
Else the movie is scaled to fit in 640x480.

Preferred compressor

Preferred compressor for standards conversion

Lets you choose a default compressor for SD (PAL/NTSC) presets and HD (720p,1080i) presets.
This compressor is also used as default in other cases whenever appropriate.

Deinterlaced playback preferences

Screen ID

Select the screen to be used for full screen playback

Speed

Select default playback speed

Full Screen

Open and play movies in full screen mode, autoclose.
Any manipulation (like stop) cancels autoclose.

Debug messages preferences

General

Debug messages are off by default. They are mainly for my own use, but if you are so inclined you can try to chase a bug down a little before reporting it.
"Threads" are units of application code that can be run simultaneously on multiple processors.
"Components" are just sets of source files or even sets of subroutines that constitute some functionality.
This message system replaces the old downloadable debug variant of the application. It is new and still incomplete and in need of some polishing.

Write to file

If you check "Write to file" messages are written to a file in home/library/logs/JES debug logs.
Each thread uses its own file. In order to view, double click on it or (better) open from TextEdit using UTF8 format. Use a "Fixed Width" font like Monaco 10.
You can always trash the logs folder, even if a project is running.
Direct display in a TextEdit window is nice but often too slow. If the Activity Monitor shows TextEdit at 100% CPU all the time JES D will get bogged down.
If you check neither "Write to file" nor "Use TextEdit" the messages are sent to the system Console (search for "Deinterlacer"). This mixes all threads and display can be delayed by several minutes (closing the application may speed things up, as may switching to "All messages").

Print name

Only one of thread name, component name or subcomponent name is printed. If you check both "Print thread name" and "Print component name" the component name is printed.

Line number

"Line number" and "File name" refer to the source code file. "Label" is the position where the code jumps to in case of error (usually the end of the current subroutine).
File names may be abbreviated. The ellipsis character (three dots) is encoded in UTF8!

Error name

Error name and comment are the standard name and comment used by the Mac OS.

Verbosity

Higher verbosity = more messages.
Level 0 suppresses per frame messages.
Set to 1 to get messages for each frame that is processed.
Set to 2 for per line messages (remove jags only currently, not recommended for anything but very short movies).

Call chain length

Subroutines call subroutines which in turn ... This setting limits output to a certain depth.

Threads, components

Standard threads are read, write, color correction etc.
Project threads are deinterlace, reinterlace, etc.
Some of the components are Proj = Project, StdC = Standards conversion, Pref = Preferences, ProD = project dialog, etc.