Shorten the name of describe-templates.h

Its length makes "ls" use few wide columns.

1 files changed, 137 insertions, 0 deletions

diff --git a/crawl-ref/source/process_desc.h b/crawl-ref/source/process_desc.h
new file mode 100644
index 0000000000..db9a0c17c2
--- /dev/null
+++ b/crawl-ref/source/process_desc.h
@@ -0,0 +1,137 @@
+/**
+ * @file
+ * @brief Templates used in describe.cc and in some tiles-only sources
+ */
+
+#ifndef DESCRIBE_TEMPLATES_H
+#define DESCRIBE_TEMPLATES_H
+
+template<class T> void process_description(T &proc, const describe_info &inf);
+template<class T> void process_quote(T &proc, const describe_info &inf);
+
+/* ***********************************************************************
+ * template implementations
+ * *********************************************************************** */
+// My kingdom for a closure.
+template<class T>
+inline void process_description(T &proc, const describe_info &inf)
+{
+    const unsigned int line_width = proc.width();
+    const          int height     = proc.height();
+
+    std::string desc;
+
+    // How many lines is the title; we also seem to be adding 1 to
+    // start with.
+    int num_lines = count_desc_lines(inf.title, line_width) + 1;
+
+    int body_lines   = count_desc_lines(inf.body.str(), line_width);
+    const int suffix_lines = count_desc_lines(inf.suffix, line_width);
+    const int prefix_lines = count_desc_lines(inf.prefix, line_width);
+    const int footer_lines = count_desc_lines(inf.footer, line_width)
+                             + (inf.footer.empty() ? 0 : 1);
+
+    // Maybe skip the body if body + title would be too many lines.
+    if (inf.title.empty())
+    {
+        desc = inf.body.str();
+        // There is a default 1 line addition for some reason.
+        num_lines = body_lines + 1;
+    }
+    else if (body_lines + num_lines + 2 <= height)
+    {
+        desc = inf.title + "\n\n";
+        desc += inf.body.str();
+        // Got 2 lines from the two \ns that weren't counted yet.
+        num_lines += body_lines + 2;
+    }
+    else
+        desc = inf.title + "\n";
+
+    // Prefer the footer over the suffix.
+    if (num_lines + suffix_lines + footer_lines <= height)
+    {
+        desc = desc + inf.suffix;
+        num_lines += suffix_lines;
+    }
+
+    // Prefer the footer over the prefix.
+    if (num_lines + prefix_lines + footer_lines <= height)
+    {
+        desc = inf.prefix + desc;
+        num_lines += prefix_lines;
+    }
+
+    if (!inf.footer.empty() && num_lines + footer_lines <= height)
+    {
+        const int bottom_line = std::min(std::max(24, num_lines + 2),
+                                         height - footer_lines + 1);
+        const int newlines = bottom_line - num_lines;
+
+        if (newlines >= 0)
+        {
+            desc.append(newlines, '\n');
+            desc = desc + inf.footer;
+        }
+    }
+
+    while (!desc.empty())
+    {
+        proc.print(wordwrap_line(desc, line_width));
+        if (!desc.empty())
+            proc.nextline();
+    }
+}
+
+template<class T>
+inline void process_quote(T &proc, const describe_info &inf)
+{
+    const unsigned int line_width = proc.width();
+    const          int height     = proc.height();
+
+    std::string desc;
+
+    // How many lines is the title; we also seem to be adding 1 to
+    // start with.
+    int num_lines = count_desc_lines(inf.title, line_width) + 1;
+
+    int body_lines   = count_desc_lines(inf.quote, line_width);
+
+    // Maybe skip the body if body + title would be too many lines.
+    if (inf.title.empty())
+    {
+        desc = inf.quote;
+        // There is a default 1 line addition for some reason.
+        num_lines = body_lines + 1;
+    }
+    else if (body_lines + num_lines + 2 <= height)
+    {
+        desc = inf.title + "\n\n";
+        desc += inf.quote;
+        // Got 2 lines from the two \ns that weren't counted yet.
+        num_lines += body_lines + 2;
+    }
+    else
+        desc = inf.title + "\n";
+
+    if (num_lines <= height)
+    {
+        const int bottom_line = std::min(std::max(24, num_lines + 2),
+                                         height);
+        const int newlines = bottom_line - num_lines;
+
+        if (newlines >= 0)
+        {
+            desc.append(newlines, '\n');
+        }
+    }
+
+    while (!desc.empty())
+    {
+        proc.print(wordwrap_line(desc, line_width));
+        if (!desc.empty())
+            proc.nextline();
+    }
+}
+
+#endif