2 * Copyright © 2010 Behdad Esfahbod
3 * Copyright © 2011 Google, Inc.
5 * This is part of HarfBuzz, a text shaping library.
7 * Permission is hereby granted, without written agreement and without
8 * license or royalty fees, to use, copy, modify, and distribute this
9 * software and its documentation for any purpose, provided that the
10 * above copyright notice and the following two paragraphs appear in
11 * all copies of this software.
13 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
14 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
15 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
16 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
19 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
20 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
21 * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
22 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
23 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
25 * Google Author(s): Behdad Esfahbod
48 /* Controlled by cmd-line options */
49 static int margin_t = 10;
50 static int margin_b = 10;
51 static int margin_l = 10;
52 static int margin_r = 10;
53 static int line_space = 0;
54 static int face_index = 0;
55 static double font_size = 18;
56 static const char *fore = "#000000";
57 static const char *back = "#ffffff";
58 static const char *text = NULL;
59 static const char *font_file = NULL;
60 static const char *out_file = "/dev/stdout";
61 static const char *direction = NULL;
62 static const char *script = NULL;
63 static const char *language = NULL;
64 static hb_feature_t *features = NULL;
65 static unsigned int num_features;
66 static hb_bool_t annotate = FALSE;
67 static hb_bool_t debug = FALSE;
69 /* Ugh, global vars. Ugly, but does the job */
71 static int height = 0;
72 static cairo_surface_t *surface = NULL;
73 static cairo_pattern_t *fore_pattern = NULL;
74 static cairo_pattern_t *back_pattern = NULL;
75 static cairo_font_face_t *cairo_face;
78 G_GNUC_NORETURN static void
79 usage (FILE *f, int status)
81 fprintf (f, "usage: hb-view [OPTS...] font-file text\n");
85 G_GNUC_NORETURN static void
88 printf ("hb-view (harfbuzz) %s\n", HB_VERSION_STRING);
92 static void parse_features (char *s);
95 parse_opts (int argc, char **argv)
97 argv[0] = (char *) "hb-view";
100 int option_index = 0, c;
101 static const struct option long_options[] = {
102 {"annotate", 0, &annotate, TRUE},
103 {"background", 1, 0, 'B'},
104 {"debug", 0, &debug, TRUE},
105 {"direction", 1, 0, 'd'},
106 {"features", 1, 0, 'f'},
107 {"font-size", 1, 0, 's'},
108 {"face-index", 1, 0, 'i'},
109 {"foreground", 1, 0, 'F'},
111 {"language", 1, 0, 'L'},
112 {"line-space", 1, 0, 'l'},
113 {"margin", 1, 0, 'm'},
114 {"output", 1, 0, 'o'},
115 {"script", 1, 0, 'S'},
116 {"version", 0, 0, 'v'},
120 c = getopt_long (argc, argv, "", long_options, &option_index);
135 face_index = atoi (optarg);
138 line_space = atoi (optarg);
141 switch (sscanf (optarg, "%d %d %d %d", &margin_t, &margin_r, &margin_b, &margin_l)) {
143 case 1: margin_r = margin_t;
144 case 2: margin_b = margin_t;
145 case 3: margin_l = margin_r;
149 font_size = strtod (optarg, NULL);
152 parse_features (optarg);
182 if (optind + 2 != argc)
184 font_file = argv[optind++];
185 text = argv[optind++];
190 parse_space (char **pp)
193 #define ISSPACE(c) ((c)==' '||(c)=='\f'||(c)=='\n'||(c)=='\r'||(c)=='\t'||(c)=='\v')
194 while (c = **pp, ISSPACE (c))
200 parse_char (char **pp, char c)
212 parse_uint (char **pp, unsigned int *pv)
217 v = strtol (p, pp, 0);
228 parse_feature_value_prefix (char **pp, hb_feature_t *feature)
230 if (parse_char (pp, '-'))
233 parse_char (pp, '+');
241 parse_feature_tag (char **pp, hb_feature_t *feature)
247 #define ISALNUM(c) (('a' <= (c) && (c) <= 'z') || ('A' <= (c) && (c) <= 'Z') || ('0' <= (c) && (c) <= '9'))
248 while (c = **pp, ISALNUM(c))
256 feature->tag = hb_tag_from_string (p);
263 parse_feature_indices (char **pp, hb_feature_t *feature)
268 feature->end = (unsigned int) -1;
270 if (!parse_char (pp, '['))
273 has_start = parse_uint (pp, &feature->start);
275 if (parse_char (pp, ':')) {
276 parse_uint (pp, &feature->end);
279 feature->end = feature->start + 1;
282 return parse_char (pp, ']');
286 parse_feature_value_postfix (char **pp, hb_feature_t *feature)
288 return !parse_char (pp, '=') || parse_uint (pp, &feature->value);
293 parse_one_feature (char **pp, hb_feature_t *feature)
295 return parse_feature_value_prefix (pp, feature) &&
296 parse_feature_tag (pp, feature) &&
297 parse_feature_indices (pp, feature) &&
298 parse_feature_value_postfix (pp, feature) &&
299 (parse_char (pp, ',') || **pp == '\0');
303 skip_one_feature (char **pp)
306 e = strchr (*pp, ',');
310 *pp = *pp + strlen (*pp);
313 static void parse_features (char *s)
323 /* count the features first, so we can allocate memory */
332 features = (hb_feature_t *) calloc (num_features, sizeof (*features));
334 /* now do the actual parsing */
338 if (parse_one_feature (&p, &features[num_features]))
341 skip_one_feature (&p);
346 static cairo_glyph_t *
347 _hb_cr_text_glyphs (cairo_t *cr,
348 const char *utf8, int len,
349 unsigned int *pnum_glyphs)
351 cairo_scaled_font_t *scaled_font = cairo_get_scaled_font (cr);
352 FT_Face ft_face = cairo_ft_scaled_font_lock_face (scaled_font);
353 hb_font_t *hb_font = hb_ft_font_create (ft_face, NULL);
354 hb_buffer_t *hb_buffer;
355 cairo_glyph_t *cairo_glyphs;
356 hb_glyph_info_t *hb_glyph;
357 hb_glyph_position_t *hb_position;
358 unsigned int num_glyphs, i;
361 hb_buffer = hb_buffer_create (0);
364 hb_buffer_set_direction (hb_buffer, hb_direction_from_string (direction));
366 hb_buffer_set_script (hb_buffer, hb_script_from_string (script));
368 hb_buffer_set_language (hb_buffer, hb_language_from_string (language));
372 hb_buffer_add_utf8 (hb_buffer, utf8, len, 0, len);
374 hb_shape (hb_font, hb_buffer, features, num_features);
376 num_glyphs = hb_buffer_get_length (hb_buffer);
377 hb_glyph = hb_buffer_get_glyph_infos (hb_buffer, NULL);
378 hb_position = hb_buffer_get_glyph_positions (hb_buffer, NULL);
379 cairo_glyphs = cairo_glyph_allocate (num_glyphs);
382 for (i = 0; i < num_glyphs; i++)
384 cairo_glyphs[i].index = hb_glyph->codepoint;
385 cairo_glyphs[i].x = ( hb_position->x_offset + x) * (1./64);
386 cairo_glyphs[i].y = (-hb_position->y_offset + y) * (1./64);
387 x += hb_position->x_advance;
388 y += -hb_position->y_advance;
393 hb_buffer_destroy (hb_buffer);
394 hb_font_destroy (hb_font);
395 cairo_ft_scaled_font_unlock_face (scaled_font);
398 *pnum_glyphs = num_glyphs;
403 create_context (void)
406 unsigned int fr, fg, fb, fa, br, bg, bb, ba;
409 cairo_surface_destroy (surface);
411 cairo_pattern_destroy (back_pattern);
413 cairo_pattern_destroy (fore_pattern);
415 br = bg = bb = ba = 255;
416 sscanf (back + (*back=='#'), "%2x%2x%2x%2x", &br, &bg, &bb, &ba);
417 fr = fg = fb = 0; fa = 255;
418 sscanf (fore + (*fore=='#'), "%2x%2x%2x%2x", &fr, &fg, &fb, &fa);
420 if (!annotate && ba == 255 && fa == 255 && br == bg && bg == bb && fr == fg && fg == fb) {
421 /* grayscale. use A8 surface */
422 surface = cairo_image_surface_create (CAIRO_FORMAT_A8, width, height);
423 cr = cairo_create (surface);
424 cairo_set_operator (cr, CAIRO_OPERATOR_SOURCE);
425 cairo_set_source_rgba (cr, 1., 1., 1., br / 255.);
427 back_pattern = cairo_pattern_reference (cairo_get_source (cr));
428 cairo_set_source_rgba (cr, 1., 1., 1., fr / 255.);
429 fore_pattern = cairo_pattern_reference (cairo_get_source (cr));
431 /* color. use (A)RGB surface */
433 surface = cairo_image_surface_create (CAIRO_FORMAT_ARGB32, width, height);
435 surface = cairo_image_surface_create (CAIRO_FORMAT_RGB24, width, height);
436 cr = cairo_create (surface);
437 cairo_set_source_rgba (cr, br / 255., bg / 255., bb / 255., ba / 255.);
439 back_pattern = cairo_pattern_reference (cairo_get_source (cr));
440 cairo_set_source_rgba (cr, fr / 255., fg / 255., fb / 255., fa / 255.);
441 fore_pattern = cairo_pattern_reference (cairo_get_source (cr));
444 cairo_set_font_face (cr, cairo_face);
453 cairo_font_extents_t font_extents;
455 cairo_glyph_t *glyphs = NULL;
456 unsigned int num_glyphs = 0;
458 const char *end, *p = text;
461 cr= create_context ();
463 cairo_set_font_size (cr, font_size);
464 cairo_font_extents (cr, &font_extents);
473 cairo_text_extents_t extents;
475 end = strchr (p, '\n');
477 end = p + strlen (p);
483 glyphs = _hb_cr_text_glyphs (cr, p, end - p, &num_glyphs);
485 cairo_glyph_extents (cr, glyphs, num_glyphs, &extents);
487 y += ceil (font_extents.ascent);
488 width = MAX (width, extents.x_advance);
490 cairo_translate (cr, x, y);
495 /* Draw actual glyph origins */
496 cairo_set_source_rgba (cr, 1., 0., 0., .5);
497 cairo_set_line_width (cr, 5);
498 cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
499 for (i = 0; i < num_glyphs; i++) {
500 cairo_move_to (cr, glyphs[i].x, glyphs[i].y);
501 cairo_rel_line_to (cr, 0, 0);
507 cairo_show_glyphs (cr, glyphs, num_glyphs);
509 y += ceil (font_extents.height - ceil (font_extents.ascent));
511 cairo_glyph_free (glyphs);
517 height = y + margin_b;
518 width += margin_l + margin_r;
526 main (int argc, char **argv)
528 static FT_Library ft_library;
529 static FT_Face ft_face;
530 cairo_status_t status;
532 setlocale (LC_ALL, "");
534 parse_opts (argc, argv);
536 FT_Init_FreeType (&ft_library);
537 if (FT_New_Face (ft_library, font_file, face_index, &ft_face)) {
538 fprintf (stderr, "Failed to open font file `%s'\n", font_file);
541 cairo_face = cairo_ft_font_face_create_for_ft_face (ft_face, 0);
546 status = cairo_surface_write_to_png (surface, out_file);
547 if (status != CAIRO_STATUS_SUCCESS) {
548 fprintf (stderr, "Failed to write output file `%s': %s\n",
549 out_file, cairo_status_to_string (status));
556 cairo_pattern_destroy (fore_pattern);
557 cairo_pattern_destroy (back_pattern);
558 cairo_surface_destroy (surface);
559 cairo_font_face_destroy (cairo_face);
560 cairo_debug_reset_static_data ();
562 FT_Done_Face (ft_face);
563 FT_Done_FreeType (ft_library);