2 tie-formatting-problem.cc -- implement Tie_formatting_problem
4 source file of the GNU LilyPond music typesetter
6 (c) 2005--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
10 #include "tie-formatting-problem.hh"
13 #include "directional-element-interface.hh"
15 #include "libc-extension.hh"
17 #include "note-head.hh"
18 #include "rhythmic-head.hh"
20 #include "staff-symbol-referencer.hh"
22 #include "tie-configuration.hh"
28 Tie_formatting_problem::print_ties_configuration (Ties_configuration const *ties)
30 for (vsize i = 0; i < ties->size (); i++)
32 char const *man_pos = (specifications_[i].has_manual_position_) ? "(M)" : "";
33 char const *man_dir = (specifications_[i].has_manual_dir_) ? "(M)" : "";
34 char const *dir = (ties->at (i).dir_ == UP) ? "up" : "dn";
36 printf ("(P%d%s, %s%s) ", ties->at (i).position_, man_pos, dir, man_dir);
42 Tie_formatting_problem::get_attachment (Real y) const
48 attachments[d] = skyline_height (chord_outlines_[d], y, -d);
50 while (flip (&d) != LEFT);
55 Tie_formatting_problem::Tie_formatting_problem()
60 Tie_formatting_problem::~Tie_formatting_problem ()
62 for (Tie_configuration_map::const_iterator i (possibilities_.begin ());
63 i != possibilities_.end (); i++)
68 Tie_formatting_problem::set_chord_outline (vector<Item*> bounds,
71 Real staff_space = Staff_symbol_referencer::staff_space (bounds[0]);
74 vector<Box> head_boxes;
77 for (vsize i = 0; i < bounds.size (); i++)
79 Grob *head = bounds[i];
80 if (!Note_head::has_interface (head))
84 stem = unsmob_grob (head->get_object ("stem"));
86 Real p = Staff_symbol_referencer::get_position (head);
87 Interval y ((p-1) * 0.5 * staff_space,
88 (p+1) * 0.5 * staff_space);
90 Interval x = head->extent (x_refpoint_, X_AXIS);
91 head_boxes.push_back (Box (x, y));
92 boxes.push_back (Box (x, y));
94 Grob *dots = Rhythmic_head::get_dots (head);
95 if (dir == LEFT && dots)
97 Interval x = dots->extent (x_refpoint_, X_AXIS);
98 int p = int (Staff_symbol_referencer::get_position (dots));
100 dot_positions_.insert (p);
103 Interval y (dots->extent (dots, Y_AXIS));
104 y.translate (p * staff_space * 0.5);
106 boxes.push_back (Box (x, y));
110 chord_outlines_[dir] = empty_skyline (-dir);
111 if (bounds[0]->break_status_dir ())
113 Real x = robust_relative_extent (bounds[0], x_refpoint_, X_AXIS)[-dir];
114 chord_outlines_[dir].at (0).height_ = x;
119 for (vsize i = 0; i < head_boxes.size (); i++)
121 x.unite (head_boxes[i][X_AXIS]);
124 chord_outlines_[dir].at (0).height_ = x[dir];
127 for (vsize i = 0; i < boxes.size (); i++)
128 insert_extent_into_skyline (&chord_outlines_[dir] ,
129 boxes[i], Y_AXIS, -dir);
132 && !Stem::is_invisible (stem))
135 x.add_point (stem->relative_coordinate (x_refpoint_, X_AXIS));
136 x.widen (staff_space / 20); // ugh.
138 y.add_point (Stem::stem_end_position (stem) * staff_space * .5);
140 Direction stemdir = get_grob_direction (stem);
141 y.add_point (Stem::head_positions (stem)[-stemdir]
144 insert_extent_into_skyline (&chord_outlines_[dir], Box (x,y), Y_AXIS, -dir);
146 stem_extents_[dir].unite (Box (x,y));
150 Box flag_box = Stem::get_translated_flag (stem).extent_box ();
151 flag_box.translate( Offset (x[RIGHT], X_AXIS));
152 insert_extent_into_skyline (&chord_outlines_[dir], flag_box,
157 Direction updowndir = DOWN;
162 if (head_boxes.size())
164 Box b = boundary (head_boxes, updowndir, 0);
166 x[-dir] = b[X_AXIS].linear_combination (-dir / 2);
167 y[-updowndir] = b[Y_AXIS][updowndir];
168 y[updowndir] = updowndir * infinity_f;
172 insert_extent_into_skyline (&chord_outlines_[dir],
176 while (flip (&updowndir) != DOWN);
178 head_extents_[dir].set_empty ();
179 for (vsize i = 0; i < head_boxes.size (); i++)
181 head_extents_[dir].unite (head_boxes[i]);
187 Tie_formatting_problem::from_tie (Grob *tie)
190 ties.push_back (tie);
193 details_.from_grob (tie);
197 Tie_formatting_problem::common_x_refpoint () const
203 Tie_formatting_problem::from_ties (vector<Grob*> const &ties)
208 x_refpoint_ = ties[0];
209 for (vsize i = 0; i < ties.size (); i++)
211 x_refpoint_ = dynamic_cast<Spanner*> (ties[i])->get_bound (LEFT)->common_refpoint (x_refpoint_, X_AXIS);
212 x_refpoint_ = dynamic_cast<Spanner*> (ties[i])->get_bound (RIGHT)->common_refpoint (x_refpoint_, X_AXIS);
215 details_.from_grob (ties[0]);
220 vector<Item*> bounds;
222 for (vsize i = 0; i < ties.size (); i++)
224 Item *it = dynamic_cast<Spanner*> (ties[i])->get_bound (d);
226 bounds.push_back (it);
229 set_chord_outline (bounds, d);
231 while (flip (&d) != LEFT);
234 for (vsize i = 0; i < ties.size (); i++)
236 Tie_specification spec;
238 if (scm_is_number (ties[i]->get_property_data (ly_symbol2scm ("direction"))))
240 spec.manual_dir_ = to_dir (ties[i]->get_property ("direction"));
241 spec.has_manual_dir_ = true;
244 spec.position_ = Tie::get_position (ties[i]);
245 if (scm_is_number (ties[i]->get_property ("staff-position")))
247 spec.manual_position_ = scm_to_double (ties[i]->get_property ("staff-position"));
248 spec.has_manual_position_ = true;
249 spec.position_ = int (my_round (spec.manual_position_));
254 spec.note_head_drul_[d] = Tie::head (ties[i], d);
256 while (flip (&d) != LEFT);
258 specifications_.push_back (spec);
263 Tie_formatting_problem::from_semi_ties (vector<Grob*> const &lv_ties, Direction head_dir)
265 if (lv_ties.empty ())
268 details_.from_grob (lv_ties[0]);
271 for (vsize i = 0; i < lv_ties.size (); i++)
273 Tie_specification spec;
274 Item *head = unsmob_item (lv_ties[i]->get_object ("note-head"));
277 programming_error ("LV tie without head?!");
281 spec.position_ = int (Staff_symbol_referencer::get_position (head));
284 spec.note_head_drul_[head_dir] = head;
285 heads.push_back (head);
286 specifications_.push_back (spec);
289 x_refpoint_ = lv_ties [0];
290 for (vsize i = 0; i < lv_ties.size (); i++)
291 x_refpoint_ = lv_ties[i]->common_refpoint (x_refpoint_, X_AXIS);
292 for (vsize i = 0; i < heads.size (); i++)
293 x_refpoint_ = heads[i]->common_refpoint (x_refpoint_, X_AXIS);
295 set_chord_outline (heads, head_dir);
297 Real extremal = head_dir * infinity_f;
299 for (vsize i = 0; i < chord_outlines_[head_dir].size (); i++)
301 extremal = head_dir * min (head_dir * extremal,
302 head_dir * chord_outlines_[head_dir][i].height_);
305 Skyline_entry right_entry;
306 right_entry.width_.set_full ();
307 right_entry.height_ = extremal - head_dir * 1.5;
309 chord_outlines_[-head_dir].push_back (right_entry);
314 Tie_formatting_problem::get_tie_specification (int i) const
316 return specifications_[i];
321 Tie_formatting_problem::get_configuration (int pos, Direction dir) const
323 pair<int,int> key (pos, dir);
324 Tie_configuration_map::const_iterator f = possibilities_.find (key);
326 if (f != possibilities_.end ())
332 Tie_configuration *conf = generate_configuration (pos, dir);
333 ((Tie_formatting_problem*) this)->possibilities_[key] = conf;
338 Tie_formatting_problem::generate_configuration (int pos, Direction dir) const
340 Tie_configuration *conf = new Tie_configuration;
341 conf->position_ = pos;
343 Real y = conf->position_ * 0.5 * details_.staff_space_;
347 if (dot_positions_.find (pos) != dot_positions_.end ())
349 conf->delta_y_ += dir * 0.25 * details_.staff_space_;
356 && max (fabs (head_extents_[LEFT][Y_AXIS][dir] - y),
357 fabs (head_extents_[RIGHT][Y_AXIS][dir] - y)) < 0.25
358 && !Staff_symbol_referencer::on_line (details_.staff_symbol_referencer_, pos))
361 (head_extents_[LEFT][Y_AXIS][dir] - y)
362 + dir * details_.outer_tie_vertical_gap_;
367 conf->attachment_x_ = get_attachment (y + conf->delta_y_);
368 Real h = conf->height (details_);
373 - should make sliding criterion, should flatten ties if
375 - they're just the wrong (ie. touching line at top & bottom)
379 if (h < details_.intra_space_threshold_ * 0.5 * details_.staff_space_)
381 if (!Staff_symbol_referencer::on_line (details_.staff_symbol_referencer_, pos)
382 && abs (pos) < 2 * Staff_symbol_referencer::staff_radius (details_.staff_symbol_referencer_))
384 conf->center_tie_vertically (details_);
386 else if (Staff_symbol_referencer::on_line (details_.staff_symbol_referencer_, pos))
388 conf->delta_y_ += dir *
389 details_.tip_staff_line_clearance_ * 0.5 * details_.staff_space_;
394 Real top_y = y + conf->delta_y_ + conf->dir_ * h;
395 Real top_pos = top_y / (0.5*details_.staff_space_);
396 int round_pos = int (my_round (top_pos));
398 /* TODO: should use other variable? */
399 Real clearance = details_.center_staff_line_clearance_;
400 if (fabs (top_pos - round_pos) < clearance
401 && Staff_symbol_referencer::on_staff_line (details_.staff_symbol_referencer_,
404 Real new_y = (round_pos + clearance * conf->dir_) * 0.5 * details_.staff_space_;
405 conf->delta_y_ = (new_y - top_y);
410 conf->attachment_x_ = get_attachment (y + conf->delta_y_);
411 if (conf->height (details_) < details_.intra_space_threshold_ * 0.5 * details_.staff_space_)
414 This is less sensible for long ties, since those are more
417 Interval close_by = get_attachment (y
419 + (dir * details_.intra_space_threshold_ * 0.25
420 * details_.staff_space_));
422 conf->attachment_x_.intersect (close_by);
425 conf->attachment_x_.widen ( - details_.x_gap_);
430 Real y = conf->position_ * details_.staff_space_ * 0.5 + conf->delta_y_;
431 if (stem_extents_[d][X_AXIS].is_empty ()
432 || !stem_extents_[d][Y_AXIS].contains (y))
435 conf->attachment_x_[d] =
436 d* min (d * conf->attachment_x_[d],
437 d * (stem_extents_[d][X_AXIS][-d] - d * details_.stem_gap_));
439 while (flip (&d) != LEFT);
444 TIE_IDX and TIES_CONF are optional.
447 Tie_formatting_problem::score_aptitude (Tie_configuration *conf,
448 Tie_specification const &spec,
449 Ties_configuration *ties_conf, int tie_idx) const
452 Real curve_y = conf->position_ * details_.staff_space_ * 0.5 + conf->delta_y_;
453 Real tie_y = spec.position_ * details_.staff_space_ * 0.5;
454 if (sign (curve_y - tie_y) != conf->dir_)
456 Real p = details_.wrong_direction_offset_penalty_;
458 ties_conf->add_tie_score (p, tie_idx, "wrong dir");
464 Real p = details_.vertical_distance_penalty_factor_ * fabs (curve_y - tie_y);
466 ties_conf->add_tie_score (p, tie_idx, "vdist");
474 if (!spec.note_head_drul_[d])
477 Interval head_x = spec.note_head_drul_[d]->extent (x_refpoint_, X_AXIS);
478 Real dist = head_x.distance (conf->attachment_x_[d]);
481 TODO: flatten with log or sqrt.
483 Real p = details_.horizontal_distance_penalty_factor_ * dist;
485 ties_conf->add_tie_score (p, tie_idx,
486 (d == LEFT) ? "lhdist" : "rhdist");
490 while (flip (&d) != LEFT);
496 Tie_formatting_problem::score_configuration (Tie_configuration *conf) const
503 Real length = conf->attachment_x_.length ();
505 conf->add_score (details_.min_length_penalty_factor_
506 * peak_around (0.33 * details_.min_length_, details_.min_length_, length),
509 Real tip_pos = conf->position_ + conf->delta_y_ / 0.5 * details_.staff_space_;
510 Real tip_y = tip_pos * details_.staff_space_ * 0.5;
511 Real height = conf->height (details_);
513 Real top_y = tip_y + conf->dir_ * height;
514 Real top_pos = 2 * top_y / details_.staff_space_;
515 Real round_top_pos = rint (top_pos);
516 if (Staff_symbol_referencer::on_line (details_.staff_symbol_referencer_,
518 && Staff_symbol_referencer::staff_radius (details_.staff_symbol_referencer_) > top_y)
521 details_.staff_line_collision_penalty_
522 * peak_around (0.1 * details_.center_staff_line_clearance_,
523 details_.center_staff_line_clearance_,
524 fabs (top_pos - round_top_pos)),
528 if (Staff_symbol_referencer::on_line (details_.staff_symbol_referencer_,
529 int (rint (tip_pos))))
531 conf->add_score (details_.staff_line_collision_penalty_
532 * peak_around (0.1 * details_.tip_staff_line_clearance_,
533 details_.tip_staff_line_clearance_,
534 fabs (tip_pos - rint (tip_pos))),
538 if (!dot_x_.is_empty ())
541 Real x = dot_x_.center ();
543 Bezier b = conf->get_transformed_bezier (details_);
544 if (b.control_point_extent (X_AXIS).contains (x))
546 Real y = b.get_other_coordinate (X_AXIS, x);
548 for (set<int>::const_iterator i (dot_positions_.begin ());
549 i != dot_positions_.end (); i ++)
552 conf->add_score (details_.dot_collision_penalty_
553 * peak_around (.1 * details_.dot_collision_clearance_,
554 details_.dot_collision_clearance_,
555 fabs (dot_pos * details_.staff_space_ * 0.5 - y)),
561 conf->scored_ = true;
565 Tie_formatting_problem::find_optimal_tie_configuration (Tie_specification const &spec) const
567 vector<Tie_configuration*> confs;
569 int pos = spec.position_;
570 Direction dir = spec.manual_dir_;
572 for (int i = 0; i < details_.single_tie_region_size_; i ++)
574 confs.push_back (generate_configuration (pos + i * dir, dir));
576 if (spec.has_manual_position_)
578 confs.back ()->delta_y_
579 = (spec.manual_position_ - spec.position_)
580 * 0.5 * details_.staff_space_;
589 Real best_score = 1e6;
590 for (vsize i = 0; i < confs.size (); i ++)
592 score_configuration (confs[i]);
593 Real score = score_aptitude (confs[i], spec, 0, 0)
594 + confs[i]->score ();
596 if (score < best_score)
603 Tie_configuration best = *confs[best_idx];
604 for (vsize i = 0; i < confs.size (); i++)
610 Tie_specification::Tie_specification ()
612 has_manual_position_ = false;
613 has_manual_dir_ = false;
615 manual_position_ = 0;
616 manual_dir_ = CENTER;
617 note_head_drul_[LEFT] =
618 note_head_drul_[RIGHT] = 0;
623 Tie_formatting_problem::score_ties_aptitude (Ties_configuration *ties) const
625 if (ties->size () != specifications_.size ())
627 programming_error ("Huh? Mismatch between sizes.");
631 for (vsize i = 0; i < ties->size (); i++)
632 score_aptitude (&ties->at (i), specifications_[i],
637 Tie_formatting_problem::score_ties (Ties_configuration *ties) const
642 score_ties_configuration (ties);
643 score_ties_aptitude (ties);
644 ties->scored_ = true;
648 Tie_formatting_problem::score_ties_configuration (Ties_configuration *ties) const
650 for (vsize i = 0; i < ties->size (); i++)
652 score_configuration (&ties->at (i));
653 ties->add_tie_score (ties->at (i).score (), i, "conf");
656 Real last_edge = 0.0;
657 Real last_center = 0.0;
658 for (vsize i = 0; i < ties->size (); i++)
660 Bezier b (ties->at (i).get_transformed_bezier (details_));
662 Real center = b.curve_point (0.5)[Y_AXIS];
663 Real edge = b.curve_point (0.0)[Y_AXIS];
667 if (edge <= last_edge)
668 ties->add_score (details_.tie_column_monotonicity_penalty_, "monoton edge");
669 if (center <= last_center)
670 ties->add_score (details_.tie_column_monotonicity_penalty_, "monoton cent");
672 ties->add_score (details_.tie_tie_collision_penalty_ *
673 peak_around (0.1 * details_.tie_tie_collision_distance_,
674 details_.tie_tie_collision_distance_,
675 fabs (center - last_center)),
677 ties->add_score (details_.tie_tie_collision_penalty_ *
678 peak_around (0.1 * details_.tie_tie_collision_distance_,
679 details_.tie_tie_collision_distance_,
680 fabs (edge - last_edge)), "tietie edge");
684 last_center = center;
687 ties->add_score (details_.outer_tie_length_symmetry_penalty_factor_
688 * fabs (ties->at (0).attachment_x_.length () - ties->back ().attachment_x_.length ()),
691 ties->add_score (details_.outer_tie_vertical_distance_symmetry_penalty_factor_
692 * fabs (fabs (specifications_[0].position_ * 0.5 * details_.staff_space_
693 - (ties->at (0).position_ * 0.5 * details_.staff_space_
694 + ties->at (0).delta_y_))
696 fabs (specifications_.back ().position_ * 0.5 * details_.staff_space_
697 - (ties->back ().position_ * 0.5 * details_.staff_space_
698 + ties->back ().delta_y_))),
703 Generate with correct X-attachments and beziers, copying delta_y_
704 from TIES_CONFIG if necessary.
707 Tie_formatting_problem::generate_ties_configuration (Ties_configuration const &ties_config)
709 Ties_configuration copy;
710 for (vsize i = 0; i < ties_config.size (); i++)
712 Tie_configuration * ptr = get_configuration (ties_config[i].position_, ties_config[i].dir_);
713 if (specifications_[i].has_manual_position_)
716 = (specifications_[i].manual_position_ - ties_config[i].position_)
717 * 0.5 * details_.staff_space_;
719 copy.push_back (*ptr);
726 Tie_formatting_problem::generate_base_chord_configuration ()
728 Ties_configuration ties_config;
729 for (vsize i = 0; i < specifications_.size (); i ++)
731 Tie_configuration conf;
732 if (specifications_[i].has_manual_dir_)
733 conf.dir_ = specifications_[i].manual_dir_;
734 if (specifications_[i].has_manual_position_)
736 conf.position_ = (int) my_round (specifications_[i].manual_position_);
737 conf.delta_y_ = (specifications_[i].manual_position_ - conf.position_)
738 * 0.5 * details_.staff_space_;
742 conf.position_ = specifications_[i].position_;
744 ties_config.push_back (conf);
747 set_ties_config_standard_directions (&ties_config);
748 for (vsize i = 0; i < ties_config.size (); i++)
749 if (!specifications_[i].manual_position_)
750 ties_config[i].position_ += ties_config[i].dir_;
752 ties_config = generate_ties_configuration (ties_config);
758 Tie_formatting_problem::find_best_variation (Ties_configuration const &base,
759 vector<Tie_configuration_variation> vars)
761 Ties_configuration best = base;
764 This simply is 1-opt: we have K substitions, and we try applying
765 exactly every one for each.
767 for (vsize i = 0; i < vars.size (); i++)
769 Ties_configuration variant (base);
770 variant[vars[i].index_] = *vars[i].suggestion_;
772 variant.reset_score ();
773 score_ties (&variant);
775 if (variant.score () < best.score ())
787 Tie_formatting_problem::generate_optimal_chord_configuration ()
790 Ties_configuration base = generate_base_chord_configuration ();
791 vector<Tie_configuration_variation> vars = generate_collision_variations (base);
794 Ties_configuration best = find_best_variation (base, vars);
795 vars = generate_extremal_tie_variations (best);
796 best = find_best_variation (best, vars);
802 Tie_formatting_problem::set_ties_config_standard_directions (Ties_configuration *tie_configs)
804 if (tie_configs->empty ())
807 if (!tie_configs->at (0).dir_)
808 tie_configs->at (0).dir_ = DOWN;
809 if (!tie_configs->back ().dir_)
810 tie_configs->back ().dir_ = UP;
815 for (vsize i = 1; i < tie_configs->size (); i++)
817 Real diff = (tie_configs->at (i-1).position_
818 - tie_configs->at (i).position_);
820 if (fabs (diff) <= 1)
822 if (!tie_configs->at (i-1).dir_)
823 tie_configs->at (i-1).dir_ = DOWN;
824 if (!tie_configs->at (i).dir_)
825 tie_configs->at (i).dir_ = UP;
829 for (vsize i = 1; i < tie_configs->size() - 1; i++)
831 Tie_configuration &conf = tie_configs->at (i);
835 Direction position_dir =
836 Direction (sign (conf.position_));
840 conf.dir_ = position_dir;
844 Tie_configuration_variation::Tie_configuration_variation ()
850 vector<Tie_configuration_variation>
851 Tie_formatting_problem::generate_extremal_tie_variations (Ties_configuration const &ties) const
853 vector<Tie_configuration_variation> vars;
857 if (boundary (ties, d, 0).dir_ == d
858 && !boundary (specifications_, d, 0).has_manual_position_)
859 for (int i = 1; i <= details_.multi_tie_region_size_; i++)
861 Tie_configuration_variation var;
862 var.index_ = (d == DOWN) ? 0 : ties.size () - 1;
863 var.suggestion_ = get_configuration (boundary (ties, d, 0).position_
865 vars.push_back (var);
868 while (flip (&d) != DOWN);
874 vector<Tie_configuration_variation>
875 Tie_formatting_problem::generate_collision_variations (Ties_configuration const &ties) const
877 Real center_distance_tolerance = 0.25;
879 vector<Tie_configuration_variation> vars;
880 Real last_center = 0.0;
881 for (vsize i = 0; i < ties.size (); i++)
883 Bezier b (ties[i].get_transformed_bezier (details_));
885 Real center = b.curve_point (0.5)[Y_AXIS];
889 if (center <= last_center + center_distance_tolerance)
891 if (!specifications_[i].has_manual_dir_)
893 Tie_configuration_variation var;
895 var.suggestion_ = get_configuration (specifications_[i].position_
899 vars.push_back (var);
902 if (!specifications_[i-1].has_manual_dir_)
904 Tie_configuration_variation var;
906 var.suggestion_ = get_configuration (specifications_[i-1].position_
910 vars.push_back (var);
913 if (i == 1 && !specifications_[i-1].has_manual_position_
914 && ties[i-1].dir_ == DOWN)
916 Tie_configuration_variation var;
918 var.suggestion_ = get_configuration (specifications_[i-1].position_
920 vars.push_back (var);
922 if (i == ties.size() && !specifications_[i].has_manual_position_
923 && ties[i].dir_ == UP)
925 Tie_configuration_variation var;
927 var.suggestion_ = get_configuration (specifications_[i].position_
929 vars.push_back (var);
932 else if (dot_positions_.find (ties[i].position_) != dot_positions_.end ()
933 && !specifications_[i].has_manual_position_)
935 Tie_configuration_variation var;
937 var.suggestion_ = get_configuration (ties[i].position_ + ties[i].dir_,
939 vars.push_back (var);
944 last_center = center;
952 Tie_formatting_problem::set_manual_tie_configuration (SCM manual_configs)
955 for (SCM s = manual_configs;
956 scm_is_pair (s) && k < specifications_.size (); s = scm_cdr (s))
958 SCM entry = scm_car (s);
959 if (scm_is_pair (entry))
961 Tie_specification &spec = specifications_[k];
963 if (scm_is_number (scm_car (entry)))
965 spec.has_manual_position_ = true;
966 spec.manual_position_ = scm_to_double (scm_car (entry));
968 if (scm_is_number (scm_cdr (entry)))
970 spec.has_manual_dir_ = true;
971 spec.manual_dir_ = Direction (scm_to_int (scm_cdr (entry)));