. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Services\ChartService; use Fisharebest\Webtrees\Tree; use Fisharebest\Webtrees\Webtrees; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; /** * Class FanChartModule */ class FanChartModule extends AbstractModule implements ModuleChartInterface { use ModuleChartTrait; // Chart styles private const STYLE_HALF_CIRCLE = 2; private const STYLE_THREE_QUARTER_CIRCLE = 3; private const STYLE_FULL_CIRCLE = 4; // Limits private const MINIMUM_GENERATIONS = 2; private const MAXIMUM_GENERATIONS = 9; private const MINIMUM_WIDTH = 50; private const MAXIMUM_WIDTH = 500; // Defaults private const DEFAULT_STYLE = self::STYLE_THREE_QUARTER_CIRCLE; private const DEFAULT_GENERATIONS = 4; private const DEFAULT_WIDTH = 100; /** * How should this module be identified in the control panel, etc.? * * @return string */ public function title(): string { /* I18N: Name of a module/chart */ return I18N::translate('Fan chart'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Fan Chart” module */ return I18N::translate('A fan chart of an individual’s ancestors.'); } /** * CSS class for the URL. * * @return string */ public function chartMenuClass(): string { return 'menu-chart-fanchart'; } /** * Return a menu item for this chart - for use in individual boxes. * * @param Individual $individual * * @return Menu|null */ public function chartBoxMenu(Individual $individual): ?Menu { return $this->chartMenu($individual); } /** * The title for a specific instance of this chart. * * @param Individual $individual * * @return string */ public function chartTitle(Individual $individual): string { /* I18N: http://en.wikipedia.org/wiki/Family_tree#Fan_chart - %s is an individual’s name */ return I18N::translate('Fan chart of %s', $individual->fullName()); } /** * A form to request the chart parameters. * * @param ServerRequestInterface $request * @param Tree $tree * @param UserInterface $user * @param ChartService $chart_service * * @return ResponseInterface */ public function getChartAction(ServerRequestInterface $request, Tree $tree, UserInterface $user, ChartService $chart_service): ResponseInterface { $ajax = $request->getQueryParams()['ajax'] ?? ''; $xref = $request->getQueryParams()['xref'] ?? ''; $individual = Individual::getInstance($xref, $tree); Auth::checkIndividualAccess($individual); Auth::checkComponentAccess($this, 'chart', $tree, $user); $chart_style = (int) ($request->getQueryParams()['chart_style'] ?? self::DEFAULT_STYLE); $fan_width = (int) ($request->getQueryParams()['fan_width'] ?? self::DEFAULT_WIDTH); $generations = (int) ($request->getQueryParams()['generations'] ?? self::DEFAULT_GENERATIONS); $fan_width = min($fan_width, self::MAXIMUM_WIDTH); $fan_width = max($fan_width, self::MINIMUM_WIDTH); $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); if ($ajax === '1') { return $this->chart($individual, $chart_style, $fan_width, $generations, $chart_service); } $ajax_url = $this->chartUrl($individual, [ 'ajax' => true, 'chart_style' => $chart_style, 'fan_width' => $fan_width, 'generations' => $generations, ]); return $this->viewResponse('modules/fanchart/page', [ 'ajax_url' => $ajax_url, 'chart_style' => $chart_style, 'chart_styles' => $this->chartStyles(), 'fan_width' => $fan_width, 'generations' => $generations, 'individual' => $individual, 'maximum_generations' => self::MAXIMUM_GENERATIONS, 'minimum_generations' => self::MINIMUM_GENERATIONS, 'maximum_width' => self::MAXIMUM_WIDTH, 'minimum_width' => self::MINIMUM_WIDTH, 'module_name' => $this->name(), 'title' => $this->chartTitle($individual), ]); } /** * Generate both the HTML and PNG components of the fan chart * * @param Individual $individual * @param int $chart_style * @param int $fan_width * @param int $generations * @param ChartService $chart_service * * @return ResponseInterface */ protected function chart(Individual $individual, int $chart_style, int $fan_width, int $generations, ChartService $chart_service): ResponseInterface { $ancestors = $chart_service->sosaStradonitzAncestors($individual, $generations); $gen = $generations - 1; $sosa = 2 ** $generations - 1; // fan size $fanw = 640 * $fan_width / 100; $cx = $fanw / 2 - 1; // center x $cy = $cx; // center y $rx = $fanw - 1; $rw = $fanw / ($gen + 1); $fanh = $fanw; // fan height if ($chart_style === self::STYLE_HALF_CIRCLE) { $fanh = $fanh * ($gen + 1) / ($gen * 2); } if ($chart_style === self::STYLE_THREE_QUARTER_CIRCLE) { $fanh *= 0.86; } $scale = $fanw / 640; // Create the image $image = imagecreate((int) $fanw, (int) $fanh); // Create colors $transparent = imagecolorallocate($image, 0, 0, 0); imagecolortransparent($image, $transparent); $theme = app(ModuleThemeInterface::class); $foreground = $this->imageColor($image, $theme->parameter('chart-font-color')); $backgrounds = [ 'M' => $this->imageColor($image, $theme->parameter('chart-background-m')), 'F' => $this->imageColor($image, $theme->parameter('chart-background-f')), 'U' => $this->imageColor($image, $theme->parameter('chart-background-u')), ]; imagefilledrectangle($image, 0, 0, (int) $fanw, (int) $fanh, $transparent); $fandeg = 90 * $chart_style; // Popup menus for each ancestor $html = ''; // Areas for the imagemap $areas = ''; // loop to create fan cells while ($gen >= 0) { // clean current generation area $deg2 = 360 + ($fandeg - 180) / 2; $deg1 = $deg2 - $fandeg; imagefilledarc($image, (int) $cx, (int) $cy, (int) $rx, (int) $rx, (int) $deg1, (int) $deg2, $backgrounds['U'], IMG_ARC_PIE); $rx -= 3; // calculate new angle $p2 = 2 ** $gen; $angle = $fandeg / $p2; $deg2 = 360 + ($fandeg - 180) / 2; $deg1 = $deg2 - $angle; // special case for rootid cell if ($gen == 0) { $deg1 = 90; $deg2 = 360 + $deg1; } // draw each cell while ($sosa >= $p2) { if ($ancestors->has($sosa)) { $person = $ancestors->get($sosa); $name = $person->fullName(); $addname = $person->alternateName(); $text = I18N::reverseText($name); if ($addname) { $text .= "\n" . I18N::reverseText($addname); } $text .= "\n" . I18N::reverseText($person->getLifeSpan()); $background = $backgrounds[$person->sex()]; imagefilledarc($image, (int) $cx, (int) $cy, (int) $rx, (int) $rx, (int) $deg1, (int) $deg2, $background, IMG_ARC_PIE); // split and center text by lines $wmax = (int) ($angle * 7 / 7 * $scale); $wmax = min($wmax, 35 * $scale); if ($gen == 0) { $wmax = min($wmax, 17 * $scale); } $text = $this->splitAlignText($text, (int) $wmax); // text angle $tangle = 270 - ($deg1 + $angle / 2); if ($gen == 0) { $tangle = 0; } // calculate text position $deg = $deg1 + 0.44; if ($deg2 - $deg1 > 40) { $deg = $deg1 + ($deg2 - $deg1) / 11; } if ($deg2 - $deg1 > 80) { $deg = $deg1 + ($deg2 - $deg1) / 7; } if ($deg2 - $deg1 > 140) { $deg = $deg1 + ($deg2 - $deg1) / 4; } if ($gen == 0) { $deg = 180; } $rad = deg2rad($deg); $mr = ($rx - $rw / 4) / 2; if ($gen > 0 && $deg2 - $deg1 > 80) { $mr = $rx / 2; } $tx = $cx + $mr * cos($rad); $ty = $cy + $mr * sin($rad); if ($sosa == 1) { $ty -= $mr / 2; } // print text imagettftext( $image, 7, $tangle, (int) $tx, (int) $ty, $foreground, Webtrees::ROOT_DIR . 'resources/fonts/DejaVuSans.ttf', $text ); $areas .= '= $deg1) { $rad = deg2rad($deg); $tx = round($cx + $mr * cos($rad)); $ty = round($cy + $mr * sin($rad)); $areas .= "$tx,$ty,"; $deg -= ($deg2 - $deg1) / 6; } // join first point $mr = $rx / 2; $deg = $deg1; $rad = deg2rad($deg); $tx = round($cx + $mr * cos($rad)); $ty = round($cy + $mr * sin($rad)); $areas .= "$tx,$ty"; // add action url $areas .= '" href="#' . $person->xref() . '"'; $html .= '
'; $html .= '
'; $html .= '
'; $html .= '' . $name . ''; foreach ($theme->individualBoxMenu($person) as $menu) { $html .= '' . $menu->getLabel() . ''; } $html .= '
'; $html .= '
'; $html .= '
'; $areas .= ' alt="' . strip_tags($person->fullName()) . '" title="' . strip_tags($person->fullName()) . '">'; } $deg1 -= $angle; $deg2 -= $angle; $sosa--; } $rx -= $rw; $gen--; } ob_start(); imagepng($image); imagedestroy($image); $png = ob_get_clean(); return response(view('modules/fanchart/chart', [ 'fanh' => $fanh, 'fanw' => $fanw, 'html' => $html, 'areas' => $areas, 'png' => $png, 'title' => $this->chartTitle($individual), ])); } /** * split and center text by lines * * @param string $data input string * @param int $maxlen max length of each line * * @return string $text output string */ protected function splitAlignText(string $data, int $maxlen): string { $RTLOrd = [ 215, 216, 217, 218, 219, ]; $lines = explode("\n", $data); // more than 1 line : recursive calls if (count($lines) > 1) { $text = ''; foreach ($lines as $line) { $text .= $this->splitAlignText($line, $maxlen) . "\n"; } return $text; } // process current line word by word $split = explode(' ', $data); $text = ''; $line = ''; // do not split hebrew line $found = false; foreach ($RTLOrd as $ord) { if (strpos($data, chr($ord)) !== false) { $found = true; } } if ($found) { $line = $data; } else { foreach ($split as $word) { $len = strlen($line); $wlen = strlen($word); if (($len + $wlen) < $maxlen) { if (!empty($line)) { $line .= ' '; } $line .= $word; } else { $p = max(0, (int) (($maxlen - $len) / 2)); if (!empty($line)) { $line = str_repeat(' ', $p) . $line; // center alignment using spaces $text .= $line . "\n"; } $line = $word; } } } // last line if (!empty($line)) { $len = strlen($line); if (in_array(ord($line[0]), $RTLOrd, true)) { $len /= 2; } $p = max(0, (int) (($maxlen - $len) / 2)); $line = str_repeat(' ', $p) . $line; // center alignment using spaces $text .= $line; } return $text; } /** * Convert a CSS color into a GD color. * * @param resource $image * @param string $css_color * * @return int */ protected function imageColor($image, string $css_color): int { return imagecolorallocate( $image, (int) hexdec(substr($css_color, 0, 2)), (int) hexdec(substr($css_color, 2, 2)), (int) hexdec(substr($css_color, 4, 2)) ); } /** * This chart can display its output in a number of styles * * @return array */ protected function chartStyles(): array { return [ /* I18N: layout option for the fan chart */ self::STYLE_HALF_CIRCLE => I18N::translate('half circle'), /* I18N: layout option for the fan chart */ self::STYLE_THREE_QUARTER_CIRCLE => I18N::translate('three-quarter circle'), /* I18N: layout option for the fan chart */ self::STYLE_FULL_CIRCLE => I18N::translate('full circle'), ]; } }