Files
rawTherapee/rtdata/languages
Lawrence f9a8875bb5 Add more perspective correction adjusters
Add camera lens/sensor shift support with horizontal/vertical shift
adjusters.

Add shifting and rotation of corrected image. This allows
post-correction adjustments to be made more easily given the fixed image
canvas size.

Add scaling of final result. This also helps reduce frustrations with
the fixed image canvas size.

Replace field of view with focal length and crop factor. Use of focal
length and crop factor is more common than diagonal angular field of
view. The new adjusters should be more intuitive for most photographers.
The implementation of perspective correction uses a focal length
relative to the image dimensions. The existing code calculates that
focal length with trigonometry. The new code does it by multiplying
by a ratio.

Replace vertical bias with horizontal and vertical perspective
distortion recovery. Vertical bias is not intuitive as it causes
vertical lines to converge off-center if horizontal correction is
applied. The new adjusters perform perspective distortion on the
projection of the corrected image, allowing vertical/horizontal lines to
converge towards the center lines of the image.

Refactor perspective transformation math to use dynamically computed
homogeneous coordinate matrices instead of pre-calculated formulas. This
should add some overhead, but results in more maintainable code and
possible improved performance due to the reduced number of arithmetic
and assignments needed for each pixel.

Integrate new adjusters in the GUI. This includes fine granularity for
batch processing add/set modes and history.
2019-12-27 16:40:41 -08:00
..
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-09-10 12:34:57 +02:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:24:15 +01:00
2019-12-02 11:25:57 +01:00
2019-12-02 11:24:15 +01:00

This is the directory where all translations should go.

Translations are loaded for a given term at three levels:

  1) default
  2) <Language>
  3) <Language> <Locale/Variant>

Developers who are adding a new feature should add new strings *only* to 
default.  This file should be comprised of basic English text.  It will be used 
in the event that there are no more specific languages specified.  Once you 
have modified default, you should run ./tools/generateTranslationDiffs (Bash 
script) which will re-generate the localizations with commented out additions 
which you have just added.

Translators should in general implement the <Language> file.  This is the 
generic translation for a given language; for instance, 'French', 'German', 
'Norsk', etc.  If a string exists in this file (and the user has specified this 
language), then RawTherapee will override the value in default with the value 
in <Language>.  Please note that the filename for this file must not contain 
any spaces.

In some situations, translations may differ based on region, locale, etc.  A 
good example of this is the difference in spelling between 'color' (American 
English) and 'colour' (British English). In this case, the vast majority of 
strings are identical between English and English (UK); however, to keep the 
proper spelling in Britain, we have a locale file called 'English (UK)' which
contains the differences between the two.  RawTherapee uses locale files when:
  a) The user has selected a language which has a space in the file name
  b) There is another file which is identical to the locale file up until the 
     space (i.e., 'English' to the locale file 'English (UK)').

If a locale file is used, it is applied in the same manner as <Language> is to 
default.  The locale will override any keys present from the ones in the 
language file (and in turn, the default).

After the generateTranslationDiffs has been run, all untranslated terms for 
a given language/locale will exist at the end of the file, prefixed by a ! 
comment marker.  Translators should go through this section of the file and 
translate all terms which they can. After you have translated a line, just 
remove the ! comment marker.  Comments may be included using the #xx comment 
marker, where xx is a numeric prefix used to make sure automated sorting keeps 
comments in the right order, e.g.:
  #00 Comment line 1...
  #01 Line 2...
  #02 3, etc.

To create a file with only Latin characters from a non-Latin one, you can use 
sed with the "y" command. For example, to create a latin-only "Polish (Latin 
Characters)" file from the non-latin "Polish" one:
  sed 'y/ĄĆĘŁŃÓŚŹŻąćęłńóśźż/ACELNOSZZacelnoszz/' < Polish > "Polish (Latin Characters)"

You can use this Wikipedia "Character sets" category page to help you find all 
the characters in the language file you want to convert into Latin-only:
  http://en.wikipedia.org/wiki/Category:Character_sets

To convert all line terminators in all language files to CRLF (dos/mac/unix)
you can use vim:
  a) cd rtdata/languages
     vim
  b) In vim, type:
     :set ffs=dos
     :args *
     :argdo w
  c) vim will process all language files. Once done, you can close it:
     :q