emf 0.2.0-x86_64-linux-musl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE.txt +24 -0
  3. data/README.adoc +341 -0
  4. data/exe/emf +125 -0
  5. data/lib/emf/backend.rb +60 -0
  6. data/lib/emf/binary/class_field_accessors.rb +49 -0
  7. data/lib/emf/binary/codec.rb +19 -0
  8. data/lib/emf/binary/float32_le.rb +54 -0
  9. data/lib/emf/binary/types.rb +139 -0
  10. data/lib/emf/binary.rb +10 -0
  11. data/lib/emf/conformance/context.rb +36 -0
  12. data/lib/emf/conformance/diagnostic.rb +18 -0
  13. data/lib/emf/conformance/manifest/emf_bitmap_misc.yml +622 -0
  14. data/lib/emf/conformance/manifest/emf_control_buffers.yml +61 -0
  15. data/lib/emf/conformance/manifest/emf_core.yml +117 -0
  16. data/lib/emf/conformance/manifest/emf_corpus_rules.yml +21 -0
  17. data/lib/emf/conformance/manifest/emf_objects_geometry.yml +229 -0
  18. data/lib/emf/conformance/manifest/emf_plus.yml +357 -0
  19. data/lib/emf/conformance/manifest/emf_plus_core.yml +33 -0
  20. data/lib/emf/conformance/manifest/emf_state_path.yml +403 -0
  21. data/lib/emf/conformance/manifest/emf_text.yml +97 -0
  22. data/lib/emf/conformance/manifest/wmf.yml +874 -0
  23. data/lib/emf/conformance/manifest.rb +79 -0
  24. data/lib/emf/conformance/profile.rb +35 -0
  25. data/lib/emf/conformance/record_types.rb +24 -0
  26. data/lib/emf/conformance/registry.rb +76 -0
  27. data/lib/emf/conformance/report.rb +83 -0
  28. data/lib/emf/conformance/rule.rb +16 -0
  29. data/lib/emf/conformance/rules/emf_bitmap.rb +357 -0
  30. data/lib/emf/conformance/rules/emf_comment_escape.rb +309 -0
  31. data/lib/emf/conformance/rules/emf_control_buffers.rb +137 -0
  32. data/lib/emf/conformance/rules/emf_corpus_named.rb +83 -0
  33. data/lib/emf/conformance/rules/emf_framing.rb +94 -0
  34. data/lib/emf/conformance/rules/emf_geometry.rb +282 -0
  35. data/lib/emf/conformance/rules/emf_header.rb +114 -0
  36. data/lib/emf/conformance/rules/emf_objects.rb +291 -0
  37. data/lib/emf/conformance/rules/emf_parse_recovery.rb +97 -0
  38. data/lib/emf/conformance/rules/emf_path_clip.rb +165 -0
  39. data/lib/emf/conformance/rules/emf_plus.rb +75 -0
  40. data/lib/emf/conformance/rules/emf_plus_common.rb +58 -0
  41. data/lib/emf/conformance/rules/emf_plus_drawing.rb +78 -0
  42. data/lib/emf/conformance/rules/emf_plus_effects.rb +104 -0
  43. data/lib/emf/conformance/rules/emf_plus_fields.rb +169 -0
  44. data/lib/emf/conformance/rules/emf_plus_fields_b.rb +102 -0
  45. data/lib/emf/conformance/rules/emf_plus_framing.rb +172 -0
  46. data/lib/emf/conformance/rules/emf_plus_objects.rb +97 -0
  47. data/lib/emf/conformance/rules/emf_plus_payloads.rb +320 -0
  48. data/lib/emf/conformance/rules/emf_plus_properties.rb +96 -0
  49. data/lib/emf/conformance/rules/emf_plus_state.rb +77 -0
  50. data/lib/emf/conformance/rules/emf_state.rb +244 -0
  51. data/lib/emf/conformance/rules/emf_text.rb +221 -0
  52. data/lib/emf/conformance/rules/emf_transform.rb +85 -0
  53. data/lib/emf/conformance/rules/wmf_buffers.rb +259 -0
  54. data/lib/emf/conformance/rules/wmf_framing.rb +146 -0
  55. data/lib/emf/conformance/rules/wmf_layout_records.rb +112 -0
  56. data/lib/emf/conformance/rules/wmf_objects.rb +168 -0
  57. data/lib/emf/conformance/rules/wmf_records.rb +191 -0
  58. data/lib/emf/conformance/rules/wmf_rejections.rb +184 -0
  59. data/lib/emf/conformance/runner.rb +61 -0
  60. data/lib/emf/conformance/ternary_raster_operations.rb +52 -0
  61. data/lib/emf/conformance.rb +31 -0
  62. data/lib/emf/detector.rb +58 -0
  63. data/lib/emf/emf_plus/binary.rb +8 -0
  64. data/lib/emf/emf_plus/effects/blur.rb +24 -0
  65. data/lib/emf/emf_plus/effects/brightness_contrast.rb +22 -0
  66. data/lib/emf/emf_plus/effects/color_balance.rb +24 -0
  67. data/lib/emf/emf_plus/effects/color_curve.rb +24 -0
  68. data/lib/emf/emf_plus/effects/color_lookup_table.rb +26 -0
  69. data/lib/emf/emf_plus/effects/color_matrix.rb +23 -0
  70. data/lib/emf/emf_plus/effects/effect.rb +50 -0
  71. data/lib/emf/emf_plus/effects/hue_saturation_lightness.rb +24 -0
  72. data/lib/emf/emf_plus/effects/levels.rb +24 -0
  73. data/lib/emf/emf_plus/effects/opaque.rb +19 -0
  74. data/lib/emf/emf_plus/effects/red_eye_correction.rb +35 -0
  75. data/lib/emf/emf_plus/effects/sharpen.rb +24 -0
  76. data/lib/emf/emf_plus/effects/tint.rb +22 -0
  77. data/lib/emf/emf_plus/effects.rb +45 -0
  78. data/lib/emf/emf_plus/frame.rb +41 -0
  79. data/lib/emf/emf_plus/links/effect_link.rb +16 -0
  80. data/lib/emf/emf_plus/links/get_dc_span.rb +18 -0
  81. data/lib/emf/emf_plus/links/link_error.rb +15 -0
  82. data/lib/emf/emf_plus/links.rb +77 -0
  83. data/lib/emf/emf_plus/object_chain.rb +108 -0
  84. data/lib/emf/emf_plus/object_table.rb +182 -0
  85. data/lib/emf/emf_plus/objects/brush.rb +296 -0
  86. data/lib/emf/emf_plus/objects/custom_line_cap.rb +106 -0
  87. data/lib/emf/emf_plus/objects/font.rb +47 -0
  88. data/lib/emf/emf_plus/objects/image.rb +68 -0
  89. data/lib/emf/emf_plus/objects/image_attributes.rb +28 -0
  90. data/lib/emf/emf_plus/objects/opaque.rb +19 -0
  91. data/lib/emf/emf_plus/objects/parts.rb +103 -0
  92. data/lib/emf/emf_plus/objects/path.rb +21 -0
  93. data/lib/emf/emf_plus/objects/pen.rb +132 -0
  94. data/lib/emf/emf_plus/objects/region.rb +39 -0
  95. data/lib/emf/emf_plus/objects/string_format.rb +55 -0
  96. data/lib/emf/emf_plus/objects/typed.rb +50 -0
  97. data/lib/emf/emf_plus/objects.rb +46 -0
  98. data/lib/emf/emf_plus/parser.rb +75 -0
  99. data/lib/emf/emf_plus/records/base.rb +107 -0
  100. data/lib/emf/emf_plus/records/begin_container.rb +31 -0
  101. data/lib/emf/emf_plus/records/begin_container_no_params.rb +20 -0
  102. data/lib/emf/emf_plus/records/body.rb +16 -0
  103. data/lib/emf/emf_plus/records/clear.rb +22 -0
  104. data/lib/emf/emf_plus/records/clip_transform_flags.rb +26 -0
  105. data/lib/emf/emf_plus/records/comment.rb +21 -0
  106. data/lib/emf/emf_plus/records/draw_arc.rb +33 -0
  107. data/lib/emf/emf_plus/records/draw_beziers.rb +31 -0
  108. data/lib/emf/emf_plus/records/draw_closed_curve.rb +34 -0
  109. data/lib/emf/emf_plus/records/draw_curve.rb +38 -0
  110. data/lib/emf/emf_plus/records/draw_driver_string.rb +61 -0
  111. data/lib/emf/emf_plus/records/draw_ellipse.rb +28 -0
  112. data/lib/emf/emf_plus/records/draw_image.rb +42 -0
  113. data/lib/emf/emf_plus/records/draw_image_points.rb +62 -0
  114. data/lib/emf/emf_plus/records/draw_lines.rb +34 -0
  115. data/lib/emf/emf_plus/records/draw_path.rb +23 -0
  116. data/lib/emf/emf_plus/records/draw_pie.rb +33 -0
  117. data/lib/emf/emf_plus/records/draw_rects.rb +30 -0
  118. data/lib/emf/emf_plus/records/draw_string.rb +41 -0
  119. data/lib/emf/emf_plus/records/end_container.rb +20 -0
  120. data/lib/emf/emf_plus/records/end_of_file.rb +17 -0
  121. data/lib/emf/emf_plus/records/fill_brush.rb +21 -0
  122. data/lib/emf/emf_plus/records/fill_closed_curve.rb +38 -0
  123. data/lib/emf/emf_plus/records/fill_ellipse.rb +29 -0
  124. data/lib/emf/emf_plus/records/fill_path.rb +23 -0
  125. data/lib/emf/emf_plus/records/fill_pie.rb +34 -0
  126. data/lib/emf/emf_plus/records/fill_polygon.rb +32 -0
  127. data/lib/emf/emf_plus/records/fill_rects.rb +31 -0
  128. data/lib/emf/emf_plus/records/fill_region.rb +23 -0
  129. data/lib/emf/emf_plus/records/get_dc.rb +18 -0
  130. data/lib/emf/emf_plus/records/header.rb +35 -0
  131. data/lib/emf/emf_plus/records/multiply_world_transform.rb +24 -0
  132. data/lib/emf/emf_plus/records/object.rb +32 -0
  133. data/lib/emf/emf_plus/records/offset_clip.rb +24 -0
  134. data/lib/emf/emf_plus/records/primitives/argb.rb +20 -0
  135. data/lib/emf/emf_plus/records/primitives/bitmap.rb +32 -0
  136. data/lib/emf/emf_plus/records/primitives/bitmap_data.rb +21 -0
  137. data/lib/emf/emf_plus/records/primitives/blend_colors.rb +22 -0
  138. data/lib/emf/emf_plus/records/primitives/blend_factors.rb +21 -0
  139. data/lib/emf/emf_plus/records/primitives/bounded_array.rb +38 -0
  140. data/lib/emf/emf_plus/records/primitives/byte_reader.rb +25 -0
  141. data/lib/emf/emf_plus/records/primitives/character_range.rb +20 -0
  142. data/lib/emf/emf_plus/records/primitives/compressed_image.rb +17 -0
  143. data/lib/emf/emf_plus/records/primitives/focus_scale_data.rb +20 -0
  144. data/lib/emf/emf_plus/records/primitives/graphics_version.rb +21 -0
  145. data/lib/emf/emf_plus/records/primitives/language_identifier.rb +22 -0
  146. data/lib/emf/emf_plus/records/primitives/metafile.rb +19 -0
  147. data/lib/emf/emf_plus/records/primitives/palette.rb +21 -0
  148. data/lib/emf/emf_plus/records/primitives/path.rb +89 -0
  149. data/lib/emf/emf_plus/records/primitives/path_point_type.rb +21 -0
  150. data/lib/emf/emf_plus/records/primitives/path_point_type_rle.rb +23 -0
  151. data/lib/emf/emf_plus/records/primitives/point.rb +18 -0
  152. data/lib/emf/emf_plus/records/primitives/point_array.rb +42 -0
  153. data/lib/emf/emf_plus/records/primitives/point_f.rb +19 -0
  154. data/lib/emf/emf_plus/records/primitives/point_r.rb +19 -0
  155. data/lib/emf/emf_plus/records/primitives/rect.rb +20 -0
  156. data/lib/emf/emf_plus/records/primitives/rect_array.rb +24 -0
  157. data/lib/emf/emf_plus/records/primitives/rect_f.rb +21 -0
  158. data/lib/emf/emf_plus/records/primitives/region_node.rb +68 -0
  159. data/lib/emf/emf_plus/records/primitives/region_node_child_nodes.rb +22 -0
  160. data/lib/emf/emf_plus/records/primitives/region_node_path.rb +37 -0
  161. data/lib/emf/emf_plus/records/primitives/relative_coordinate.rb +32 -0
  162. data/lib/emf/emf_plus/records/primitives/string_format_data.rb +23 -0
  163. data/lib/emf/emf_plus/records/primitives/transform_matrix.rb +23 -0
  164. data/lib/emf/emf_plus/records/primitives.rb +41 -0
  165. data/lib/emf/emf_plus/records/reset_clip.rb +17 -0
  166. data/lib/emf/emf_plus/records/reset_world_transform.rb +17 -0
  167. data/lib/emf/emf_plus/records/restore.rb +20 -0
  168. data/lib/emf/emf_plus/records/rotate_world_transform.rb +24 -0
  169. data/lib/emf/emf_plus/records/save.rb +20 -0
  170. data/lib/emf/emf_plus/records/scale_world_transform.rb +26 -0
  171. data/lib/emf/emf_plus/records/serializable_object.rb +32 -0
  172. data/lib/emf/emf_plus/records/set_anti_alias_mode.rb +25 -0
  173. data/lib/emf/emf_plus/records/set_clip_path.rb +20 -0
  174. data/lib/emf/emf_plus/records/set_clip_rect.rb +24 -0
  175. data/lib/emf/emf_plus/records/set_clip_region.rb +20 -0
  176. data/lib/emf/emf_plus/records/set_compositing_mode.rb +21 -0
  177. data/lib/emf/emf_plus/records/set_compositing_quality.rb +21 -0
  178. data/lib/emf/emf_plus/records/set_interpolation_mode.rb +21 -0
  179. data/lib/emf/emf_plus/records/set_page_transform.rb +25 -0
  180. data/lib/emf/emf_plus/records/set_pixel_offset_mode.rb +21 -0
  181. data/lib/emf/emf_plus/records/set_rendering_origin.rb +22 -0
  182. data/lib/emf/emf_plus/records/set_text_contrast.rb +24 -0
  183. data/lib/emf/emf_plus/records/set_text_rendering_hint.rb +21 -0
  184. data/lib/emf/emf_plus/records/set_ts_clip.rb +40 -0
  185. data/lib/emf/emf_plus/records/set_ts_graphics.rb +88 -0
  186. data/lib/emf/emf_plus/records/set_world_transform.rb +22 -0
  187. data/lib/emf/emf_plus/records/shape_flags.rb +23 -0
  188. data/lib/emf/emf_plus/records/translate_world_transform.rb +26 -0
  189. data/lib/emf/emf_plus/records/unknown.rb +20 -0
  190. data/lib/emf/emf_plus/records.rb +107 -0
  191. data/lib/emf/emf_plus/serializer.rb +20 -0
  192. data/lib/emf/emf_plus/stream/conformance.rb +68 -0
  193. data/lib/emf/emf_plus/stream/editor.rb +21 -0
  194. data/lib/emf/emf_plus/stream/emf_gap.rb +20 -0
  195. data/lib/emf/emf_plus/stream/link_index.rb +30 -0
  196. data/lib/emf/emf_plus/stream/rebuild.rb +47 -0
  197. data/lib/emf/emf_plus/stream/record_handle.rb +26 -0
  198. data/lib/emf/emf_plus/stream/segment.rb +70 -0
  199. data/lib/emf/emf_plus/stream.rb +153 -0
  200. data/lib/emf/emf_plus.rb +18 -0
  201. data/lib/emf/emr/binary/dib_header.rb +142 -0
  202. data/lib/emf/emr/binary/ext_text_out_fields.rb +43 -0
  203. data/lib/emf/emr/binary/extended_pen_buffers.rb +23 -0
  204. data/lib/emf/emr/binary/fast_fill.rb +1164 -0
  205. data/lib/emf/emr/binary/font.rb +159 -0
  206. data/lib/emf/emr/binary/header.rb +41 -0
  207. data/lib/emf/emr/binary/lazy_utf16_array.rb +82 -0
  208. data/lib/emf/emr/binary/pack_plan.rb +144 -0
  209. data/lib/emf/emr/binary/pack_plan_check.rb +75 -0
  210. data/lib/emf/emr/binary/pack_plan_exact.rb +130 -0
  211. data/lib/emf/emr/binary/pack_plan_generate.rb +116 -0
  212. data/lib/emf/emr/binary/pack_plan_values.rb +92 -0
  213. data/lib/emf/emr/binary/palette_body.rb +19 -0
  214. data/lib/emf/emr/binary/palette_entry.rb +18 -0
  215. data/lib/emf/emr/binary/record.rb +50 -0
  216. data/lib/emf/emr/binary/records/abort_path.rb +16 -0
  217. data/lib/emf/emr/binary/records/alpha_blend.rb +60 -0
  218. data/lib/emf/emr/binary/records/angle_arc.rb +19 -0
  219. data/lib/emf/emr/binary/records/arc.rb +19 -0
  220. data/lib/emf/emr/binary/records/arc_to.rb +19 -0
  221. data/lib/emf/emr/binary/records/begin_path.rb +16 -0
  222. data/lib/emf/emr/binary/records/bit_blt.rb +51 -0
  223. data/lib/emf/emr/binary/records/chord.rb +19 -0
  224. data/lib/emf/emr/binary/records/close_figure.rb +16 -0
  225. data/lib/emf/emr/binary/records/color_correct_palette.rb +71 -0
  226. data/lib/emf/emr/binary/records/colormatch_to_target_w.rb +92 -0
  227. data/lib/emf/emr/binary/records/comment.rb +20 -0
  228. data/lib/emf/emr/binary/records/create_brush_indirect.rb +20 -0
  229. data/lib/emf/emr/binary/records/create_colorspace.rb +83 -0
  230. data/lib/emf/emr/binary/records/create_colorspace_w.rb +106 -0
  231. data/lib/emf/emr/binary/records/create_dib_pattern_brush_pt.rb +39 -0
  232. data/lib/emf/emr/binary/records/create_font_indirect_w.rb +22 -0
  233. data/lib/emf/emr/binary/records/create_mono_brush.rb +39 -0
  234. data/lib/emf/emr/binary/records/create_palette.rb +35 -0
  235. data/lib/emf/emr/binary/records/create_pen.rb +20 -0
  236. data/lib/emf/emr/binary/records/delete_colorspace.rb +38 -0
  237. data/lib/emf/emr/binary/records/delete_object.rb +16 -0
  238. data/lib/emf/emr/binary/records/draw_escape.rb +61 -0
  239. data/lib/emf/emr/binary/records/ellipse.rb +18 -0
  240. data/lib/emf/emr/binary/records/end_path.rb +16 -0
  241. data/lib/emf/emr/binary/records/eof.rb +30 -0
  242. data/lib/emf/emr/binary/records/exclude_clip_rect.rb +16 -0
  243. data/lib/emf/emr/binary/records/ext_create_pen.rb +96 -0
  244. data/lib/emf/emr/binary/records/ext_escape.rb +61 -0
  245. data/lib/emf/emr/binary/records/ext_flood_fill.rb +24 -0
  246. data/lib/emf/emr/binary/records/ext_select_clip_rgn.rb +27 -0
  247. data/lib/emf/emr/binary/records/ext_text_out_a.rb +40 -0
  248. data/lib/emf/emr/binary/records/ext_text_out_w.rb +52 -0
  249. data/lib/emf/emr/binary/records/fill_path.rb +16 -0
  250. data/lib/emf/emr/binary/records/fill_rgn.rb +26 -0
  251. data/lib/emf/emr/binary/records/flatten_path.rb +16 -0
  252. data/lib/emf/emr/binary/records/force_ufi_mapping.rb +54 -0
  253. data/lib/emf/emr/binary/records/frame_rgn.rb +27 -0
  254. data/lib/emf/emr/binary/records/gls_bounded_record.rb +77 -0
  255. data/lib/emf/emr/binary/records/gls_record.rb +58 -0
  256. data/lib/emf/emr/binary/records/gradient_fill.rb +26 -0
  257. data/lib/emf/emr/binary/records/intersect_clip_rect.rb +16 -0
  258. data/lib/emf/emr/binary/records/invert_rgn.rb +25 -0
  259. data/lib/emf/emr/binary/records/line_to.rb +16 -0
  260. data/lib/emf/emr/binary/records/mask_blt.rb +83 -0
  261. data/lib/emf/emr/binary/records/modify_world_transform.rb +17 -0
  262. data/lib/emf/emr/binary/records/move_to_ex.rb +16 -0
  263. data/lib/emf/emr/binary/records/named_escape.rb +94 -0
  264. data/lib/emf/emr/binary/records/offset_clip_rgn.rb +16 -0
  265. data/lib/emf/emr/binary/records/paint_rgn.rb +25 -0
  266. data/lib/emf/emr/binary/records/pie.rb +19 -0
  267. data/lib/emf/emr/binary/records/pixel_format.rb +92 -0
  268. data/lib/emf/emr/binary/records/plg_blt.rb +83 -0
  269. data/lib/emf/emr/binary/records/poly_bezier.rb +17 -0
  270. data/lib/emf/emr/binary/records/poly_bezier16.rb +17 -0
  271. data/lib/emf/emr/binary/records/poly_bezier_to.rb +17 -0
  272. data/lib/emf/emr/binary/records/poly_bezier_to16.rb +17 -0
  273. data/lib/emf/emr/binary/records/poly_draw.rb +18 -0
  274. data/lib/emf/emr/binary/records/poly_draw16.rb +18 -0
  275. data/lib/emf/emr/binary/records/poly_polygon.rb +19 -0
  276. data/lib/emf/emr/binary/records/poly_polygon16.rb +19 -0
  277. data/lib/emf/emr/binary/records/poly_polyline.rb +19 -0
  278. data/lib/emf/emr/binary/records/poly_polyline16.rb +19 -0
  279. data/lib/emf/emr/binary/records/poly_textout_a.rb +144 -0
  280. data/lib/emf/emr/binary/records/poly_textout_w.rb +144 -0
  281. data/lib/emf/emr/binary/records/polygon.rb +17 -0
  282. data/lib/emf/emr/binary/records/polygon16.rb +17 -0
  283. data/lib/emf/emr/binary/records/polyline.rb +17 -0
  284. data/lib/emf/emr/binary/records/polyline16.rb +17 -0
  285. data/lib/emf/emr/binary/records/polyline_to.rb +17 -0
  286. data/lib/emf/emr/binary/records/polyline_to16.rb +17 -0
  287. data/lib/emf/emr/binary/records/raw.rb +22 -0
  288. data/lib/emf/emr/binary/records/realize_palette.rb +16 -0
  289. data/lib/emf/emr/binary/records/rectangle.rb +18 -0
  290. data/lib/emf/emr/binary/records/resize_palette.rb +31 -0
  291. data/lib/emf/emr/binary/records/restore_dc.rb +17 -0
  292. data/lib/emf/emr/binary/records/round_rect.rb +19 -0
  293. data/lib/emf/emr/binary/records/save_dc.rb +16 -0
  294. data/lib/emf/emr/binary/records/scale_viewport_ext_ex.rb +19 -0
  295. data/lib/emf/emr/binary/records/scale_window_ext_ex.rb +19 -0
  296. data/lib/emf/emr/binary/records/select_clip_path.rb +20 -0
  297. data/lib/emf/emr/binary/records/select_object.rb +16 -0
  298. data/lib/emf/emr/binary/records/select_palette.rb +17 -0
  299. data/lib/emf/emr/binary/records/set_arc_direction.rb +16 -0
  300. data/lib/emf/emr/binary/records/set_bk_color.rb +16 -0
  301. data/lib/emf/emr/binary/records/set_bk_mode.rb +16 -0
  302. data/lib/emf/emr/binary/records/set_brush_org_ex.rb +16 -0
  303. data/lib/emf/emr/binary/records/set_color_adjustment.rb +136 -0
  304. data/lib/emf/emr/binary/records/set_colorspace.rb +38 -0
  305. data/lib/emf/emr/binary/records/set_dibits_to_device.rb +60 -0
  306. data/lib/emf/emr/binary/records/set_icm_mode.rb +16 -0
  307. data/lib/emf/emr/binary/records/set_icm_profile_a.rb +87 -0
  308. data/lib/emf/emr/binary/records/set_icm_profile_w.rb +87 -0
  309. data/lib/emf/emr/binary/records/set_layout.rb +16 -0
  310. data/lib/emf/emr/binary/records/set_linked_ufis.rb +65 -0
  311. data/lib/emf/emr/binary/records/set_map_mode.rb +16 -0
  312. data/lib/emf/emr/binary/records/set_mapper_flags.rb +16 -0
  313. data/lib/emf/emr/binary/records/set_metargn.rb +16 -0
  314. data/lib/emf/emr/binary/records/set_miter_limit.rb +16 -0
  315. data/lib/emf/emr/binary/records/set_palette_entries.rb +35 -0
  316. data/lib/emf/emr/binary/records/set_pixel_v.rb +18 -0
  317. data/lib/emf/emr/binary/records/set_poly_fill_mode.rb +16 -0
  318. data/lib/emf/emr/binary/records/set_rop2.rb +16 -0
  319. data/lib/emf/emr/binary/records/set_stretch_blt_mode.rb +16 -0
  320. data/lib/emf/emr/binary/records/set_text_align.rb +16 -0
  321. data/lib/emf/emr/binary/records/set_text_color.rb +17 -0
  322. data/lib/emf/emr/binary/records/set_text_justification.rb +23 -0
  323. data/lib/emf/emr/binary/records/set_viewport_ext_ex.rb +16 -0
  324. data/lib/emf/emr/binary/records/set_viewport_org_ex.rb +16 -0
  325. data/lib/emf/emr/binary/records/set_window_ext_ex.rb +16 -0
  326. data/lib/emf/emr/binary/records/set_window_org_ex.rb +16 -0
  327. data/lib/emf/emr/binary/records/set_world_transform.rb +16 -0
  328. data/lib/emf/emr/binary/records/small_text_out.rb +79 -0
  329. data/lib/emf/emr/binary/records/stretch_blt.rb +53 -0
  330. data/lib/emf/emr/binary/records/stretch_dibits.rb +56 -0
  331. data/lib/emf/emr/binary/records/stroke_and_fill_path.rb +16 -0
  332. data/lib/emf/emr/binary/records/stroke_path.rb +16 -0
  333. data/lib/emf/emr/binary/records/transparent_blt.rb +60 -0
  334. data/lib/emf/emr/binary/records/widen_path.rb +16 -0
  335. data/lib/emf/emr/binary/records.rb +260 -0
  336. data/lib/emf/emr/binary/region_data.rb +33 -0
  337. data/lib/emf/emr/binary/state_record_body.rb +33 -0
  338. data/lib/emf/emr/binary/thin_shell.rb +226 -0
  339. data/lib/emf/emr/binary/type_codes.rb +132 -0
  340. data/lib/emf/emr/binary/value_view/layout.rb +101 -0
  341. data/lib/emf/emr/binary/value_view/reader_source.rb +88 -0
  342. data/lib/emf/emr/binary/value_view.rb +173 -0
  343. data/lib/emf/emr/binary/variable_buffers.rb +87 -0
  344. data/lib/emf/emr/binary/with_bounds.rb +15 -0
  345. data/lib/emf/emr/binary.rb +17 -0
  346. data/lib/emf/emr/filled_record.rb +77 -0
  347. data/lib/emf/emr/parser.rb +374 -0
  348. data/lib/emf/emr/path_association.rb +16 -0
  349. data/lib/emf/emr/serializer.rb +23 -0
  350. data/lib/emf/emr.rb +11 -0
  351. data/lib/emf/error.rb +42 -0
  352. data/lib/emf/model/diagnostic.rb +41 -0
  353. data/lib/emf/model/emr/header.rb +132 -0
  354. data/lib/emf/model/emr/records.rb +184 -0
  355. data/lib/emf/model/emr/wire_values.rb +43 -0
  356. data/lib/emf/model/emr.rb +11 -0
  357. data/lib/emf/model/geometry/color.rb +85 -0
  358. data/lib/emf/model/geometry/matrix.rb +52 -0
  359. data/lib/emf/model/geometry/point.rb +41 -0
  360. data/lib/emf/model/geometry/point_f.rb +33 -0
  361. data/lib/emf/model/geometry/point_s.rb +33 -0
  362. data/lib/emf/model/geometry/rect.rb +57 -0
  363. data/lib/emf/model/geometry/rect_s.rb +49 -0
  364. data/lib/emf/model/geometry/size.rb +33 -0
  365. data/lib/emf/model/geometry.rb +16 -0
  366. data/lib/emf/model/metafile.rb +54 -0
  367. data/lib/emf/model/record.rb +19 -0
  368. data/lib/emf/model/visitor.rb +42 -0
  369. data/lib/emf/model/wmf/bitmap_records.rb +155 -0
  370. data/lib/emf/model/wmf/brush_records.rb +45 -0
  371. data/lib/emf/model/wmf/dc_escape_records.rb +67 -0
  372. data/lib/emf/model/wmf/font_record.rb +40 -0
  373. data/lib/emf/model/wmf/geometry_records.rb +107 -0
  374. data/lib/emf/model/wmf/header.rb +36 -0
  375. data/lib/emf/model/wmf/object_records.rb +71 -0
  376. data/lib/emf/model/wmf/palette_records.rb +68 -0
  377. data/lib/emf/model/wmf/records.rb +247 -0
  378. data/lib/emf/model/wmf/region_records.rb +112 -0
  379. data/lib/emf/model/wmf/state_records.rb +188 -0
  380. data/lib/emf/model/wmf/text_records.rb +36 -0
  381. data/lib/emf/model/wmf.rb +11 -0
  382. data/lib/emf/model.rb +13 -0
  383. data/lib/emf/native/bitmap_fields.rb +58 -0
  384. data/lib/emf/native/diagnostic_contract.rb +39 -0
  385. data/lib/emf/native/diagnostics.rb +81 -0
  386. data/lib/emf/native/emf_plus_loader.rb +35 -0
  387. data/lib/emf/native/emf_plus_snapshot.rb +96 -0
  388. data/lib/emf/native/emf_plus_source.rb +20 -0
  389. data/lib/emf/native/emf_plus_stream.rb +150 -0
  390. data/lib/emf/native/fields.rb +369 -0
  391. data/lib/emf/native/font_fields.rb +87 -0
  392. data/lib/emf/native/gradient_fields.rb +23 -0
  393. data/lib/emf/native/header.rb +35 -0
  394. data/lib/emf/native/header_errors.rb +30 -0
  395. data/lib/emf/native/hydrator.rb +151 -0
  396. data/lib/emf/native/lazy_wire.rb +100 -0
  397. data/lib/emf/native/legacy_state_fields.rb +22 -0
  398. data/lib/emf/native/library_path.rb +68 -0
  399. data/lib/emf/native/loader.rb +120 -0
  400. data/lib/emf/native/palette_fields.rb +45 -0
  401. data/lib/emf/native/platforms.json +6 -0
  402. data/lib/emf/native/poly_text_fields.rb +116 -0
  403. data/lib/emf/native/provenance.json +11 -0
  404. data/lib/emf/native/resource_failure.rb +28 -0
  405. data/lib/emf/native/small_text_fields.rb +27 -0
  406. data/lib/emf/native/snapshot.rb +102 -0
  407. data/lib/emf/native/wmf_bitmap_fields.rb +58 -0
  408. data/lib/emf/native/wmf_brush_fields.rb +62 -0
  409. data/lib/emf/native/wmf_fields.rb +117 -0
  410. data/lib/emf/native/wmf_hydrator.rb +143 -0
  411. data/lib/emf/native/wmf_loading.rb +49 -0
  412. data/lib/emf/native/wmf_palette_fields.rb +60 -0
  413. data/lib/emf/native/wmf_region_fields.rb +92 -0
  414. data/lib/emf/native/wmf_rejection.rb +84 -0
  415. data/lib/emf/native/wmf_remaining_fields.rb +70 -0
  416. data/lib/emf/native/wmf_snapshot.rb +51 -0
  417. data/lib/emf/native/wmf_text_fields.rb +56 -0
  418. data/lib/emf/native/x86_64-linux-musl/libemf_ffi.so +0 -0
  419. data/lib/emf/native.rb +61 -0
  420. data/lib/emf/parse_evidence.rb +57 -0
  421. data/lib/emf/resource_budget/bitmap.rb +66 -0
  422. data/lib/emf/resource_budget/gradient.rb +30 -0
  423. data/lib/emf/resource_budget/poly_text.rb +85 -0
  424. data/lib/emf/resource_budget.rb +382 -0
  425. data/lib/emf/resource_limits/emf_records.rb +130 -0
  426. data/lib/emf/resource_limits.rb +58 -0
  427. data/lib/emf/version.rb +5 -0
  428. data/lib/emf/visitors/dump.rb +61 -0
  429. data/lib/emf/visitors/stats.rb +64 -0
  430. data/lib/emf/visitors.rb +8 -0
  431. data/lib/emf/wmf/binary.rb +158 -0
  432. data/lib/emf/wmf/bitmap_codec.rb +118 -0
  433. data/lib/emf/wmf/brush_codec.rb +102 -0
  434. data/lib/emf/wmf/dc_escape_codec.rb +75 -0
  435. data/lib/emf/wmf/dib.rb +187 -0
  436. data/lib/emf/wmf/embedded_emf.rb +137 -0
  437. data/lib/emf/wmf/escape_views.rb +89 -0
  438. data/lib/emf/wmf/evidence.rb +255 -0
  439. data/lib/emf/wmf/geometry_codec.rb +49 -0
  440. data/lib/emf/wmf/palette_codec.rb +85 -0
  441. data/lib/emf/wmf/parser.rb +158 -0
  442. data/lib/emf/wmf/recovery.rb +95 -0
  443. data/lib/emf/wmf/region_codec.rb +151 -0
  444. data/lib/emf/wmf/serializer.rb +175 -0
  445. data/lib/emf/wmf/text_codec.rb +123 -0
  446. data/lib/emf/wmf.rb +16 -0
  447. data/lib/emf.rb +60 -0
  448. metadata +520 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 7e931ad510f34e757e04a5175c33f3d43cd4776d20dff08d19a97a46f1430656
