. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Aura\Router\RouterContainer; use Fig\Http\Message\RequestMethodInterface; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Registry; 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; use Psr\Http\Server\RequestHandlerInterface; use function app; use function array_keys; use function assert; use function implode; use function intdiv; use function is_string; use function max; use function min; use function redirect; use function route; use function str_contains; /** * Class FanChartModule */ class FanChartModule extends AbstractModule implements ModuleChartInterface, RequestHandlerInterface { use ModuleChartTrait; protected const ROUTE_URL = '/tree/{tree}/fan-chart-{style}-{generations}-{width}/{xref}'; // Chart styles private const STYLE_HALF_CIRCLE = '2'; private const STYLE_THREE_QUARTER_CIRCLE = '3'; private const STYLE_FULL_CIRCLE = '4'; // Defaults private const DEFAULT_STYLE = self::STYLE_THREE_QUARTER_CIRCLE; private const DEFAULT_GENERATIONS = 4; private const DEFAULT_WIDTH = 100; protected const DEFAULT_PARAMETERS = [ 'style' => self::DEFAULT_STYLE, 'generations' => self::DEFAULT_GENERATIONS, 'width' => self::DEFAULT_WIDTH, ]; // Limits private const MINIMUM_GENERATIONS = 2; private const MAXIMUM_GENERATIONS = 9; private const MINIMUM_WIDTH = 50; private const MAXIMUM_WIDTH = 500; /** @var ChartService */ private $chart_service; /** * FanChartModule constructor. * * @param ChartService $chart_service */ public function __construct(ChartService $chart_service) { $this->chart_service = $chart_service; } /** * Initialization. * * @return void */ public function boot(): void { $router_container = app(RouterContainer::class); assert($router_container instanceof RouterContainer); $router_container->getMap() ->get(static::class, static::ROUTE_URL, $this) ->allows(RequestMethodInterface::METHOD_POST) ->tokens([ 'generations' => '\d+', 'style' => implode('|', array_keys($this->styles())), 'width' => '\d+', ]); } /** * 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 Individual $individual * @param mixed[] $parameters * * @return string */ public function chartUrl(Individual $individual, array $parameters = []): string { return route(static::class, [ 'xref' => $individual->xref(), 'tree' => $individual->tree()->name(), ] + $parameters + self::DEFAULT_PARAMETERS); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function handle(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $user = $request->getAttribute('user'); $xref = $request->getAttribute('xref'); assert(is_string($xref)); $individual = Registry::individualFactory()->make($xref, $tree); $individual = Auth::checkIndividualAccess($individual, false, true); $style = $request->getAttribute('style'); $generations = (int) $request->getAttribute('generations'); $width = (int) $request->getAttribute('width'); $ajax = $request->getQueryParams()['ajax'] ?? ''; // Convert POST requests into GET requests for pretty URLs. if ($request->getMethod() === RequestMethodInterface::METHOD_POST) { $params = (array) $request->getParsedBody(); return redirect(route(static::class, [ 'tree' => $tree->name(), 'xref' => $params['xref'], 'style' => $params['style'], 'generations' => $params['generations'], 'width' => $params['width'], ])); } Auth::checkComponentAccess($this, ModuleChartInterface::class, $tree, $user); $width = min($width, self::MAXIMUM_WIDTH); $width = max($width, self::MINIMUM_WIDTH); $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); if ($ajax === '1') { return $this->chart($individual, $style, $width, $generations); } $ajax_url = $this->chartUrl($individual, [ 'ajax' => true, 'generations' => $generations, 'style' => $style, 'width' => $width, ]); return $this->viewResponse('modules/fanchart/page', [ 'ajax_url' => $ajax_url, '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' => $this->name(), 'style' => $style, 'styles' => $this->styles(), 'title' => $this->chartTitle($individual), 'tree' => $tree, 'width' => $width, ]); } /** * Generate both the HTML and PNG components of the fan chart * * @param Individual $individual * @param string $style * @param int $width * @param int $generations * * @return ResponseInterface */ protected function chart(Individual $individual, string $style, int $width, int $generations): ResponseInterface { $ancestors = $this->chart_service->sosaStradonitzAncestors($individual, $generations); $gen = $generations - 1; $sosa = 2 ** $generations - 1; // fan size $fanw = intdiv(640 * $width, 100); $cx = $fanw / 2 - 1; // center x $cy = $cx; // center y $rx = $fanw - 1; $rw = $fanw / ($gen + 1); $fanh = $fanw; // fan height if ($style === self::STYLE_HALF_CIRCLE) { $fanh = intdiv($fanh * ($gen + 1), $gen * 2); } if ($style === self::STYLE_THREE_QUARTER_CIRCLE) { $fanh = intdiv($fanw * 86, 100); } $scale = $fanw / 640; // Create the image $image = imagecreate($fanw, (int) $fanh); // Create colors $transparent = imagecolorallocate($image, 0, 0, 0); imagecolortransparent($image, $transparent); /** @var ModuleThemeInterface $theme */ $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, $fanw, $fanh, $transparent); $fandeg = 90 * $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; // The arc size must be an even number of pixels: https://bugs.php.net/bug.php?id=79763 $even_rx = 2 * intdiv(1 + (int) $rx, 2); imagefilledarc($image, (int) $cx, (int) $cy, $even_rx, $even_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->lifespan()); $background = $backgrounds[$person->sex()]; // The arc size must be an even number of pixels: https://bugs.php.net/bug.php?id=79763 $even_rx = 2 * intdiv(1 + (int) $rx, 2); imagefilledarc($image, (int) $cx, (int) $cy, $even_rx, $even_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; } // If PHP is compiled with --enable-gd-jis-conv, then the function // imagettftext() is modified to expect EUC-JP encoding instead of UTF-8. // Attempt to detect and convert... if (gd_info()['JIS-mapped Japanese Font Support'] ?? false) { $text = mb_convert_encoding($text, 'EUC-JP', 'UTF-8'); } // 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 .= '
'; $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 (str_contains($data, chr($ord))) { $found = true; } } if ($found) { $line = $data; } else { foreach ($split as $word) { $len = strlen($line); $wlen = strlen($word); if (($len + $wlen) < $maxlen) { if ($line !== '') { $line .= ' '; } $line .= $word; } else { $p = max(0, (int) (($maxlen - $len) / 2)); if ($line !== '') { $line = str_repeat(' ', $p) . $line; // center alignment using spaces $text .= $line . "\n"; } $line = $word; } } } // last line if ($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