Changes

Jump to: navigation, search

Addon:Life Line Chart View

2,310 bytes added, 06:44, 11 June 2022
m
LifeLineChartView-addon-Configure-dialogs-51.png
{{languages|Addon:Life Line Chart View}}
{{Third-party plugin}}
{{man warn|To enable SVG file export use the minimum requirement of Python 3.6 for svgwrite [[#Prerequisites|prerequisite]]}}
[[File:LifeLineChartViewScreenshot1-51.png|450px|thumb|right|Life Line Chart View - addon - Visualizing an ancestors tree (Gramps 5.1.x version)]]
[[File:LifeLineChartViewScreenshot2-51.png|450px|thumb|right|Life Line Chart View - addon - Visualizing a descendant tree with photos (Gramps 5.1.x version)]]
[[File:LifeLineChartViewScreenshot3-51.png|450px|thumb|right|Life Line Chart View - addon - Visualizing a larger ancestor tree (Gramps 5.1.x version)]]
[[File:LifeLineChartViewScreenshot4-51.png|450px|thumb|right|Life Line Chart View - addon - Visualizing a ancestor tree with photos (Gramps 5.1.x version)]]
[[File:LifeLineChartViewScreenshot6-51.png|450px|thumb|right|Life Line Chart View - addon - Visualizing a descendant tree in cactus shape (Gramps 5.1.x version)]]
'''Life Line Chart View''' is an interactive {{icon|ance}} [[Gramps Glossary#charts view|{{man label|Charts}} ]] category view addon which shows individuals as lines in an ancestor or descendant chart. The length and position of the line depends on the actual life span and the marriages. The pedigree/ancestor collapse is addressedhandled. Labels for birth / names, death, and marriages can be added.
The active person on the person tab is starting point in both charts. Birth/christening/baptism, death/burial, and marriage dates need to be available to properly draw this chart. If they are incomplete reasonable guess values are chosen if possible. If not, then these individuals are not shown
= Usage =
If the addon was loaded successfully, then the Two new chart icons will appear in the {{icon|ance}} {{man label|Charts}} category view tool barif the addon was loaded successfully and the [[Addon:Life_Line_Chart_View#Prerequisites|prerequisites]] have been installed:[[File:ButtonsLifeLineChartView default Toolbar-Icons-51.png]]* Life Line Ancestor Chart View (left icon)* Life Line Descendant Chart View (right icon)
* The charts can be configured in a using the [[Addon:Life_Line_Chart_View#Configure_Options|Configure the active view]] dialog.
* You may zoom (if the chart is focused) with
** the GUI control buttons (+, -, fit to view, reset to 1)
* Scrolling is possible (if the chart is focussedfocused) with
** {{man key press|mouse wheel}}, {{man key press|shift|mouse wheel}}
** {{man key press|Ctrl|left mouse button}} (grabbing)
** Opening the edit dialog
** Change active person
** Show / hide persons and ther their ancestors / descendants
** Showing siblings in the ancestor chart
== Configure Options ==
[[File:ConfigureScreenshotLifeLineChartView-addon-Configure-dialogs-51.png|450px|thumb|right|Life Line Chart View - addon - Configure dialog (Gramps 5.1.x version)]] The Configure the active view dialog shows two tabs of option that you can configure independently for the charts. === General Layout === 
* number of generations.
* shape relative line width.* vertical and warp variantshorizontal chart size.* label layoutwarping of the whole chart (normal grid, sine, triangle).* show or hide pedigree collapse.* unique line color or coloringbased on surname.* line fading represents the uncertainty of dates or the age.* sizingshow or hide lables for birth, death, marriages.* line weighting in (only descendant diagram).* general chart layout "parents enclose children" or "cactus" (only descendant diagram).* optimizations (only ancestor diagram):** flip family to reduce the cross chart connection lengths.** horizontal chart compression.* softness of the family shape.* vertical flipping of the whole chart.* show photos of the person on the line.* size of the photos. === Label Configuration ===* birth and death label.** position.** rotation.** alignment.** word wrapping.** font name and size.* marriage label font size and name.
== Features ==
* Photos of the persons can be displayed along the line. Their position is either based on the date that is set in the media object, or displayed in the order of appearance in the dbfamily tree.[[File:LifeLineChartViewScreenshot4-51* Overview map on the bottom left.png|450px|thumb|right* The diagram can be exported as an SVG file using the {{man button|Save the Life Line Chart View - addon - Visualizing a ancestor tree with photos }} button (Gramps not available using Python 3.5).1.x version)]]
* Layout optimization algorithms.
* Overview map on the bottom left.
* The diagram can be exported as SVG.
* Dark theme.
* Handling of [https://en.wikipedia.org/wiki/Pedigree_collapse pedigree collapse].
= Prerequisites =
'''If the requirements for this addon have not already been installed you will be prompted to downloaded download them semi-automaticallyby selecting the {{man button|Download module}} button for each.''' The addon is based on the Python module [https://pypi.org/project/life-line-chart life_line_chart], this Python module is required. [[File:LifeLineChartView-life line chart.png]]
The addon is based on To enable SVG file export, the python module ([https://pypi.org/project/life-line-chart life_line_chartsvgwrite svgwrite]. This python module and the dependent modules (svgwrite) are is required(which has a minimum requirement of Python 3. If these modules are not available, then downloaded to the plugins folder and used from there6).
[[File:LifeLineChartView-svgwrite.png]]
 
= Issues =
* "smooth scrolling" is supported since GTK 3.24 ([https://docs.gtk.org/gtk3/class.EventControllerScroll.html GTK documentation]), the Windows AIO currently uses an older version.
* Touch screens are not properly supported on Windows. This is an unresolved GTK issue ([https://gitlab.gnome.org/GNOME/gtk/-/issues/3162#note_911387 GTK issue])
== Issues ==
For current issues see the related tag [https://gramps-project.org/bugs/tag_view_page.php?tag_id=372 LifeLineChartView] on the bugtracker.
 
<!--default categories-->
[[Category:Views]]
[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Navigation menu