Scratchpad:Implementation of Parts and Translations
From OpenLP
This is a suggestion, how to implement support for parts, translations and -literations. Currently this are my (M²j) own ideas. There is not jet any feedback from a core developer. Feel invited to make your suggestions.
I'm looking forward to hear your suggestions and ideas.
Contents |
Songs plugin
The two basic options to define languages in floationg text are per line definition and block definition. I think blockwise definition is more smooth to read. But I didn't find any nice method to define grouping in blockwise definition. So here is a suggestion for linewise definition:
This are the rules:
- Page breaks are permitted, when a line starts with a plus (+).
- Special line attributes are introduces with special characters and terminated with a colon (:).
- Parts are introduced by a at sign (@)
- Translations are introduced by a sharp (#)
- Transliterations are introduced by a dollar sign ($)
Some simple example:
- ---[verse:1]---
- Nearerm my God, to Thee, nearer to Thee!
- +#de: Näher, mein Gott, zu dir, näher zu dir.
- E'en though it be a cross that raiseth me.
- +#de: Drückt mich auch Kummer hier, drohet man mir,
- still al my song shall be, nearermy God to Thee,
- +#de: soll doch trotz Kreutz und Pein dies meine Losung sein:
- nearer my God to Thee, nerer to Thee.
- +#de: Näher, mein Gott, zu dir, näher zu dir!
- ---[verse:2]---
- Though like the wanderer, The sun gone down,
- +#de: Bricht mir, wie Jakob, dort Nacht auch herein,
Also one more complicated:
- @men: And I will love and adore Him,
- +@men#de: Und ich will ihm lieben und anbeten,
- +@women: You are Alpha, Omega,
- +@women#de: Du bist der Erste und Letzte,
- +@women: Beginning and End,
- +@women#de: Anfang und Ende,
- @men: an I will bow down before Him.
- +@men#de: und ich will mich vor ihm verbeugen.
- +@women: You’re my Saviour, Messiah,
- +@women#de: Du bist mein Retter, Messias,
- +@women: Redeemer and Friend.
- +@women#de: Erlöser und Freund.
- You’re my Prince of Peace,
- +#de: Du bist mein Friedensprinz
- and I will live my life for You.
- +#de: und ich will für dich leben.
I think the syntax @men: is quite intuitive and still offers much flexibility. As we just check the character in the first column all texts (or HTML tags) are possible if you put a space in the first column.
Still there is the question, if the part tags are equal to displayed part labels. If not: How can we define them in the GUI. Part labels would be nice to display them just once each slide instead of every line.
The Songs plugin has to assign parts, translations and -literations to textClasses. If they aren't assigned, they are not displayed.
Themes
A theme should consist out of a set of areas, textClasses and general properties.
General properties are covering background and slide transition properties.
A area defines:
- identifier (area's name)
- location on the screen (X, Y, width, height) [absolute (px)|relative (%)]
- layer, a index to define the stack order.
- text_alignment (horizontal, vertical)
- wrap_indentation
A textClass defines:
- identifier (textClass's name) \\ I assume, that here any name is allowed. It has to be checked, if a additional international name is necessary
- font with the properties: name, proportion, weight, italics and color
- outline with the properties: width and color
- shadow with the properties: x-offset, y-offset and color
- line_adjustment
- area, the area in which the text is displayed
The required textClasses are main and footer. Other classes can be added on a dynamic base. Undefined parameters will be derived from main.
The song plugin defines a textClass for each string. According to the area of this textClass it is layouted on the screen.
If more than one textClass is assigned to a area, the text gets stacked in the order the lines are received from the songs plugin. Later this might get enhanced by enabling translations in blocks on a area level for example.
If the song plugin links to a invalid textClass, the text is displayed by the main class.
This changes the theme XML format. My first draft would just enhance it, but I think as long we are alpha software, this is the better way.
Other ideas
- A textClass may have the attribute persistent. This defines, that the label is repeated on each slide. This way we can allow for example to display a song title or a sermon subject on each slide. This would also allow to decide whether to show the copyright informations just on the first slide or permanent (I don’t know, how the policies of CCLI are, but AFAIK VG Musikedition permits this).
- A media object may define a image, video, solid color or gradient, which may be assigned to a area. So you can display a church logo, etc. without integrating it in the background image. This way you can also threat the background (maybe with the obligatory area screen).
- A media object should have the property fitting. This property can be none to show the item native resolution, stretch to stretch the item to the area size, proportional to scale proportional on the area or crop to stretch it proportional and crop away borders that it's filling the area.
Display
I have a small sample implementation of the rendering in Qt/C++ using QPainter (Screenshot). It has to be discussed, if it should be implemented in QtWebKit.