4
+ data.tar.gz: ce5f9931677d9787e72976b0c9d9b988f92580614b1663a7e4d29afd01bcdea9
5
+ SHA512:
6
+ metadata.gz: e903a53dad97b2f18239cddcea328f8e5579da9d062d40316b1b9a8b628bbf8183e9e37810ad4821d8c4c45e80f93b577207892df1f472790041d1f55a58120b
7
+ data.tar.gz: f816ab675d5efad944e8caa4047741f541814f0f7afe7faf38118d52aef53e69f5b54e6ab0a4f7ad18a403948727aad197bbea0eefc8efdf73c68776900def89
data/LICENSE.txt ADDED
@@ -0,0 +1,24 @@
1
+ BSD 2-Clause License
2
+
3
+ Copyright (c) 2026, Ribose Inc.
4
+
5
+ Redistribution and use in source and binary forms, with or without
6
+ modification, are permitted provided that the following conditions are met:
7
+
8
+ 1. Redistributions of source code must retain the above copyright notice, this
9
+ list of conditions and the following disclaimer.
10
+
11
+ 2. Redistributions in binary form must reproduce the above copyright notice,
12
+ this list of conditions and the following disclaimer in the documentation
13
+ and/or other materials provided with the distribution.
14
+
15
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
19
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
22
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
23
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
data/README.adoc ADDED
@@ -0,0 +1,341 @@
1
+ = emf: parser for WMF, EMF, and EMF+ metafiles
2
+
3
+ `emf` is a clean-room Ruby parser with an optional Rust native backend for the three Microsoft Windows
4
+ metafile formats:
5
+
6
+ * **WMF** — Windows Metafile (see MS-WMF, kaitai `wmf.ksy`)
7
+ * **EMF** — Enhanced Metafile (see MS-EMF)
8
+ * **EMF+** — Enhanced Metafile Plus (see MS-EMFPLUS; embedded in EMF
9
+ via `EMR_COMMENT` records)
10
+
11
+ It reads binary input into an OOP domain model and serialises the model
12
+ back to binary. It is the parsing half of the upcoming `emfsvg` gem
13
+ (EMF <-> SVG transformation). It replaces the FFI-based `emf2svg-ruby`
14
+ wrapper around the GPLv2 `libemf2svg` C library.
15
+
16
+ == Status
17
+
18
+ * **EMF**: parsing, mutable wire records and binary serialization are implemented.
19
+ * **EMF+**: raw carrier payloads (`Metafile#emf_plus`) and a typed stream view
20
+ (`Metafile#emf_plus_stream`) are implemented.
21
+ * **WMF**: standard and placeable headers, records and binary serialization
22
+ are implemented.
23
+ * **Native backend**: Rust decoding and a Ruby adapter are implemented and match the
24
+ Ruby backend on the valid and corrupt fixture corpora, every EMF record type and
25
+ mutated WMF input; installed platform qualification remains open.
26
+ * **Qualification**: implementation does not imply complete format coverage or
27
+ release readiness. See link:TODO.plan/10-progress.md[delivery progress] and
28
+ link:TODO.plan/09-format-extension.md[format extension acceptance].
29
+ * **License**: BSD-2-Clause. No GPL obligation.
30
+
31
+ == Installation
32
+
33
+ Add to your Gemfile:
34
+
35
+ gem "emf", "~> 0.1"
36
+
37
+ Or install directly:
38
+
39
+ gem install emf
40
+
41
+ Requires Ruby >= 3.1.
42
+
43
+ == Backend selection
44
+
45
+ The public `Emf.parse`, `Emf.parse_file` and `Emf.serialize` APIs use
46
+ `EMF_BACKEND` at call time:
47
+
48
+ [cols="1,3",options="header"]
49
+ |===
50
+ |Value |Behavior
51
+ |`auto` (default) |Use the native backend when available; fall back to Ruby if native setup raises `Emf::Native::Unavailable`.
52
+ |`ruby` |Use Ruby directly, without loading the native library.
53
+ |`native` |Require the native backend; unavailable setup raises `Emf::Native::Unavailable`.
54
+ |===
55
+
56
+ `Emf.backend` resolves the backend at call time and returns `:ruby` or `:native`.
57
+ It uses the same selection as parsing and serialization, including the `auto`
58
+ availability fallback. It returns a symbol rather than a backend adapter.
59
+ Explicit `native` selection raises `Emf::Native::Unavailable` if unavailable;
60
+ unexpected setup errors propagate. This query may load the native library, and
61
+ its result describes the current settings rather than pinning future operations.
62
+
63
+ Other values raise `ArgumentError`. A parsing or serialization error after
64
+ backend selection propagates to the caller; it is not retried using Ruby.
65
+ Both backends return the existing Ruby model and use the Ruby binary writers
66
+ for serialization, including mutable wire records.
67
+
68
+ For example, to explicitly use Ruby:
69
+
70
+ EMF_BACKEND=ruby ruby -remf -e 'p Emf.parse_file(ARGV.fetch(0)).format' image.emf
71
+
72
+ Native loading uses a packaged platform manifest when present. For development
73
+ with an existing compatible library, `EMF_NATIVE_LIBRARY` overrides discovery:
74
+
75
+ EMF_BACKEND=native EMF_NATIVE_LIBRARY=/absolute/path/to/libemf_ffi.dylib ruby -remf -e 'p Emf.parse_file(ARGV.fetch(0)).format' image.emf
76
+
77
+ Use the appropriate shared-library filename for the platform. An empty override
78
+ makes native loading unavailable. Native installation and platform support must
79
+ be qualified using link:TODO.plan/08-platform-delivery.md[the delivery checks];
80
+ the source implementation alone does not establish an available platform gem.
81
+
82
+ == Synopsis
83
+
84
+ require "emf"
85
+
86
+ # Parse from bytes or a file path
87
+ metafile = Emf.parse_file("image.emf")
88
+ metafile.format # => :emf or :emf_plus
89
+ metafile.records.length # => 3538
90
+ metafile.errors.empty? # => true (no parse errors)
91
+
92
+ # Walk records with a visitor
93
+ stats = Emf::Visitors::Stats.new.visit_all(metafile)
94
+ puts stats.to_s
95
+
96
+ # Serialise the model back to binary
97
+ bytes = Emf.serialize(metafile)
98
+
99
+ === Reading field values without BinData
100
+
101
+ `record.values` returns a record's field values as a frozen, plain Ruby object
102
+ (a `Data` with the wire's member names; nested structs as nested `Data`; a counted
103
+ point array as an Array of `Data` points with `x` and `y`) without making
104
+ BinData field objects. It is `nil` for records without a fixed layout or a
105
+ counted point array (for example ExtTextOut, bitmaps, fonts, Comment, Raw); use
106
+ `record.wire` for those. The values are equal on the Ruby and native backends and
107
+ always reflect edits made through `record.wire`.
108
+
109
+ record = metafile.records.find { |r| r.type_id == 86 } # POLYGON16
110
+ record.values.rcl_bounds.left
111
+ record.values.apts.map { |point| [point.x, point.y] }
112
+
113
+ == Command-line tool
114
+
115
+ emf version Print version
116
+ emf info FILE Header summary + record counts
117
+ emf dump FILE Record-by-record dump
118
+ emf stats FILE Record-type histogram
119
+ emf validate FILE Parse + report errors (exit 0 ok, 1 invalid)
120
+ emf round-trip FILE [--out] Re-serialize after parse, compare or write
121
+
122
+ == Conformance lens
123
+
124
+ `Emf::Conformance` checks a metafile against the Microsoft specifications
125
+ (MS-EMF, MS-EMFPLUS and MS-WMF) and reports what it finds. It does not repair
126
+ files and it does not change what the parser returns. The report uses the key
127
+ layout of `svg_conform`, so tools that read one can read the other.
128
+
129
+ require "emf"
130
+
131
+ report = Emf::Conformance.check("image.emf", profile: :tolerant)
132
+ report.valid? # => true when there are no errors (warnings do not count)
133
+ report.to_h # => Hash with string keys
134
+ report.to_yaml
135
+
136
+ The lens reads only the public model, so the Ruby and the native backend give
137
+ the same report. It adds no runtime dependency: `bindata` is still the only one.
138
+
139
+ === Input
140
+
141
+ `check` accepts four forms:
142
+
143
+ [cols="1,3",options="header"]
144
+ |===
145
+ |Input |Behavior
146
+ |path `String` |Read with `File.binread`. The path becomes the report's `filename`.
147
+ |`Pathname` |Same as a path `String`.
148
+ |bytes `String` |Parsed once. `filename` is `nil`. A `String` is taken as a path only when it names an existing file, has no NUL byte and is under 4096 bytes long.
149
+ |`Emf::Model::Metafile` |Evaluated without parsing again. `filename` is `nil`.
150
+ |===
151
+
152
+ A parsed `Metafile` carries no input bytes. Rules that compare a declared
153
+ length with the real input length are skipped for it. One example is
154
+ `emf.header.bytes`. The WMF size check against the input is another. Pass the
155
+ path or the bytes when you want those rules to run.
156
+
157
+ === Profiles
158
+
159
+ `profile:` is `:strict` (the default) or `:tolerant`. Any other value raises
160
+ `ArgumentError`.
161
+
162
+ * `:strict` reports every spec violation as an error.
163
+ * `:tolerant` accepts what real producers write. A rule that carries a
164
+ `tolerant_reason` becomes a warning instead of an error. The warning keeps
165
+ its `requirement_id`, `kind`, citation and offset. The reason appears as
166
+ `context.waiver`.
167
+
168
+ A waiver belongs to the rule, not to a file. Every input that triggers that
169
+ rule gets the downgrade. There is no per-file allowlist. A rule without a
170
+ `tolerant_reason` is an error under both profiles.
171
+
172
+ Two files in `spec/fixtures/emf-corrupted/` cannot be parsed into a model. One
173
+ has a truncated header and one has an unrecognised first word. They report
174
+ `valid: false` under both profiles, with the error `emf.parse.unparseable`.
175
+ The other 19 corrupted fixtures are `valid: true` under `:tolerant`.
176
+
177
+ === The report
178
+
179
+ `Report#to_h` has these keys: `filename`, `profile`, `tool`, `version`,
180
+ `timestamp`, `valid`, `errors` and `warnings`. `errors` and `warnings` each hold
181
+ `total_count`, `by_requirement` and the ordered `issues`. Issues are ordered by
182
+ offset, then requirement id. Each issue has `type`, `requirement_id`,
183
+ `message`, `element`, `attribute`, `value`, `offset`, `severity`, `kind`,
184
+ `category`, `spec_citation`, `remediation_available` and `context`.
185
+ `offset` is the absolute byte offset in the file. `kind` is a stable
186
+ machine-readable name. `category` repeats `kind` and `severity` repeats `type`,
187
+ for `svg_conform` compatibility.
188
+
189
+ This is the strict report for a repo fixture. It comes from
190
+ `Emf::Conformance.check("spec/fixtures/emf/test-000.emf").to_h(timestamp: false).to_yaml`.
191
+ The `timestamp` line is left out by `timestamp: false`.
192
+
193
+ filename: spec/fixtures/emf/test-000.emf
194
+ profile: strict
195
+ tool: emf
196
+ version: 0.1.2
197
+ valid: false
198
+ errors:
199
+ total_count: 1
200
+ by_requirement:
201
+ emfplus.property.enum: 1
202
+ issues:
203
+ - type: error
204
+ requirement_id: emfplus.property.enum
205
+ message: SetCompositingQuality CompositingQuality value 0 is outside 1..5 (EMF+
206
+ record 0x4024 at offset 0 of EMR_COMMENT_EMFPLUS record 50)
207
+ element: emf_plus:0x4024
208
+ attribute:
209
+ value:
210
+ offset: 52152
211
+ severity: error
212
+ kind: property_enum
213
+ category: property_enum
214
+ spec_citation: MS-EMFPLUS 2.3.6
215
+ remediation_available: false
216
+ context:
217
+ spec_citation: MS-EMFPLUS 2.3.6
218
+ format: emf_plus
219
+ record_index: 50
220
+ record_type: 16420
221
+ warnings:
222
+ total_count: 0
223
+ by_requirement: {}
224
+ issues: []
225
+
226
+ With `profile: :tolerant` the same file is `valid: true`. The finding moves to
227
+ `warnings`, and `context.waiver` carries the written reason.
228
+
229
+ === Comparing backends
230
+
231
+ The report holds a creation `timestamp`, so two runs never compare equal as they
232
+ are. To compare two reports, drop the timestamp or pin it:
233
+
234
+ Emf::Conformance.check(path).to_h(timestamp: false)
235
+ Emf::Conformance.check(path, now: Time.utc(2026, 1, 1)).to_h # "timestamp" => "2026-01-01T00:00:00Z"
236
+
237
+ Run once with `EMF_BACKEND=ruby` and once with `EMF_BACKEND=native` (see
238
+ <<Backend selection>>) and compare the two results. They must be equal. The
239
+ `native` value raises `Emf::Native::Unavailable` when no native library loads.
240
+
241
+ === The rule manifest
242
+
243
+ Every rule the lens implements, and every check it does not yet make, is listed
244
+ in `lib/emf/conformance/manifest/*.yml`. A row has an `id`, a `format`, the
245
+ `record_types` it covers, a `citation`, a `status` and a `reason`. The reason is
246
+ required for every status except `implemented`.
247
+
248
+ [cols="1,3",options="header"]
249
+ |===
250
+ |Status |Meaning
251
+ |`implemented` |A registered rule with this id exists.
252
+ |`deferred` |The data is readable from the public model today, but no rule is written yet.
253
+ |`blocked:model` |The check needs a public model field that does not exist yet. The reason names the field.
254
+ |`not_checkable` |No input can violate it, or the bytes are ignored on receipt.
255
+ |===
256
+
257
+ Read the manifest to see what a clean report does not prove. A `deferred` or
258
+ `blocked:model` row is a check the lens does not make. Every record type of the
259
+ three specifications appears in at least one row.
260
+
261
+ == Architecture
262
+
263
+ Three layers, kept strictly separate (MECE):
264
+
265
+ binary bytes --[bindata]--> Emr::Binary::*Record (byte-faithful)
266
+ |
267
+ Record.from_wire
268
+ v
269
+ Model::*Record (semantic OOP, immutable)
270
+ |
271
+ Record#to_wire
272
+ v
273
+ Emr::Binary::*Record --[bindata]--> binary bytes
274
+
275
+ * **Wire layer** (`Emf::Emr::Binary::*`): one bindata class per EMR record
276
+ type, declared by spec. Pure data, no behaviour. Symmetric read/write.
277
+ * **Domain layer** (`Emf::Model::*`): immutable value objects with
278
+ `attr_reader`, value equality, `accept(visitor)`, `from_wire`, `to_wire`.
279
+ * **Visitor pattern** (`Emf::Model::Visitor`): consumers subclass the base
280
+ and override only the `visit_*` methods they care about. Adding a record
281
+ type touches the record's own file plus three lines in `records.rb`
282
+ (autoload + TYPE_TO_NAME + the file itself) -- no central switch.
283
+
284
+ === Constraints honoured throughout
285
+
286
+ * No `require_relative` and no `require` of internal paths in `lib/` --
287
+ everything autoloads via the parent-namespace file pattern.
288
+ * No `double()` in specs -- real instances only.
289
+ * No `send` to private methods, no `instance_variable_set`/`get`, no
290
+ `respond_to?` for type checks.
291
+ * No AI attribution in any commit. All changes go through PRs.
292
+
293
+ See `docs/architecture.adoc` and `docs/format_notes.adoc` for the deep
294
+ dive, and link:TODO.plan/10-progress.md[delivery progress] for implementation status.
295
+
296
+ === Reference documentation
297
+
298
+ The Microsoft specifications are checked in at `reference-docs/` as both
299
+ the original `.docx` files and per-chapter GFM markdown under
300
+ `reference-docs/<spec>/`. The conversion script is
301
+ `scripts/convert_docs.rb` (rubyzip + nokogiri). Re-run when the spec
302
+ revision bumps.
303
+
304
+ == Development
305
+
306
+ git clone https://github.com/claricle/emf
307
+ cd emf
308
+ bundle install
309
+ bundle exec rspec # fixture and unit checks
310
+ bundle exec rubocop # clean
311
+
312
+ The round-trip harness in `spec/emf/round_trip_spec.rb` is the strongest
313
+ correctness signal: it walks every non-corrupted fixture and asserts
314
+ byte-identical parse -> serialise -> parse.
315
+
316
+ == Roadmap
317
+
318
+ The execution plan for issue #15 starts at
319
+ link:TODO.plan/00-overview.md[the shared roadmap]. Implementation is in progress; remaining acceptance and
320
+ qualification work is tracked in the linked sections.
321
+
322
+ * link:TODO.plan/05-ruby-execution.md[Ruby implementation]: existing API dispatch,
323
+ model compatibility, mutable wire serialization, fallback and CLI behavior.
324
+ * link:TODO.plan/03-rust-core.md[Rust core] and
325
+ link:TODO.plan/04-c-abi.md[C ABI]: typed decoding, serialization and native ownership.
326
+ * link:TODO.plan/09-format-extension.md[Format extensions]: WMF and structured EMF+.
327
+ * link:TODO.plan/06-resilience.md[Resilience],
328
+ link:TODO.plan/07-performance.md[performance] and
329
+ link:TODO.plan/08-platform-delivery.md[platform delivery].
330
+
331
+ Other roadmap items include semantic domain records beyond `WireAdapter` and
332
+ two-pass path association (`BEGINPATH` with `FILLPATH`/`STROKEPATH`). These remain
333
+ separate from the issue #15 delivery criteria.
334
+
335
+ == License
336
+
337
+ BSD-2-Clause. See `LICENSE.txt`.
338
+
339
+ The gem is a clean-room reimplementation derived from the public
340
+ Microsoft Open Specifications (MS-WMF, MS-EMF, MS-EMFPLUS). No code was
341
+ copied from `libemf2svg` (GPLv2) or `libUEMF` (GPLv2).
data/exe/emf ADDED
@@ -0,0 +1,125 @@
1
+ #! /usr/bin/env ruby
2
+ # frozen_string_literal: true
3
+
4
+ require "optparse"
5
+
6
+ $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
7
+ require "emf"
8
+
9
+ module Emf
10
+ module CLI
11
+ module_function
12
+
13
+ def run(argv)
14
+ command = argv.shift
15
+ case command
16
+ when "version", "-v", "--version" then puts "emf #{Emf::VERSION}"
17
+ when "info" then info(argv)
18
+ when "dump" then dump(argv)
19
+ when "validate" then validate(argv)
20
+ when "stats" then stats(argv)
21
+ when "round-trip" then round_trip(argv)
22
+ when "help", "-h", "--help", nil then print_help
23
+ else
24
+ warn "emf: unknown command '#{command}' (see `emf help`)"
25
+ exit 1
26
+ end
27
+ end
28
+
29
+ def parse_path(argv)
30
+ path = argv.shift
31
+ return path if path && !path.empty?
32
+
33
+ warn "emf: missing FILE argument"
34
+ exit 2
35
+ end
36
+
37
+ def info(argv)
38
+ path = parse_path(argv)
39
+ mf = Emf.parse_file(path)
40
+ puts "Format: #{mf.format}"
41
+ puts "Records: #{mf.records.size}"
42
+ puts "Errors: #{mf.errors.size}"
43
+ puts "EMF+: #{mf.emf_plus ? "present (#{mf.emf_plus.bytesize} bytes)" : 'absent'}"
44
+ puts "Trailing: #{mf.trailing.bytesize} bytes"
45
+ return unless mf.header
46
+
47
+ h = mf.header
48
+ return wmf_info(h) if mf.format == :wmf
49
+
50
+ puts "Bounds: left=#{h.bounds.left} top=#{h.bounds.top} right=#{h.bounds.right} bottom=#{h.bounds.bottom}"
51
+ puts "Frame: left=#{h.frame.left} top=#{h.frame.top} right=#{h.frame.right} bottom=#{h.frame.bottom}"
52
+ puts "Device: #{h.device_pixels.cx}x#{h.device_pixels.cy} px (#{h.device_mm.cx / 100.0}x#{h.device_mm.cy / 100.0} mm)"
53
+ puts "nRecords: #{h.n_records} nHandles: #{h.n_handles} nBytes: #{h.n_bytes}"
54
+ end
55
+
56
+ def wmf_info(header)
57
+ puts "Type: #{header.type} Version: #{header.version} Size: #{header.size_words} words"
58
+ puts "Objects: #{header.number_of_objects} MaxRecord: #{header.max_record_words} words Members: #{header.number_of_members}"
59
+ return unless header.placeable
60
+
61
+ placeable = header.placeable
62
+ puts "Bounds: left=#{placeable.left} top=#{placeable.top} right=#{placeable.right} bottom=#{placeable.bottom}"
63
+ puts "Units: #{placeable.inch} per inch"
64
+ end
65
+
66
+ def dump(argv)
67
+ path = parse_path(argv)
68
+ mf = Emf.parse_file(path)
69
+ d = Emf::Visitors::Dump.new
70
+ d.visit_all(mf)
71
+ puts d
72
+ end
73
+
74
+ def validate(argv)
75
+ path = parse_path(argv)
76
+ mf = Emf.parse_file(path)
77
+ if mf.errors.empty?
78
+ puts "OK: #{mf.records.size} records, 0 errors"
79
+ exit 0
80
+ else
81
+ puts "INVALID: #{mf.records.size} records, #{mf.errors.size} errors"
82
+ mf.errors.first(10).each { |e| puts " #{e.message}" }
83
+ exit 1
84
+ end
85
+ end
86
+
87
+ def stats(argv)
88
+ path = parse_path(argv)
89
+ mf = Emf.parse_file(path)
90
+ s = Emf::Visitors::Stats.new
91
+ s.visit_all(mf)
92
+ puts s
93
+ end
94
+
95
+ def round_trip(argv)
96
+ path = parse_path(argv)
97
+ original = File.binread(path)
98
+ reborn = Emf.serialize(Emf.parse(original))
99
+ out = argv.shift
100
+ if out
101
+ File.binwrite(out, reborn)
102
+ puts "Wrote #{out} (#{reborn.bytesize} bytes)"
103
+ else
104
+ puts original == reborn ? "OK: byte-identical round-trip" : "DRIFT: original=#{original.bytesize} reborn=#{reborn.bytesize}"
105
+ end
106
+ end
107
+
108
+ def print_help
109
+ puts <<~HELP
110
+ emf #{Emf::VERSION} — pure-Ruby WMF/EMF/EMF+ parser
111
+
112
+ Usage:
113
+ emf version Print the version
114
+ emf info FILE Print metafile header and record counts
115
+ emf dump FILE Print a record-by-record dump
116
+ emf validate FILE Parse and report errors (exit 0 ok, 1 invalid)
117
+ emf stats FILE Print record-type histogram
118
+ emf round-trip FILE [--out] Serialize after parse, compare or write
119
+ emf help Show this message
120
+ HELP
121
+ end
122
+ end
123
+ end
124
+
125
+ Emf::CLI.run(ARGV)
@@ -0,0 +1,60 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Emf
4
+ module Backend
5
+ module Ruby
6
+ class << self
7
+ def parse(bytes)
8
+ deferred = ResourceLimits.preflight(bytes, defer: true)
9
+ case Detector.call(bytes)
10
+ when :wmf_apm, :wmf_standard then Wmf::Parser.call(bytes)
11
+ when :emf then Emr::Parser.call(bytes, deferred_admission: deferred)
12
+ end
13
+ rescue FormatError, ParseError => e
14
+ raise ParseEvidenceBuilder.attach(e, bytes)
15
+ end
16
+
17
+ def serialize(metafile)
18
+ case metafile.format
19
+ when :wmf then Wmf::Serializer.call(metafile)
20
+ when :emf, :emf_plus then Emr::Serializer.call(metafile)
21
+ else raise SerializeError, "unknown format: #{metafile.format.inspect}"
22
+ end
23
+ end
24
+ end
25
+ end
26
+ private_constant :Ruby
27
+
28
+ class << self
29
+ def resolved
30
+ selected.equal?(Ruby) ? :ruby : :native
31
+ end
32
+
33
+ def parse(bytes)
34
+ selected.parse(bytes)
35
+ end
36
+
37
+ def serialize(metafile)
38
+ selected.serialize(metafile)
39
+ end
40
+
41
+ private
42
+
43
+ def selected
44
+ override = ENV.fetch("EMF_BACKEND", "auto")
45
+ case override
46
+ when "ruby" then Ruby
47
+ when "auto" then native_or_ruby
48
+ when "native" then Native.backend
49
+ else raise ArgumentError, "invalid EMF_BACKEND: #{override.inspect} (expected auto, ruby, or native)"
50
+ end
51
+ end
52
+
53
+ def native_or_ruby
54
+ Native.backend
55
+ rescue Native::Unavailable
56
+ Ruby
57
+ end
58
+ end
59
+ end
60
+ end
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Emf
4
+ module Binary
5
+ # BinData defines three singleton accessors per field on every instance,
6
+ # which dominates allocation when a metafile holds tens of thousands of
7
+ # records. The accessors depend only on the field's index, so they are
8
+ # defined once per class on first instantiation and shared afterwards.
9
+ module ClassFieldAccessors
10
+ private
11
+
12
+ def define_field_accessors
13
+ klass = self.class
14
+ return if klass.instance_variable_get(:@field_accessors_defined)
15
+
16
+ get_parameter(:fields).each_with_index do |field, index|
17
+ name = field.name_as_sym
18
+ define_class_accessors(klass, name, index) if name
19
+ end
20
+ klass.instance_variable_set(:@field_accessors_defined, true)
21
+ end
22
+
23
+ def define_setter(klass, name, index)
24
+ klass.define_method("#{name}=") { |val| assign_field_at(index, val) }
25
+ end
26
+
27
+ # The generic assignment; a class that can take one into the bytes it
28
+ # is still made from overrides it.
29
+ def assign_field_at(index, val)
30
+ instantiate_obj_at(index) if @field_objs.nil? || @field_objs[index].nil?
31
+ @field_objs[index].assign(val)
32
+ end
33
+
34
+ def define_class_accessors(klass, name, index)
35
+ klass.define_method(name) do
36
+ @field_objs&.at(index) || begin
37
+ instantiate_obj_at(index)
38
+ @field_objs[index]
39
+ end
40
+ end
41
+ define_setter(klass, name, index)
42
+ klass.define_method("#{name}?") do
43
+ instantiate_obj_at(index) if @field_objs.nil? || @field_objs[index].nil?
44
+ include_obj?(@field_objs[index])
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "bindata"
4
+
5
+ module Emf
6
+ module Binary
7
+ module Codec
8
+ module_function
9
+
10
+ def utf16le_to_utf8(bytes)
11
+ bytes.dup.force_encoding("UTF-16LE").encode("UTF-8")
12
+ end
13
+
14
+ def cp1252_to_utf8(bytes)
15
+ bytes.dup.force_encoding("CP1252").encode("UTF-8")
16
+ end
17
+ end
18
+ end
19
+ end
@@ -0,0 +1,54 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "bindata"
4
+
5
+ module Emf
6
+ module Binary
7
+ # Little-endian IEEE 754 single that writes back the exact bits it read.
8
+ # Ruby widens a float32 to a double on read but `pack("e")` canonicalises
9
+ # every NaN to 0x7fc00000, so NaN payloads (and signalling NaNs) would
10
+ # otherwise change on a parse -> serialize round trip. Only NaNs carry
11
+ # their bits; every other value re-encodes exactly through the Float.
12
+ # Assigning a value drops the retained bits.
13
+ class Float32Le < BinData::BasePrimitive
14
+ def initialize_instance
15
+ super
16
+ @nan_bits = nil
17
+ end
18
+
19
+ def assign(val)
20
+ @nan_bits = nil
21
+ super
22
+ end
23
+
24
+ def assign_bits(bits)
25
+ @value = [bits].pack("V").unpack1("e")
26
+ @nan_bits = @value.nan? ? bits : nil
27
+ bits
28
+ end
29
+
30
+ def do_num_bytes
31
+ 4
32
+ end
33
+
34
+ private
35
+
36
+ def sensible_default
37
+ 0.0
38
+ end
39
+
40
+ def read_and_return_value(io)
41
+ raw = io.readbytes(4)
42
+ value = raw.unpack1("e")
43
+ @nan_bits = value.nan? ? raw.unpack1("V") : nil
44
+ value
45
+ end
46
+
47
+ def value_to_binary_string(val)
48
+ return [@nan_bits].pack("V") if @nan_bits
49
+
50
+ [val].pack("e")
51
+ end
52
+ end
53
+ end
54
+ end